Skip to content

Commit

Permalink
VisuallyHiddenTextを使用したコンポーネントに変更した
Browse files Browse the repository at this point in the history
  • Loading branch information
oremega committed Dec 26, 2024
1 parent 3025959 commit b8db367
Showing 1 changed file with 24 additions and 29 deletions.
53 changes: 24 additions & 29 deletions src/content/articles/products/components/visually-hidden-text.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,44 +13,39 @@ VisuallyHiddenTextコンポーネントは、テキストを視覚的に隠し

文脈をしっかり考慮し、スクリーンリーダーユーザーにとって価値のある情報を提供することが重要です。

## 実装例
## VisuallyHiddenTextを使用したコンポーネント

### 日付入力の開始日と終了日
「入社年月日」の見出しと`DatePicker`コンポーネントだけで開始日と終了日であることが自明で冗長になるので`VisuallyHiddenText`を使用している。
### RangeSeparator
期間や範囲を表す```-``から`などの意味のわかる文字に置き換えてくれます。(参考:[RangeSeparator](/products/components/range-separator/)

```tsx editable
<>
<FormControl
title="入社年月日"
role="group"
titleType="subBlockTitle">
<Cluster gap={0.5} align="center" >
<VisuallyHiddenText>開始日</VisuallyHiddenText>
<DatePicker
name="startAtDate"
/>

<RangeSeparator />

<VisuallyHiddenText>終了日</VisuallyHiddenText>
<DatePicker
name="endAtDate"
/>
</Cluster>
</FormControl>
</>
<p>
兼務先(部署2
<RangeSeparator />
10)も所属部署として扱う
</p>
```

### Badgeにアクセスブルな名前をつける
ドット表示の場合には視覚情報しか持たないため、何らかの形で必ずアクセシブルな名前を与えてください。(参考:[Badge](/products/components/badge/)
### FormControl[dangerouslyTitleHidden]
「入社年月日」の見出しと`DatePicker`コンポーネントだけで開始日と終了日であることが自明で冗長になるので`FormControl``dangerouslyTitleHidden`propsを使用している。

```tsx editable
<>
<Badge dot count={9} />
<VisuallyHiddenText>通知があります</VisuallyHiddenText>
</>
<Fieldset title="入社年月日" >
<Cluster gap={0.5} align="center">
<FormControl title="開始日" dangerouslyTitleHidden>
<DatePicker name="startAtDate" />
</FormControl>

<RangeSeparator />

<FormControl title="終了日" dangerouslyTitleHidden>
<DatePicker name="EndAtDate" />
</FormControl>
</Cluster>
</Fieldset>
```


## Props

<ComponentPropsTable name="VisuallyHiddenText" />
Expand Down

0 comments on commit b8db367

Please sign in to comment.