method

button_tag

v3.1.0 - Show latest stable - 0 notes - Class: ActionView::Helpers::FormTagHelper

button_tag(content_or_options = nil, options = nil, &block) public

Creates a button element that defines a submit button, resetbutton or a generic button which can be used in JavaScript, for example. You can use the button tag as a regular submit tag but it isn’t supported in legacy browsers. However, the button tag allows richer labels such as images and emphasis, so this helper will also accept a block.

Options

:confirm => 'question?' - If present, the unobtrusive JavaScript drivers will provide a prompt with the question specified. If the user accepts, the form is processed normally, otherwise no action is taken.
:disabled - If true, the user will not be able to use this input.
:disable_with - Value of this parameter will be used as the value for a disabled version of the submit button when the form is submitted. This feature is provided by the unobtrusive JavaScript driver.
Any other key creates standard HTML options for the tag.

Examples

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", :disable_with => "Please wait..."
# => <button data-disable-with="Please wait..." name="button"
             type="submit">Checkout</button>

Show source

# File actionpack/lib/action_view/helpers/form_tag_helper.rb, line 458
      def button_tag(content_or_options = nil, options = nil, &block)
        options = content_or_options if block_given? && content_or_options.is_a?(Hash)
        options ||= {}
        options.stringify_keys!

        if disable_with = options.delete("disable_with")
          options["data-disable-with"] = disable_with
        end

        if confirm = options.delete("confirm")
          options["data-confirm"] = confirm
        end

        options.reverse_merge! 'name' => 'button', 'type' => 'submit'

        content_tag :button, content_or_options || 'Button', options, &block
      end

button_tag

Related methods

Options

Examples