CSS スクロールスナップに関するページを更新

- scroll-margin-block-end および scroll-margin-block-start は新規翻訳
- 「CSS スクロールスナップの基本概念」は新規翻訳
- それ以外は 2021/10/09 時点の英語版に同期

1 files changed, 124 insertions, 36 deletions

diff --git a/files/ja/web/css/scroll-margin-inline/index.md b/files/ja/web/css/scroll-margin-inline/index.md
index 06d1900196..6fb2eda59d 100644
--- a/files/ja/web/css/scroll-margin-inline/index.md
+++ b/files/ja/web/css/scroll-margin-inline/index.md
@@ -3,64 +3,152 @@ title: scroll-margin-inline
 slug: Web/CSS/scroll-margin-inline
 tags:
   - CSS
-  - CSS Property
   - CSS プロパティ
   - Reference
   - Web
+  - recipe:css-shorthand-property
   - scroll-margin
   - scroll-margin-inline
+browser-compat: css.properties.scroll-margin-inline
 translation_of: Web/CSS/scroll-margin-inline
 ---
-<div>{{CSSRef}}</div>
+{{CSSRef}}
 
-<p><code>scroll-margin-inline</code> プロパティは、インライン方向の scroll-margin の個別指定を設定する一括指定プロパティです。</p>
+`scroll-margin-inline` は[一括指定プロパティ](/ja/docs/Web/CSS/Shorthand_properties)で、インライン方向のスクロールマージンを設定します。
 
-<p>scroll-margin 系のプロパティは、このボックスをスナップポートにスナップするために使用されます。スクロールスナップ領域は変換された境界ボックスによって定義され、四角形の囲みボックスを探して (スクロールコンテナーの座標空間における軸に合わせられ)、それから指定された外部距離が追加されます。</p>
+## 構成要素のプロパティ
 
-<p>{{cssinfo}}</p>
+このプロパティは以下の CSS プロパティの一括指定です。
 
-<h2 id="Syntax" name="Syntax">構文</h2>
+- [`scroll-margin-inline-end`](/ja/docs/Web/CSS/scroll-margin-inline-end)
+- [`scroll-margin-inline-start`](/ja/docs/Web/CSS/scroll-margin-inline-start)
 
-<pre class="brush: css">/* &lt;length&gt; 値 */
+## 構文
+
+```css
+/* <length> 値 */
 scroll-margin-inline: 10px;
 scroll-margin-inline: 1em .5em ;
 
 /* グローバル値 */
 scroll-margin-inline: inherit;
 scroll-margin-inline: initial;
+scroll-margin-inline: revert;
 scroll-margin-inline: unset;
-</pre>
+```
+
+### 値
+
+- `<length>`
+  - : スクロールコンテナーの対応する辺からの距離です。
+
+## 解説
+
+scroll-margin 系のプロパティは、このボックスをスナップポートにスナップするために使用されます。スクロールスナップ領域は変換された境界ボックスによって定義され、四角形の囲みボックスを探して (スクロールコンテナーの座標空間における軸に合わせられ)、それから指定された外部距離が追加されます。
 
-<h3 id="Values" name="Values">値</h3>
+## 公式定義
 
-<dl>
- <dt><code><var>&lt;length&gt;</var></code></dt>
- <dd>スクロールコンテナーの対応する辺からの距離です。</dd>
-</dl>
+{{cssinfo}}
 
-<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
+## 形式文法
 
 {{csssyntax}}
 
-<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 Scroll Snap Points", "#propdef-scroll-margin-inline", "scroll-margin-inline")}}</td>
-   <td>{{Spec2("CSS Scroll Snap Points")}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
-
-<p>{{Compat("css.properties.scroll-margin-inline")}}</p>
+## 例
+
+<h3 id="Simple_demonstration">簡単なデモ</h3>
+
+この例では、上記のインタラクティブ例と非常によく似たものを実装していますが、ここではその実装方法を説明します。
+
+ここでの目的は、水平方向にスクロールする 4 つのブロックを作成することです。2 つ目と 3 つ目のブロックは、それぞれのブロックの右端に近いところでスナップします。
+
+#### HTML
+
+ブロックを表す HTML はとても簡単です。
+
+```html
+<div class="scroller">
+  <div>1</div>
+  <div>2</div>
+  <div>3</div>
+  <div>4</div>
+</div>
+```
+
+#### CSS
+
+外側のコンテナーのスタイルは以下のようになっています。
+
+```css
+.scroller {
+  text-align: left;
+  width: 250px;
+  height: 250px;
+  overflow-x: scroll;
+  display: flex;
+  box-sizing: border-box;
+  border: 1px solid #000;
+  scroll-snap-type: x mandatory;
+}
+```
+
+スクロールスナップに関連する主な部品は、`overflow-x: scroll` で、コンテンツがスクロールしても隠れないようにしています。また、`scroll-snap-type: x mandatory` で、スクロールのスナップは水平軸に沿って行わなければならず、スクロールは常にスナップ点で静止するようになっています。
+
+子要素のスタイルは次のようになっています。
+
+```css
+.scroller > div {
+  flex: 0 0 250px;
+  width: 250px;
+  background-color: #663399;
+  color: #fff;
+  font-size: 30px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  scroll-snap-align: end;
+}
+
+.scroller > div:nth-child(2n) {
+  background-color: #fff;
+  color: #663399;
+}
+```
+
+ここで最も重要なのは `scroll-snap-align: end` で、これは右側の端 (ここでは x 軸に沿った「末尾」) をスナップ点として指定するものです。
+
+
+最後に、スクロールのマージン値を指定しますが、これは 2 番目と 3 番目の子要素に対して異なる値を指定します。
+
+```css
+.scroller > div:nth-child(2) {
+  scroll-margin-inline: 1rem;
+}
+
+.scroller > div:nth-child(3) {
+  scroll-margin-inline: 2rem;
+}
+```
+
+つまり、真ん中の子要素を過ぎてスクロールした場合、2 番目の `<div>` のインラインの末尾から `1rem`、3 番目の `<div>` のインラインの末尾から `2rem` のところでスナップすることになります。
+
+> **Note:** ここでは `scroll-margin` をインライン軸 (この場合は X 軸) の先頭*と*末尾に一度に設定していますが、実際に関係するのは末尾側だけです。例えば `scroll-margin-inline: 0 1rem` や `scroll-margin-inline-end: 1rem` などのように、一辺のみにスクロールマージンを設定しても同様に機能します。
+
+#### 結果
+
+自分でやってみましょう。
+
+{{EmbedLiveSample('Simple_demonstration', '100%', 300)}}
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [CSS スクロールスナップ](/ja/docs/Web/CSS/CSS_Scroll_Snap)
+- [Well-Controlled Scrolling with CSS Scroll Snap](https://web.dev/css-scroll-snap/)