Field (am-field)

am-field 是給 Input / Textarea 這類文字型控制項使用的包裝層，負責 label、hint、error 與垂直節奏。

Contract

• 適合包 Input、Textarea
• controlId 必須和 slotted control 的 id 相同
• hint 會輸出 ${controlId}-hint，error 會輸出 ${controlId}-error
• 有 hint/error 時，控制項需以 aria-describedby／aria-errormessage 引用對應 ID
• required 與 invalid 仍需同步設定在實際控制項
• Checkbox / Switch 已自帶 label，不需要再外包一層 Field

使用

<Field
  controlId="email"
  label="Email"
  hint="We'll use this for updates."
  required={true}
>
  <Input
    id="email"
    type="email"
    placeholder="name@company.com"
    required
    aria-describedby="email-hint"
  />
</Field>

詳見 playground /playground/forms/ 範例。