Skip to content

Commit 1274e7e

Browse files
Merge pull request #528 from IgniteUI/jp-sync/badge-a11y-pr526-826d619037c3858f
[jp-sync] Sync JP docs: badge/button-group/avatar accessibility (EN PR #526)
2 parents 741d813 + d211ad7 commit 1274e7e

3 files changed

Lines changed: 88 additions & 25 deletions

File tree

docs/xplat/src/content/jp/components/inputs/badge.mdx

Lines changed: 34 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -898,19 +898,49 @@ igc-badge::part(base) {
898898

899899
## アクセシビリティ
900900

901-
{Platform} Badge は視覚的なステータスを伝えるものであり、そのステータスが重要な場合は、意味のあるテキストまたは周囲のアクセシブルなコンテキストを持つ必要があります
901+
{Platform} Badge は、短いカウント、状態、または通知を伝える非インタラクティブなステータス表示です
902902

903903
### キーボード インタラクション
904904

905-
バッジは視覚的なステータス インジケーターであり、インタラクティブなキーボード操作は提供しません。バッジが装飾する要素のフォーカス動作に従ってアクセスされます。
905+
バッジはフォーカスを受け取らず、キーボード入力を処理せず、コンポーネントのインタラクション イベントを公開しません。
906+
907+
| キー | アクション |
908+
| -- | -- |
909+
| n/a | バッジはキーボードによるインタラクティブ操作に対応していません。 |
906910

907911
### スクリーン リーダー / ARIA
908912

909-
バッジが支援技術では他に得られない情報を伝える場合は、周囲のコンポーネントに意味のある表示コンテンツまたはアクセシブルなラベルを提供してください。特定の周囲のコントロールについて、実際のアナウンス内容を確認してください。
913+
バッジ ホストは `role="status"` を使用して、コンテンツをステータス情報として公開します。
914+
915+
<PlatformBlock for="WebComponents, React, Blazor">
916+
917+
- コンポーネントは `aria-roledescription` を設定して、バッジとその現在の `variant` を識別します。
918+
- テキストのないバッジ (`dot` バッジを含む) が支援技術では他に得られないステータスを伝える場合は、`aria-label` を追加してください。
919+
- バッジのコンテンツまたはアクセシブルなラベルは、装飾されるアイテムに固有のものにしてください。例えば、単に `3` ではなく `3 件の未読メッセージ` のように記述してください。
920+
921+
</PlatformBlock>
922+
923+
<PlatformBlock for="Angular">
924+
925+
- コンポーネントは `role="status"``aria-label="badge"` で初期化されます。
926+
- Angular はバッジの種類とそのアイコンまたは値から `aria-roledescription` を導出します。`badge` が意味のあるアクセシブル名でない場合は、`label` 入力を設定してください。
927+
- テキストのないバッジや `dot` バッジのステータスが支援技術では他に得られない場合は、意味のある `label` を追加してください。
928+
929+
</PlatformBlock>
910930

911931
### アクセシビリティ準拠
912932

913-
このコンポーネントのアクセシビリティ準拠は、製品の公式アクセシビリティ ステートメントおよびレンダリングされる使用状況のコンテキストに対して検証する必要があります。
933+
インフラジスティックスは、[アクセシビリティ準拠](../interactivity/accessibility-compliance.mdx) トピックで、Section 508 および WCAG 2.1 ガイドライン領域における {ProductName} のアクセシビリティ サポートを文書化しています。
934+
935+
| 基準 | コンポーネントの準拠方法 |
936+
| -- | -- |
937+
| [4.1.2 名前、役割、値](https://www.w3.org/WAI/WCAG21/Understanding/name-role-value.html) | バッジはセマンティックな `status` ロールを公開します。xplat 実装は現在のバリアントに基づくロールの説明も公開します。Angular はバッジの種類とコンテンツに基づいてアクセシブルなラベルとロールの説明を公開します。 |
938+
939+
ユーザー側の責任:
940+
941+
- バッジに意味のあるテキストがない場合、特に `dot` バッジの場合は、ステータスを説明するアクセシブルな名前を提供してください。
942+
- バッジの色のみをステータスの表示手段として使用しないでください。テキスト、アイコン、または他のアクセシブルな手掛かりと組み合わせてください。
943+
- テーマ スタイルをオーバーライドする際は、バッジの前景色と背景色のコントラストを十分に確保してください。
914944

915945
## トラブルシューティング
916946

docs/xplat/src/content/jp/components/inputs/button-group.mdx

Lines changed: 50 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ import buttonGroupDoNot3 from '@xplat-images/button-group/button-group-do-not-3.
4444

4545
</PlatformBlock>
4646

47-
## アナトミー
47+
## 構造
4848

4949
{Platform} ボタン グループは、関連するトグル ボタンを共有コンテナーと個々のボタン アイテムを持つ単一グループに整理します。
5050

@@ -53,7 +53,7 @@ import buttonGroupDoNot3 from '@xplat-images/button-group/button-group-do-not-3.
5353
name="Button Group"
5454
description="ボタン グループ コンポーネントは、関連するトグル ボタンを共有コンテナー内に整理し、ユーザーが単一または複数の選択を行えるようにします。"
5555
src={buttonGroupAnatomy.src}
56-
alt="共有コンテナー、ボタン アイコン、ラベルを示すボタン グループのアナトミー"
56+
alt="共有コンテナー、ボタン アイコン、ラベルを示すボタン グループの構造"
5757
/>
5858

5959
<style>{`
@@ -79,17 +79,17 @@ Button Group
7979
└── Label
8080
```
8181

82-
## はじめに
82+
## 作業の開始
8383

8484
<PlatformBlock for="Angular">
8585

86-
{Platform} ボタン グループを使用するには、基本的なプロジェクト設定について [{ProductName} はじめに](/general/getting-started) トピックを参照してから、ターゲット プラットフォームのコンポーネントを登録してください。
86+
{Platform} ボタン グループを使用するには、基本的なプロジェクト設定について [{ProductName} の作業の開始](/general/getting-started) トピックを参照してから、ターゲット プラットフォームのコンポーネントを登録してください。
8787

8888
</PlatformBlock>
8989

9090
<PlatformBlock for="React,WebComponents,Blazor">
9191

92-
{Platform} ボタン グループを使用するには、基本的なプロジェクト設定について [{ProductName} はじめに](../general-getting-started.mdx) トピックを参照してから、ターゲット プラットフォームのコンポーネントを登録してください。
92+
{Platform} ボタン グループを使用するには、基本的なプロジェクト設定について [{ProductName} の作業の開始](../general-getting-started.mdx) トピックを参照してから、ターゲット プラットフォームのコンポーネントを登録してください。
9393

9494
</PlatformBlock>
9595

@@ -166,7 +166,7 @@ import { IGX_BUTTON_GROUP_DIRECTIVES } from 'igniteui-angular/button-group';
166166
import { IgxIconComponent } from 'igniteui-angular/icon';
167167
```
168168

169-
Ignite UI for Angular の完全な紹介については、[**はじめに**](/general/getting-started) トピックをお読みください。
169+
Ignite UI for Angular の完全な紹介については、[**作業の開始**](/general/getting-started) トピックをお読みください。
170170

171171
</PlatformBlock>
172172

@@ -668,7 +668,7 @@ igx-buttongroup {
668668

669669
</PlatformBlock>
670670

671-
### Do/Don't
671+
### 使用すべき場合と使用すべきでない場合
672672

673673
**使用する場合:** ユーザーが 1 つまたは複数のオプションを選択できる関連するトグル アクションを整理するためにボタン グループを使用します。
674674

@@ -701,7 +701,9 @@ igx-buttongroup {
701701

702702
## プロパティ
703703

704-
ボタン グループのプロパティはコンポーネント API リファレンスから生成されます。プロパティの行は、ドキュメントのビルド時に型付き API ソースから注入されます。
704+
ボタン グループのプロパティはコンポーネント API リファレンスから生成されます。
705+
706+
プロパティの行は、ドキュメントのビルド時に型付き API ソースから注入されます。
705707

706708
| 名前 | タイプ | デフォルト | 説明 |
707709
| --- | --- | --- | --- |
@@ -950,24 +952,55 @@ igc-toggle-button::part(toggle) {
950952

951953
## アクセシビリティ
952954

953-
ボタン グループは、各ボタンのインタラクションとアクセシブルな状態を保持しながら、関連するトグル ボタンをグループ化します。すべてのボタンに意味のあるコンテンツを提供し、意図するインタラクションに合った選択モードを選択してください
955+
{Platform} Button Group は、関連するトグル ボタンを整理しながら、各ボタンの選択状態と無効状態を公開します
954956

955957
### キーボード インタラクション
956958

957-
{Platform} ボタン グループは、含まれるトグル ボタンのキーボード動作に従います。含まれるボタンが提供するキーボード インタラクションを使用し、設定された選択モードのフォーカス順序と選択動作を確認してください
959+
ボタン グループは、内包するトグル ボタンにキーボード インタラクションを委譲します。各トグル ボタンはネイティブ ボタンをレンダリングするため、標準のボタン キーボード動作によってフォーカスされたアイテムがアクティブ化され、設定された選択モードに従って選択状態が更新されます
958960

959-
| インタラクション | 期待される動作 |
961+
| キー | アクション |
960962
| --- | --- |
961-
| キーボード フォーカス | 含まれるトグル ボタンには、それぞれのフォーカス動作に従ってアクセスできます。 |
962-
| トグル ボタン インタラクション | フォーカスされたボタンは、設定された選択モードに従って選択状態を変更します。 |
963+
| Tab / Shift+Tab | グループ内の次または前の有効なトグル ボタンにフォーカスを移動します。 |
964+
| Enter / Space | フォーカスされたトグル ボタンをアクティブ化し、設定された選択モードに従って選択または選択解除します。 |
965+
966+
ボタン グループが無効の場合、内包するトグル ボタンも無効になり、キーボードによるインタラクティブ操作に対応しなくなります。
963967

964968
### スクリーン リーダー / ARIA
965969

966-
支援技術のユーザーが各オプションとその選択状態を識別できるよう、すべての {Platform} トグル ボタンに明確なラベルを使用してください。アイコンがアクセシブルな名前を提供しない場合は、ボタンに適切なテキスト ラベルまたはアクセシブルな名前を提供してください。
970+
ボタン グループはグループの関係を公開し、各トグル ボタンはネイティブ ボタン セマンティクスを通じてその状態を公開します。
971+
972+
<PlatformBlock for="WebComponents, React, Blazor">
973+
974+
- グループ コンテナーは `role="group"` を使用し、`aria-disabled` を通じてグループの無効状態を反映します。
975+
- 各トグル ボタンは、選択状態に `aria-pressed`、無効状態に `aria-disabled` を持つネイティブ `button` をレンダリングします。
976+
- グループはユーザーの操作によりトグル ボタンの選択状態が変化した後、`igcSelect` および `igcDeselect` を発行します。イベントの詳細はトグル ボタンの `value` です。
977+
- すべてのトグル ボタンに表示テキストまたは `aria-label` を提供してください。特にアイコンのみのコントロールでは重要です。
978+
979+
</PlatformBlock>
980+
981+
<PlatformBlock for="Angular">
982+
983+
- グループ コンテナーは `role="group"` を使用します。
984+
- Angular は選択状態が変化すると各内包ボタンの `aria-pressed` 値を更新し、グループが無効の場合は子ボタンを無効にします。
985+
- グループはユーザーが選択を変更すると `selected` および `deselected` を発行します。各イベントには選択されたトグル ボタンとそのインデックスが含まれます。
986+
- すべてのアイコンのみのボタンに表示テキスト、`igxLabel`、または他のアクセシブルな名前を提供してください。
987+
988+
</PlatformBlock>
989+
990+
### アクセシビリティ準拠
991+
992+
インフラジスティックスは、[アクセシビリティ準拠](../interactivity/accessibility-compliance.mdx) トピックで、Section 508 および WCAG 2.1 ガイドライン領域における {ProductName} のアクセシビリティ サポートを文書化しています。
993+
994+
| 基準 | コンポーネントの準拠方法 |
995+
| -- | -- |
996+
| [2.1.1 キーボード](https://www.w3.org/WAI/WCAG21/Understanding/keyboard) | 各トグル ボタンはネイティブ ボタンを使用するため、グループの選択動作は標準のボタン キーボード アクティベーションを通じて利用できます。 |
997+
| [4.1.2 名前、役割、値](https://www.w3.org/WAI/WCAG21/Understanding/name-role-value) | グループは `role="group"` を公開します。トグル ボタンはネイティブ ボタン セマンティクスを公開し、選択状態が変化すると `aria-pressed` を更新します。xplat トグル ボタンは `aria-disabled` も公開します。 |
967998

968-
### アクセシビリティ コンプライアンス
999+
ユーザー側の責任:
9691000

970-
レンダリングされた {Platform} ボタン グループをアプリケーションのアクセシビリティ要件と照らし合わせて確認してください。ターゲット フレームワークで設定された選択モードのボタン名、フォーカス順序、選択状態のアナウンス、動作を確認してください。
1001+
- 各トグル ボタンに明確な表示ラベルまたはアクセシブルな名前を付けてください。特にアイコンのみのボタンでは重要です。
1002+
- グループの選択モードをコントロールの目的に合わせて設定し、ユーザーが 1 つまたは複数のオプションを選択できるかどうかを理解できるようにしてください。
1003+
- グループまたはその選択状態をカスタマイズする際は、論理的なボタンの順序と十分な色のコントラストを維持してください。
9711004

9721005
## トラブルシューティング
9731006

@@ -1011,7 +1044,7 @@ API の詳細とプロジェクト サポートについては、次の {Platfor
10111044

10121045
- <ApiLink pkg="core" type="ToggleButton" />
10131046

1014-
## よくある質問
1047+
## FAQ
10151048

10161049
これらのよくある質問は、{Platform} ボタン グループの選択、コンテンツ、設定に関する一般的なシナリオをカバーします。
10171050

docs/xplat/src/content/jp/components/layouts/avatar.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -569,17 +569,17 @@ Ignite UI コンポーネント トークンと共にユーティリティ フ
569569

570570
| 基準 | コンポーネントの準拠方法 |
571571
| -- | -- |
572-
| [1.1.1 非テキスト コンテンツ](https://www.w3.org/WAI/WCAG22/Understanding/non-text-content) | アバターにはアクセシブルなラベルがあり、画像アバターは `alt` を通じて特定の代替テキストを受け取ることができます。 |
573-
| [4.1.2 名前、役割、値](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value) | コンポーネントは画像セマンティクスで初期化され、コンテンツ関連の ARIA 情報を公開します。 |
572+
| [1.1.1 非テキスト コンテンツ](https://www.w3.org/WAI/WCAG21/Understanding/non-text-content) | アバターにはアクセシブルなラベルがあり、画像アバターは `alt` を通じて特定の代替テキストを受け取ることができます。 |
573+
| [4.1.2 名前、役割、値](https://www.w3.org/WAI/WCAG21/Understanding/name-role-value) | コンポーネントは画像セマンティクスで初期化され、コンテンツ関連の ARIA 情報を公開します。 |
574574

575575
</PlatformBlock>
576576

577577
<PlatformBlock for="Angular">
578578

579579
| 基準 | コンポーネントの準拠方法 |
580580
| -- | -- |
581-
| [1.1.1 非テキスト コンテンツ](https://www.w3.org/WAI/WCAG22/Understanding/non-text-content) | アバターにはアクセシブル ラベルがあり、表現されるエンティティを識別する周囲のテキストと組み合わせることができます。 |
582-
| [4.1.2 名前、役割、値](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value) | コンポーネントは `role="img"` とデフォルトのアクセシブル ラベルで初期化されます。 |
581+
| [1.1.1 非テキスト コンテンツ](https://www.w3.org/WAI/WCAG21/Understanding/non-text-content) | アバターにはアクセシブル ラベルがあり、表現されるエンティティを識別する周囲のテキストと組み合わせることができます。 |
582+
| [4.1.2 名前、役割、値](https://www.w3.org/WAI/WCAG21/Understanding/name-role-value) | コンポーネントは `role="img"` とデフォルトのアクセシブル ラベルで初期化されます。 |
583583

584584
</PlatformBlock>
585585

0 commit comments

Comments
 (0)