CSS 論理的プロパティと値のボックスモデルに関するプロパティを更新

- 2021/11/15 時点の英語版に同期

1 files changed, 70 insertions, 66 deletions

diff --git a/files/ja/web/css/margin-block/index.md b/files/ja/web/css/margin-block/index.md
index c68a537ebe..c27b0155a0 100644
--- a/files/ja/web/css/margin-block/index.md
+++ b/files/ja/web/css/margin-block/index.md
@@ -3,23 +3,21 @@ title: margin-block
 slug: Web/CSS/margin-block
 tags:
   - CSS
-  - CSS Logical Property
-  - CSS Property
-  - CSS プロパティ
   - CSS 論理的プロパティ
-  - Experimental
-  - Reference
+  - CSS プロパティ
+  - 実験的
+  - リファレンス
   - margin-block
-  - margin-block-end
-  - margin-block-start
-  - 一括指定プロパティ
+  - recipe:css-shorthand-property
+browser-compat: css.properties.margin-block
 translation_of: Web/CSS/margin-block
 ---
-<div>{{CSSRef}}{{SeeCompatTable}}</div>
+{{CSSRef}}
 
-<p>The <strong><code>margin-block</code></strong> は <a href="/ja/docs/Web/CSS" title="CSS">CSS</a> のプロパティで、論理的なブロックの先頭と末尾のマージンを設定します。これは要素の書字方向やテキストの向きに応じて物理的なマージンに変換されます。</p>
+The **`margin-block`** は [CSS](/ja/docs/Web/CSS) の[一括指定プロパティ](/ja/docs/Web/CSS/Shorthand_properties)で、論理的なブロックの先頭と末尾のマージンを設定します。これは要素の書字方向やテキストの向きに応じて物理的なマージンに変換されます。
 
-<pre class="brush:css no-line-numbers">/* &lt;length&gt; 値 */
+```css
+/* <length> 値 */
 margin-block: 10px 20px;  /* 絶対的な長さ */
 margin-block: 1em 2em;   /* テキストの大きさに対する相対値 */
 margin-block: 5% 2%;    /* 直近のブロックコンテナーの大きさに対する相対値 */
@@ -31,76 +29,82 @@ margin-block: auto;
 /* グローバル値 */
 margin-block: inherit;
 margin-block: initial;
+margin-block: revert;
 margin-block: unset;
-</pre>
+```
 
-<p>これらの値は、 {{CSSxRef("margin-top")}} と {{CSSxRef("margin-bottom")}}、または {{CSSxRef("margin-right")}} と {{CSSxRef("margin-left")}} プロパティに、 {{CSSxRef("writing-mode")}}, {{CSSxRef("direction")}}, {{CSSxRef("text-orientation")}} で定義された値にしたがって対応します。</p>
+このプロパティは、 {{CSSxRef("margin-top")}} と {{CSSxRef("margin-bottom")}}、または {{CSSxRef("margin-right")}} と {{CSSxRef("margin-left")}} プロパティに、 {{CSSxRef("writing-mode")}}, {{CSSxRef("direction")}}, {{CSSxRef("text-orientation")}} で定義された値にしたがって対応します。
 
-<p>値は {{CSSxRef("margin-block-start")}} と {{CSSxRef("margin-block-end")}} で個別に設定することができます。インライン方向のプロパティは {{CSSxRef("margin-inline")}} で、 {{CSSxRef("margin-inline-start")}} と {{CSSxRef("margin-inline-end")}} を設定します。</p>
+## 構成要素のプロパティ
 
-<h2 id="Syntax" name="Syntax">構文</h2>
+このプロパティは以下の CSS プロパティの一括指定です。
 
-<h3 id="Values" name="Values">値</h3>
+- [`margin-block-end`](/ja/docs/Web/CSS/margin-block-end)
+- [`margin-block-start`](/ja/docs/Web/CSS/margin-block-start)
 
-<p><code>margin-block</code> プロパティは、 {{CSSxRef("margin-left")}} プロパティと同じ値を取ります。</p>
+## 構文
 
-<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
+### 値
 
-{{CSSSyntax}}
+`margin-block` プロパティは、 {{CSSxRef("margin-left")}} プロパティと同じ値を取ります。
 
-<h2 id="Example" name="Example">例</h2>
+## 公式定義
 
-<h3 id="HTML">HTML</h3>
+{{cssinfo}}
+
+## 形式文法
+
+{{CSSSyntax}}
 
-<pre class="brush: html">&lt;div&gt;
-  &lt;p class="exampleText"&gt;Example text&lt;/p&gt;
-&lt;/div&gt;
-</pre>
+## 例
 
-<h3 id="CSS">CSS</h3>
+<h3 id="Setting_block_start_and_end_margins">ブロック方向の先頭と末尾のマージンを設定</h3>
 
-<pre class="brush: css">div {
+#### CSS
+
+```css
+div {
   background-color: yellow;
   width: 120px;
-  height: 120px;
+  height: auto;
+  border: 1px solid green;
 }
 
-.exampleText {
-  writing-mode: vertical-rl;
+p {
+  margin: 0;
   margin-block: 20px 40px;
-  background-color: #c8c800;
-}</pre>
-
-<p>{{EmbedLiveSample("Example", 140, 140)}}</p>
-
-<h2 id="Specification" name="Specification">仕様書</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("CSS Logical Properties", "#propdef-margin-block", "margin-block")}}</td>
-   <td>{{Spec2("CSS Logical Properties")}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
-</table>
-
-<p>{{CSSInfo}}</p>
-
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
-
-<p>{{Compat("css.properties.margin-block")}}</p>
-
-<h2 id="See_also" name="See_also">関連情報</h2>
-
-<ul>
- <li>対応する物理的プロパティ: {{CSSxRef("margin-top")}}, {{CSSxRef("margin-right")}}, {{CSSxRef("margin-bottom")}}, {{CSSxRef("margin-left")}}</li>
- <li>{{CSSxRef("writing-mode")}}, {{CSSxRef("direction")}}, {{CSSxRef("text-orientation")}}</li>
-</ul>
+  background-color: tan;
+}
+
+.verticalExample {
+  writing-mode: vertical-rl;
+}
+```
+
+#### HTML
+
+```html
+<div>
+  <p>Example text</p>
+</div>
+<div class="verticalExample">
+  <p>Example text</p>
+</div>
+```
+
+#### 結果
+
+{{EmbedLiveSample("Setting_block_start_and_end_margins", 140, 200)}}
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- 対応する物理的プロパティ: {{CSSxRef("margin-top")}}, {{CSSxRef("margin-right")}}, {{CSSxRef("margin-bottom")}}, {{CSSxRef("margin-left")}}
+- {{CSSxRef("writing-mode")}}, {{CSSxRef("direction")}}, {{CSSxRef("text-orientation")}}