initial commit

1 files changed, 129 insertions, 0 deletions

diff --git a/files/ja/web/html/element/aside/index.html b/files/ja/web/html/element/aside/index.html
new file mode 100644
index 0000000000..5d93628c92
--- /dev/null
+++ b/files/ja/web/html/element/aside/index.html
@@ -0,0 +1,129 @@
+---
+title: '<aside>: 余談要素'
+slug: Web/HTML/Element/aside
+tags:
+  - Element
+  - HTML
+  - HTML セクション
+  - HTML5
+  - 'HTML:フローコンテンツ'
+  - 'HTML:区分コンテンツ'
+  - 'HTML:知覚可能コンテンツ'
+  - Reference
+  - Web
+  - ウェブ
+  - リファレンス
+  - 要素
+translation_of: Web/HTML/Element/aside
+---
+<div>{{HTMLRef}}</div>
+
+<p><span class="seoSummary"><strong>HTML の <code>&lt;aside&gt;</code> 要素</strong>は、文書のメインコンテンツと間接的な関係しか持っていない文書の部分を表現します。</span>サイドバーやコールアウトボックスなどを表現するためによく使われます。</p>
+
+<div>{{EmbedInteractiveExample("pages/tabbed/aside.html", "tabbed-standard")}}</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/Guide/HTML/Content_categories">コンテンツカテゴリ</a></th>
+   <td><a href="/ja/docs/Web/Guide/HTML/Content_categories#Flow_content">フローコンテンツ</a>、<a href="/ja/docs/Web/Guide/HTML/Content_categories#Sectioning_content">区分コンテンツ</a>、<a href="/ja/docs/Web/Guide/HTML/Content_categories#Palpable_content">知覚可能コンテンツ</a></td>
+  </tr>
+  <tr>
+   <th scope="row">許可されている内容</th>
+   <td><a href="/ja/docs/Web/Guide/HTML/Content_categories#Flow_content">フローコンテンツ</a></td>
+  </tr>
+  <tr>
+   <th scope="row">タグの省略</th>
+   <td>{{no_tag_omission}}</td>
+  </tr>
+  <tr>
+   <th scope="row">許可されている親要素</th>
+   <td><a href="/ja/docs/Web/Guide/HTML/Content_categories#Flow_content">フローコンテンツ</a>を受け入れるすべての要素。<code>&lt;aside&gt;</code> 要素は {{HTMLElement("address")}} 要素の子孫要素として配置してはならない。</td>
+  </tr>
+  <tr>
+   <th scope="row">暗黙の ARIA ロール</th>
+   <td><code><a href="/ja/docs/Web/Accessibility/ARIA/Roles/Complementary_role">complementary</a></code></td>
+  </tr>
+  <tr>
+   <th scope="row">許可されている ARIA ロール</th>
+   <td>{{ARIARole("feed")}}, {{ARIARole("none")}}, {{ARIARole("note")}}, {{ARIARole("presentation")}}, {{ARIARole("region")}}, {{ARIARole("search")}}</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;aside&gt;</code> 要素を使用しないでください。</li>
+</ul>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<h3 id="Using_&lt;aside>" name="Using_&lt;aside>">&lt;aside&gt; の使用</h3>
+
+<p>このれは <code>&lt;aside&gt;</code> を使用して記事の中のある段落をマークアップします。この段落は記事の主要な内容と間接的な関係しかありません。</p>
+
+<pre class="brush: html">&lt;article&gt;
+  &lt;p&gt;
+    The Disney movie &lt;cite&gt;The Little Mermaid&lt;/cite&gt; was
+    first released to theatres in 1989.
+  &lt;/p&gt;
+  &lt;aside&gt;
+    &lt;p&gt;
+      The movie earned $87 million during its initial release.
+    &lt;/p&gt;
+  &lt;/aside&gt;
+  &lt;p&gt;
+    More info about the movie...
+  &lt;/p&gt;
+&lt;/article&gt;</pre>
+
+<p>{{EmbedLiveSample("Examples")}}</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', 'semantics.html#the-aside-element', '&lt;aside&gt;')}}</td>
+   <td>{{Spec2('HTML WHATWG')}}</td>
+   <td></td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML5 W3C', 'sections.html#the-aside-element', '&lt;aside&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>
+
+<div>{{Compat("html.elements.aside")}}</div>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li>他の区分化関連要素: {{HTMLElement("body")}}, {{HTMLElement("article")}}, {{HTMLElement("section")}}, {{HTMLElement("nav")}}, {{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}}, {{HTMLElement("h6")}}, {{HTMLElement("hgroup")}}, {{HTMLElement("header")}}, {{HTMLElement("footer")}}, {{HTMLElement("address")}}</li>
+ <li><a href="/ja/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines">HTML のセクションとアウトラインの使用</a></li>
+ <li><a href="/ja/docs/Web/Accessibility/ARIA/ARIA_Techniques/Complementary_role">ARIA: Complementary role</a></li>
+</ul>