From 6ef1fa4618e08426b874529619a66adbd3d1fcf0 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 12:07:59 +0100 Subject: unslug ja: move --- .../ja/orphaned/learn/how_to_contribute/index.html | 86 ++++++++++++++++++++++ .../learn/html/forms/html5_updates/index.html | 46 ++++++++++++ 2 files changed, 132 insertions(+) create mode 100644 files/ja/orphaned/learn/how_to_contribute/index.html create mode 100644 files/ja/orphaned/learn/html/forms/html5_updates/index.html (limited to 'files/ja/orphaned/learn') diff --git a/files/ja/orphaned/learn/how_to_contribute/index.html b/files/ja/orphaned/learn/how_to_contribute/index.html new file mode 100644 index 0000000000..bd269dd210 --- /dev/null +++ b/files/ja/orphaned/learn/how_to_contribute/index.html @@ -0,0 +1,86 @@ +--- +title: MDN の学習エリアに貢献するには +slug: Learn/How_to_contribute +tags: + - Beginner + - Contribute + - Documentation + - Guide + - Learn + - MDN Meta + - 'l10n:priority' +translation_of: Learn/How_to_contribute +--- +
{{LearnSidebar}}
+ +

あなたがこのページに初めて、あるいはたくさん検索した末に辿り着いたのなら、それはきっとあなたが MDN の学習エリアへの貢献に興味を持って下さったからでしょう。素晴らしいことです！

+ +

このページでは、 MDN の学習コンテンツの改良に協力し始めるのに必要となる全てが見つかるでしょう。できることはたくさんあって、それはあなたがどれくらい時間を使えるか、初心者かウェブ開発者か教師かによって決まります。

+ +
+

メモ: 学習エリアの記事を書くためのガイドは、ウェブを学習する人に役立つ記事の書き方にあります。

+
+ +

特定のタスクを探す

+ +

学習エリアに貢献する共通の方法は、記事を読み、誤字を直し、改良を提案することです。GitHub repoへのサンプル追加も、何が必要か聞きたいと思って連絡頂くのも歓迎です。

+ +

新しいことを学習するときに、貢献することは楽しめる良い方法です。道に迷った気になったり、質問があった場合は、Learning Area Discourse thread や IRC channel いずれも英語ベース (詳しくはページ最下部を見てください)。Chris Mills が Learning Area (学習エリア) のトピックドライバーです — 彼に直接 ping してもいいでしょう。

+ +

下記の節では一般的なアイデアとして、やることの種類を挙げています。

+ +

初心者の方なら

+ +

すばらしい！初心者は学習エリアの中身にフィードバックを作るのに重要かつ貴重です。あなたにはこの記事のターゲット読者の一員で、われわれのチームの貴重なメンバーになりうるという独特の視点があります。実際に、記事を何かの学習に使ってつまったり、誤解を招く記事を見かけた場合、自分で修正するか、または我々が確実に修正できるように問題点を連絡することができます。

+ +

次のように、貢献できるいくつかの方法があります:

+ +
+
記事にタグを追加する (5分)
+
MDN のコンテンツをタグ付けするのは、 MDN に協力する最も簡単な方法です。タグによって状況にあわせた機能を提供できるようになるため、タグ付けはとても意味ある貢献です。タグ付けを始める前に、用語集の記事と学習記事の一覧をご覧ください。
+
用語集の記事を読んでレビューする (5分)
+
コンテンツを初心者の目線で見てもらう必要があります。用語集の記事に分かりにくい箇所があれば改善が必要なため、気軽に変更してください。自分には必要なスキルが無いと感じたら、私たちのメーリングリストに連絡してください。
+
用語集の記事を書く (20分)
+
これは新しいことを学ぶ最良の方法です。理解したい概念を選び、それについて学んだら、用語集の記事を書きましょう。何かを他人に説明することは、頭の中で知識を「定着」させ、物事を自分自身で良く理解できるようになり、さらに他人のために役立ちます。みんなが得をします！
+
学習記事を読んでレビューする (2時間)
+
これは用語集の記事のレビューとよく似ています（上記参照）。こういった記事は通常かなり長いため、より時間を要するだけです。
+
+ +

ウェブ開発者なら

+ +

素敵です！あなたの技術スキルは、初心者向けの技術的に正確なコンテンツを提供するために、まさに我々が必要としているものです。ここは MDN の特定の箇所としてウェブの学習専用であり、説明はできるだけ簡潔であり、簡潔すぎて役立たないのは避けないといけません。過度に正確であることよりも、理解できることがもっと重要です。

+ +
+
用語集の記事を読んでレビューする (5分)
+
ウェブ開発者であるあなたには、私たちのコンテンツが複雑になりすぎずに技術的に正確であるかを確認していただく必要があります。必要に応じて気軽に変更を加えてください。編集の前に内容を議論したい場合は、私たちのメーリングリストまたは IRC channelでコンタクトしてください。
+
用語集の記事を書く (20分)
+
技術的な専門用語を明確にすることは、学習するのと、技術的に正確かつシンプルであるためのとても良い方法です。初心者からは感謝されるでしょう。注目すべき未定義の用語がたくさんあります。都合が良いものを選んでください。
+
学習記事を読んでレビューする (2時間)
+
これは用語集の記事のレビュー（上記）と同じことです。この記事は少し長い時間がかかるだけです。
+
新しい学習記事を書く (4時間以上)
+
MDN には、ウェブ技術（HTML, CSS, JavaScriptなど）についてのシンプルで直言的な記事が欠けています。また MDN にはレビューや作り直しをするべき古いコンテンツもあります。あなたのスキルの限界までふりしぼって、ウェブ技術が初心者でも使えるようにしてください。
+
練習、コードサンプル、インタラクティブな学習ツールの作成 (?時間)
+
全ての学習記事は「アクティブラーニング」と呼ぶ記事を必要としています。その理由は人は自分で何かやってみるのが学ぶのに最良だからです。この素材は、ユーザーが記事に述べられる概念を適用・操作するのを助ける、練習やインタラクティブコンテンツです。アクティブラーニングのコンテンツを作るには多数の方法があり、 JSFiddle や同等品でコードサンプルを作ることから、Thimble で完全にハック可能なインタラクティブコンテンツを作ることまであります。創造性を解き放って！
+
+ +

教師なら

+ +

MDN は技術的な卓越性において長い歴史がありますが、新人に概念を教える最良の方法についての理解は十分ではありません。ここは教師・教育者であるあなたを必要とするところです。私たちの教材が読者にとって優れた、実践的な学びの道筋を提供できるよう手助けできます。

+ +
+
用語集の記事を読んでレビューする (15分)
+
用語集の記事を確認して、必要に応じて気軽に変更を加えてください。編集の前に内容を議論したい場合は私たちのメーリングリストまたは IRC channelでコンタクトしてください
+
用語集の記事を書く (1時間)
+
用語集にて、明確でシンプルな言葉の定義と、概念の基本的な説明は、初心者の要求を満たすのに重要です。教育者としての経験がすばらしい用語集の記事の作成に役立ちます。注目すべき未定義の用語がたくさんあります。都合が良いものを選んでください。
+
記事のイラストや図を描く (1時間)
+
ご存知のように、イラストはあらゆる学習コンテンツの中で有益な部分です。これは MDN でよく不足しているもので、あなたのスキルがそのエリアを違ったものにします。図示コンテンツが不足している記事を確認して、絵を作りたいものを選びます。
+
学習記事を読んでレビューする (2時間)
+
これは用語集の記事（上記）のレビューと同じことです。この記事は少し長い時間がかかるだけです。
+
新しい学習記事を書く (4時間)
+
ウェブのエコシステムとその周りの機能的なトピックについてのシンプルで直言的な記事が必要です。学習記事では知るべきことを全て網羅するよりも、教育的である必要があるため、何をどのように網羅すべきかを知っているあなたの経験は良い資産になるでしょう。
+
練習、クイズ、インタラクティブな学習ツールの作成 (?時間)
+
全ての学習記事は「アクティブラーニング」と呼ぶ記事を必要としています。その理由は人は自分で何かやってみるのが学ぶのに最良だからです。この素材は、ユーザーが記事に述べられる概念を適用・操作するのを助ける、練習やインタラクティブコンテンツです。アクティブラーニングのコンテンツを作るには多数の方法があり、クイズを作ることから、Thimble で完全にハック可能なインタラクティブコンテンツを作ることまであります。創造性を解き放って！
+
+
学習の進路を作る (?時間)
+
進歩的で理解できるチュートリアルを提供するため、コンテンツを学習進路に形付ける必要があります。既存のコンテンツを集めて、学習記事を作成するのに何がたりないか理解するのに良い方法です。
+
diff --git a/files/ja/orphaned/learn/html/forms/html5_updates/index.html b/files/ja/orphaned/learn/html/forms/html5_updates/index.html new file mode 100644 index 0000000000..abf99e2af7 --- /dev/null +++ b/files/ja/orphaned/learn/html/forms/html5_updates/index.html @@ -0,0 +1,46 @@ +--- +title: Forms in HTML5 +slug: Web/HTML/Forms_in_HTML +translation_of: Learn/HTML/Forms/HTML5_updates +--- +

{{ gecko_minversion_header("2") }}

+

HTML5 のフォーム関連要素/属性は HTML4 よりも幅広いマークアップを提供し、また HTML4 時代に必要とされた長たらしいスクリプトやスタイルシートを書く手間を省いてくれます。HTML5 のフォーム機能は、Web サイトごとに異なっている入力へのフィードバックに今より優れた一貫性をもたらし、より良いユーザエクスペリエンスを提供します。また、スクリプトを無効化したブラウザでも同様の体験を提供します。

+

このページでは、Gecko/Firefox がサポートするフォーム機能のうち、新しいもの、もしくは変更されたものについて紹介します。

+

<input> 要素

+

{{ HTMLElement("input") }} 要素の {{ htmlattrxref("type", "input") }} 属性に新しい値が追加されました。

+ +

{{ HTMLElement("input") }} 要素には新しい属性も追加されています。

+

<form> 要素

+

{{ HTMLElement("form") }} 要素に新しい属性が追加されました。

+ +

<datalist> 要素

+

{{ HTMLElement("datalist") }} 要素は {{ HTMLElement("option") }} 要素を内容に持つ、{{ HTMLElement("input") }} フィールドのサジェストを定義します。

+

{{ HTMLElement("input") }} 要素の {{ htmlattrxref("list", "input") }} 属性から、特定の {{ HTMLElement("datalist") }} 要素を指定します。

+

<output> 要素

+

{{ HTMLElement("output") }} 要素は計算結果を表示します。

+

{{ htmlattrxref("for", "output") }} 属性を使って、output 要素と計算に利用する文書内の他の要素 (入力や変数など) とを関連づけることができます。{{ htmlattrxref("for", "output") }} 属性の値は計算に利用する要素の ID を空白で区切り入力します。

+

{{ non-standard_inline() }} Gecko 2.0 では {{ HTMLElement("output") }} 要素に任意のフォーム検証とエラーメッセージを定義でき、また {{ Cssxref(":invalid") }}, {{ Cssxref(":valid") }}, {{ Cssxref(":-moz-ui-invalid") }}, {{ Cssxref(":-moz-ui-valid") }} といった CSS 擬似クラスを適用することができます。これにより、特定の入力値ではないがビジネスルールに抵触するような計算結果の制約 (例: 「パーセンテージの合計が 100 を超えてはいけない」) を検証することができます。

+

placeholder 属性

+

{{ HTMLElement("input") }}, {{ HTMLElement("textarea") }} 要素の {{ htmlattrxref("placeholder", "input") }} 属性は、フィールドに入力できる値のヒントを提示します。プレースホルダに指定するテキストには CR や LF を記述することはできません。

+

autofocus 属性

+

{{ htmlattrxref("autofocus", "input") }} 属性はページのロード時に自動的にフォーカスのあたるべきフォームコントロールを指定します。ユーザーの行動が優先されるため、すでに別のコントロールに入力している場合などには自動的にフォーカスされません。autofocus 属性を与えられる要素は文書中でただ 1 つです。この属性は真偽値属性であり、{{ HTMLElement("input") }}, {{ HTMLElement("button") }}, {{ HTMLElement("select") }}, {{ HTMLElement("textarea") }} 要素に指定可能です。ただし、{{ htmlattrxref("autofocus", "input") }} 要素の {{ htmlattrxref("type", "input") }} 属性が hidden を値にもつ場合、この属性を利用することができません (つまり、隠れたコントロールへ自動的にフォーカスさせることはできません)。

+

label.control DOM プロパティ

+

HTMLLabelElement DOM インターフェースは HTML の {{ HTMLElement("label") }} 要素が持つ属性に加えて、新しいプロパティを備えています。control プロパティは、ラベルに結びついたコントロールを返します。つまり、このラベルがどの要素のコントロールなのかを知ることができます。コントロールは要素の {{ htmlattrxref("for", "label") }} 属性もしくは要素の最初の子孫コントロール要素から決定されます。

+

フォーム検証

+

HTML5 はフォームに入力された値をクライアントサイドで検証するための構文及び API を提供しています。この検証機能はサーバーサイドの検証を置き換えるものではありません。セキュリティやデータの整合性といった点からサーバーサイドの検証は必要です。しかし、入力したデータについてユーザーにすぐフィードバックできるため、クライアントサイドの検証はより良いユーザーエクスペリエンスを提供します。

+

{{ HTMLElement("input") }} 要素に title 属性が指定されている場合、その内容が検証に失敗した際のエラーメッセージとして表示されます。属性値が空の場合、ツールチップは表示されません。属性が指定されていない場合は、標準の検証メッセージ ({{ htmlattrxref("x-moz-errormessage") }} 属性もしくは setCustomValidity() メソッドで指定) が使用されます。

+
Note: フォームの検証はフォーム中の {{ HTMLElement("button") }} 要素ではサポートされていません。フォームの妥当状態と連動するスタイルをボタンに与えたい場合は {{ cssxref(":-moz-submit-invalid") }} 擬似クラスを利用してください。
+

フォーム検証の HTML 構文

+

次の HTML5 構文によって、フォームに入力する内容に制約をかけることができます。

+ +

{{ HTMLElement("form") }} 要素の {{ htmlattrxref("novalidate", "form") }} 属性、{{ HTMLElement("button") }} 要素の {{ htmlattrxref("formnovalidate", "button") }} 属性、{{ htmlattrxref("type", "input") }} に submit もしくは image を持つ {{ HTMLElement("input") }} 要素の {{ htmlattrxref("formnovalidate", "input") }} 属性を使用すれば、検証を行わないようにすることも可能です。これらの属性は、フォーム送信時に検証を行わないことを示します。

+

フォーム検証 API

+

次の DOM プロパティとメソッドにより、クライアントサイドのスクリプトから検証をかけることが可能です。

+ +

{{ languages({"en": "en/HTML/HTML5/Forms_in_HTML5"}) }}

+

{{ HTML5ArticleTOC() }}

-- cgit v1.2.3-54-g00ecf