Fieldset

Demo

Features

• root（<fieldset>）/legend（<legend>）/helper_text/error_text の 4 パーツで複数の crate::field をグループ化する（ark-ui Fieldset と一致、fieldset.rs:1-9）。
• root の disabled はネイティブ <fieldset disabled> として出力し、HTML 仕様により内側の全コントロールが自動的に無効化される（fieldset.rs:8-9, 148-167）。
• disabled/invalid の 2 種の data-* 存在属性を 4 パーツすべてへ一貫して付与する。data-state/data-orientation/data-motion 等の局所操作状態・レイアウト計測の関心は出力しない（chakra-ui の Fieldset.Content はレイアウト用ラッパーであり styled 層の関心、docs/policy/intentional-non-adoption.md §3.25 規則 2）。
• aria-describedby は invalid のとき error id、has_helper_text のとき helper id を空白区切りで合成する（field.rs と同型の合成則、fieldset.rs:123-146）。
• invalid はグループ全体のみに反映され、個別 Field の aria-invalid へは伝播しない（誤ったコントロール単位のエラー通知を避けるための意図的な判断、fieldset.rs:69-72）。
• ark-ui の Root id 自動付与（fieldset::<id>）は採らず、呼び出し側が attrs で任意付与できる。has_helper_text は ark-ui の MutationObserver による動的検知を静的フラグへ写像したものであり、呼び出し側は実際に helper_text パーツを描画するかどうかと整合させる契約を持つ（field.rs と同型）。バリデーションの実行自体は利用者側の通常の Rust コードが担う（docs/policy/intentional-non-adoption.md §3.25 規則 1、Radix Form は不採用）。
• legend_with_variant(variant, ...) で legend パーツへ data-variant（LegendVariant、legend/label）を語彙として出力する（イシュー #2214、shadcn/ui FieldLegend の variant prop 突合）。既存 legend は data-variant を出力しない契約のまま不変。見た目（フォントサイズ）は pre-styled-ui 層の責務で headless 層は語彙のみを持つ（docs/policy/intentional-non-adoption.md §3.25 規則 2）。

API Reference

Arguments

Data Attributes

Examples

Invalid group

invalid な Fieldset と error_text の組み立て例です。

自前 CSS の最小例

data-scope / data-part / data-disabled / data-invalid 属性セレクタで見た目を組み立てる最小例です。

[data-scope="fieldset"][data-part="root"] {
  border: 1px solid #888;
  border-radius: 4px;
  padding: 0.75rem;
}
[data-scope="fieldset"][data-part="legend"] {
  font-weight: 600;
  padding: 0 0.25rem;
}
[data-scope="fieldset"][data-part="root"][data-disabled] {
  opacity: 0.5;
}
[data-scope="fieldset"][data-part="root"][data-invalid] {
  border-color: #dc2626;
}
[data-scope="fieldset"][data-part="error-text"] {
  color: #dc2626;
  font-size: 0.875rem;
}

Accessibility

Keyboard Interactions

WAI-ARIA