initial commit

1 files changed, 171 insertions, 0 deletions

diff --git a/files/ja/web/html/element/figure/index.html b/files/ja/web/html/element/figure/index.html
new file mode 100644
index 0000000000..2eb475494e
--- /dev/null
+++ b/files/ja/web/html/element/figure/index.html
@@ -0,0 +1,171 @@
+---
+title: '<figure>: 任意のキャプション付きの図要素'
+slug: Web/HTML/Element/figure
+tags:
+  - HTML
+  - HTML コンテンツグループ化
+  - 'HTML:フローコンテンツ'
+  - 'HTML:区分化ルート'
+  - 'HTML:知覚可能コンテンツ'
+  - Reference
+  - 要素
+translation_of: Web/HTML/Element/figure
+---
+<div>{{HTMLRef}}</div>
+
+<p><span class="seoSummary"><strong>HTML の <code>&lt;figure&gt;</code> (任意のキャプション付きの図) 要素</strong>は、図表などの自己完結型のコンテンツを表し、任意で ({{HTMLElement("figcaption")}}) 要素を使用して表されるキャプションを伴います。</span>図、すなわちキャプションとその中身は一つの単位として参照されます。</p>
+
+<div>{{EmbedInteractiveExample("pages/tabbed/figure.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"><a href="/ja/docs/Web/HTML/Content_categories">コンテンツカテゴリ</a></th>
+   <td><a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a>, <a href="/ja/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines#Sectioning_roots">区分化ルート</a>, 知覚可能コンテンツ</td>
+  </tr>
+  <tr>
+   <th scope="row">許可されている内容</th>
+   <td>{{HTMLElement("figcaption")}} 要素とそれに続く<a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a>、またはフローコンテンツとそれに続く{{HTMLElement("figcaption")}} 要素、またはフローコンテンツ</td>
+  </tr>
+  <tr>
+   <th scope="row">タグの省略</th>
+   <td>{{no_tag_omission}}</td>
+  </tr>
+  <tr>
+   <th scope="row">許可されている親要素</th>
+   <td><a href="/ja/docs/Web/HTML/Content_categories#Flow_content">フローコンテンツ</a>を受け入れるすべての要素</td>
+  </tr>
+  <tr>
+   <th scope="row">許可されている ARIA ロール</th>
+   <td>{{ARIARole("group")}}, {{ARIARole("presentation")}}</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>
+
+<ul>
+ <li>ふつう <code>&lt;figure&gt;</code> は画像、イラスト、グラフ、コードの断片など、文書の本文の流れから参照されるものの、本文の流れに影響を与えることなく、文書のほかの部分や付録に移動することが可能なものに用います。</li>
+ <li><a href="/ja/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines#Sectioning_roots">区分化ルート</a>となり、 <code>&lt;figure&gt;</code> 要素のコンテンツのアウトラインは、文書の本文のアウトラインから除外されます。</li>
+ <li>キャプションは <code>&lt;figure&gt;</code> 要素の中に (最初または最後の子要素として) {{HTMLElement("figcaption")}} 要素を挿入することで表すことができます。図の中で最初に見つかった最初の <code>&lt;figcaption&gt;</code> 要素が図のキャプションとして表示されます。</li>
+</ul>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<h3 id="Images" name="Images">画像</h3>
+
+<pre class="brush: html">&lt;!-- 単なる画像 --&gt;
+&lt;figure&gt;
+  &lt;img
+  src="https://developer.mozilla.org/static/img/favicon144.png"
+  alt="美しい MDN のロゴ"&gt;
+&lt;/figure&gt;
+
+&lt;!-- キャプションが付いた画像 --&gt;
+&lt;figure&gt;
+  &lt;img
+  src="https://developer.mozilla.org/static/img/favicon144.png"
+  alt="美しい MDN のロゴ"&gt;
+  &lt;figcaption&gt;MDN ロゴ&lt;/figcaption&gt;
+&lt;/figure&gt;
+</pre>
+
+<div>{{EmbedLiveSample("Images", "100%", 375)}}</div>
+
+<h3 id="Code_snippets" name="Code_snippets">コードスニペット</h3>
+
+<pre class="brush: html">&lt;figure&gt;
+  &lt;figcaption&gt;Get browser details using &lt;code&gt;navigator&lt;/code&gt;.&lt;/figcaption&gt;
+  &lt;pre&gt;
+function NavigatorExample() {
+  var txt;
+  txt = "Browser CodeName: " + navigator.appCodeName + "; ";
+  txt+= "Browser Name: " + navigator.appName + "; ";
+  txt+= "Browser Version: " + navigator.appVersion  + "; ";
+  txt+= "Cookies Enabled: " + navigator.cookieEnabled  + "; ";
+  txt+= "Platform: " + navigator.platform  + "; ";
+  txt+= "User-agent header: " + navigator.userAgent  + "; ";
+  console.log("NavigatorExample", txt);
+}
+  &lt;/pre&gt;
+&lt;/figure&gt;</pre>
+
+<div>{{EmbedLiveSample("Code_snippets", "100%", 250)}}</div>
+
+<h3 id="Quotations" name="Quotations">引用</h3>
+
+<pre class="brush: html">&lt;figure&gt;
+  &lt;figcaption&gt;&lt;cite&gt;Edsger Dijkstra:&lt;/cite&gt;&lt;/figcaption&gt;
+  &lt;blockquote&gt;デバッグがソフトウェアのバグを取るプロセスであるならば、
+  プログラミングはそれを入れるプロセスだ。&lt;/blockquote&gt;
+&lt;/figure&gt;
+</pre>
+
+<div>{{EmbedLiveSample("Quotations")}}</div>
+
+<h3 id="Poems" name="Poems">詩</h3>
+
+<pre class="brush: html">&lt;figure&gt;
+  &lt;p style="white-space:pre"&gt;
+Bid me discourse, I will enchant thine ear,
+  Or like a fairy trip upon the green,
+Or, like a nymph, with long dishevell'd hair,
+  Dance on the sands, and yet no footing seen:
+Love is a spirit all compact of fire,
+  Not gross to sink, but light, and will aspire.&lt;/p&gt;
+  &lt;figcaption&gt;&lt;cite&gt;Venus and Adonis&lt;/cite&gt;,
+    by William Shakespeare&lt;/figcaption&gt;
+&lt;/figure&gt;</pre>
+
+<div>{{EmbedLiveSample("Poems", "100%", 250)}}</div>
+
+<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', 'semantics.html#the-figure-element', '&lt;figure&gt;')}}</td>
+   <td>{{Spec2('HTML WHATWG')}}</td>
+   <td></td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML5.2', 'grouping-content.html#the-figure-element', '&lt;figure&gt;')}}</td>
+   <td>{{Spec2('HTML5.2')}}</td>
+   <td>HTML 5.0 から変更なし</td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML5 W3C', 'grouping-content.html#the-figure-element', '&lt;figure&gt;')}}</td>
+   <td>{{Spec2('HTML5 W3C')}}</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.figure")}}</p>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li>{{HTMLElement("figcaption")}} 要素</li>
+</ul>