CSS Positioned Layout のプロパティの文書を更新

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

1 files changed, 74 insertions, 93 deletions

diff --git a/files/ja/web/css/top/index.md b/files/ja/web/css/top/index.md
index c6ff6fb4bc..87b3c530cd 100644
--- a/files/ja/web/css/top/index.md
+++ b/files/ja/web/css/top/index.md
@@ -3,38 +3,36 @@ title: top
 slug: Web/CSS/top
 tags:
   - CSS
-  - CSS Positioning
-  - CSS Property
-  - Reference
-  - 'recipe:css-property'
+  - CSS 位置指定レイアウト
+  - CSS プロパティ
+  - リファレンス
+  - recipe:css-property
+browser-compat: css.properties.top
 translation_of: Web/CSS/top
 ---
-<div>{{CSSRef}}</div>
+{{CSSRef}}
 
-<p><strong><code>top</code></strong> は <a href="/ja/docs/Web/CSS" title="CSS">CSS</a> のプロパティで、<ruby><a href="/ja/docs/Web/CSS/position">位置指定要素</a><rp> (</rp><rt>positioned elements</rt><rp>) </rp></ruby>の垂直位置の決定に関与します。位置指定されていない要素には効果はありません。</p>
+**`top`** は [CSS](/ja/docs/Web/CSS) のプロパティで、[位置指定要素](/ja/docs/Web/CSS/position)の垂直位置の決定に関与します。位置指定されていない要素には効果はありません。
 
-<div>{{EmbedInteractiveExample("pages/css/top.html")}}</div>
+{{EmbedInteractiveExample("pages/css/top.html")}}
 
-<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p>
+`top` の効果は、要素がどの様に配置されているか (つまり、 {{cssxref("position")}} プロパティの値) によって変わります。
 
-<p><code>top</code> の効果は、要素がどの様に配置されているか (つまり、 {{cssxref("position")}} プロパティの値) によって変わります。</p>
+- `position` が `absolute` または `fixed` に設定されている場合、 `top` プロパティは要素の上辺と包含ブロックの上辺との間の距離を指定します。
+- `position` が `relative` に設定されている場合、 `top` プロパティは要素の上辺が通常位置から下方へ移動する量を指定します。
+- `position` が `sticky` に設定されている場合、 `top` プロパティは粘着制約矩形の計算に使用されます。
+- `position` が `static` に設定されている場合、 `top` プロパティは*効果がありません*。
 
-<ul>
- <li><code>position</code> が <code>absolute</code> または <code>fixed</code> に設定されている場合、 <code>top</code> プロパティは要素の上辺と包含ブロックの上辺との間の距離を指定します。</li>
- <li><code>position</code> が <code>relative</code> に設定されている場合、 <code>top</code> プロパティは要素の上辺が通常位置から下方へ移動する量を指定します。</li>
- <li><code>position</code> が <code>sticky</code> に設定されている場合、 <code>top</code> プロパティは粘着制約矩形の計算に使用されます。</li>
- <li><code>position</code> が <code>static</code> に設定されている場合、 <code>top</code> プロパティは<em>効果がありません</em>。</li>
-</ul>
+`top` と {{cssxref("bottom")}} の両方が指定されており、 `position` が `absolute` または `fixed` に設定されており、*かつ* {{cssxref("height")}} が未指定 (`auto` または `100%` のどちらか) の場合は、 `top` と `bottom` の距離が尊重されます。それ以外の場合、 {{cssxref("height")}} が何らかの形で制約されていた場合、または `position` が `relative` に設定されていた場合は、 `top` プロパティが優先されて `bottom` プロパティは無視されます。
 
-<p><code>top</code> と {{cssxref("bottom")}} の両方が指定されており、 <code>position</code> が <code>absolute</code> または <code>fixed</code> に設定されており、<em>かつ</em> {{cssxref("height")}} が未指定 (<code>auto</code> または <code>100%</code> のどちらか) の場合は、 <code>top</code> と <code>bottom</code> の距離が尊重されます。それ以外の場合、 {{cssxref("height")}} が何らかの形で制約されていた場合、または <code>position</code> が <code>relative</code> に設定されていた場合は、 <code>top</code> プロパティが優先されて <code>bottom</code> プロパティは無視されます。</p>
+## 構文
 
-<h2 id="Syntax" name="Syntax">構文</h2>
-
-<pre class="brush:css no-line-numbers notranslate">/* &lt;length&gt; 値 */
+```css
+/* <length> 値 */
 top: 3px;
 top: 2.4em;
 
-/* 包含ブロックの高さに対する &lt;percentage&gt; */
+/* 包含ブロックの高さに対する <percentage> */
 top: 10%;
 
 /* キーワード値 */
@@ -43,43 +41,45 @@ top: auto;
 /* グローバル値 */
 top: inherit;
 top: initial;
+top: revert;
 top: unset;
-</pre>
-
-<h3 id="Values" name="Values">値</h3>
-
-<dl>
- <dt>{{cssxref("&lt;length&gt;")}}</dt>
- <dd>負、null、または正の {{cssxref("&lt;length&gt;")}} で、以下のものを表します。
- <ul>
-  <li><em>絶対位置指定要素</em>の場合は、包含ブロックの上辺までの距離。</li>
-  <li><em>相対位置指定要素</em>の場合は、通常の位置からの下方向への移動量。</li>
- </ul>
- </dd>
- <dt>{{cssxref("&lt;percentage&gt;")}}</dt>
- <dd>包含ブロックの高さに対する {{cssxref("&lt;percentage&gt;")}} です。</dd>
- <dt><code>auto</code></dt>
- <dd>以下のように指定します。
- <ul>
-  <li><em>絶対位置指定要素</em>では、要素の位置は {{Cssxref("bottom")}} プロパティに基づいて決まり、 <code>height: auto</code> は内容物の高さに基づいて決まります。また、 <code>bottom</code> も <code>auto</code> であった場合は、要素は垂直方向には静的要素が配置される場合と同様に配置されます。</li>
-  <li><em>相対位置指定要素</em>では、通常の位置から要素までの距離は {{Cssxref("bottom")}} に基づきます。また、 <code>bottom</code> も <code>auto</code> であった場合は、垂直方向には移動しません。</li>
- </ul>
- </dd>
- <dt><code>inherit</code></dt>
- <dd>値が親要素 (包含ブロックとは限りません) の計算値と同じであることを示すキーワードです。そして、この計算値は {{cssxref("&lt;length&gt;")}}, {{cssxref("&lt;percentage&gt;")}}, または <code>auto</code> キーワードと同様に扱われます。</dd>
-</dl>
-
-<h2 id="Formal_definition" name="Formal_definition">公式定義</h2>
-
-<p>{{CSSInfo}}</p>
-
-<h2 id="Formal_syntax" name="Formal_syntax">形式文法</h2>
+```
+
+### 値
+
+- {{cssxref("&lt;length&gt;")}}
+
+  - : 負、null、または正の {{cssxref("&lt;length&gt;")}} で、以下のものを表します。
+
+    - *絶対位置指定要素*の場合は、包含ブロックの上辺までの距離。
+    - *相対位置指定要素*の場合は、通常の位置からの下方向への移動量。
+
+- {{cssxref("&lt;percentage&gt;")}}
+  - : 包含ブロックの高さに対する {{cssxref("&lt;percentage&gt;")}} です。
+- `auto`
+
+  - : 以下のように指定します。
+
+    - *絶対位置指定要素*では、要素の位置は {{Cssxref("bottom")}} プロパティに基づいて決まり、 `height: auto` は内容物の高さに基づいて決まります。また、 `bottom` も `auto` であった場合は、要素は垂直方向には静的要素が配置される場合と同様に配置されます。
+    - *相対位置指定要素*では、通常の位置から要素までの距離は {{Cssxref("bottom")}} に基づきます。また、 `bottom` も `auto` であった場合は、垂直方向には移動しません。
+
+- `inherit`
+  - : 値が親要素 (包含ブロックとは限りません) の計算値と同じであることを示すキーワードです。そして、この計算値は {{cssxref("&lt;length&gt;")}}, {{cssxref("&lt;percentage&gt;")}}, または `auto` キーワードと同様に扱われます。
+
+## 公式定義
+
+{{CSSInfo}}
+
+## 形式文法
 
 {{csssyntax}}
 
-<h2 id="Examples" name="Examples">例</h2>
+<h2 id="Examples">例</h2>
+
+### 位置指定要素を上から 10% に設定
 
-<pre class="brush: css notranslate">body {
+```css
+body {
   background: beige;
 }
 
@@ -91,44 +91,25 @@ div {
   left: 15%;
   background: gold;
   border: 1px solid blue;
-}</pre>
-
-<pre class="brush: html notranslate">&lt;div&gt;この内容の寸法は、辺の位置によって決まります。&lt;/div&gt;</pre>
-
-<p>{{EmbedLiveSample('Examples','100%','200')}}</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 Positioning', '#propdef-top', 'top')}}</td>
-   <td>{{Spec2('CSS3 Positioning')}}</td>
-   <td>sticky の位置の動作を追加</td>
-  </tr>
-  <tr>
-   <td>{{SpecName('CSS2.1', 'visuren.html#propdef-top', 'top')}}</td>
-   <td>{{Spec2('CSS2.1')}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
-
-<p>{{Compat("css.properties.top")}}</p>
-
-<h2 id="See_also" name="See_also">関連情報</h2>
-
-<ul>
- <li>{{cssxref("inset")}} は関連する {{cssxref("top")}}, {{cssxref("bottom")}}, {{cssxref("left")}}, {{cssxref("right")}} プロパティすべての一括指定です</li>
- <li>対応する論理プロパティ: {{cssxref("inset-block-start")}}, {{cssxref("inset-block-end")}}, {{cssxref("inset-inline-start")}}, {{cssxref("inset-inline-end")}} および一括指定の {{cssxref("inset-block")}} と {{cssxref("inset-inline")}}</li>
- <li>{{cssxref("position")}}</li>
-</ul>
+}
+```
+
+```html
+<div>この内容の寸法は、辺の位置によって決まります。</div>
+```
+
+{{EmbedLiveSample('Examples','100%','200')}}
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{cssxref("inset")}}: 関連するすべてのプロパティである {{cssxref("top")}}, {{cssxref("bottom")}}, {{cssxref("left")}}, {{cssxref("right")}} の一括指定
+- 対応する論理的プロパティ: {{cssxref("inset-block-start")}}, {{cssxref("inset-block-end")}}, {{cssxref("inset-inline-start")}}, {{cssxref("inset-inline-end")}} および一括指定の {{cssxref("inset-block")}} と {{cssxref("inset-inline")}}
+- {{cssxref("position")}}