Skip to content

docs:translate guide/a11y-semantics #85

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

Merged
merged 3 commits into from
Sep 24, 2020

Conversation

ryo-gk
Copy link
Member

@ryo-gk ryo-gk commented Sep 23, 2020

resolve #46

@netlify
Copy link

netlify bot commented Sep 23, 2020

Deploy preview for vuejs-v3-ja-doc-preview ready!

Built with commit 01a6ed2

https://deploy-preview-85--vuejs-v3-ja-doc-preview.netlify.app

@ryo-gk ryo-gk changed the title docs:translate guide/ally-semantics docs:translate guide/a11y-semantics Sep 23, 2020
Copy link
Member

@kazupon kazupon left a comment

Choose a reason for hiding this comment

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

レビュー 👀 しました。
良さそうです!

@kazupon
Copy link
Member

kazupon commented Sep 23, 2020

@yamanoku
度々、すいませんが、a11y 自分そんなに詳しくないので、念の為、こちら一度確認してもらえませんでしょうか? 🙏

@kazupon kazupon requested a review from yamanoku September 23, 2020 15:50
@@ -46,12 +46,12 @@ Provide labels to describe the purpose of all form control; linking `for` and `i
</p>
<script async src="https://static.codepen.io/assets/embed/ei.js"></script>

If you inspect this element in your chrome developer tools and open the Accessibility tab inside the Elements tab, you will see how the input gets its name from the label:
chrome デベロッパツールでこの要素を検証し、Elements タブ内の Accessibility タブを開くと、どのように入力欄がその名前をラベルから取得するかを確認できます :

![Chrome Developer Tools showing input accessible name from label](/images/AccessibleLabelChromeDevTools.png)
Copy link
Collaborator

@yamanoku yamanoku Sep 23, 2020

Choose a reason for hiding this comment

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

こちらの画像における代替テキストも日本語訳してもらえるとありがたいです

@@ -85,13 +85,13 @@ You can also give the input an accessible name with [`aria-label`](https://devel
</p>
<script async src="https://static.codepen.io/assets/embed/ei.js"></script>

Feel free to inspect this element in Chrome DevTools to see how the accessible name has changed:
この要素を Chrome DevTools で自由に検証し、どのようにアクセス可能な名前が変更されたか確認してください:

![Chrome Developer Tools showing input accessible name from aria-label](/images/AccessibleARIAlabelDevTools.png)
Copy link
Collaborator

@yamanoku yamanoku Sep 23, 2020

Choose a reason for hiding this comment

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

こちらの画像における代替テキストも日本語訳してもらえるとありがたいです

@@ -159,15 +159,15 @@ Using [`aria-labelledby`](https://developer.mozilla.org/en-US/docs/Web/Accessibi
</p>
<script async src="https://static.codepen.io/assets/embed/ei.js"></script>

You can see the description by instecting Chrome DevTools:
Chrome DevTools で検出することで Description を確認することができます:

![Chrome Developer Tools showing input accessible name from aria-labelledby and description with aria-describedby](/images/AccessibleARIAdescribedby.png)
Copy link
Collaborator

@yamanoku yamanoku Sep 23, 2020

Choose a reason for hiding this comment

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

こちらの画像における代替テキストも日本語訳してもらえるとありがたいです

@@ -197,7 +197,7 @@ You can provide additional instructions and bind multiple ids inside an [`aria-l
</fieldset>
```

Alternatively, you can attach the instructions to the input with [`aria-describedby`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute):
あるいは、[`aria-describedby`](https://developer.mozilla.org/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute) を使用して入力欄に指示を添付することもできます:
Copy link
Collaborator

@yamanoku yamanoku Sep 23, 2020

Choose a reason for hiding this comment

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

Suggested change
あるいは、[`aria-describedby`](https://developer.mozilla.org/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute) を使用して入力欄に指示を添付することもできます:
あるいは、[`aria-describedby`](https://developer.mozilla.org/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute) を使用して入力欄に説明を添付することもできます:

[IMO] 指示より「説明」 のほうが適切かもしれません

参考:WCAG文書とWAICによる日本語翻訳文書

Comment on lines 183 to 184
入力欄に指示を追加するとき、入力欄に対して正しくリンクしていることを確認してください。
あなたは追加の指示を提供し、複数の id を [`aria-labelledby`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-labelledby_attribute) 内に束縛することができます。これにより、さらに柔軟な設計が可能になります。
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
入力欄に指示を追加するとき、入力欄に対して正しくリンクしていることを確認してください。
あなたは追加の指示を提供し、複数の id を [`aria-labelledby`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-labelledby_attribute) 内に束縛することができます。これにより、さらに柔軟な設計が可能になります。
入力欄に説明を追加するとき、入力欄に対して正しくリンクしていることを確認してください。
あなたは追加の説明を提供し、複数の id を [`aria-labelledby`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-labelledby_attribute) 内に束縛することができます。これにより、さらに柔軟な設計が可能になります。

[IMO] 指示より「説明」 のほうが適切かもしれません

参考:WCAG文書とWAICによる日本語翻訳文書

Copy link
Collaborator

Choose a reason for hiding this comment

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

@kazupon
[IMO] bindは「束縛」よりも「バインド」のままで訳したほうが開発者としてはイメージしやすそうな気がしたのですがいかがでしょう 👀

Copy link
Member

Choose a reason for hiding this comment

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

そうしたいところなんですが、Vue 3 のドキュメント、結構 Vue 2 ベースになっていて、他の翻訳も bind を 束縛で通してしてしまっています。一貫性を持たせたいので、一旦現状どおりとさせてください。 🙏


### Instructions
### 指示
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
### 指示
### 説明

[IMO] 指示より「説明」 のほうが適切かもしれません

参考:WCAG文書とWAICによる日本語翻訳文書

Copy link
Collaborator

@yamanoku yamanoku left a comment

Choose a reason for hiding this comment

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

@ryo-gk @kazupon
レビューいたしました!よろしくお願いいたします!

@kazupon
Copy link
Member

kazupon commented Sep 24, 2020

@yamanoku
レビューありがとうございました!

@ryo-gk
引き続き、よろしくお願いしいたします!

@kazupon
Copy link
Member

kazupon commented Sep 24, 2020

確認しました。
LGTMです!
CIでエラーが起きていますが、翻訳作業に支障がない(このPRとは別事象)ので、マージします。

翻訳ありがとうございました!

@kazupon kazupon merged commit 59ae855 into vuejs-jp:lang-ja Sep 24, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Accessibility > Semantics の翻訳
3 participants