CSS Box Alignments 関係の文書を更新

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

1 files changed, 79 insertions, 103 deletions

diff --git a/files/ja/web/css/align-self/index.md b/files/ja/web/css/align-self/index.md
index 7605ab04dd..bd33894002 100644
--- a/files/ja/web/css/align-self/index.md
+++ b/files/ja/web/css/align-self/index.md
@@ -3,26 +3,26 @@ title: align-self
 slug: Web/CSS/align-self
 tags:
   - CSS
+  - CSS ボックス配置
   - CSS フレックスボックス
   - CSS プロパティ
-  - CSS ボックス配置
-  - place-self
   - リファレンス
+  - recipe:css-property
+browser-compat: css.properties.align-self
 translation_of: Web/CSS/align-self
 ---
-<div>{{CSSRef}}</div>
+{{CSSRef}}
 
-<p><strong><code>align-self</code></strong> は <a href="/ja/docs/Web/CSS">CSS</a> のプロパティで、グリッドやフレックスのアイテムの {{cssxref("align-items")}} の値を上書きします。グリッドでは、アイテムは{{glossary("Grid Areas", "グリッド領域")}}内に配置されます。フレックスボックスでは、アイテムは{{glossary("cross axis", "交差軸")}}上に配置されます。</p>
+**`align-self`** は [CSS](/ja/docs/Web/CSS) のプロパティで、グリッドやフレックスのアイテムの {{cssxref("align-items")}} の値を上書きします。グリッドでは、アイテムは{{glossary("Grid Areas", "グリッド領域")}}内で配置されます。フレックスボックスでは、アイテムは{{glossary("cross axis", "交差軸")}}上で配置されます。
 
-<div>{{EmbedInteractiveExample("pages/css/align-self.html")}}</div>
+{{EmbedInteractiveExample("pages/css/align-self.html")}}
 
-<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p>
+このプロパティは、ブロックレベルのボックスやテーブルのセルには適用されません。フレックスボックスの交差軸のマージンが `auto` の場合、`align-self` は無視されます。
 
-<p>このプロパティは、ブロックレベルのボックスやテーブルのセルには適用されません。フレックスボックスの交差軸のマージンが <code>auto</code> の場合、 <code> align-self</code> は無視されます。</p>
+## 構文
 
-<h2 id="Syntax" name="Syntax">構文</h2>
-
-<pre class="brush: css no-line-numbers">/* キーワード値 */
+```css
+/* キーワード値 */
 align-self: auto;
 align-self: normal;
 
@@ -49,63 +49,68 @@ align-self: unsafe center;
 /* グローバル値 */
 align-self: inherit;
 align-self: initial;
-align-self: unset;</pre>
-
-<h3 id="Values" name="Values">値</h3>
-
-<dl>
- <dt><code>auto</code></dt>
- <dd>親の {{cssxref("align-items")}} の値で計算します。</dd>
- <dt><code>normal</code></dt>
- <dd>このキーワードの効果は、現在のレイアウトモードに依存します。
- <ul>
-  <li>絶対位置のレイアウトでは、このキーワードは<em>置換</em>の絶対位置ボックスには <code>start</code> のように動作し、<em>その他</em>の絶対位置ボックスには <code>stretch</code> のように動作します。</li>
-  <li>絶対位置指定レイアウトの固定位置指定時は、このキーワードは <code>stretch</code> と同様に動作します。</li>
-  <li>フレックスアイテムでは、このキーワードは <code>stretch</code> と同様に動作します。</li>
-  <li>グリッドアイテムでは、このキーワードは <code>stretch</code> のうちの一つと似た動作をしますが、アスペクト比や固有の寸法を持つボックスは <code>start</code> のように動作します。</li>
-  <li>ブロックレベルボックスと表のセルでは、プロパティは適用されません。</li>
- </ul>
- </dd>
- <dt><code>self-start</code></dt>
- <dd>アイテムは交差軸の開始側に対応する配置コンテナーの端に詰めて配置されます。</dd>
- <dt><code>self-end</code></dt>
- <dd>アイテムは交差軸の終端側に対応する配置コンテナーの端に詰めて配置されます。</dd>
- <dt><code>flex-start</code></dt>
- <dd>このフレックスアイテムの cross-start マージン側が、行の cross-start 側に詰められます。</dd>
- <dt><code>flex-end</code></dt>
- <dd>このフレックスアイテムの cross-end マージン側が、行の cross-end 側に詰められます。</dd>
- <dt><code>center</code></dt>
- <dd>このフレックスアイテムのマージンボックスが、行の交差軸方向の中央に配置されます。アイテムの交差軸方向の寸法がフレックスコンテナーよりも大きい場合は、両方向に均等にはみ出します。</dd>
- <dt><code>baseline<br>
- first baseline</code><br>
- <code>last baseline</code></dt>
- <dd>first-baseline 配置または last-baseline 配置への関与を指定します。ボックスの最初または最後のベースラインセットの配置ベースラインを、ベースライン共有グループ内のすべてのボックスで共有される最初または最後のベースラインセットで対応するベースラインに揃えます。<br>
- <code>first baseline</code> の代替配置は <code>start</code>、<code>last baseline</code> の代替配置は <code>end</code> です。</dd>
- <dt><code>stretch</code></dt>
- <dd>アイテムの交差軸方向の寸法の合計値が、配置コンテナーの寸法よりも小さく、アイテムの寸法が <code>auto</code> であった場合、アイテムの寸法は {{cssxref("max-height")}}/{{cssxref("max-width")}} (または同等の機能) で課された制約を尊重しつつ、均等の寸法 (比例的ではない) に拡大されるので、 <code>auto</code> が指定されたアイテムすべての寸法の合計は、ちょうど配置コンテナーの交差軸方向を埋めるようになります。</dd>
- <dt><code>safe</code></dt>
- <dd>アイテムのサイズが配置コンテナーを超えるとき、アイテムは配置モードが <code>start</code> であったかのように配置されます。</dd>
- <dt><code>unsafe</code></dt>
- <dd>アイテムの配置コンテナーのサイズの関係にかかわらず、指定した値を尊重します。</dd>
-</dl>
-
-<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
+align-self: revert;
+align-self: unset;
+```
+
+### 値
+
+- `auto`
+  - : 親の {{cssxref("align-items")}} の値で計算します。
+- `normal`
+
+  - : このキーワードの効果は、現在のレイアウトモードに依存します。
+
+    - 絶対位置のレイアウトでは、このキーワードは*置換*の絶対位置ボックスには `start` のように動作し、*その他*の絶対位置ボックスには `stretch` のように動作します。
+    - 絶対位置指定レイアウトの固定位置指定時は、このキーワードは `stretch` と同様に動作します。
+    - フレックスアイテムでは、このキーワードは `stretch` と同様に動作します。
+    - グリッドアイテムでは、このキーワードは `stretch` のうちの一つと似た動作をしますが、アスペクト比や固有の寸法を持つボックスは `start` のように動作します。
+    - ブロックレベルボックスと表のセルでは、プロパティは適用されません。
+
+- `self-start`
+  - : アイテムは交差軸の開始側に対応する配置コンテナーの端に詰めて配置されます。
+- `self-end`
+  - : アイテムは交差軸の終端側に対応する配置コンテナーの端に詰めて配置されます。
+- `flex-start`
+  - : このフレックスアイテムの cross-start マージン側が、行の cross-start 側に詰められます。
+- `flex-end`
+  - : このフレックスアイテムの cross-end マージン側が、行の cross-end 側に詰められます。
+- `center`
+  - : このフレックスアイテムのマージンボックスが、行の交差軸方向の中央に配置されます。アイテムの交差軸方向の寸法がフレックスコンテナーよりも大きい場合は、両方向に均等にはみ出します。
+- `baseline`, `first baseline`, `last baseline`
+  - : first-baseline 配置または last-baseline 配置への関与を指定します。ボックスの最初または最後のベースラインセットの配置ベースラインを、ベースライン共有グループ内のすべてのボックスで共有される最初または最後のベースラインセットで対応するベースラインに揃えます。
+    `first baseline` の代替配置は `start`、`last baseline` の代替配置は `end` です。
+- `stretch`
+  - : アイテムの交差軸方向の寸法の合計値が、配置コンテナーの寸法よりも小さく、アイテムの寸法が `auto` であった場合、アイテムの寸法は {{cssxref("max-height")}}/{{cssxref("max-width")}} (または同等の機能) で課された制約を尊重しつつ、均等の寸法 (比例的ではない) に拡大されるので、 `auto` が指定されたアイテムすべての寸法の合計は、ちょうど配置コンテナーの交差軸方向を埋めるようになります。
+- `safe`
+  - : アイテムのサイズが配置コンテナーを超えるとき、アイテムは配置モードが `start` であったかのように配置されます。
+- `unsafe`
+  - : アイテムの配置コンテナーのサイズの関係にかかわらず、指定した値を尊重します。
+
+## 公式定義
+
+{{CSSInfo}}
+
+## 関連情報
 
 {{csssyntax}}
 
-<h2 id="Example" name="Example">例</h2>
+<h2 id="Examples">例</h2>
 
-<h3 id="HTML" name="HTML">HTML</h3>
+### HTML
 
-<pre class="brush: html">&lt;section&gt;
-  &lt;div&gt;Item #1&lt;/div&gt;
-  &lt;div&gt;Item #2&lt;/div&gt;
-  &lt;div&gt;Item #3&lt;/div&gt;
-&lt;/section&gt;</pre>
+```html
+<section>
+  <div>Item #1</div>
+  <div>Item #2</div>
+  <div>Item #3</div>
+</section>
+```
 
-<h3 id="CSS" name="CSS">CSS</h3>
+### CSS
 
-<pre class="brush: css">section {
+```css
+section {
   display: flex;
   align-items: center;
   height: 120px;
@@ -121,54 +126,25 @@ div {
 div:nth-child(3) {
   align-self: flex-end;
   background: pink;
-}</pre>
-
-<h3 id="Result" name="Result">表示結果</h3>
-
-<p>{{EmbedLiveSample('Example')}}</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-align-self", "align-self")}}</td>
-   <td>{{Spec2("CSS3 Box Alignment")}}</td>
-   <td>最新の構文定義に更新。</td>
-  </tr>
-  <tr>
-   <td>{{SpecName("CSS3 Flexbox", "#propdef-align-self", "align-self")}}</td>
-   <td>{{Spec2("CSS3 Flexbox")}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
-</table>
+}
+```
 
-<p>{{cssinfo}}</p>
+### 結果
 
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+{{EmbedLiveSample('Examples')}}
 
-<h3 id="Support_in_Flex_layout" name="Support_in_Flex_layout">フレックスレイアウトでの対応</h3>
+## 仕様書
 
-<p>{{Compat("css.properties.align-self.flex_context")}}</p>
+{{Specifications("css.properties.align-self.grid_context")}}
 
-<h3 id="Support_in_Grid_layout" name="Support_in_Grid_layout">グリッドレイアウトでの対応</h3>
+## ブラウザーの互換性
 
-<p>{{Compat("css.properties.align-self.grid_context")}}</p>
+{{Compat}}
 
-<h2 id="See_also" name="See_also">関連情報</h2>
+## 関連情報
 
-<ul>
- <li>CSS フレックスボックスガイド: <em><a href="/ja/docs/Web/CSS/CSS_Flexible_Box_Layout/Basic_Concepts_of_Flexbox">フレックスボックスの基本概念</a></em></li>
- <li>CSS フレックスボックスガイド: <em><a href="/ja/docs/Web/CSS/CSS_Flexible_Box_Layout/Aligning_Items_in_a_Flex_Container">フレックスコンテナー内でのアイテムの配置</a></em></li>
- <li>CSS グリッドガイド: <em><a href="/ja/docs/Web/CSS/CSS_Grid_Layout/Box_Alignment_in_CSS_Grid_Layout">CSS グリッドレイアウト内でのボックス配置</a></em></li>
- <li><a href="/ja/docs/Web/CSS/CSS_Box_Alignment">CSS ボックス配置</a></li>
- <li>{{cssxref("align-items")}} プロパティ</li>
-</ul>
+- CSS フレックスボックスガイド: _[フレックスボックスの基本概念](/ja/docs/Web/CSS/CSS_Flexible_Box_Layout/Basic_Concepts_of_Flexbox)_
+- CSS フレックスボックスガイド: _[フレックスコンテナー内でのアイテムの配置](/ja/docs/Web/CSS/CSS_Flexible_Box_Layout/Aligning_Items_in_a_Flex_Container)_
+- CSS グリッドガイド: _[CSS グリッドレイアウト内でのボックス配置](/ja/docs/Web/CSS/CSS_Grid_Layout/Box_Alignment_in_CSS_Grid_Layout)_
+- [CSS ボックス配置](/ja/docs/Web/CSS/CSS_Box_Alignment)
+- {{cssxref("align-items")}} プロパティ