From 9a1b0cfb8b87f55176b344f7468dd70a1c856b6c Mon Sep 17 00:00:00 2001 From: Wind1808 <42607060+Wind1808@users.noreply.github.com> Date: Thu, 6 May 2021 02:25:46 +0900 Subject: ARIA: figure ロールの更新 (#724) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../aria/roles/figure_role/index.html | 47 +++++++++++----------- 1 file changed, 24 insertions(+), 23 deletions(-) (limited to 'files/ja/web') diff --git a/files/ja/web/accessibility/aria/roles/figure_role/index.html b/files/ja/web/accessibility/aria/roles/figure_role/index.html index f878ae0eaa..ceca6b81dc 100644 --- a/files/ja/web/accessibility/aria/roles/figure_role/index.html +++ b/files/ja/web/accessibility/aria/roles/figure_role/index.html @@ -7,9 +7,7 @@ tags: - Accessibility translation_of: Web/Accessibility/ARIA/Roles/Figure_Role --- -
\{{ariaref}}
- -

ARIA の figure ロールは、適切な意味論が存在しないページコンテンツ内の図表を識別するために使用できます。 図表は、通常、1つまたは複数の画像、コードスニペット、または情報を通常のテキストの流れとは異なる方法で配置するその他のコンテンツとみなされます。

+

ARIA の図表 (figure) ロールは、適切な意味論がまだ存在しないページコンテンツ内の図表を識別するために使用できます。 図表は一般的に、正規のテキストの流れとは異なる方法で情報を伝える、1つ以上の画像、コードスニペット、またはその他のコンテンツと見なされます。

<div role="figure" aria-labelledby="caption">
   <img src="image.png"
@@ -18,17 +16,17 @@ translation_of: Web/Accessibility/ARIA/Roles/Figure_Role
 </div>
 
-

上記の例では、画像とキャプションの2つの別々のコンテンツ項目で構成される図表があります。 これは、コンテンツを role="figure" を使用して図表として識別する {{htmlelement("div")}} 要素で囲まれます。

+

上記の例では、画像とキャプションという2つの別々のコンテンツ項目で構成される図表があります。 これは、role="figure" を使用してコンテンツを図表として識別する {{htmlelement("div")}} 要素で囲まれています。

-

図表を作成するために ARIA を使用する代わりに、{{htmlelement("figcaption")}} 要素と共に、ネイティブな意味論の HTML {{htmlelement("figure")}} 要素の使用を検討してください。 以下の{{anch("Best practices","ベストプラクティス")}}をご覧ください。

+

図表の作成に ARIA を使用する代わりに、ネイティブで意味論的な HTML {{htmlelement("figure")}} 要素を {{htmlelement("figcaption")}} 要素と共に使用することを検討してください。 以下の{{anch("Best practices","ベストプラクティス")}}をご覧ください。

説明

-

一緒にグループ化され、図表(画像、動画、音声、コードスニペット、または他のコンテンツを含む)として消費されるべきコンテンツは、 role="figure" を使用して図表として識別できます。

+

(画像、動画、音声、コードスニペット、または他のコンテンツを含む可能性がある) 図表としてまとめて消費されるべきコンテンツは、 role="figure" を使用して図表として識別できます。

-

図表のコンテンツをどのように書くべきかについての鉄則はありません。 他のコンテンツと同様にアクセス可能であることを確認するべきです。 例えば、支援技術のユーザーがキーボードやマウスなどで操作できることを確認してください。

+

図表のコンテンツをどのように書くべきかについての鉄則はありません。 他のコンテンツと同様にアクセスできることを確認するべきです。 例えば、支援技術のユーザーによって知覚できることや、キーボードやマウスでナビゲートできることなどを確認します。

-

図表にキャプションやラベルを追加する場合は、さまざまな方法でキャプションやラベルを追加できます。 図表を説明するコンテンツを含む要素に ID を追加し、図表上の適切な属性でその ID を参照して、次のように図表をラベルに関連付けることができます。

+

さまざまな方法で、図表にキャプションやラベルを追加できます。 次のように、図表を説明するコンテンツを含む要素に ID を追加し、その ID を図表の適切な属性内で参照して、図表をラベルに関連付けることができます。

<div role="figure" aria-labelledby="figure-1">
   ...
@@ -47,10 +45,7 @@ translation_of: Web/Accessibility/ARIA/Roles/Figure_Role
   <figcaption>図表を説明するテキスト。</figcaption>
 </figure>
- - -

ラベルを画面に表示したくないが、支援技術のユーザーにわかりやすいラベルを提供したい場合は、図表コンテナの aria-label 属性を使用できます。

+

ラベルを画面に表示したくないが、支援技術のユーザーにわかりやすいラベルを提供したい場合は、図表コンテナーに aria-label 属性を使用できます。

<div role="figure" aria-label="図表を説明するテキスト。">
   ...
@@ -62,23 +57,22 @@ translation_of: Web/Accessibility/ARIA/Roles/Figure_Role
   ...
 </figure>
-

一般的には、メインテキストから図表を参照するべきですが、図表は参照元の要素と同じ場所に表示する必要はありません。

+

一般的には、本文から図表を参照するべきですが、図表は参照元の要素と同じ場所に表示する必要はありません。

-

: 可能な限り、意味論的 HTML 要素を使用して図表とそのキャプション({{htmlelement("figure")}} と {{htmlelement("figcaption")}})をマークアップするべきです。 詳しくは、{{anch("Best practices","ベストプラクティス")}}を参照してください。

+

: 可能な限り、適切な意味論の HTML 要素を使用して図表とそのキャプション ({{htmlelement("figure")}} と {{htmlelement("figcaption")}}) をマークアップするべきです。 詳しくは、{{anch("Best practices","ベストプラクティス")}}を参照してください。

-

 

関連する WAI-ARIA のロール、ステート、プロパティ

aria-describedby
-
キャプションとしての参照テキストを含む要素の ID。
+
キャプションとしての参照テキストを含む要素の id。
aria-labelledby
-
ラベルとしてのテキストを含む要素の ID。
+
ラベルとしてのテキストを含む要素の id。
aria-label
-
ラベルとして機能することができるテキストを含む要素がない場合は、figure ロールを持つ要素や <figure> 要素の aria-label の値として直接ラベルを追加できます。
+
ラベルになるようなテキストを含む要素がない場合は、図表 (figure) ロールを持つ要素や <figure> 要素の aria-label の値として直接ラベルを追加できます。

キーボードインタラクション

@@ -87,11 +81,11 @@ translation_of: Web/Accessibility/ARIA/Roles/Figure_Role

必要な JavaScript 機能

-

ロール固有の JavaScript 要件はありません。 HTML の意味論を制御できない場合は、JavaScript でこれらのロールとプロパティを追加することで、HTML のアクセシビリティを向上させることができます。

+

ロールに固有の JavaScript 要件はありません。 HTML の意味論を制御できない場合は、JavaScript でこれらのロールとプロパティを追加することで、HTML のアクセシビリティを向上させることができます。

-

aria-labelledby でその ID を参照することによって、図表の説明的なラベルを提供する段落を識別するために、このページの最初の例を拡張することもできます。

+

次のように、ページの最初の例を拡張して、aria-labelledby でその ID を参照することにより、図表の説明的なラベルを提供する段落を特定することもできます。

<div role="figure" aria-labelledby="figure-1">
   <img src="diagram.png"
@@ -105,9 +99,9 @@ translation_of: Web/Accessibility/ARIA/Roles/Figure_Role
 
 

ベストプラクティス

-

たとえば、HTML を制御できないが、JavaScript を使用した後でアクセシビリティを動的に向上させる必要がある場合など、role="figure" のみを使用する必要があります。

+

必要な場合にのみ role="figure" を使用してください。 例えば、HTML を制御できないが、JavaScript を使用して事後に動的にアクセシビリティを向上させることができる場合などです。

-

可能であれば、図表とそのキャプション({{htmlelement("figure")}} と {{htmlelement("figcaption")}})をマークアップするために、適切な意味論の HTML 要素を使用する必要があります。 たとえば、上記の例は次のように書き直されます。

+

可能であれば、適切な意味論の HTML 要素を使用して、図表とそのキャプション ({{htmlelement("figure")}} と {{htmlelement("figcaption")}}) をマークアップするべきです。 例えば、上記の例は次のように書き直すべきです。

<figure>
   <img src="diagram.png"
@@ -144,5 +138,12 @@ translation_of: Web/Accessibility/ARIA/Roles/Figure_Role
  
  • Accessibility Object Model
  • ARIA in HTML
  • HTML <figure> 要素
  • -
  • HTML <figcation> 要素
  • +
  • HTML <figcaption> 要素
  • + + + -- cgit v1.2.3-54-g00ecf