diff options
author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2021-05-01 01:26:03 +0900 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-05-01 01:26:03 +0900 |
commit | b76d47d75c13eb067cfb11b535677c3bd0a23b16 (patch) | |
tree | e87529a077f214508825cd615aaadcbb77a675d0 /files/ja/web/html | |
parent | 21e4ac24f8ae3253aa753e3376d00b58f96fb431 (diff) | |
download | translated-content-b76d47d75c13eb067cfb11b535677c3bd0a23b16.tar.gz translated-content-b76d47d75c13eb067cfb11b535677c3bd0a23b16.tar.bz2 translated-content-b76d47d75c13eb067cfb11b535677c3bd0a23b16.zip |
20210418-Web/HTML/Element/menu (#559)
2021/03/27 時点の英語版に同期
Diffstat (limited to 'files/ja/web/html')
-rw-r--r-- | files/ja/web/html/element/menu/index.html | 96 |
1 files changed, 54 insertions, 42 deletions
diff --git a/files/ja/web/html/element/menu/index.html b/files/ja/web/html/element/menu/index.html index 815207ede2..9a12563561 100644 --- a/files/ja/web/html/element/menu/index.html +++ b/files/ja/web/html/element/menu/index.html @@ -2,37 +2,47 @@ title: <menu> slug: Web/HTML/Element/menu tags: + - Element + - Experimental - HTML - - HTML 対話型コンテンツ - - 'HTML:フローコンテンツ' - - 'HTML:知覚可能コンテンツ' + - HTML interactive elements + - Navigation - Reference + - Site Navigation + - UI + - UX + - User Interface + - User experience - Web - - ウェブ + - menu + - menus + - HTML 対話型コンテンツ + - HTML:フローコンテンツ + - HTML:知覚可能コンテンツ - サイトナビゲーション - メニュー - ユーザーインターフェイス - 要素 translation_of: Web/HTML/Element/menu --- -<div>{{HTMLRef}}{{SeeCompatTable}}</div> +<p>{{HTMLRef}}{{SeeCompatTable}}</p> -<p><strong>HTML の <code><menu></code> 要素</strong>は、ユーザーが実行またはアクティブ化可能なコマンドのグループを表します。これはスクリーンの上部にあるリストメニューや、ボタンを押したときにボタンの下部に現れるような<a href="/en-US/docs/Web/HTML/Element/menu#Context_menu">コンテキストメニュー</a>を含みます。</p> +<p><strong>HTML の <code><menu></code> 要素</strong>は、ユーザーが実行またはアクティブ化できるコマンドのグループを表します。これは画面の上部に現れるリストメニューと、ボタンを押したときにその下部付近に現れるような<a href="/ja/docs/Web/HTML/Element/menu#context_menu">コンテキストメニュー</a>の両方を含みます。</p> <table class="properties"> <tbody> <tr> - <th scope="row"><a href="/ja/docs/Web/HTML/Content_categories">コンテンツカテゴリ</a></th> + <th scope="row"><a href="/ja/docs/Web/Guide/HTML/Content_categories">コンテンツカテゴリー</a></th> <td> - <p><a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a>。要素の子が1個以上の {{HTMLElement("li")}} 要素を含んでいる場合は<a href="/ja/docs/Web/Guide/HTML/Content_categories#Palpable_content">知覚可能コンテンツ</a>。</p> + <p><a href="/ja/docs/Web/Guide/HTML/Content_categories#flow_content">フローコンテンツ</a>。この要素の子に 1 個以上の {{HTMLElement("li")}} 要素がある場合は<a href="/ja/docs/Web/Guide/HTML/Content_categories#palpable_content">知覚可能コンテンツ</a>。</p> </td> </tr> <tr> <th scope="row">許可されている内容</th> <td> - <p>要素が<em>リストメニュー</em>状態である場合: <a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a>または0個以上の {{HTMLElement("li")}}, {{HTMLElement("script")}}, {{HTMLElement("template")}}。 (<em>リストメニュー</em>は、親要素が<em>コンテキストメニュー</em>状態の {{HTMLElement("menu")}} でない場合の既定の状態です。)</p> + <p>要素が<em>リストメニュー</em>状態である場合: <a href="/ja/docs/Web/Guide/HTML/Content_categories#flow_content">フローコンテンツ</a>または 0 個以上の {{HTMLElement("li")}}, {{HTMLElement("script")}}, {{HTMLElement("template")}}。 (<em>リストメニュー</em>は、親要素が<em>コンテキストメニュー</em>状態の {{HTMLElement("menu")}} でない場合の既定の状態です。)</p> - <p>要素が<em>コンテキストメニュー</em>状態である場合は、任意の順序で、0個以上の {{HTMLElement("menu")}} (コンテキストメニュー状態に限る), {{HTMLElement("menuitem")}}, {{HTMLElement("hr")}}, {{HTMLElement("script")}}, {{HTMLElement("template")}}。</p> + <p>要素が<em>コンテキストメニュー</em>状態である場合: 任意の順序で、 0 個以上の {{HTMLElement("menu")}} (コンテキストメニュー状態に限る), {{HTMLElement("menuitem")}}, {{HTMLElement("hr")}}, {{HTMLElement("script")}}, {{HTMLElement("template")}}。</p> </td> </tr> <tr> @@ -41,11 +51,15 @@ translation_of: Web/HTML/Element/menu </tr> <tr> <th scope="row">許可されている親要素</th> - <td><a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a>を受け入れるすべての要素</td> + <td><a href="/ja/docs/Web/Guide/HTML/Content_categories#flow_content">フローコンテンツ</a>を受け入れるすべての要素</td> + </tr> + <tr> + <th scope="row">暗黙の ARIA ロール</th> + <td><code><a href="/ja/docs/Web/Accessibility/ARIA/Roles/List_role">list</a></code></td> </tr> <tr> <th scope="row">許可されている ARIA ロール</th> - <td>なし</td> + <td>{{ARIARole("directory")}}, {{ARIARole("group")}}, <code><a href="/ja/docs/Web/Accessibility/ARIA/Roles/listbox_role">listbox</a></code>, {{ARIARole("menu")}}, {{ARIARole("menubar")}}, {{ARIARole("none")}}, {{ARIARole("presentation")}}, {{ARIARole("radiogroup")}}, {{ARIARole("tablist")}}, {{ARIARole("toolbar")}}, {{ARIARole("tree")}}</td> </tr> <tr> <th scope="row">DOM インターフェイス</th> @@ -54,37 +68,37 @@ translation_of: Web/HTML/Element/menu </tbody> </table> -<h2 id="Attributes" name="Attributes">属性</h2> +<h2 id="Attributes">属性</h2> -<p>この要素には<a href="/ja/docs/Web/HTML/Global_attributes" title="HTML/Global attributes">グローバル属性</a>があります。</p> +<p>この要素には<a href="/ja/docs/Web/HTML/Global_attributes">グローバル属性</a>があります。</p> <dl> <dt>{{HTMLAttrDef("label")}} {{Deprecated_inline}}</dt> - <dd>ユーザーに対して表示する、メニューの名称です。入れ子のメニューで、サブメニューへアクセスできるようにするためにラベルを与えます。親要素が<em>コンテキストメニュー</em>状態の {{HTMLElement("menu")}} である場合に限り、必須です。</dd> + <dd>ユーザーに対して表示されるメニューの名称です。入れ子のメニューの中で、サブメニューへアクセスするためのラベルを提供するために使用されます。親要素が {{HTMLElement("menu")}} で<em>コンテキストメニュー</em>状態である場合に限り、指定する必要があります。</dd> <dt>{{HTMLAttrDef("type")}}</dt> - <dd>この属性は定義済みのメニューの種類を示すものであり、以下2つの値のいずれかを指定します。 + <dd>この属性は定義済みのメニューの種類を示すものであり、以下 2 つの値のいずれかを指定します。 <ul> - <li><code>context</code> {{Deprecated_inline}} : <em>ポップアップメニュー</em>状態であり、他の要素を経由してアクティブになるコマンドのグループを表します。 {{HTMLElement("button")}} 要素の {{HTMLAttrxRef("menu", "button")}} 属性や、 <a href="/ja/docs/Web/HTML/Global_attributes#attr-contextmenu"><code>contextmenu</code></a> 属性を持つ要素を経由することが考えられます。 <code><menu></code> 要素が別の menu 要素の入れ子になっているとき、親要素がすでにこの状態であれば、子要素で値が指定されていない場合の既定値になります。</li> - <li><code>toolbar</code>: <em>ツールバー</em>状態であり、ユーザーと対話するための一連のコマンドを表します。これは {{HTMLElement("li")}} が並んだ番号なしリストの形か、子要素に <code><li></code> を含まない場合は、利用できるコマンドを記述した<a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a>です。属性が指定されていない場合の既定値です。</li> + <li><code>context</code> {{Deprecated_inline}} : 他の要素を介して起動されるコマンドのグループを表す<em>ポップアップメニュー</em>状態を表します。これは {{HTMLElement("button")}} 要素の {{HTMLAttrxRef("menu", "button")}} 属性で参照されるボタンメニューや、 <a href="/ja/docs/Web/HTML/Global_attributes#attr-contextmenu"><code>contextmenu</code></a> 属性のある要素のコンテキストメニューである可能性があります。この値はこの属性がなく、その親要素も <code><menu></code> であった場合の既定値です。</li> + <li><code>toolbar</code>: <em>ツールバー</em>状態であり、ユーザーと対話するための一連のコマンドから成るツールバーを表します。これは {{HTMLElement("li")}} の番号なしリストの形か、子要素に <code><li></code> を含まない場合は、利用できるコマンドを記述した<a href="/ja/docs/Web/Guide/HTML/Content_categories#flow_content">フローコンテンツ</a>です。この値はこの属性が指定されていない場合の既定値です。</li> </ul> </dd> </dl> -<h2 id="Usage_notes" name="Usage_notes">使用上の注意</h2> +<h2 id="Usage_notes">使用上の注意</h2> -<p>{{HTMLElement("menu")}} 要素と {{HTMLElement("ul")}} 要素はともに順序なしリストの項目を表すものですが、 {{HTMLElement("ul")}} は主に項目の表示を目的とするのに対し、 {{HTMLElement("menu")}} 要素は操作を行うための対話型の項目を含めるためのものです。</p> +<p>{{HTMLElement("menu")}} 要素と {{HTMLElement("ul")}} 要素はともに順序なしリストの項目を表すものです。主な違いは、 {{HTMLElement("ul")}} は主に項目の表示を目的とするのに対し、 {{HTMLElement("menu")}} 要素は操作を行うための対話型の項目のためのものです。</p> -<p>HTML メニューは、コンテキストメニュー(一般的に、別の要素を右クリックすると表示される)またはツールバーを作成するために使用できます。</p> +<p>HTML メニューは、コンテキストメニュー (一般的に、別の要素を右クリックすると表示される) またはツールバーを作成するために使用することができます。</p> -<p><strong>{{anch("Context menu", "コンテキストメニュー")}}</strong>は、「メニューで選択可能な項目を表す {{HTMLElement("menuitem")}} 要素」「メニュー内のサブメニューを表す <code><menu></code> 要素」「メニューの内容をセクションに分けるセパレーター行を表す {{HTMLElement("hr")}} 要素」を包含する <code><menu></code> 要素で構成されます。. コンテキストメニューは、関連付ける要素の {{HTMLAttrxRef("contextmenu")}} 属性、または {{anch("Button menu", "ボタンでアクティブにするメニュー")}} であれば {{HTMLElement("button")}} 要素の {{HTMLAttrxRef("menu", "button")}} 属性を使用して、メニューをアクティブ化する要素に紐づけます。</p> +<p><strong>{{anch("Context menu", "コンテキストメニュー")}}</strong>は、 <code><menu></code> 要素の中にメニューで選択可能な項目を表す {{HTMLElement("menuitem")}} 要素、メニュー内のサブメニューを表す <code><menu></code> 要素、メニューの内容をセクションに分けるセパレーター行を表す {{HTMLElement("hr")}} 要素が含まれたもので構成されます。 コンテキストメニューは、関連付ける要素の {{HTMLAttrxRef("contextmenu")}} 属性、または{{anch("Button menu", "ボタンでアクティブにするメニュー")}}であれば {{HTMLElement("button")}} 要素の {{HTMLAttrxRef("menu", "button")}} 属性を使用して、メニューをアクティブ化する要素に紐づけます。</p> -<p><strong>{{anch("Toolbar", "ツールバーメニュー")}}</strong> は、以下のいずれかをコンテンツにした <code><menu></code> 要素で構成されます: {{HTMLElement("li")}} 要素で表した項目の順不同リスト (それぞれの項目が、ユーザーが利用できるコマンドやオプションを表します)。または、(<code><li></code> 要素がない場合) 使用なコマンドやオプションを表す <a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a>。</p> +<p><strong>{{anch("Toolbar", "ツールバーメニュー")}}</strong> は、 <code><menu></code> 要素の中身が 2 通りのうちの一方で記述されたもので構成されます。 {{HTMLElement("li")}} 要素で表した項目の順不同リスト (それぞれの項目が、ユーザーが利用できるコマンドやオプションを表す) または、 (<code><li></code> 要素がない場合) 使用なコマンドやオプションを表す<a href="/ja/docs/Web/Guide/HTML/Content_categories#flow_content">フローコンテンツ</a>のどちらかです。</p> -<p>この要素は HTML4 で非推奨になりましたが、 HTML5.1 および HTML living standard で再導入されました。本ドキュメントは、現行の Firefox の実装について説明します。 HTML 5.1 によって、type 属性の 'list' が 'toolbar' に変わりました。</p> +<p>この要素は HTML4 で非推奨になりましたが、 HTML5.1 および HTML living standard で再導入されました。本ドキュメントは、現行の Firefox の実装について説明します。 HTML 5.1 によれば、 type 属性の 'list' が 'toolbar' に変わったようです。</p> -<h2 id="Examples" name="Examples">例</h2> +<h2 id="Examples">例</h2> -<h3 id="Context_menu" name="Context_menu">コンテキストメニュー</h3> +<h3 id="Context_menu">コンテキストメニュー</h3> <p>{{Deprecated_header}}</p> @@ -112,17 +126,17 @@ translation_of: Web/HTML/Element/menu } </pre> -<h4 id="Result" name="Result">結果</h4> +<h4 id="Result">結果</h4> <p>{{EmbedLiveSample("Context_menu", "100%", 80)}}</p> -<h3 id="Menu_button" name="Menu_button">メニューボタン</h3> +<h3 id="Menu_button">メニューボタン</h3> -<div class="blockIndicator warning"> -<p>メニューボタンを実装しているブラウザーはまだありません。 <code><menu></code> 要素の {{HTMLAttrxRef("type", "menu")}} 属性は廃止されました。</p> +<div class="notecard warning"> +<p>メニューボタンを実装しているブラウザーはまだ知られていません。 <code><menu></code> 要素の {{HTMLAttrxRef("type", "menu")}} 属性は廃止されました。</p> </div> -<div class="blockIndicator warning"> +<div class="notecard warning"> <p>{{HTMLElement("menuitem")}} 要素は廃止されました。</p> </div> @@ -141,14 +155,14 @@ translation_of: Web/HTML/Element/menu </menu> </pre> -<h4 id="Result_2" name="Result_2">結果</h4> +<h4 id="Result_2">結果</h4> <p>{{EmbedLiveSample("Menu_button", "100%", 50)}}</p> -<h3 id="Toolbar" name="Toolbar">ツールバー</h3> +<h3 id="Toolbar">ツールバー</h3> -<div class="blockIndicator warning"> -<p>ツールバーメニューを実装しているブラウザーはまだありません。</p> +<div class="notecard warning"> +<p>ツールバーメニューを実装しているブラウザーはまだ知られていません。</p> </div> <h4 id="HTML_3">HTML</h4> @@ -174,11 +188,11 @@ translation_of: Web/HTML/Element/menu </menu> </pre> -<h4 id="Result_3" name="Result_3">結果</h4> +<h4 id="Result_3">結果</h4> <p>{{EmbedLiveSample("Toolbar", "100%", 100)}}</p> -<h2 id="Specifications" name="Specifications">仕様書</h2> +<h2 id="Specifications">仕様書</h2> <table class="standard-table"> <thead> @@ -192,7 +206,7 @@ translation_of: Web/HTML/Element/menu <tr> <td>{{SpecName("HTML WHATWG", "grouping-content.html#the-menu-element", "<menu>")}}</td> <td>{{Spec2("HTML WHATWG")}}</td> - <td>最新のスナップショット {{SpecName("HTML5.3")}} から変更なし</td> + <td>最新のスナップショット {{SpecName("HTML5.2")}} から変更なし</td> </tr> <tr> <td>{{SpecName("HTML5.1", "interactive-elements.html#the-menu-element", "<menu>")}}</td> @@ -202,13 +216,11 @@ translation_of: Web/HTML/Element/menu </tbody> </table> -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> +<h2 id="Browser_compatibility">ブラウザーの互換性</h2> <p>{{Compat("html.elements.menu")}}</p> -<h2 id="See_also" name="See_also">関連情報</h2> +<h2 id="See_also">関連情報</h2> <ul> <li>他のリスト関連 HTML 要素: {{HTMLElement("ol")}}, {{HTMLElement("ul")}}, {{HTMLElement("li")}}, {{HTMLElement("hr")}} および廃止済の {{HTMLElement("dir")}}</li> |