コンポーネント
フィールドグループ
関連するフィールドを共通の見出しの下にまとめます。
使い方
基本
HTML
<bs:bsui-field-group variant="card">
<bs:bsui-field-group-title text="Billing" />
<bs:bsui-field-group-description text="Where invoices are sent." />
<bs:bsui-field-group-content>
<bs:bsui-field>
<bs:bsui-field-label text="Company" />
<bs:bsui-input placeholder="Acme Inc." />
</bs:bsui-field>
</bs:bsui-field-group-content>
</bs:bsui-field-group>設定パネル
1枚のカードに複数のコントロールをまとめた、一般的な設定画面の形です。
HTML
<bs:bsui-field-group variant="card">
<bs:bsui-field-group-title text="Notifications" />
<bs:bsui-field-group-description text="How this workspace reaches you." />
<bs:bsui-field-group-content>
<bs:bsui-field>
<bs:bsui-field-label text="Reply-to address" />
<bs:bsui-input type="email" name="replyTo" defaultValue="team@acme.com" />
<bs:bsui-field-description text="Used on every automated email." />
</bs:bsui-field>
<bs:bsui-field>
<bs:bsui-field-label text="Digest" />
<bs:bsui-select name="digest" defaultValue="weekly" placeholder="Pick a cadence">
<bs:bsui-select-trigger />
<bs:bsui-select-popup>
<bs:bsui-select-option value="daily" label="Every morning" />
<bs:bsui-select-option value="weekly" label="Monday mornings" />
<bs:bsui-select-option value="never" label="Never" />
</bs:bsui-select-popup>
</bs:bsui-select>
</bs:bsui-field>
<bs:bsui-field>
<bs:bsui-switch name="failures" label="Alert me when a build fails" defaultChecked="true" />
</bs:bsui-field>
<bs:bsui-field>
<bs:bsui-checkbox name="marketing" label="Send product news once a month" />
</bs:bsui-field>
</bs:bsui-field-group-content>
</bs:bsui-field-group>セクション
既定のバリエーションではカードがなくなり、セクションを縦に並べる長いページに適しています。
HTML
<bs:bsui-stack direction="column" gap="6" align="stretch">
<bs:bsui-field-group>
<bs:bsui-field-group-title text="Profile" />
<bs:bsui-field-group-description text="Shown on comments and pull requests." />
<bs:bsui-field-group-content>
<bs:bsui-field>
<bs:bsui-field-label text="Display name" />
<bs:bsui-input defaultValue="Ada Lovelace" />
</bs:bsui-field>
</bs:bsui-field-group-content>
</bs:bsui-field-group>
<bs:bsui-field-group>
<bs:bsui-field-group-title text="Billing" />
<bs:bsui-field-group-description text="Where invoices are sent." />
<bs:bsui-field-group-content>
<bs:bsui-field>
<bs:bsui-field-label text="Company" />
<bs:bsui-input defaultValue="Acme Inc." />
</bs:bsui-field>
<bs:bsui-field>
<bs:bsui-field-label text="VAT ID" />
<bs:bsui-input placeholder="DE123456789" />
</bs:bsui-field>
</bs:bsui-field-group-content>
</bs:bsui-field-group>
</bs:bsui-stack>無効なグループ
グループ全体を無効なフィールドセットにすると、中のすべてのコントロールが反応しなくなります。
HTML
<bs:bsui-field-group variant="card" disabled="true">
<bs:bsui-field-group-title text="Custom domain" />
<bs:bsui-field-group-description text="Available on the Team plan." />
<bs:bsui-field-group-content>
<bs:bsui-field>
<bs:bsui-field-label text="Domain" />
<bs:bsui-input placeholder="app.acme.com" />
</bs:bsui-field>
<bs:bsui-field>
<bs:bsui-switch label="Redirect the default domain" />
</bs:bsui-field>
</bs:bsui-field-group-content>
</bs:bsui-field-group>構造
フィールドグループは以下のブロックで構成されます。それぞれ独立したブロックで、親の内部でのみレンダリングされます。
bsui/field-groupbsui/field-group-contentbsui/field-group-descriptionbsui/field-group-title
属性
| 属性 | タイプ | デフォルト |
|---|---|---|
variant | default | |
disabled | toggle | false |
bsui/field-group-content
このブロックは属性を受け取りません。
bsui/field-group-description
| 属性 | タイプ | デフォルト |
|---|---|---|
text | richtext | — |
bsui/field-group-title
| 属性 | タイプ | デフォルト |
|---|---|---|
text | richtext | — |