From 03a672ec9277f5122f5698444a5fba316b4f6da8 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sat, 1 Oct 2022 03:23:22 +0900 Subject: [PATCH] =?UTF-8?q?learn=20=E4=BB=A5=E4=B8=8B=E3=81=AE=20Note:=20W?= =?UTF-8?q?arning:=20Callout:=20=E3=82=92=E6=97=A5=E6=9C=AC=E8=AA=9E?= =?UTF-8?q?=E3=81=AB=E5=A4=89=E6=8F=9B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../accessibility_troubleshooting/index.md | 4 +- .../accessibility/css_and_javascript/index.md | 14 +- files/ja/learn/accessibility/html/index.md | 22 +- files/ja/learn/accessibility/index.md | 2 +- files/ja/learn/accessibility/mobile/index.md | 4 +- .../learn/accessibility/multimedia/index.md | 6 +- .../accessibility/wai-aria_basics/index.md | 20 +- .../what_is_accessibility/index.md | 4 +- .../design_for_all_types_of_users/index.md | 8 +- .../how_does_the_internet_work/index.md | 2 +- .../how_much_does_it_cost/index.md | 2 +- .../index.md | 2 +- .../set_up_a_local_testing_server/index.md | 4 +- .../thinking_before_coding/index.md | 2 +- .../upload_files_to_a_web_server/index.md | 4 +- .../using_github_pages/index.md | 2 +- .../what_are_browser_developer_tools/index.md | 2 +- .../what_is_a_domain_name/index.md | 4 +- .../common_questions/what_is_a_url/index.md | 8 +- .../what_software_do_i_need/index.md | 2 +- .../a_cool_looking_box/index.md | 2 +- .../advanced_styling_effects/index.md | 10 +- .../backgrounds_and_borders/index.md | 10 +- .../cascade_and_inheritance/index.md | 12 +- .../index.md | 2 +- .../building_blocks/debugging_css/index.md | 4 +- .../fundamental_css_comprehension/index.md | 4 +- .../images_media_form_elements/index.md | 4 +- files/ja/learn/css/building_blocks/index.md | 4 +- .../css/building_blocks/organizing/index.md | 2 +- .../overflowing_content/index.md | 2 +- .../selectors/attribute_selectors/index.md | 4 +- .../index.md | 2 +- .../type_class_and_id_selectors/index.md | 2 +- .../sizing_items_in_css/index.md | 2 +- .../building_blocks/the_box_model/index.md | 8 +- .../building_blocks/values_and_units/index.md | 14 +- .../ja/learn/css/css_layout/flexbox/index.md | 2 +- files/ja/learn/css/css_layout/grids/index.md | 6 +- files/ja/learn/css/css_layout/index.md | 4 +- .../css/css_layout/introduction/index.md | 10 +- .../css_layout/legacy_layout_methods/index.md | 22 +- .../css/css_layout/media_queries/index.md | 6 +- .../learn/css/css_layout/positioning/index.md | 20 +- .../practical_positioning_examples/index.md | 14 +- .../css/css_layout/responsive_design/index.md | 18 +- .../supporting_older_browsers/index.md | 2 +- .../css/first_steps/getting_started/index.md | 6 +- .../how_css_is_structured/index.md | 12 +- files/ja/learn/css/first_steps/index.md | 4 +- .../styling_a_biography_page/index.md | 2 +- .../css/first_steps/what_is_css/index.md | 4 +- .../css/howto/create_fancy_boxes/index.md | 2 +- files/ja/learn/css/howto/css_faq/index.md | 8 +- .../css/howto/generated_content/index.md | 2 +- files/ja/learn/css/index.md | 2 +- .../css/styling_text/fundamentals/index.md | 14 +- files/ja/learn/css/styling_text/index.md | 2 +- .../css/styling_text/styling_links/index.md | 8 +- .../css/styling_text/styling_lists/index.md | 4 +- .../typesetting_a_homepage/index.md | 2 +- .../learn/css/styling_text/web_fonts/index.md | 10 +- .../forms/advanced_form_styling/index.md | 8 +- .../forms/basic_native_form_controls/index.md | 18 +- files/ja/learn/forms/form_validation/index.md | 28 +- .../index.md | 12 +- .../how_to_structure_a_web_form/index.md | 10 +- .../ja/learn/forms/html5_input_types/index.md | 10 +- .../html_forms_in_legacy_browsers/index.md | 2 +- files/ja/learn/forms/index.md | 12 +- .../learn/forms/other_form_controls/index.md | 10 +- .../sending_and_retrieving_form_data/index.md | 16 +- .../sending_forms_through_javascript/index.md | 4 +- .../ja/learn/forms/styling_web_forms/index.md | 6 +- .../ja/learn/forms/ui_pseudo-classes/index.md | 22 +- files/ja/learn/forms/your_first_form/index.md | 8 +- .../css_basics/index.md | 6 +- .../dealing_with_files/index.md | 4 +- .../html_basics/index.md | 10 +- .../installing_basic_software/index.md | 2 +- .../javascript_basics/index.md | 18 +- .../publishing_your_website/index.md | 4 +- .../what_will_your_website_look_like/index.md | 4 +- .../add_a_hit_map_on_top_of_an_image/index.md | 2 +- .../howto/define_terms_with_html/index.md | 8 +- .../use_javascript_within_a_webpage/index.md | 4 +- .../advanced_text_formatting/index.md | 4 +- .../creating_hyperlinks/index.md | 12 +- .../debugging_html/index.md | 4 +- .../document_and_website_structure/index.md | 6 +- .../getting_started/index.md | 20 +- .../html_text_fundamentals/index.md | 2 +- .../learn/html/introduction_to_html/index.md | 4 +- .../marking_up_a_letter/index.md | 2 +- .../structuring_a_page_of_content/index.md | 2 +- .../the_head_metadata_in_html/index.md | 10 +- .../index.md | 6 +- .../images_in_html/index.md | 18 +- .../html/multimedia_and_embedding/index.md | 4 +- .../mozilla_splash_page/index.md | 6 +- .../other_embedding_technologies/index.md | 10 +- .../responsive_images/index.md | 10 +- .../video_and_audio_content/index.md | 10 +- files/ja/learn/html/tables/advanced/index.md | 16 +- files/ja/learn/html/tables/basics/index.md | 8 +- files/ja/learn/html/tables/index.md | 2 +- .../tables/structuring_planet_data/index.md | 2 +- files/ja/learn/index.md | 4 +- .../ja/learn/javascript/asynchronous/index.md | 4 +- .../asynchronous/introducing_workers/index.md | 258 ++++++++++++ .../javascript/asynchronous/promises/index.md | 393 ++++++++++++++++++ .../build_your_own_function/index.md | 8 +- .../building_blocks/conditionals/index.md | 12 +- .../building_blocks/events/index.md | 22 +- .../building_blocks/functions/index.md | 12 +- .../building_blocks/image_gallery/index.md | 2 +- .../learn/javascript/building_blocks/index.md | 2 +- .../building_blocks/looping_code/index.md | 24 +- .../building_blocks/return_values/index.md | 2 +- .../client-side_storage/index.md | 12 +- .../drawing_graphics/index.md | 30 +- .../fetching_data/index.md | 4 +- .../javascript/client-side_web_apis/index.md | 2 +- .../introduction/index.md | 14 +- .../manipulating_documents/index.md | 10 +- .../third_party_apis/index.md | 14 +- .../first_steps/a_first_splash/index.md | 6 +- .../javascript/first_steps/arrays/index.md | 6 +- .../ja/learn/javascript/first_steps/index.md | 4 +- .../javascript/first_steps/math/index.md | 20 +- .../silly_story_generator/index.md | 2 +- .../javascript/first_steps/strings/index.md | 4 +- .../test_your_skills_colon__arrays/index.md | 12 +- .../test_your_skills_colon__math/index.md | 10 +- .../useful_string_methods/index.md | 4 +- .../javascript/first_steps/variables/index.md | 10 +- .../first_steps/what_is_javascript/index.md | 20 +- .../first_steps/what_went_wrong/index.md | 18 +- files/ja/learn/javascript/index.md | 2 +- .../adding_bouncing_balls_features/index.md | 2 +- .../learn/javascript/objects/basics/index.md | 4 +- .../objects/classes_in_javascript/index.md | 18 +- files/ja/learn/javascript/objects/index.md | 2 +- .../ja/learn/javascript/objects/json/index.md | 8 +- .../objects/object_building_practice/index.md | 2 +- .../objects/object_prototypes/index.md | 22 +- .../index.md | 10 +- .../what_is_web_performance/index.md | 2 +- .../django/development_environment/index.md | 26 +- files/ja/learn/server-side/django/index.md | 2 +- .../server-side/django/introduction/index.md | 8 +- .../learn/server-side/django/models/index.md | 12 +- .../django/skeleton_website/index.md | 22 +- .../django/web_application_security/index.md | 6 +- .../express_nodejs/deployment/index.md | 26 +- .../development_environment/index.md | 20 +- .../author_detail_page/index.md | 2 +- .../displaying_data/author_list_page/index.md | 2 +- .../displaying_data/book_detail_page/index.md | 4 +- .../displaying_data/book_list_page/index.md | 2 +- .../index.md | 2 +- .../date_formatting_using_moment/index.md | 4 +- .../flow_control_using_async/index.md | 4 +- .../genre_detail_page/index.md | 4 +- .../displaying_data/home_page/index.md | 8 +- .../displaying_data/template_primer/index.md | 4 +- .../server-side/express_nodejs/forms/index.md | 8 +- .../learn/server-side/express_nodejs/index.md | 2 +- .../express_nodejs/introduction/index.md | 28 +- .../express_nodejs/mongoose/index.md | 34 +- .../express_nodejs/routes/index.md | 16 +- .../express_nodejs/skeleton_website/index.md | 22 +- .../tutorial_local_library_website/index.md | 2 +- .../client-server_overview/index.md | 8 +- .../first_steps/introduction/index.md | 14 +- .../first_steps/web_frameworks/index.md | 6 +- .../first_steps/website_security/index.md | 12 +- .../index.md | 8 +- .../react_components/index.md | 6 +- .../react_getting_started/index.md | 6 +- .../react_todo_list_beginning/index.md | 2 +- .../svelte_getting_started/index.md | 14 +- .../vue_getting_started/index.md | 14 +- .../accessibility/index.md | 30 +- .../automated_testing/index.md | 18 +- .../feature_detection/index.md | 12 +- .../html_and_css/index.md | 10 +- .../introduction/index.md | 6 +- .../cross_browser_testing/javascript/index.md | 34 +- .../testing_strategies/index.md | 24 +- .../your_own_automation_environment/index.md | 20 +- .../learn/tools_and_testing/github/index.md | 8 +- files/ja/learn/tools_and_testing/index.md | 4 +- .../understanding_client-side_tools/index.md | 2 +- 194 files changed, 1491 insertions(+), 832 deletions(-) create mode 100644 files/ja/learn/javascript/asynchronous/introducing_workers/index.md create mode 100644 files/ja/learn/javascript/asynchronous/promises/index.md diff --git a/files/ja/learn/accessibility/accessibility_troubleshooting/index.md b/files/ja/learn/accessibility/accessibility_troubleshooting/index.md index 589a1f32efc5f8..0a9b76cc98970f 100644 --- a/files/ja/learn/accessibility/accessibility_troubleshooting/index.md +++ b/files/ja/learn/accessibility/accessibility_troubleshooting/index.md @@ -23,7 +23,7 @@ slug: Learn/Accessibility/Accessibility_troubleshooting この評価の開始時点であなたがサイトを表示したとき、いくつかの違いや問題を見つけることでしょう。これは主にマークアップ中の違いが原因であり、CSS が正しく適用されずにスタイリングの問題を引き起こしています。心配しないでください。以降の節でそれらの問題を修正します！ -> **Note:** もし行き詰まって助けを求める場合 — ページ最下部の [Assessment or further help](#assessment_or_further_help) セクションを見てください。 +> **メモ:** もし行き詰まって助けを求める場合 — ページ最下部の [Assessment or further help](#assessment_or_further_help) セクションを見てください。 ## プロジェクトの概要 @@ -39,7 +39,7 @@ slug: Learn/Accessibility/Accessibility_troubleshooting 2. スクリーンリーダーのユーザーがナビゲートしやすいように、記事のテキストを変更できますか？ 3. サイトのナビゲーションメニュー ( `
` で囲まれた部分) は正しい HTML5 セマンティック要素の中に入れることでよりアクセシブルになったかもしれません。どれを変更する必要がありますか？変更してください。 -> **Note:** タグをスタイル付けする CSS ルールセレクターは、セマンティック見出しのために適切に変更する必要があります。パラグラフ要素を加えると、スタイルもより良く見えることに気がつくでしょう。 +> **メモ:** タグをスタイル付けする CSS ルールセレクターは、セマンティック見出しのために適切に変更する必要があります。パラグラフ要素を加えると、スタイルもより良く見えることに気がつくでしょう。 ### 画像 diff --git a/files/ja/learn/accessibility/css_and_javascript/index.md b/files/ja/learn/accessibility/css_and_javascript/index.md index d29ea634f6b7b9..cb400958836e5c 100644 --- a/files/ja/learn/accessibility/css_and_javascript/index.md +++ b/files/ja/learn/accessibility/css_and_javascript/index.md @@ -166,7 +166,7 @@ a:active { 問題を起こさない程度に十分にコントラストが大きいかどうかを調べる簡単な方法があります。前景色と背景色を入力して調べることができる、コントラストのチェック用ツールが、オンライン上にいくつもあります。たとえば、WebAIM の [Color Contrast Checker](http://webaim.org/resources/contrastchecker/) は、簡単に使えますし、色のコントラストに関して WCAG の基準に適合するためには何を行えば良いのかについて、説明もしてくれます。 -> **Note:** コントラスト比を高くすることによって、光沢のある画面のスマートフォンまたはタブレットを使う人が陽光のような明るい環境でページを読みやすくもなるでしょう。 +> **メモ:** コントラスト比を高くすることによって、光沢のある画面のスマートフォンまたはタブレットを使う人が陽光のような明るい環境でページを読みやすくもなるでしょう。 もう一つ別のコツは、標識や案内について色だけに頼らないことです。というのも、色だけに頼るのは、色が見えない人々にとってまったく良くないからです。必須のフォーム・フィールドを赤でマークする代わりに、たとえば、アスタリスクと赤でマークしましょう。 @@ -180,7 +180,7 @@ a:active { 一方で、 {{cssxref("visibility")}}`:hidden` も {{cssxref("display")}}`:none` も、スクリーン・リーダーからコンテンツを隠してしまうので、使うべきではありません。もちろん、スクリーン・リーダーからこのコンテンツを隠したいと思う然るべき理由がない限りは、ということですが。 -> **Note:** [Invisible Content Just for Screen Reader Users](http://webaim.org/techniques/css/invisiblecontent/) には、この話題をめぐる多くのさらに有用な詳細があります。 +> **メモ:** [Invisible Content Just for Screen Reader Users](http://webaim.org/techniques/css/invisiblecontent/) には、この話題をめぐる多くのさらに有用な詳細があります。 ### ユーザーがスタイルを上書きできることを受け入れる @@ -227,7 +227,7 @@ JavaScript に頼りすぎると、しばしば問題が起きます。ときど この種のフォーム検査はひかえめです。JavaScript が利用できなくても、依然としてまったく申し分なくフォームを使えます。それに、分別のあるフォームの実装なら何であれ、サーバーサイドの検査も作動させておくことでしょう。なぜなら、悪意のあるユーザーがクライアントサイドの検査を (たとえば、ブラウザーで JavaScript をオフにしておくことによって) 迂回することは、あまりに容易だからです。クライアントサイドの検査は、それでも実際に、エラーを報告するためには有用なのです。ユーザーは、自分のおかした間違いについて、サーバーまでのラウンドトリップおよびページリロードを待つ必要なしに、すぐに知ることができます。これは使い勝手の上での明らかな利点です。 -> **Note:** この単純なデモではサーバーサイドの検査を実装しませんでした。 +> **メモ:** この単純なデモではサーバーサイドの検査を実装しませんでした。 このフォーム検査も、とてもアクセシブルにしておきました。{{htmlelement("label")}} 要素を用いて、フォーム・ラベルがそのラベルの入力欄に曖昧な点なしに紐付けられるようにして、それによってスクリーン・リーダーがラベルを一緒に読み上げられるようにしました。 @@ -257,7 +257,7 @@ function validate(e) { } ``` -> **Note:** この例では、絶対的な位置指定を用いてエラーメッセージ・ボックスを隠したり見せたりしています。visibility や display などの他の方法を使っているわけではありません。なぜなら、絶対的な位置指定は、スクリーン・リーダーがコンテンツを読めるようにしておくことを妨げないからです。 +> **メモ:** この例では、絶対的な位置指定を用いてエラーメッセージ・ボックスを隠したり見せたりしています。visibility や display などの他の方法を使っているわけではありません。なぜなら、絶対的な位置指定は、スクリーン・リーダーがコンテンツを読めるようにしておくことを妨げないからです。 現実のフォーム検査は、これよりもっと複雑でしょう。入力された名前が実際に名前のようであることを確認したいかもしれませんし、入力された年齢が実際に数であり、かつ現実的である (たとえば、負数ではなく、4 桁でもない、など) ということを確認したいかもしれません。ここでは、各入力フィールドに値が入れられたことを確認する (`if(testItem.input.value === '')` という) 簡単な検査を実装しただけです。 @@ -281,7 +281,7 @@ function createLink(testItem) { 各リンクは二つの役割を果たします。つまり、何のエラーなのかを教えてくれますし、さらに、そのリンクをクリックする / アクティブにすると問題の入力要素へ直接ジャンプして入力を訂正できるようになっています。 -> **Note:** この例の `focus()` の部分は少し手が込んでいます。Chrome と Edge (と、IE の新しいバージョン) は、リンクがクリックされたときに要素にフォーカスを当てるので、`onclick`/`focus()` ブロックを必要としません。Safari はリンク自体とともにフォーム要素をハイライトするだけであり、そのため、実際にフォーム要素にフォーカスを当てるには `onclick`/`focus()` ブロックが必要です。Firefox は、こうした状況において入力要素に適切にフォーカスを当てることはまったくありません。よって、Firefox のユーザーは、現時点ではこの `onclick`/`focus()` ブロックの利益を享受できません (それ以外のすべてはうまく機能するのですが)。Firefox の問題はすぐに修正されるはずです。というのも、他のブラウザーと同等のふるまいを Firefox にさせるための作業が、今なされている最中ですから ({{bug(277178)}} を参照). +> **メモ:** この例の `focus()` の部分は少し手が込んでいます。Chrome と Edge (と、IE の新しいバージョン) は、リンクがクリックされたときに要素にフォーカスを当てるので、`onclick`/`focus()` ブロックを必要としません。Safari はリンク自体とともにフォーム要素をハイライトするだけであり、そのため、実際にフォーム要素にフォーカスを当てるには `onclick`/`focus()` ブロックが必要です。Firefox は、こうした状況において入力要素に適切にフォーカスを当てることはまったくありません。よって、Firefox のユーザーは、現時点ではこの `onclick`/`focus()` ブロックの利益を享受できません (それ以外のすべてはうまく機能するのですが)。Firefox の問題はすぐに修正されるはずです。というのも、他のブラウザーと同等のふるまいを Firefox にさせるための作業が、今なされている最中ですから ({{bug(277178)}} を参照). さらに、ソース順における先頭に `errorField` を置いてあります (CSS を使って、UI 上では別のところに配置してありますが)。これが意味することは、ユーザーが、ページの最初に戻ることで、自分のフォーム送信でまさに何が間違っているのかも分かるし、問題の入力要素にも行ける、ということです。 @@ -296,9 +296,9 @@ function createLink(testItem) { もっと詳細に [WAI-ARIA](/ja/docs/Learn/Accessibility/WAI-ARIA_basics) を扱う次の記事で、これらの属性について説明します。 -> **Note:** HTML5 フォームには `required` 属性や `min`/`minlength` 属性や `max`/`maxlength` 属性のような組み込みの検査の仕組みがあること (より詳しくは、{{htmlelement("input")}} 要素のリファレンスを参照) について考える読者もおそらくいることでしょう。このデモでは、結局これらの属性は使いませんでした。なぜなら、これらの属性についてのクロスブラウザー・サポートが当てにならないからです (たとえば IE10 以上のみでのサポートだったり、Safari ではサポートされていなかったりします)。 +> **メモ:** HTML5 フォームには `required` 属性や `min`/`minlength` 属性や `max`/`maxlength` 属性のような組み込みの検査の仕組みがあること (より詳しくは、{{htmlelement("input")}} 要素のリファレンスを参照) について考える読者もおそらくいることでしょう。このデモでは、結局これらの属性は使いませんでした。なぜなら、これらの属性についてのクロスブラウザー・サポートが当てにならないからです (たとえば IE10 以上のみでのサポートだったり、Safari ではサポートされていなかったりします)。 -> **Note:** WebAIM の [Usable and Accessible Form Validation and Error Recovery](http://webaim.org/techniques/formvalidation/) は、アクセシブルなフォーム検査についてのさらに有用な情報をいくつか教えてくれます。 +> **メモ:** WebAIM の [Usable and Accessible Form Validation and Error Recovery](http://webaim.org/techniques/formvalidation/) は、アクセシブルなフォーム検査についてのさらに有用な情報をいくつか教えてくれます。 ### JavaScript のアクセシビリティのその他の問題 diff --git a/files/ja/learn/accessibility/html/index.md b/files/ja/learn/accessibility/html/index.md index 65b9f8217db203..bbc1617a56860a 100644 --- a/files/ja/learn/accessibility/html/index.md +++ b/files/ja/learn/accessibility/html/index.md @@ -37,7 +37,7 @@ HTML の `