Skip to content

Commit 069f6df

Browse files
authored
Add Toggle layout examples to guidelines (#3340)
1 parent 4713882 commit 069f6df

File tree

1 file changed

+31
-0
lines changed
  • website/docs/components/form/toggle/partials/guidelines

1 file changed

+31
-0
lines changed

website/docs/components/form/toggle/partials/guidelines/guidelines.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,37 @@
1010
- When users need to select more than one option from a list, consider [Checkbox](/components/form/checkbox).
1111
- When only one choice can be selected, consider [Radio](/components/form/radio) buttons.
1212

13+
## Layout
14+
15+
We recommend using vertical Toggle groups, especially with short option lists.
16+
17+
<Doc::Layout @spacing="48px">
18+
<Hds::Form::Toggle::Group @layout="vertical" as |G|>
19+
<G.Legend>Vertical group</G.Legend>
20+
<G.ToggleField name="demo-group-option-1" @@id="group-option-1" as |F|>
21+
<F.Label>Option 1</F.Label>
22+
</G.ToggleField>
23+
<G.ToggleField name="demo-group-option-2" @id="group-option-2" as |F|>
24+
<F.Label>Option 2</F.Label>
25+
</G.ToggleField>
26+
<G.ToggleField name="demo-group-option-3" @id="group-option-3" as |F|>
27+
<F.Label>Option 3</F.Label>
28+
</G.ToggleField>
29+
</Hds::Form::Toggle::Group>
30+
<Hds::Form::Toggle::Group @layout="horizontal" as |G|>
31+
<G.Legend>Horizontal group</G.Legend>
32+
<G.ToggleField name="demo-group-option-1" @id="group-option-1" as |F|>
33+
<F.Label>Option 1</F.Label>
34+
</G.ToggleField>
35+
<G.ToggleField name="demo-group-option-2" @id="group-option-2" as |F|>
36+
<F.Label>Option 2</F.Label>
37+
</G.ToggleField>
38+
<G.ToggleField name="demo-group-option-3" @id="group-option-3" as |F|>
39+
<F.Label>Option 3</F.Label>
40+
</G.ToggleField>
41+
</Hds::Form::Toggle::Group>
42+
</Doc::Layout>
43+
1344
## Error validation
1445

1546
For error validation recommendations, refer to the [Form patterns](/patterns/form-patterns?tab=validation) documentation.

0 commit comments

Comments
 (0)