mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
Cleans documentation from Helpers [ci skip]
This commit is contained in:
parent
8dc4041a9b
commit
5ab0c5dc22
5 changed files with 94 additions and 117 deletions
|
@ -45,7 +45,6 @@ module ActionView
|
|||
# 40-59 secs # => less than a minute
|
||||
# 60-89 secs # => 1 minute
|
||||
#
|
||||
# ==== Examples
|
||||
# from_time = Time.now
|
||||
# distance_of_time_in_words(from_time, from_time + 50.minutes) # => about 1 hour
|
||||
# distance_of_time_in_words(from_time, 50.minutes.from_now) # => about 1 hour
|
||||
|
@ -166,7 +165,6 @@ module ActionView
|
|||
# Returns a set of select tags (one for year, month, and day) pre-selected for accessing a specified date-based
|
||||
# attribute (identified by +method+) on an object assigned to the template (identified by +object+).
|
||||
#
|
||||
#
|
||||
# ==== Options
|
||||
# * <tt>:use_month_numbers</tt> - Set to true if you want to use month numbers rather than month names (e.g.
|
||||
# "2" instead of "February").
|
||||
|
|
|
@ -105,11 +105,12 @@ module ActionView
|
|||
#
|
||||
# if @person.update_attributes(params[:person])
|
||||
# # success
|
||||
# else
|
||||
# els
|
||||
# # error handling
|
||||
# end
|
||||
#
|
||||
# That's how you typically work with resources.
|
||||
# That's how you typically work with resources. Note that it
|
||||
# would probably improve by using the Strong Parameters functionality
|
||||
module FormHelper
|
||||
extend ActiveSupport::Concern
|
||||
|
||||
|
|
|
@ -18,7 +18,8 @@ module ActionView
|
|||
|
||||
# Escapes carriage returns and single and double quotes for JavaScript segments.
|
||||
#
|
||||
# Also available through the alias j(). This is particularly helpful in JavaScript responses, like:
|
||||
# Also available through the alias j(). This is particularly helpful in JavaScript
|
||||
# responses, like:
|
||||
#
|
||||
# $('some_element').replaceWith('<%=j render 'some/element_template' %>');
|
||||
def escape_javascript(javascript)
|
||||
|
@ -43,12 +44,14 @@ module ActionView
|
|||
# </script>
|
||||
#
|
||||
# +html_options+ may be a hash of attributes for the <tt>\<script></tt>
|
||||
# tag. Example:
|
||||
# tag.
|
||||
#
|
||||
# javascript_tag "alert('All is good')", defer: 'defer'
|
||||
# # => <script defer="defer">alert('All is good')</script>
|
||||
#
|
||||
# Instead of passing the content as an argument, you can also use a block
|
||||
# in which case, you pass your +html_options+ as the first parameter.
|
||||
#
|
||||
# <%= javascript_tag defer: 'defer' do -%>
|
||||
# alert('All is good')
|
||||
# <% end -%>
|
||||
|
|
|
@ -28,8 +28,6 @@ module ActionView
|
|||
# Formats a +number+ into a US phone number (e.g., (555)
|
||||
# 123-9876). You can customize the format in the +options+ hash.
|
||||
#
|
||||
# ==== Options
|
||||
#
|
||||
# * <tt>:area_code</tt> - Adds parentheses around the area code.
|
||||
# * <tt>:delimiter</tt> - Specifies the delimiter to use
|
||||
# (defaults to "-").
|
||||
|
@ -40,8 +38,6 @@ module ActionView
|
|||
# * <tt>:raise</tt> - If true, raises +InvalidNumberError+ when
|
||||
# the argument is invalid.
|
||||
#
|
||||
# ==== Examples
|
||||
#
|
||||
# number_to_phone(5551234) # => 555-1234
|
||||
# number_to_phone("5551234") # => 555-1234
|
||||
# number_to_phone(1235551234) # => 123-555-1234
|
||||
|
@ -50,7 +46,6 @@ module ActionView
|
|||
# number_to_phone(1235551234, area_code: true, extension: 555) # => (123) 555-1234 x 555
|
||||
# number_to_phone(1235551234, country_code: 1) # => +1-123-555-1234
|
||||
# number_to_phone("123a456") # => 123a456
|
||||
#
|
||||
# number_to_phone("1234a567", raise: true) # => InvalidNumberError
|
||||
#
|
||||
# number_to_phone(1235551234, country_code: 1, extension: 1343, delimiter: ".")
|
||||
|
@ -66,8 +61,6 @@ module ActionView
|
|||
# Formats a +number+ into a currency string (e.g., $13.65). You
|
||||
# can customize the format in the +options+ hash.
|
||||
#
|
||||
# ==== Options
|
||||
#
|
||||
# * <tt>:locale</tt> - Sets the locale to be used for formatting
|
||||
# (defaults to current locale).
|
||||
# * <tt>:precision</tt> - Sets the level of precision (defaults
|
||||
|
@ -89,8 +82,6 @@ module ActionView
|
|||
# * <tt>:raise</tt> - If true, raises +InvalidNumberError+ when
|
||||
# the argument is invalid.
|
||||
#
|
||||
# ==== Examples
|
||||
#
|
||||
# number_to_currency(1234567890.50) # => $1,234,567,890.50
|
||||
# number_to_currency(1234567890.506) # => $1,234,567,890.51
|
||||
# number_to_currency(1234567890.506, precision: 3) # => $1,234,567,890.506
|
||||
|
@ -117,7 +108,6 @@ module ActionView
|
|||
# Formats a +number+ as a percentage string (e.g., 65%). You can
|
||||
# customize the format in the +options+ hash.
|
||||
#
|
||||
# ==== Options
|
||||
#
|
||||
# * <tt>:locale</tt> - Sets the locale to be used for formatting
|
||||
# (defaults to current locale).
|
||||
|
@ -138,8 +128,6 @@ module ActionView
|
|||
# * <tt>:raise</tt> - If true, raises +InvalidNumberError+ when
|
||||
# the argument is invalid.
|
||||
#
|
||||
# ==== Examples
|
||||
#
|
||||
# number_to_percentage(100) # => 100.000%
|
||||
# number_to_percentage("98") # => 98.000%
|
||||
# number_to_percentage(100, precision: 0) # => 100%
|
||||
|
@ -163,8 +151,6 @@ module ActionView
|
|||
# (e.g., 12,324). You can customize the format in the +options+
|
||||
# hash.
|
||||
#
|
||||
# ==== Options
|
||||
#
|
||||
# * <tt>:locale</tt> - Sets the locale to be used for formatting
|
||||
# (defaults to current locale).
|
||||
# * <tt>:delimiter</tt> - Sets the thousands delimiter (defaults
|
||||
|
@ -174,8 +160,6 @@ module ActionView
|
|||
# * <tt>:raise</tt> - If true, raises +InvalidNumberError+ when
|
||||
# the argument is invalid.
|
||||
#
|
||||
# ==== Examples
|
||||
#
|
||||
# number_with_delimiter(12345678) # => 12,345,678
|
||||
# number_with_delimiter("123456") # => 123,456
|
||||
# number_with_delimiter(12345678.05) # => 12,345,678.05
|
||||
|
@ -201,8 +185,6 @@ module ActionView
|
|||
# +:significant+ is +false+, and 5 if +:significant+ is +true+).
|
||||
# You can customize the format in the +options+ hash.
|
||||
#
|
||||
# ==== Options
|
||||
#
|
||||
# * <tt>:locale</tt> - Sets the locale to be used for formatting
|
||||
# (defaults to current locale).
|
||||
# * <tt>:precision</tt> - Sets the precision of the number
|
||||
|
@ -220,8 +202,6 @@ module ActionView
|
|||
# * <tt>:raise</tt> - If true, raises +InvalidNumberError+ when
|
||||
# the argument is invalid.
|
||||
#
|
||||
# ==== Examples
|
||||
#
|
||||
# number_with_precision(111.2345) # => 111.235
|
||||
# number_with_precision(111.2345, precision: 2) # => 111.23
|
||||
# number_with_precision(13, precision: 5) # => 13.00000
|
||||
|
@ -245,7 +225,6 @@ module ActionView
|
|||
}
|
||||
end
|
||||
|
||||
|
||||
# Formats the bytes in +number+ into a more understandable
|
||||
# representation (e.g., giving it 1500 yields 1.5 KB). This
|
||||
# method is useful for reporting file sizes to users. You can
|
||||
|
@ -254,8 +233,6 @@ module ActionView
|
|||
# See <tt>number_to_human</tt> if you want to pretty-print a
|
||||
# generic number.
|
||||
#
|
||||
# ==== Options
|
||||
#
|
||||
# * <tt>:locale</tt> - Sets the locale to be used for formatting
|
||||
# (defaults to current locale).
|
||||
# * <tt>:precision</tt> - Sets the precision of the number
|
||||
|
@ -275,8 +252,6 @@ module ActionView
|
|||
# * <tt>:raise</tt> - If true, raises +InvalidNumberError+ when
|
||||
# the argument is invalid.
|
||||
#
|
||||
# ==== Examples
|
||||
#
|
||||
# number_to_human_size(123) # => 123 Bytes
|
||||
# number_to_human_size(1234) # => 1.21 KB
|
||||
# number_to_human_size(12345) # => 12.1 KB
|
||||
|
@ -291,6 +266,7 @@ module ActionView
|
|||
# stripped out by default (set
|
||||
# <tt>:strip_insignificant_zeros</tt> to +false+ to change
|
||||
# that):
|
||||
#
|
||||
# number_to_human_size(1234567890123, precision: 5) # => "1.1229 TB"
|
||||
# number_to_human_size(524288000, precision: 5) # => "500 MB"
|
||||
def number_to_human_size(number, options = {})
|
||||
|
@ -348,8 +324,6 @@ module ActionView
|
|||
# * <tt>:raise</tt> - If true, raises +InvalidNumberError+ when
|
||||
# the argument is invalid.
|
||||
#
|
||||
# ==== Examples
|
||||
#
|
||||
# number_to_human(123) # => "123"
|
||||
# number_to_human(1234) # => "1.23 Thousand"
|
||||
# number_to_human(12345) # => "12.3 Thousand"
|
||||
|
|
|
@ -11,7 +11,8 @@ module ActionView #:nodoc:
|
|||
#
|
||||
# For example:
|
||||
#
|
||||
# <%=raw @user.name %>
|
||||
# raw @user.name
|
||||
# # => 'Jimmy <alert>Tables</alert>'
|
||||
def raw(stringish)
|
||||
stringish.to_s.html_safe
|
||||
end
|
||||
|
|
Loading…
Reference in a new issue