ActionView::Helpers::FormTagHelper

field_set_tag

API ドキュメント（Rails 8.1.4.1） ↗

alias: fieldset_tag

def field_set_tag(legend = nil, options = nil, &block)

説明

<fieldset> を作ります。

引数

値を変えると、ERB と HTML が変わります。

legend = nil

渡した文字列を中身にした <legend> を、<fieldset> の先頭に追加します。nil か空の文字列なら、<legend> を追加しません。options だけを渡すときも、ここに nil を書きます。この引数を省いて Hash だけを渡すと（field_set_tag(class: "x")）、その Hash を文字列にして <legend> の中身にします。

options= {}

ヘルパー共通の options

Rails はどのヘルパーでも、これらの options を同じように処理します。HTML の仕様で <fieldset> に使えないものや、使う場面が少ないとこのサイトで判断したものは、ここでは省いています。

すべてのヘルパー共通

:disabled

truefalse

true にすると disabled="disabled" を追加し、false にすると追加しません。readonly、required、autofocus など、Rails が持っている一覧（BOOLEAN_ATTRIBUTES）にある HTML 属性はどれも同じで、値が false と nil 以外なら 属性名="属性名" の形で追加します。

:class

{active: true, hidden: false}

Hash を渡すと、値が false と nil 以外のキーを空白でつなぎます。配列を渡すと、nil、false、空の文字列（空白だけの文字列も）を外して、空白でつなぎます。

:data

{controller: "tags", tags_suggestions_value: ["ruby", "rails"]}

Hash を渡すと、キーの _ を - にして、data-* 属性を追加します。値に配列や Hash を渡すと、JSON の文字列にします。

:aria

{describedby: ["name_help", "name_error"], invalid: false}

:data と同じく、aria-* 属性を追加します。値が配列なら、nil と空の文字列を外して、空白でつなぎます（何も残らなければ、追加しません）。値が Hash なら、値が false と nil 以外のキーを空白でつなぎます。

ここにない options は、<fieldset> の HTML 属性になります。値が nil なら、その HTML 属性は追加しません。

&block= nil

nil

do
  <%= label_tag :email, "Email" %>
  <%= email_field_tag :email %>
end

ERB

直前との違い：追加削除変更

HTML

プレビュー

プレビューを操作すると、フォーム送信の内容が変わります。

フォーム送信

フォームデータ

name	value

リクエストボディを見る

Content-Type：

params