diff options
Diffstat (limited to 'files/ja/web/html/element/summary/index.html')
| -rw-r--r-- | files/ja/web/html/element/summary/index.html | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/files/ja/web/html/element/summary/index.html b/files/ja/web/html/element/summary/index.html new file mode 100644 index 0000000000..d89d19b986 --- /dev/null +++ b/files/ja/web/html/element/summary/index.html @@ -0,0 +1,164 @@ +--- +title: '<summary>: 概要明示要素' +slug: Web/HTML/Element/summary +tags: + - Disclosure Box + - Disclosure Control + - Disclosure Summary + - Element + - HTML + - HTML interactive elements + - Reference + - Summary + - Web +translation_of: Web/HTML/Element/summary +--- +<div>{{HTMLRef}}</div> + +<p><span class="seoSummary"><strong>HTML の概要明示要素</strong> (<strong><code><summary></code></strong>) は、 {{HTMLElement("details")}} 要素の内容の要約、キャプション、説明、凡例を表します。</span> <code><summary></code> 要素をクリックすると、親の <code><details></code> 要素の開閉状態を切り替えることができます。</p> + +<div>{{EmbedInteractiveExample("pages/tabbed/summary.html","tabbed-shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<table class="properties"> + <tbody> + <tr> + <th scope="row">許可されている内容</th> + <td><a href="/ja/docs/Web/Guide/HTML/Content_categories#Phrasing_content">記述コンテンツ</a>。または <a href="/ja/docs/Web/Guide/HTML/Content_categories#Heading_content">見出しコンテンツ</a> のうちひとつの要素</td> + </tr> + <tr> + <th scope="row">タグの省略</th> + <td>不可。開始タグと終了タグの両方が必要。</td> + </tr> + <tr> + <th scope="row">許可されている親要素</th> + <td>{{HTMLElement("details")}} 要素</td> + </tr> + <tr> + <th scope="row">暗黙の ARIA ロール</th> + <td><code><a href="/ja/docs/Web/Accessibility/ARIA/Roles/button_role">button</a></code></td> + </tr> + <tr> + <th scope="row">許可されている ARIA ロール</th> + <td>許可されている <code>role</code> なし</td> + </tr> + <tr> + <th scope="row">DOM インターフェイス</th> + <td>{{domxref("HTMLElement")}}</td> + </tr> + </tbody> +</table> + +<h2 id="Attributes" name="Attributes">属性</h2> + +<p>この要素は<a href="/ja/docs/Web/HTML/Global_attributes">グローバル属性</a>のみを持ちます。</p> + +<h2 id="Usage_notes" name="Usage_notes">使用上の注意</h2> + +<p><code><summary></code> 要素の中身には、見出しコンテンツ、プレーンテキスト、段落内で使用できる HTML が入れられます。</p> + +<p><code><summary></code> 要素は、 <code><details></code> 要素の最初の子として<em>のみ</em>使用できます。ユーザーが概要をクリックすると、親の <code><details></code> 要素が開閉し、 <code><details></code> 要素に {{event("toggle")}} イベントが送信され、状態が変化したことを知るために使用することができます。</p> + +<h3 id="Default_label_text" name="Default_label_text">既定のラベルテキスト</h3> + +<p><code><details></code> 要素の最初の子が <code><summary></code> 要素でない場合、{{Glossary("user agent", "ユーザーエージェント")}}は既定の文字列 (ふつうは「詳細」) を折りたたみボックスのラベルとして使用します。</p> + +<h3 id="Default_style" name="Default_style">既定のスタイル</h3> + +<p>HTML 標準では、<code><summary></code> の既定のスタイルに <code>display:list-item</code> が含まれています。これで、ラベルの隣に既定で (多くは三角形で) 表示される折りたたみウィジェットのとして表示さえるアイコンを変更したり削除したりすることができます。</p> + +<p>スタイルを <code>display:block</code> に変更すると、展開用の三角印を削除することができます。</p> + +<p>詳しくは{{anch("Browser compatibility", "ブラウザーの互換性")}}の節をご覧ください。すべてのブラウザーがこの要素の機能すべてに対応しているわけではありません。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<p>以下に <code><summary></code> を使用している例をいくつか示します。 {{HTMLElement("details")}} 要素のドキュメントにもいくつか例があります。</p> + +<h3 id="Basic_example" name="Basic_example">基本的な例</h3> + +<p>{{HTMLElement("details")}} 要素の中で <code><summary></code> の使用を示す簡単な例です。</p> + +<pre class="brush: html notranslate"><details open> + <summary>Overview</summary> + <ol> + <li>Cash on hand: $500.00</li> + <li>Current invoice: $75.30</li> + <li>Due date: 5/6/19</li> + </ol> +</details></pre> + +<p>{{EmbedLiveSample("Basic_example", 650, 120)}}</p> + +<h3 id="Summaries_as_headings" name="Summaries_as_headings">見出しとしての概要</h3> + +<p>次のように、 <code><summary></code> の中で見出し要素を使用することができます。</p> + +<pre class="brush: html notranslate"><details open> + <summary><h4>Overview</h4></summary> + <ol> + <li>Cash on hand: $500.00</li> + <li>Current invoice: $75.30</li> + <li>Due date: 5/6/19</li> + </ol> +</details></pre> + +<p>{{EmbedLiveSample("Summaries_as_headings", 650, 120)}}</p> + +<p>これは現在のところ、間隔の問題をいくつか抱えており、 CSS を使用して修正することができます。</p> + +<div class="blockIndicator warning"> +<p><strong>警告:</strong> <code><summary></code> 要素の既定のロールは <a href="/ja/docs/Web/Accessibility/ARIA/Roles/button_role">button</a> (子要素からはすべてのロールを外す) ですので、この例は読み上げソフトのような支援技術のユーザーには動作しません。 <code><h4></code> のロールが削除されますので、これらのユーザーからは見出しとして扱われなくなります。</p> +</div> + +<h3 id="HTML_in_summaries" name="HTML_in_summaries">概要の中の HTML</h3> + +<p>この例は、 <code><summary></code> 要素にいくらか意味をを追加して、ラベルを重要であると示します。</p> + +<pre class="brush: html notranslate"><details open> + <summary><strong>Overview</strong></summary> + <ol> + <li>Cash on hand: $500.00</li> + <li>Current invoice: $75.30</li> + <li>Due date: 5/6/19</li> + </ol> +</details></pre> + +<p>{{EmbedLiveSample("HTML_in_summaries", 650, 120)}}</p> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + <th scope="col">状態</th> + <th scope="col">備考</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', 'interactive-elements.html#the-summary-element', '<summary>')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('HTML5.1', 'interactive-elements.html#the-summary-element', '<summary>')}}</td> + <td>{{Spec2('HTML5.1')}}</td> + <td>初回定義</td> + </tr> + </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> + +<p>{{Compat("html.elements.summary")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{HTMLElement("details")}}</li> +</ul> |