From a12511ce17cb3a97feff045386e0ad52dc6559ee Mon Sep 17 00:00:00 2001 From: wentzzz Date: Fri, 13 Oct 2023 10:14:06 +0900 Subject: [PATCH 1/6] =?UTF-8?q?=E4=B8=8B=E6=9B=B8=E3=81=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../articles/products/components/fieldset.mdx | 160 ++++++++++++++++++ 1 file changed, 160 insertions(+) diff --git a/content/articles/products/components/fieldset.mdx b/content/articles/products/components/fieldset.mdx index 8e278f4a7..39f8734e4 100644 --- a/content/articles/products/components/fieldset.mdx +++ b/content/articles/products/components/fieldset.mdx @@ -4,9 +4,169 @@ description: '' --- import { ComponentPropsTable } from '@Components/ComponentPropsTable' import { ComponentStory } from '@Components/ComponentStory' +import { + FaExclamationCircleIcon, + StatusLabel, +} from 'smarthr-ui' + +Fieldsetコンポーネントは、フォームにおける複数の入力要素をグループ化するためのコンポーネントです。 +## 使用上の注意 + +特に注意したいアンチパターンなど使用上の注意があれば書きます。種類ごとの使いどころは[種類](#h2-1)に書きます。 + +## レイアウト + +Fieldsetは、関連する複数の入力要素をグループ化する目的で使用します。それぞれのFieldsetは、そのグループの目的を明確にするタイトルをつけます。 + +```tsx editable codeBlock +
+ + + 正社員 + + 契約社員 + 派遣社員 + アルバイト + その他 + +
+``` + +```tsx editable codeBlock +
+ +
+ + + あり + + なし + +
+ + + + + + + + +
+
+``` + +## 状態 + +### 無効(disabled) + +フォームの操作ができない状態を表現したスタイルです。 + +Fieldsetに`disabled`を適用すると、内包するフォーム要素にも自動で`disabled`が適用されるため、個別に設定する必要はありません。 + +ユーザーはなぜ無効になっているのかわからないことがあります。[権限による表示制御](/products/design-patterns/access-control-pattern/)のデザインパターンを参考にして、そもそも無効ではなくフォーム自体を非表示にしたり、無効状態の理由を付近に表示することを検討してください。 + +```tsx editable codeBlock +
+ + + + + + + + + + + + +
+ + + + + +
+
+ + 正社員 + 契約社員 + 派遣社員 + アルバイト + その他 + +
+
+ + + + + +
+ + + + + + + + + + + + + +
- - - - + + + + + +
+
+ + 男性 + 女性 + 回答しない + +
- + - -
+ + + + + + + + + + + + + + +
+
- - - + + +
-
+
- 正社員 - 契約社員 - 派遣社員 - アルバイト - その他 + 男性 + 女性 + 回答しない
-
+ + + + +
+``` ## Props From c4942af6808bd63f978f1770e0605c86c2a1482b Mon Sep 17 00:00:00 2001 From: wentzzz Date: Wed, 18 Oct 2023 10:02:40 +0900 Subject: [PATCH 3/6] =?UTF-8?q?=E4=BD=BF=E7=94=A8=E3=81=97=E3=81=AA?= =?UTF-8?q?=E3=81=84=E3=82=82=E3=81=AE=E3=82=92=E5=89=8A=E9=99=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/articles/products/components/fieldset.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/content/articles/products/components/fieldset.mdx b/content/articles/products/components/fieldset.mdx index 822e24b30..03442990a 100644 --- a/content/articles/products/components/fieldset.mdx +++ b/content/articles/products/components/fieldset.mdx @@ -4,10 +4,6 @@ description: '' --- import { ComponentPropsTable } from '@Components/ComponentPropsTable' import { ComponentStory } from '@Components/ComponentStory' -import { - FaExclamationCircleIcon, - StatusLabel, -} from 'smarthr-ui' Fieldsetコンポーネントは、フォームにおける複数の入力要素をグルーピングするためのコンポーネントです。 From c4eb62b88e96d504e59022dfcb7ff8cc801dd6ba Mon Sep 17 00:00:00 2001 From: wentzzz Date: Fri, 20 Oct 2023 17:39:53 +0900 Subject: [PATCH 4/6] Update content/articles/products/components/fieldset.mdx Co-authored-by: Aguri Otsuka <44823946+aguringo@users.noreply.github.com> --- content/articles/products/components/fieldset.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/articles/products/components/fieldset.mdx b/content/articles/products/components/fieldset.mdx index 03442990a..783bf86e8 100644 --- a/content/articles/products/components/fieldset.mdx +++ b/content/articles/products/components/fieldset.mdx @@ -13,9 +13,9 @@ Fieldsetコンポーネントは、フォームにおける複数の入力要素 ### 入力要素が2つ以上の場合にのみ使用する -Fieldsetは、2つ以上の入力要素をまとめてグループ化したい場合に使用します。 +Fieldsetは、2つ以上の入力要素を持つフォームをグループ化し、タイトルやラベル、メッセージテキストを表示したい場合に使用します。 -姓名や電話番号のように値を分割して入力する場合や、CheckboxやRadioButtonといった複数の入力要素を持つフォームに対してラベルやメッセージテキストを表示したい場合に適しています。 +また、タイトルでは、まとめた入力要素がどんなグループであるかを明確に示しましょう。 入力要素が1つだけの場合は、[FormControl](/products/components/form-control/)を使用してください。 From 8ba25f2b73df50b1446a7ff5e6c92325a0dfebdb Mon Sep 17 00:00:00 2001 From: wentzzz Date: Fri, 20 Oct 2023 17:40:01 +0900 Subject: [PATCH 5/6] Update content/articles/products/components/fieldset.mdx Co-authored-by: Aguri Otsuka <44823946+aguringo@users.noreply.github.com> --- content/articles/products/components/fieldset.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/articles/products/components/fieldset.mdx b/content/articles/products/components/fieldset.mdx index 783bf86e8..143d60585 100644 --- a/content/articles/products/components/fieldset.mdx +++ b/content/articles/products/components/fieldset.mdx @@ -7,6 +7,8 @@ import { ComponentStory } from '@Components/ComponentStory' Fieldsetコンポーネントは、フォームにおける複数の入力要素をグルーピングするためのコンポーネントです。 +姓名や電話番号のように値を分割して入力する場合や、CheckboxやRadioButtonといった複数の入力要素を持つフォームに対してラベルやメッセージテキストを表示したい場合に適しています。 + ## 使用上の注意 From 916105a86361ddc015d9a8f28b9f3e8951604406 Mon Sep 17 00:00:00 2001 From: wentzzz Date: Fri, 20 Oct 2023 17:40:12 +0900 Subject: [PATCH 6/6] Update content/articles/products/components/fieldset.mdx Co-authored-by: Aguri Otsuka <44823946+aguringo@users.noreply.github.com> --- content/articles/products/components/fieldset.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/articles/products/components/fieldset.mdx b/content/articles/products/components/fieldset.mdx index 143d60585..e927ab2cc 100644 --- a/content/articles/products/components/fieldset.mdx +++ b/content/articles/products/components/fieldset.mdx @@ -23,7 +23,7 @@ Fieldsetは、2つ以上の入力要素を持つフォームをグループ化 ## レイアウト -Fieldsetは、関連する複数の入力要素をグルーピングする目的で使用します。それぞれのFieldsetは、そのグループの目的を明確にするタイトルをつけます。 +Fieldsetには、複数の入力要素のグループの目的を明確にするタイトルをつけます。 Fieldsetに内包されるフォーム要素のタイトルは、グルーピングしているFieldsetのタイトルよりも低い見出しレベルになるようにします。見出しに関する詳細は[Heading](/products/components/heading/)を参照してください。