diff options
| author | Vipul A M <vipulnsward@gmail.com> | 2016-06-30 18:55:13 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2016-06-30 18:55:13 -0700 |
| commit | 2c5517c8b7136b0bdca145e6061fbad5735610dd (patch) | |
| tree | df814fb79554040d8c46e0d9508f9aa58ebe3994 | |
| parent | 585ec13ca4210612e50445aad6c52cdff8876fc3 (diff) | |
| parent | 66fa5750a96796ecc62741f39d32979636327475 (diff) | |
| download | rails-2c5517c8b7136b0bdca145e6061fbad5735610dd.tar.gz rails-2c5517c8b7136b0bdca145e6061fbad5735610dd.tar.bz2 rails-2c5517c8b7136b0bdca145e6061fbad5735610dd.zip | |
Merge pull request #25553 from vipulnsward/25543-docs-follow-up
25543 docs cleanup
| -rw-r--r-- | actionview/lib/action_view/helpers/tag_helper.rb | 23 |
1 files changed, 7 insertions, 16 deletions
diff --git a/actionview/lib/action_view/helpers/tag_helper.rb b/actionview/lib/action_view/helpers/tag_helper.rb index 48dea8f214..0633cfc2b4 100644 --- a/actionview/lib/action_view/helpers/tag_helper.rb +++ b/actionview/lib/action_view/helpers/tag_helper.rb @@ -124,11 +124,11 @@ module ActionView # ==== Passing content # Tags can pass content to embed within it: # - # tag.h1 'All shit fit to print' # => <h1>All shit fit to print</h1> + # tag.h1 'All titles fit to print' # => <h1>All titles fit to print</h1> # # tag.div tag.p('Hello world!') # => <div><p>Hello world!</p></div> # - # Content can also be captured with a block. Great for ERB templates: + # Content can also be captured with a block, which is useful in templates: # # <%= tag.p do %> # The next great American novel starts here. @@ -136,7 +136,7 @@ module ActionView # # => <p>The next great American novel starts here.</p> # # ==== Options - # Any passed options becomes attributes on the generated tag. + # Any passed options become attributes on the generated tag. # # tag.section class: %w( kitties puppies ) # # => <section class="kitties puppies"></section> @@ -144,7 +144,7 @@ module ActionView # tag.section id: dom_id(@post) # # => <section id="<generated dom id>"></section> # - # Pass true for any attributes that can render with no values like +disabled+. + # Pass +true+ for any attributes that can render with no values, like +disabled+ and +readonly+. # # tag.input type: 'text', disabled: true # # => <input type="text" disabled="disabled"> @@ -152,7 +152,7 @@ module ActionView # HTML5 <tt>data-*</tt> attributes can be set with a single +data+ key # pointing to a hash of sub-attributes. # - # To play nicely with JavaScript conventions sub-attributes are dasherized. + # To play nicely with JavaScript conventions, sub-attributes are dasherized. # # tag.article data: { user_id: 123 } # # => <article data-user-id="123"></article> @@ -167,7 +167,7 @@ module ActionView # tag.div data: { city_state: %w( Chigaco IL ) } # # => <div data-city-state="["Chicago","IL"]"></div> # - # The generated attributes are escaped by default, but it can be turned off with + # The generated attributes are escaped by default. This can be disabled using # +escape_attributes+. # # tag.img src: 'open & shut.png' @@ -187,7 +187,7 @@ module ActionView # tag.br # => <br> # # === Legacy syntax - # Following format is legacy syntax. It will be deprecated in future versions of rails. + # The following format is for legacy syntax support. It will be deprecated in future versions of Rails. # # tag(tag_name, options) # @@ -207,15 +207,6 @@ module ActionView # HTML5 <tt>data-*</tt> attributes can be set with a single +data+ key # pointing to a hash of sub-attributes. # - # To play nicely with JavaScript conventions sub-attributes are dasherized. - # For example, a key +user_id+ would render as <tt>data-user-id</tt> and - # thus accessed as <tt>dataset.userId</tt>. - # - # Values are encoded to JSON, with the exception of strings, symbols and - # BigDecimals. - # This may come in handy when using jQuery's HTML5-aware <tt>.data()</tt> - # from 1.4.3. - # # ==== Examples # tag("br") # # => <br /> |