модуль ActionView::Helpers::FormTagHelper

Создает элемент кнопки, который определяет кнопку submit, кнопку reset или универсальную кнопку, которую можно использовать в JavaScript, например. Вы можете использовать тег button как обычный тег submit, но он не поддерживается в устаревших браузерах. Однако тег button допускает более богатые подписи, такие как изображения и выделение, поэтому этот помощник также будет принимать блок.

Параметры

• :data - Этот параметр можно использовать для добавления пользовательских атрибутов данных.

• :disabled - Если true, пользователь не сможет использовать этот ввод.

• Любой другой ключ создает стандартные параметры HTML для тега.

Атрибуты данных

• confirm: 'question?' - При наличии, драйверы unobtrusive JavaScript предоставят запрос с указанным вопросом. Если пользователь соглашается, форма обрабатывается нормально, в противном случае никаких действий не предпринимается.

• :disable_with - Значение этого параметра будет использоваться в качестве значения для отключенной версии кнопки отправки при отправке формы. Эта функция предоставляется драйвером unobtrusive JavaScript.

Примеры

button_tag
# => <button name="button" type="submit">Button</button>

button_tag(type: 'button') do
  content_tag(:strong, 'Ask me!')
end
# => <button name="button" type="button">
#     <strong>Ask me!</strong>
#    </button>

button_tag "Checkout", data: { disable_with: "Please wait..." }
# => <button data-disable-with="Please wait..." name="button" type="submit">Checkout</button>

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 479
def button_tag(content_or_options = nil, options = nil, &block)
  if content_or_options.is_a? Hash
    options = content_or_options
  else
    options ||= {}
  end

  options = { 'name' => 'button', 'type' => 'submit' }.merge!(options.stringify_keys)

  if block_given?
    content_tag :button, options, &block
  else
    content_tag :button, content_or_options || 'Button', options
  end
end

Создает тег входных данных формы флажка.

Параметры

• :disabled - Если установлено в true, пользователь не сможет использовать этот ввод.

• Любой другой ключ создает стандартные параметры HTML для тега.

Примеры

check_box_tag 'accept'
# => <input id="accept" name="accept" type="checkbox" value="1" />

check_box_tag 'rock', 'rock music'
# => <input id="rock" name="rock" type="checkbox" value="rock music" />

check_box_tag 'receive_email', 'yes', true
# => <input checked="checked" id="receive_email" name="receive_email" type="checkbox" value="yes" />

check_box_tag 'tos', 'yes', false, class: 'accept_tos'
# => <input class="accept_tos" id="tos" name="tos" type="checkbox" value="yes" />

check_box_tag 'eula', 'accepted', false, disabled: true
# => <input disabled="disabled" id="eula" name="eula" type="checkbox" value="accepted" />

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 366
def check_box_tag(name, value = "1", checked = false, options = {})
  html_options = { "type" => "checkbox", "name" => name, "id" => sanitize_to_id(name), "value" => value }.update(options.stringify_keys)
  html_options["checked"] = "checked" if checked
  tag :input, html_options
end

Создает текстовое поле типа «color».

Параметры

• Принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 561
def color_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "color"))
end

Создает текстовое поле типа «date».

Параметры

• Принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 586
def date_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "date"))
end

Создает текстовое поле типа «datetime».

Параметры

• :min - Минимально допустимое значение.

• :max - Максимально допустимое значение.

• :step - Допустимая гранулярность значения.

• В противном случае принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 608
def datetime_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "datetime"))
end

Создает текстовое поле типа «datetime-local».

Параметры

• :min - Минимально допустимое значение.

• :max - Максимально допустимое значение.

• :step - Допустимая гранулярность значения.

• В противном случае принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 619
def datetime_local_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "datetime-local"))
end

Создает текстовое поле типа «email».

Параметры

• Принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 657
def email_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "email"))
end

Создает набор полей для группировки элементов формы HTML.

legend станет заголовком набора полей (необязательно по W3C). options принимают те же значения, что и тег.

Примеры

<%= field_set_tag do %>
  <p><%= text_field_tag 'name' %></p>
<% end %>
# => <fieldset><p><input id="name" name="name" type="text" /></p></fieldset>

<%= field_set_tag 'Your details' do %>
  <p><%= text_field_tag 'name' %></p>
<% end %>
# => <fieldset><legend>Your details</legend><p><input id="name" name="name" type="text" /></p></fieldset>

<%= field_set_tag nil, class: 'format' do %>
  <p><%= text_field_tag 'name' %></p>
<% end %>
# => <fieldset class="format"><p><input id="name" name="name" type="text" /></p></fieldset>

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 550
def field_set_tag(legend = nil, options = nil, &block)
  output = tag(:fieldset, options, true)
  output.safe_concat(content_tag(:legend, legend)) unless legend.blank?
  output.concat(capture(&block)) if block_given?
  output.safe_concat("</fieldset>")
end

Создает поле загрузки файлов. Если вы используете загрузку файлов, вам также нужно будет установить параметр multipart для тега формы:

<%= form_tag '/upload', multipart: true do %>
  <label for="file">File to Upload</label> <%= file_field_tag "file" %>
  <%= submit_tag %>
<% end %>

Затем указанный URL получит объект File, содержащий выбранный файл, или, если поле было оставлено пустым, объект StringIO.

Параметры

• Создает стандартные атрибуты HTML для тега.

• :disabled - Если установлено в true, пользователь не сможет использовать этот ввод.

• :multiple - Если установлено в true, *в большинстве современных браузеров* пользователю будет разрешено выбирать несколько файлов.

• :accept - Если установлен один или несколько типов MIME, пользователю будет предложен фильтр при выборе файла. Вам все равно нужно настроить проверки модели.

Примеры

file_field_tag 'attachment'
# => <input id="attachment" name="attachment" type="file" />

file_field_tag 'avatar', class: 'profile_input'
# => <input class="profile_input" id="avatar" name="avatar" type="file" />

file_field_tag 'picture', disabled: true
# => <input disabled="disabled" id="picture" name="picture" type="file" />

file_field_tag 'resume', value: '~/resume.doc'
# => <input id="resume" name="resume" type="file" value="~/resume.doc" />

file_field_tag 'user_pic', accept: 'image/png,image/gif,image/jpeg'
# => <input accept="image/png,image/gif,image/jpeg" id="user_pic" name="user_pic" type="file" />

file_field_tag 'file', accept: 'text/html', class: 'upload', value: 'index.html'
# => <input accept="text/html" class="upload" id="file" name="file" type="file" value="index.html" />

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 266
def file_field_tag(name, options = {})
  text_field_tag(name, nil, options.update("type" => "file"))
end

Начинает тег формы, который указывает действие на URL, настроенный с помощью url_for_options, как и ActionController::Base#url_for. Метод для формы по умолчанию — POST.

Параметры

• :multipart - Если установлено в true, enctype устанавливается в «multipart/form-data».

• :method - Метод, используемый при отправке формы, обычно «get» или «post». Если используется «patch», «put», «delete» или другой глагол, добавляется скрытый ввод с именем _method для имитации глагола через post.

• :authenticity_token - Маркер подлинности для использования в форме. Используйте только в том случае, если вам нужно передать пользовательскую строку маркера подлинности или вообще не добавлять поле authenticity_token (передавая false). Удаленные формы могут опускать встроенный маркер подлинности, установив config.action_view.embed_authenticity_token_in_remote_forms = false. Это полезно, когда вы кэшируете фрагмент формы. Удаленные формы получают маркер подлинности из тега meta, поэтому встраивание не обязательно, если вы не поддерживаете браузеры без JavaScript.

• :remote - Если установлено в true, позволит драйверам unobtrusive JavaScript управлять поведением отправки. По умолчанию это поведение представляет собой отправку ajax.

• :enforce_utf8 - Если установлено в false, скрытый ввод с именем utf8 не выводится.

• Любой другой ключ создает стандартные атрибуты HTML для тега.

Примеры

form_tag('/posts')
# => <form action="/posts" method="post">

form_tag('/posts/1', method: :put)
# => <form action="/posts/1" method="post"> ... <input name="_method" type="hidden" value="put" /> ...

form_tag('/upload', multipart: true)
# => <form action="/upload" method="post" enctype="multipart/form-data">

<%= form_tag('/posts') do -%>
  <div><%= submit_tag 'Save' %></div>
<% end -%>
# => <form action="/posts" method="post"><div><input type="submit" name="commit" value="Save" /></div></form>

<%= form_tag('/posts', remote: true) %>
# => <form action="/posts" method="post" data-remote="true">

form_tag('http://far.away.com/form', authenticity_token: false)
# form without authenticity token

form_tag('http://far.away.com/form', authenticity_token: "cf50faa3fe97702ca1ae")
# form with custom authenticity token

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 67
def form_tag(url_for_options = {}, options = {}, &block)
  html_options = html_options_for_form(url_for_options, options)
  if block_given?
    form_tag_in_block(html_options, &block)
  else
    form_tag_html(html_options)
  end
end

Создает скрытое поле ввода формы, используемое для передачи данных, которые будут потеряны из-за отсутствия состояния HTTP или данных, которые должны быть скрыты от пользователя.

Параметры

• Создает стандартные атрибуты HTML для тега.

Примеры

hidden_field_tag 'tags_list'
# => <input id="tags_list" name="tags_list" type="hidden" />

hidden_field_tag 'token', 'VUBJKB23UIVI1UU1VOBVI@'
# => <input id="token" name="token" type="hidden" value="VUBJKB23UIVI1UU1VOBVI@" />

hidden_field_tag 'collected_input', '', onchange: "alert('Input collected!')"
# => <input id="collected_input" name="collected_input" onchange="alert('Input collected!')"
#    type="hidden" value="" />

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 227
def hidden_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "hidden"))
end

Отображает изображение, которое при нажатии отправит форму.

source передаётся в ActionView::Helpers::AssetUrlHelper#path_to_image

Параметры

• :data - Этот параметр может быть использован для добавления пользовательских атрибутов данных.

• :disabled - Если установлено в true, пользователь не сможет использовать этот элемент ввода.

• Любой другой ключ создаёт стандартные атрибуты HTML для тега.

Атрибуты данных

• confirm: 'question?' - Это добавит всплывающее окно подтверждения JavaScript с заданным вопросом. Если пользователь соглашается, форма обрабатывается в обычном режиме; в противном случае никакие действия не выполняются.

Примеры

image_submit_tag("login.png")
# => <input alt="Login" src="/images/login.png" type="image" />

image_submit_tag("purchase.png", disabled: true)
# => <input alt="Purchase" disabled="disabled" src="/images/purchase.png" type="image" />

image_submit_tag("search.png", class: 'search_button', alt: 'Find')
# => <input alt="Find" class="search_button" src="/images/search.png" type="image" />

image_submit_tag("agree.png", disabled: true, class: "agree_disagree_button")
# => <input alt="Agree" class="agree_disagree_button" disabled="disabled" src="/images/agree.png" type="image" />

image_submit_tag("save.png", data: { confirm: "Are you sure?" })
# => <input alt="Save" src="/images/save.png" data-confirm="Are you sure?" type="image" />

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 525
def image_submit_tag(source, options = {})
  options = options.stringify_keys
  tag :input, { "alt" => image_alt(source), "type" => "image", "src" => path_to_image(source) }.update(options)
end

Создаёт элемент метки. Поддерживает использование блоков.

Параметры

• Создаёт стандартные атрибуты HTML для тега.

Примеры

label_tag 'name'
# => <label for="name">Name</label>

label_tag 'name', 'Your name'
# => <label for="name">Your name</label>

label_tag 'name', nil, class: 'small_label'
# => <label for="name" class="small_label">Name</label>

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 200
def label_tag(name = nil, content_or_options = nil, options = nil, &block)
  if block_given? && content_or_options.is_a?(Hash)
    options = content_or_options = content_or_options.stringify_keys
  else
    options ||= {}
    options = options.stringify_keys
  end
  options["for"] = sanitize_to_id(name) unless name.blank? || options.has_key?("for")
  content_tag :label, content_or_options || name.to_s.humanize, options, &block
end

Создаёт текстовое поле типа “месяц”.

Параметры

• :min - Минимальное допустимое значение.

• :max - Максимальное допустимое значение.

• :step - Допустимое значение гранулярности.

• В противном случае принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 630
def month_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "month"))
end

Создаёт поле для ввода чисел.

Параметры

• :min - Минимальное допустимое значение.

• :max - Максимальное допустимое значение.

• :in - Диапазон, определяющий :min и :max значения.

• :step - Допустимое значение гранулярности.

• В противном случае принимает те же параметры, что и text_field_tag.

Примеры

number_field_tag 'quantity', nil, in: 1...10
# => <input id="quantity" name="quantity" min="1" max="9" type="number" />

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 674
def number_field_tag(name, value = nil, options = {})
  options = options.stringify_keys
  options["type"] ||= "number"
  if range = options.delete("in") || options.delete("within")
    options.update("min" => range.min, "max" => range.max)
  end
  text_field_tag(name, value, options)
end

Создаёт поле для ввода пароля, поле для ввода текста с маской, скрывающей введённые данные.

Параметры

• :disabled - Если установлено в true, пользователь не сможет использовать этот элемент ввода.

• :size - Количество видимых символов, которые будут отображаться в поле ввода.

• :maxlength - Максимальное количество символов, которое браузер позволит ввести пользователю.

• Любой другой ключ создаёт стандартные атрибуты HTML для тега.

Примеры

password_field_tag 'pass'
# => <input id="pass" name="pass" type="password" />

password_field_tag 'secret', 'Your secret here'
# => <input id="secret" name="secret" type="password" value="Your secret here" />

password_field_tag 'masked', nil, class: 'masked_input_field'
# => <input class="masked_input_field" id="masked" name="masked" type="password" />

password_field_tag 'token', '', size: 15
# => <input id="token" name="token" size="15" type="password" value="" />

password_field_tag 'key', nil, maxlength: 16
# => <input id="key" maxlength="16" name="key" type="password" />

password_field_tag 'confirm_pass', nil, disabled: true
# => <input disabled="disabled" id="confirm_pass" name="confirm_pass" type="password" />

password_field_tag 'pin', '1234', maxlength: 4, size: 6, class: "pin_input"
# => <input class="pin_input" id="pin" maxlength="4" name="pin" size="6" type="password" value="1234" />

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 299
def password_field_tag(name = "password", value = nil, options = {})
  text_field_tag(name, value, options.update("type" => "password"))
end

Создаёт радиокнопку; используйте группы радиокнопок с одинаковым именем, чтобы пользователи могли выбирать из группы вариантов.

Параметры

• :disabled - Если установлено в true, пользователь не сможет использовать этот элемент ввода.

• Любой другой ключ создаёт стандартные атрибуты HTML для тега.

Примеры

radio_button_tag 'gender', 'male'
# => <input id="gender_male" name="gender" type="radio" value="male" />

radio_button_tag 'receive_updates', 'no', true
# => <input checked="checked" id="receive_updates_no" name="receive_updates" type="radio" value="no" />

radio_button_tag 'time_slot', "3:00 p.m.", false, disabled: true
# => <input disabled="disabled" id="time_slot_300_pm" name="time_slot" type="radio" value="3:00 p.m." />

radio_button_tag 'color', "green", true, class: "color_input"
# => <input checked="checked" class="color_input" id="color_green" name="color" type="radio" value="green" />

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 391
def radio_button_tag(name, value, checked = false, options = {})
  html_options = { "type" => "radio", "name" => name, "id" => "#{sanitize_to_id(name)}_#{sanitize_to_id(value)}", "value" => value }.update(options.stringify_keys)
  html_options["checked"] = "checked" if checked
  tag :input, html_options
end

Создаёт элемент формы диапазона.

Параметры

• Принимает те же параметры, что и number_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 687
def range_field_tag(name, value = nil, options = {})
  number_field_tag(name, value, options.stringify_keys.update("type" => "range"))
end

Создаёт текстовое поле типа “поиск”.

Параметры

• Принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 569
def search_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "search"))
end

Создаёт выпадающее поле выбора, или, если параметр :multiple установлен в true, поле выбора с множественным выбором.

Helpers::FormOptions могут быть использованы для создания общих полей выбора, таких как страны, часовые пояса или связанные записи. option_tags — строка, содержащая теги опций для поля выбора.

Параметры

• :multiple - Если установлено в true, выбор позволит выбрать несколько вариантов.

• :disabled - Если установлено в true, пользователь не сможет использовать этот элемент ввода.

• :include_blank - Если установлено в true, будет создана пустая опция.

• :prompt - Создать опцию запроса с пустым значением и текстом, предлагающим пользователю выбрать что-то.

• Любой другой ключ создаёт стандартные атрибуты HTML для тега.

Примеры

select_tag "people", options_from_collection_for_select(@people, "id", "name")
# <select id="people" name="people"><option value="1">David</option></select>

select_tag "people", "<option>David</option>".html_safe
# => <select id="people" name="people"><option>David</option></select>

select_tag "count", "<option>1</option><option>2</option><option>3</option><option>4</option>".html_safe
# => <select id="count" name="count"><option>1</option><option>2</option>
#    <option>3</option><option>4</option></select>

select_tag "colors", "<option>Red</option><option>Green</option><option>Blue</option>".html_safe, multiple: true
# => <select id="colors" multiple="multiple" name="colors[]"><option>Red</option>
#    <option>Green</option><option>Blue</option></select>

select_tag "locations", "<option>Home</option><option selected='selected'>Work</option><option>Out</option>".html_safe
# => <select id="locations" name="locations"><option>Home</option><option selected='selected'>Work</option>
#    <option>Out</option></select>

select_tag "access", "<option>Read</option><option>Write</option>".html_safe, multiple: true, class: 'form_input'
# => <select class="form_input" id="access" multiple="multiple" name="access[]"><option>Read</option>
#    <option>Write</option></select>

select_tag "people", options_from_collection_for_select(@people, "id", "name"), include_blank: true
# => <select id="people" name="people"><option value=""></option><option value="1">David</option></select>

select_tag "people", options_from_collection_for_select(@people, "id", "name"), prompt: "Select something"
# => <select id="people" name="people"><option value="">Select something</option><option value="1">David</option></select>

select_tag "destination", "<option>NYC</option><option>Paris</option><option>Rome</option>".html_safe, disabled: true
# => <select disabled="disabled" id="destination" name="destination"><option>NYC</option>
#    <option>Paris</option><option>Rome</option></select>

select_tag "credit_card", options_for_select([ "VISA", "MasterCard" ], "MasterCard")
# => <select id="credit_card" name="credit_card"><option>VISA</option>
#    <option selected="selected">MasterCard</option></select>

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 125
def select_tag(name, option_tags = nil, options = {})
  option_tags ||= ""
  html_name = (options[:multiple] == true && !name.to_s.ends_with?("[]")) ? "#{name}[]" : name

  if options.include?(:include_blank)
    include_blank = options.delete(:include_blank)

    if include_blank == true
      include_blank = ''
    end

    if include_blank
      option_tags = content_tag(:option, include_blank, value: '').safe_concat(option_tags)
    end
  end

  if prompt = options.delete(:prompt)
    option_tags = content_tag(:option, prompt, value: '').safe_concat(option_tags)
  end

  content_tag :select, option_tags, { "name" => html_name, "id" => sanitize_to_id(name) }.update(options.stringify_keys)
end

Создаёт кнопку отправки с текстом value в качестве подписи.

Параметры

• :data - Этот параметр может быть использован для добавления пользовательских атрибутов данных.

• :disabled - Если true, пользователь не сможет использовать этот элемент ввода.

• Любой другой ключ создаёт стандартные атрибуты HTML для тега.

Атрибуты данных

• confirm: 'question?' - Если присутствует, драйверы JavaScript обеспечат всплывающее окно запроса с заданным вопросом. Если пользователь соглашается, форма обрабатывается в обычном режиме; в противном случае никакие действия не выполняются.

• :disable_with - Значение этого параметра будет использоваться как значение для отключенной версии кнопки отправки при отправке формы. Эта функция предоставляется драйвером unobtrusive JavaScript.

Примеры

submit_tag
# => <input name="commit" type="submit" value="Save changes" />

submit_tag "Edit this article"
# => <input name="commit" type="submit" value="Edit this article" />

submit_tag "Save edits", disabled: true
# => <input disabled="disabled" name="commit" type="submit" value="Save edits" />

submit_tag "Complete sale", data: { disable_with: "Please wait..." }
# => <input name="commit" data-disable-with="Please wait..." type="submit" value="Complete sale" />

submit_tag nil, class: "form_submit"
# => <input class="form_submit" name="commit" type="submit" />

submit_tag "Edit", class: "edit_button"
# => <input class="edit_button" name="commit" type="submit" value="Edit" />

submit_tag "Save", data: { confirm: "Are you sure?" }
# => <input name='commit' type='submit' value='Save' data-confirm="Are you sure?" />

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 435
def submit_tag(value = "Save changes", options = {})
  options = options.stringify_keys

  tag :input, { "type" => "submit", "name" => "commit", "value" => value }.update(options)
end

Создаёт текстовое поле типа “тел”.

Параметры

• Принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 577
def telephone_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "tel"))
end

Создаёт область ввода текста; используйте textarea для длинных текстовых вводов, таких как записи в блогах или описания.

Параметры

• :size - Строка, определяющая размеры (колонки на строки) textarea (например, «25x10»).

• :rows - Укажите количество строк в textarea

• :cols - Укажите количество столбцов в textarea

• :disabled - Если установлено в true, пользователь не сможет использовать этот ввод.

• :escape - По умолчанию содержимое текстового поля HTML-экранировано. Если вам нужен неэкранированный контент, установите это значение в false.

• Любой другой ключ создаёт стандартные HTML-атрибуты для тега.

Примеры

text_area_tag 'post'
# => <textarea id="post" name="post"></textarea>

text_area_tag 'bio', @user.bio
# => <textarea id="bio" name="bio">This is my biography.</textarea>

text_area_tag 'body', nil, rows: 10, cols: 25
# => <textarea cols="25" id="body" name="body" rows="10"></textarea>

text_area_tag 'body', nil, size: "25x10"
# => <textarea name="body" id="body" cols="25" rows="10"></textarea>

text_area_tag 'description', "Description goes here.", disabled: true
# => <textarea disabled="disabled" id="description" name="description">Description goes here.</textarea>

text_area_tag 'comment', nil, class: 'comment_input'
# => <textarea class="comment_input" id="comment" name="comment"></textarea>

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 332
def text_area_tag(name, content = nil, options = {})
  options = options.stringify_keys

  if size = options.delete("size")
    options["cols"], options["rows"] = size.split("x") if size.respond_to?(:split)
  end

  escape = options.delete("escape") { true }
  content = ERB::Util.html_escape(content) if escape

  content_tag :textarea, content.to_s.html_safe, { "name" => name, "id" => sanitize_to_id(name) }.update(options)
end

Создаёт стандартное текстовое поле; используйте эти текстовые поля для ввода коротких фрагментов текста, таких как имя пользователя или поисковый запрос.

Параметры

• :disabled - Если установлено в true, пользователь не сможет использовать этот ввод.

• :size - Количество видимых символов, которые поместятся в поле.

• :maxlength - Максимальное количество символов, которое браузер позволит ввести пользователю.

• :placeholder - Текст, отображаемый в поле по умолчанию, который удаляется при получении фокуса полем.

• Любой другой ключ создаёт стандартные HTML-атрибуты для тега.

Примеры

text_field_tag 'name'
# => <input id="name" name="name" type="text" />

text_field_tag 'query', 'Enter your search query here'
# => <input id="query" name="query" type="text" value="Enter your search query here" />

text_field_tag 'search', nil, placeholder: 'Enter search term...'
# => <input id="search" name="search" placeholder="Enter search term..." type="text" />

text_field_tag 'request', nil, class: 'special_input'
# => <input class="special_input" id="request" name="request" type="text" />

text_field_tag 'address', '', size: 75
# => <input id="address" name="address" size="75" type="text" value="" />

text_field_tag 'zip', nil, maxlength: 5
# => <input id="zip" maxlength="5" name="zip" type="text" />

text_field_tag 'payment_amount', '$0.00', disabled: true
# => <input disabled="disabled" id="payment_amount" name="payment_amount" type="text" value="$0.00" />

text_field_tag 'ip', '0.0.0.0', maxlength: 15, size: 20, class: "ip-input"
# => <input class="ip-input" id="ip" maxlength="15" name="ip" size="20" type="text" value="0.0.0.0" />

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 182
def text_field_tag(name, value = nil, options = {})
  tag :input, { "type" => "text", "name" => name, "id" => sanitize_to_id(name), "value" => value }.update(options.stringify_keys)
end

Создаёт текстовое поле типа «время».

Параметры

• :min - Минимально допустимое значение.

• :max - Максимально допустимое значение.

• :step - Допустимая гранулярность значений.

• В противном случае принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 597
def time_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "time"))
end

Создаёт текстовое поле типа «url».

Параметры

• Принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 649
def url_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "url"))
end

Создаёт скрытый тег UTF8-принудителя. Переопределите этот метод в помощнике, чтобы настроить тег.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 693
def utf8_enforcer_tag
  tag(:input, :type => "hidden", :name => "utf8", :value => "✓".html_safe)
end

Создаёт текстовое поле типа «неделя».

Параметры

• :min - Минимально допустимое значение.

• :max - Максимально допустимое значение.

• :step - Допустимая гранулярность значений.

• В противном случае принимает те же параметры, что и text_field_tag.

# File actionview/lib/action_view/helpers/form_tag_helper.rb, line 641
def week_field_tag(name, value = nil, options = {})
  text_field_tag(name, value, options.stringify_keys.update("type" => "week"))
end