aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source/routing.md
diff options
context:
space:
mode:
authorYoshiyuki Hirano <yhirano@me.com>2017-12-12 03:43:44 +0900
committerYoshiyuki Hirano <yhirano@me.com>2017-12-12 14:07:58 +0900
commit3dc774f37196634c0ead612fae52b37aa8a5838c (patch)
tree942daa16cef81ef03dddec86fb1e39ad0681dd83 /guides/source/routing.md
parent4edce566ad13d54c86637caf56750df0d6dc7b1a (diff)
downloadrails-3dc774f37196634c0ead612fae52b37aa8a5838c.tar.gz
rails-3dc774f37196634c0ead612fae52b37aa8a5838c.tar.bz2
rails-3dc774f37196634c0ead612fae52b37aa8a5838c.zip
[ci skip] Update routing guide for Direct
* Added the direct method to routing guide.
Diffstat (limited to 'guides/source/routing.md')
-rw-r--r--guides/source/routing.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/guides/source/routing.md b/guides/source/routing.md
index 638f77be13..efc0e32b56 100644
--- a/guides/source/routing.md
+++ b/guides/source/routing.md
@@ -852,6 +852,49 @@ You can specify unicode character routes directly. For example:
get 'こんにちは', to: 'welcome#index'
```
+### Direct routes
+
+You can create custom URL helpers directly. For example:
+
+```ruby
+direct :homepage do
+ "http://www.rubyonrails.org"
+end
+
+# >> homepage_url
+# => "http://www.rubyonrails.org"
+```
+
+The return value of the block must be a valid argument for the `url_for` method. So, you can pass a valid string URL, Hash, Array, an Active Model instance, or an Active Model class.
+
+```ruby
+direct :commentable do |model|
+ [ model, anchor: model.dom_id ]
+end
+
+direct :main do
+ { controller: 'pages', action: 'index', subdomain: 'www' }
+end
+```
+
+### Using `resolve`
+
+The `resolve` method allows customizing polymorphic mapping of models. For example:
+
+``` ruby
+resource :basket
+
+resolve("Basket") { [:basket] }
+```
+
+``` erb
+<%= form_for @basket do |form| %>
+ <!-- basket form -->
+<% end %>
+```
+
+This will generate the singular URL `/basket` instead of the usual `/baskets/:id`.
+
Customizing Resourceful Routes
------------------------------