CSS Box Alignments 関係の文書を更新

- 2021/10/17 時点の英語版に同期
- 一部および画像は新規翻訳

1 files changed, 92 insertions, 123 deletions

diff --git a/files/ja/web/css/gap/index.md b/files/ja/web/css/gap/index.md
index edc971b860..8d9de3c7ef 100644
--- a/files/ja/web/css/gap/index.md
+++ b/files/ja/web/css/gap/index.md
@@ -3,47 +3,42 @@ title: gap (grid-gap)
 slug: Web/CSS/gap
 tags:
   - CSS
-  - CSS グリッドレイアウト
-  - CSS フレックスボックスレイアウト
-  - CSS プロパティ
-  - CSS ボックス配置
+  - CSS フレックスボックス
+  - CSS グリッド
   - CSS 段組みレイアウト
-  - Reference
-  - gap
+  - CSS プロパティ
   - リファレンス
+  - gap
+  - recipe:css-property
+browser-compat: css.properties.gap
 translation_of: Web/CSS/gap
 ---
-<div>{{CSSRef}}</div>
-
-<p><span class="seoSummary"><strong><code>gap</code></strong> は <a href="/ja/docs/Web/CSS">CSS</a> のプロパティで、行や列の間のすき間 ({{glossary("gutters", "溝")}}) を定義します。これは {{CSSxRef("row-gap")}} および {{CSSxRef("column-gap")}} の<a href="/ja/docs/Web/CSS/Shorthand_properties">一括指定</a>です。</span></p>
+{{CSSRef}}
 
-<div>{{EmbedInteractiveExample("pages/css/gap.html")}}</div>
+**`gap`** は [CSS](/ja/docs/Web/CSS) のプロパティで、行や列の間のすき間 ({{glossary("gutters", "溝")}}) を定義します。これは {{CSSxRef("row-gap")}} および {{CSSxRef("column-gap")}} の[一括指定](/ja/docs/Web/CSS/Shorthand_properties)です。
 
-<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div>
+{{EmbedInteractiveExample("pages/css/gap.html")}}
 
-<div class="note">
-<p><a href="/ja/docs/Web/CSS/CSS_Grid_Layout">CSS グリッドレイアウト</a>では、当初は <code>grid-gap</code> プロパティを定義していました。この接頭辞付きのプロパティは <code>gap</code> に置き換えられました。しかし、グリッドで <code>grid-gap</code> を実装していて <code>gap</code> を実装していないブラウザーに対応するため、上記のデモにあるように、接頭辞付きのプロパティを使用する必要があるでしょう。</p>
-</div>
-
-<h2 id="Syntax" name="Syntax">構文</h2>
+## 構文
 
-<pre class="brush: css; no-line-numbers notranslate">/* 単一の &lt;length&gt; 値 */
+```css
+/* 単一の <length> 値 */
 gap: 20px;
 gap: 1em;
 gap: 3vmin;
 gap: 0.5cm;
 
-/* 単一の &lt;percentage&gt; 値 */
+/* 単一の <percentage> 値 */
 gap: 16%;
 gap: 100%;
 
-/* 二つの &lt;length&gt; 値 */
+/* 2 つの <length> 値 */
 gap: 20px 10px;
 gap: 1em 0.5em;
 gap: 3vmin 2vmax;
 gap: 0.5cm 2mm;
 
-/* 一つ又は二つの &lt;percentage&gt; 値 */
+/* 1 つまたは 2 つの <percentage> 値 */
 gap: 16% 100%;
 gap: 21px 82%;
 
@@ -54,52 +49,57 @@ gap: calc(20px + 10%) calc(10% - 5px);
 /* グローバル値 */
 gap: inherit;
 gap: initial;
+gap: revert;
 gap: unset;
-</pre>
+```
+
+このプロパティは `<'row-gap'>` の値と、任意で `<'column-gap'>` の値を続けて指定します。 `<'column-gap'>` が省略された場合、 `<'row-gap'>` と同じ値が設定されます。
 
-<p>このプロパティは <code>&lt;'row-gap'&gt;</code> の値と、任意で <code>&lt;'column-gap'&gt;</code> の値を続けて指定します。 <code>&lt;'column-gap'&gt;</code> が省略された場合、 <code>&lt;'row-gap'&gt;</code> と同じ値が設定されます。</p>
+`<'row-gap'>` および `<'column-gap'>` はそれぞれ、 `<length>` または `<percentage>` で指定します。
 
-<p><code>&lt;'row-gap'&gt;</code> 及び <code>&lt;'column-gap'&gt;</code> はそれぞれ、 <code>&lt;length&gt;</code> 又は <code>&lt;percentage&gt;</code> で指定します。</p>
+### 値
 
-<h3 id="Values" name="Values">値</h3>
+- {{CSSxRef("&lt;length&gt;")}}
+  - : グリッド線を隔てる溝の幅です。
+- {{CSSxRef("&lt;percentage&gt;")}}
+  - : 要素の寸法に対する、グリッド線を隔てる溝の幅です。
 
-<dl>
- <dt>{{CSSxRef("&lt;length&gt;")}}</dt>
- <dd>グリッド線を隔てる溝の幅です。</dd>
- <dt>{{CSSxRef("&lt;percentage&gt;")}}</dt>
- <dd>要素の寸法に対する、グリッド線を隔てる溝の幅です。</dd>
-</dl>
+## 公式定義
 
-<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
+{{cssinfo}}
 
-{{CSSSyntax}}
+## 関連情報
 
-<h2 id="Examples" name="Examples">例</h2>
+{{csssyntax}}
 
-<h3 id="Flex_layout" name="Flex_layout">フレックスレイアウト</h3>
+## 例
 
-<h4 id="HTML">HTML</h4>
+<h3 id="Flex_layout">フレックスレイアウト</h3>
 
-<pre class="brush: html; notranslate">&lt;div id="flexbox"&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-&lt;/div&gt;
-</pre>
+#### HTML
+
+```html
+<div id="flexbox">
+  <div></div>
+  <div></div>
+  <div></div>
+  <div></div>
+  <div></div>
+  <div></div>
+</div>
+```
 
-<h4 id="CSS">CSS</h4>
+#### CSS
 
-<pre class="brush: css; highlight[5] notranslate">#flexbox {
+```css
+#flexbox {
   display: flex;
   flex-wrap: wrap;
   width: 300px;
   gap: 20px 5px;
 }
 
-#flexbox &gt; div {
+#flexbox > div {
   border: 1px solid green;
   background-color: lime;
   flex: 1 1 auto;
@@ -107,115 +107,84 @@ gap: unset;
   height: 50px;
 
 }
-</pre>
+```
 
-<h4 id="Result" name="Result">結果</h4>
+#### 結果
 
-<p>{{EmbedLiveSample("Flex_layout", "auto", "120px")}}</p>
+{{EmbedLiveSample("Flex_layout", "auto", "120px")}}
 
-<h3 id="Grid_layout" name="Grid_layout">グリッドレイアウト</h3>
+<h3 id="Grid_layout">グリッドレイアウト</h3>
 
-<h4 id="HTML_2">HTML</h4>
+#### HTML
 
-<pre class="brush: html; notranslate">&lt;div id="grid"&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-  &lt;div&gt;&lt;/div&gt;
-&lt;/div&gt;</pre>
-
-<h4 id="CSS_2">CSS</h4>
-
-<div class="hidden">
-<pre class="brush: css notranslate">#grid {
-  grid-gap: 20px 5px;
-}
-</pre>
+```html
+<div id="grid">
+  <div></div>
+  <div></div>
+  <div></div>
+  <div></div>
+  <div></div>
+  <div></div>
+  <div></div>
+  <div></div>
+  <div></div>
 </div>
+```
 
-<pre class="brush: css; highlight[5] notranslate">#grid {
+#### CSS
+
+```css
+#grid {
   display: grid;
   height: 200px;
   grid-template: repeat(3, 1fr) / repeat(3, 1fr);
   gap: 20px 5px;
 }
 
-#grid &gt; div {
+#grid > div {
   border: 1px solid green;
   background-color: lime;
 }
-</pre>
+```
 
-<h4 id="Result_2" name="Result_2">結果</h4>
+#### 結果
 
-<p>{{EmbedLiveSample("Grid_layout", "auto", "120px")}}</p>
+{{EmbedLiveSample("Grid_layout", "auto", "120px")}}
 
-<h3 id="Multi-column_layout" name="Multi-column_layout">段組みレイアウト</h3>
+<h3 id="Multi-column_layout">段組みレイアウト</h3>
 
-<h4 id="HTML_3">HTML</h4>
+#### HTML
 
-<pre class="brush: html; notranslate">&lt;p class="content-box"&gt;
+```html
+<p class="content-box">
   This is some multi-column text with a 40px column
-  gap created with the CSS &lt;code&gt;gap&lt;/code&gt; property.
+  gap created with the CSS <code>gap</code> property.
   Don't you think that's fun and exciting? I sure do!
-&lt;/p&gt;
-</pre>
+</p>
+```
 
-<h4 id="CSS_3">CSS</h4>
+#### CSS
 
-<pre class="brush: css; highlight[3] notranslate">.content-box {
+```css
+.content-box {
   column-count: 3;
   gap: 40px;
 }
-</pre>
-
-<h4 id="Result_3" name="Result_3">結果</h4>
-
-<p>{{EmbedLiveSample("Multi-column_layout", "auto", "120px")}}</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("CSS3 Box Alignment", "#propdef-gap", "gap")}}</td>
-   <td>{{Spec2("CSS3 Box Alignment")}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
-</table>
-
-<p>{{CSSInfo}}</p>
-
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+```
 
-<h3 id="Support_in_Flex_layout" name="Support_in_Flex_layout">フレックスレイアウトでの対応</h3>
+#### 結果
 
-<p>{{Compat("css.properties.gap.flex_context")}}</p>
+{{EmbedLiveSample("Multi-column_layout", "auto", "120px")}}
 
-<h3 id="Support_in_Grid_layout" name="Support_in_Grid_layout">グリッドレイアウトでの対応</h3>
+## 仕様書
 
-<p>{{Compat("css.properties.gap.grid_context")}}</p>
+{{Specifications("css.properties.gap.grid_context")}}
 
-<h3 id="Support_in_Multi-column_layout" name="Support_in_Multi-column_layout">段組みレイアウトでの対応</h3>
+## ブラウザーの互換性
 
-<p>{{Compat("css.properties.gap.multicol_context")}}</p>
+{{Compat}}
 
-<h2 id="See_also" name="See_also">関連情報</h2>
+## 関連情報
 
-<ul>
- <li>関連する CSS プロパティ: {{CSSxRef("row-gap")}}, {{CSSxRef("column-gap")}}</li>
- <li>グリッドレイアウトガイド: <em><a href="/ja/docs/Web/CSS/CSS_Grid_Layout/Basic_Concepts_of_Grid_Layout#Gutters">グリッドレイアウトの基本概念 - 溝</a></em></li>
-</ul>
+- 関連する CSS プロパティ: {{CSSxRef("row-gap")}}, {{CSSxRef("column-gap")}}
+- グリッドレイアウトガイド: _[グリッドレイアウトの基本概念 - 溝](/ja/docs/Web/CSS/CSS_Grid_Layout/Basic_Concepts_of_Grid_Layout#gutters)_