Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ボタン パターンの日本語化 #130

Open
wants to merge 7 commits into
base: waic-main
Choose a base branch
from
Open

ボタン パターンの日本語化 #130

wants to merge 7 commits into from

Conversation

tsmd
Copy link
Collaborator

@tsmd tsmd commented Aug 16, 2023

@netlify
Copy link

netlify bot commented Aug 16, 2023

Deploy Preview for waic-apg ready!

Name Link
🔨 Latest commit 17b22b5
🔍 Latest deploy log https://app.netlify.com/sites/waic-apg/deploys/6629a4b1cff48f00088e0a1a
😎 Deploy Preview https://deploy-preview-130--waic-apg.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@tsmd tsmd added this to the 1st release milestone Nov 27, 2023
調整しました。
@DaichiImai
Copy link
Contributor

ChatGPT による翻訳内容を確認し、修正を加えました。 9c6b55d

主な修正点は以下のとおりです。

WCAG の訳出ガイドラインに準じて、用語や表記を修正。
WG4用語集に準じて、用語や表記を修正。
その他、通しで読んでみて不自然な日本語になっている箇所を修正。

調整しました。
@DaichiImai
Copy link
Contributor

DaichiImai commented Apr 24, 2024

サンプルページを調整しました。

ボタンの例
https://deploy-preview-130--waic-apg.netlify.app/patterns/button/examples/button

@DaichiImai
Copy link
Contributor

もう一つのサンプルページを調整しました。

ボタンの例(IDLバージョン)
https://deploy-preview-130--waic-apg.netlify.app/patterns/button/examples/button_idl

@tsmd tsmd removed the request for review from DaichiImai May 18, 2024 14:57
Copy link
Collaborator Author

@tsmd tsmd left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

content/patterns/button/button-pattern.html

のみレビューしました!
残りは引き続きやっていきます

<p>
A <a class="role-reference" href="#button">button</a> is a widget that enables users to trigger an action or event, such as submitting a form, opening a dialog, canceling an action, or performing a delete operation.
A common convention for informing users that a button launches a dialog is to append &quot;&#8230;&quot; (ellipsis) to the button label, e.g., &quot;Save as&#8230;&quot;.
<a class="role-reference" href="#button">ボタン</a> は、フォームの送信、ダイアログのオープン、アクションのキャンセル、削除操作などの利用者のアクションやイベントのトリガを可能にするウィジェットです。
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

「performing a delete operation」の「performing」が抜けてるかもしれないです。
また「利用者のアクション」とするよりは、「アクションやイベントを利用者がトリガーできるようにする」といったニュアンスが近いのかなと。

Suggested change
<a class="role-reference" href="#button">ボタン</a> は、フォームの送信、ダイアログのオープン、アクションのキャンセル、削除操作などの利用者のアクションやイベントのトリガを可能にするウィジェットです
<a class="role-reference" href="#button">ボタン</a> は、フォームの送信、ダイアログのオープン、アクションのキャンセル、削除操作の実行などのアクションやイベントを利用者がトリガーできるようにするウィジェットです

ボタンがトグルボタンであることを支援技術に伝えるには、<a href="#aria-pressed" class="state-reference">aria-pressed</a> 属性に値を指定します。
例えば、オーディオプレーヤーのミュートというラベルのボタンは、押された状態を true に設定することで、音がミュートされていることを示すことができます。
<strong>重要:</strong>トグルボタンのラベルは、その状態が変化しても変化しないことが重要です。
この例では、押された状態が true のとき、ラベルは &quot;ミュート&quot; のままなので、スクリーンリーダーは "ミュート トグルボタン 押されています" のように言うでしょう。
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

スクリーンリーダーは「言う」より「読み上げる」の方が一般的な表現な気がしました。

Suggested change
この例では、押された状態が true のとき、ラベルは &quot;ミュート&quot; のままなので、スクリーンリーダーは "ミュート トグルボタン 押されています" のように言うでしょう
この例では、押された状態が true のとき、ラベルは &quot;ミュート&quot; のままなので、スクリーンリーダーは "ミュート トグルボタン 押されています" のように読み上げるでしょう

Comment on lines +42 to +45
ウィジェットの外観及び役割は、それが提供する機能と一致することが重要です。
それにもかかわらず、要素がリンクの視覚的なスタイルを持ちながら、ボタンのアクションを実行することがあります。
このような場合、要素に <code>button</code> の役割を与えることは、支援技術利用者が要素の機能を理解するのに役立ちます。
しかし、より良い解決策は、機能と ARIA の役割が一致するように視覚デザインを調整することです。
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ARIAの文脈で「role」を使う時は「役割」ではなく「ロール」としておきたいです。

Suggested change
ウィジェットの外観及び役割は、それが提供する機能と一致することが重要です。
それにもかかわらず、要素がリンクの視覚的なスタイルを持ちながら、ボタンのアクションを実行することがあります。
このような場合、要素に <code>button</code> の役割を与えることは、支援技術利用者が要素の機能を理解するのに役立ちます。
しかし、より良い解決策は、機能と ARIA の役割が一致するように視覚デザインを調整することです
ウィジェットの外観及びロールは、それが提供する機能と一致することが重要です。
それにもかかわらず、要素がリンクの視覚的なスタイルを持ちながら、ボタンのアクションを実行することがあります。
このような場合、要素に <code>button</code> ロールを与えることは、支援技術利用者が要素の機能を理解するのに役立ちます。
しかし、より良い解決策は、機能と ARIA ロールが一致するように視覚デザインを調整することです

However, if the dialog were confirming the action of deleting the page from which it was opened, the focus would logically move to a new context.
ボタンを押すとダイアログが閉じる場合、ダイアログのコンテキストで実行された機能が論理的に別の要素につながらない限り、フォーカスは通常、ダイアログを開いたボタンに戻ります。
例えば、ダイアログのキャンセルボタンを押すと、フォーカスはダイアログを開いたボタンに戻ります。
しかし、ダイアログが開かれたページを削除する操作を確認するものであった場合、フォーカスは論理的に新しいコンテキストに移動します。
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ダイアログが開かれたページそのものであることが「the」に込められてる感があったので、日本語ではもう少し明示的に訳してもよいかもしれません。

Suggested change
しかし、ダイアログが開かれたページを削除する操作を確認するものであった場合、フォーカスは論理的に新しいコンテキストに移動します。
しかし、ダイアログがそのダイアログが開かれたページを削除する操作を確認するものであった場合、フォーカスは論理的に新しいコンテキストに移動します。

</li>
</ul>
</li>
</ul>
</section>

<section id="roles_states_properties">
<h2>WAI-ARIA Roles, States, and Properties</h2>
<h2>WAI-ARIAの役割、状態、およびプロパティ</h2>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

この辺はカタカナにしたいです!

Suggested change
<h2>WAI-ARIAの役割、状態、およびプロパティ</h2>
<h2>WAI-ARIA ロール、ステート、及びプロパティ</h2>

<ul>
<li>The button has role of <a class="role-reference" href="#button">button</a>.</li>
<li>ボタンは <a class="role-reference" href="#button">button</a> の役割を持っています。</li>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<li>ボタンは <a class="role-reference" href="#button">button</a> の役割を持っています</li>
<li>ボタンは <a class="role-reference" href="#button">button</a> のロールを持っています</li>

Comment on lines +102 to +103
ボタンがトグルボタンの場合、ボタンは <a href="#aria-pressed" class="state-reference">aria-pressed</a> の状態を持ちます。
ボタンがオンに切り替えられると、この状態の値は <code>true</code> になり、オフに切り替えられると、この状態の値は <code>false</code> になります。
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
ボタンがトグルボタンの場合、ボタンは <a href="#aria-pressed" class="state-reference">aria-pressed</a> の状態を持ちます
ボタンがオンに切り替えられると、この状態の値は <code>true</code> になり、オフに切り替えられると、この状態の値は <code>false</code> になります。
ボタンがトグルボタンの場合、ボタンは <a href="#aria-pressed" class="state-reference">aria-pressed</a> のステートを持ちます
ボタンがオンに切り替えられると、このステートの値は <code>true</code> になり、オフに切り替えられると、このステートの値は <code>false</code> になります。

Copy link
Collaborator Author

@tsmd tsmd left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

残りの部分をレビューしました!
ご確認をおねがいいたします〜

<p>The following command and toggle button examples demonstrate the <a href="../button-pattern.html">Button Pattern</a>.</p>
<p>Similar examples include:</p>
<h2>この例について</h2>
<p>以下のコマンドとトグルボタンの例は、<a href="../button-pattern.html">ボタンパターン</a> のデモンストレーションです。</p>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<p>以下のコマンドとトグルボタンの例は<a href="../button-pattern.html">ボタンパターン</a> のデモンストレーションです。</p>
<p>以下のコマンド及びトグルボタンの例は<a href="../button-pattern.html">ボタンパターン</a> のデモンストレーションです。</p>

Comment on lines +130 to +131
<li>要素を <code>button</code> ウィジェットとして識別します。</li>
<li>ボタンのアクセシブルな名前は、要素のテキストコンテンツによって定義されます。</li>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

このセクションはリストで、言い切りの形にするとより馴染むかなと思います!

Suggested change
<li>要素を <code>button</code> ウィジェットとして識別します</li>
<li>ボタンのアクセシブルな名前は、要素のテキストコンテンツによって定義されます</li>
<li>要素を <code>button</code> ウィジェットとして識別する</li>
<li>ボタンのアクセシブルな名前は、要素のテキストコンテンツによって定義される</li>

Comment on lines +143 to +144
<li>要素をタブの順序に含めます。</li>
<li><code>href</code> 属性を持っていない <code>a</code> 要素に必要です。</li>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

こちらも言い切りの形に。
2つめのliは、bacause が訳出されていなかったので「ため」を足しました。

Suggested change
<li>要素をタブの順序に含めます</li>
<li><code>href</code> 属性を持っていない <code>a</code> 要素に必要です</li>
<li>要素をタブ順序に含める</li>
<li><code>href</code> 属性を持たないため <code>a</code> 要素に必要</li>

Comment on lines +154 to +155
<li>ボタンをトグルボタンとして識別します。</li>
<li>トグルボタンが押されていないことを示します。</li>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<li>ボタンをトグルボタンとして識別します</li>
<li>トグルボタンが押されていないことを示します</li>
<li>ボタンをトグルボタンとして識別する</li>
<li>トグルボタンが押されていないことを示す</li>

Comment on lines +165 to +166
<li>ボタンをトグルボタンとして識別します。</li>
<li>トグルボタンが押されていることを示します。</li>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<li>ボタンをトグルボタンとして識別します</li>
<li>トグルボタンが押されていることを示します</li>
<li>ボタンをトグルボタンとして識別する</li>
<li>トグルボタンが押されていることを示す</li>

Comment on lines +146 to +147
<li>要素をタブの順序に含めます。</li>
<li><code>href</code> 属性を持たない <code>a</code> 要素に必要です。</li>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<li>要素をタブの順序に含めます</li>
<li><code>href</code> 属性を持たない <code>a</code> 要素に必要です</li>
<li>要素をタブ順序に含める</li>
<li><code>href</code> 属性を持たないため <code>a</code> 要素に必要</li>

Comment on lines +157 to +159
<li>JavaScript で <code>button.ariaPressed = 'false';</code> と設定します。</li>
<li>この設定は、ボタンをトグルボタンとして識別します。</li>
<li>トグルボタンが押されていないことを示します。</li>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

言い切りの形にしつつ、
ひとつめのliの「Set」は過去分詞系だとおもいました。
ふたつめのliは、「この設定は」という謎の節が生み出されていたのでトリました。

Suggested change
<li>JavaScript <code>button.ariaPressed = 'false';</code> と設定します</li>
<li>この設定は、ボタンをトグルボタンとして識別します</li>
<li>トグルボタンが押されていないことを示します</li>
<li>JavaScript にて <code>button.ariaPressed = 'false';</code> によって設定される</li>
<li>ボタンをトグルボタンとして識別する</li>
<li>トグルボタンが押されていないことを示す</li>

Comment on lines +169 to +171
<li>JavaScript で<code>button.ariaPressed = 'true';</code> と設定します。</li>
<li>この設定は、ボタンをトグルボタンとして識別します。</li>
<li>トグルボタンが押されていることを示します。</li>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

同上です

Suggested change
<li>JavaScript <code>button.ariaPressed = 'true';</code> と設定します</li>
<li>この設定は、ボタンをトグルボタンとして識別します</li>
<li>トグルボタンが押されていることを示します</li>
<li>JavaScript にて <code>button.ariaPressed = 'true';</code> によって設定される</li>
<li>ボタンをトグルボタンとして識別する</li>
<li>トグルボタンが押されていることを示す</li>

</ul>
</td>
</tr>
<tr data-test-id="svg-aria-hidden">
<td></td>
<th scope="row"><code>aria-hidden="true"</code></th>
<td><code>svg</code></td>
<td>Excludes SVG from accessible name calculation for the button.</td>
<td>ボタンのアクセシブルな名前の計算から SVG を除外します。</td>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<td>ボタンのアクセシブルな名前の計算から SVG を除外します</td>
<td>ボタンのアクセシブルな名前の計算から SVG を除外する</td>

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: レビュー中
Development

Successfully merging this pull request may close these issues.

Button
2 participants