margin-inline

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

* Some parts of this feature may have varying levels of support.

The margin-inline は CSS の一括指定プロパティで、論理的なインライン方向の先頭と末尾のマージンを設定します。これは要素の書字方向やテキストの向きに応じて物理的なマージンに変換されます。

試してみましょう

margin-inline: 5% 10%;
writing-mode: horizontal-tb;

margin-inline: 10px 40px;
writing-mode: vertical-rl;

margin-inline: 5% 10%;
writing-mode: horizontal-tb;
direction: rtl;

<section id="default-example">
  <div id="container">
    <div class="col">One</div>
    <div class="col transition-all" id="example-element">Two</div>
    <div class="col">Three</div>
  </div>
</section>

#container {
  width: 300px;
  height: 200px;
  display: flex;
  align-content: flex-start;
  justify-content: flex-start;
}

.col {
  width: 33.33%;
  border: solid #ce7777 10px;
  background-color: #2b3a55;
  color: white;
  flex-shrink: 0;
}

#example-element {
  border: solid 10px #ffbf00;
  background-color: #2b3a55;
  unicode-bidi: bidi-override;
}

構成要素のプロパティ

このプロパティは以下の CSS プロパティの一括指定です。

構文

css

/* <length> 値 */
margin-inline: 10px 20px; /* 絶対的な長さ */
margin-inline: 1em 2em; /* テキストの大きさに対する相対値 */
margin-inline: 5% 2%; /* 直近のブロックコンテナーの大きさに対する相対値 */
margin-inline: 10px; /* 先頭と末尾の両方を設定 */
margin-inline: anchor-size(width);
margin-inline: calc(anchor-size(self-block) / 5) auto;

/* キーワード値 */
margin-inline: auto;

/* グローバル値 */
margin-inline: inherit;
margin-inline: initial;
margin-inline: revert;
margin-inline: revert-layer;
margin-inline: unset;

このプロパティは、 margin-top と margin-bottom、または margin-right と margin-left プロパティに、 writing-mode, direction, text-orientation で定義された値にしたがって対応します。

margin-inline プロパティは、 1 つまたは 2 つの値を使用して指定します。

1 つの値が指定された場合は、先頭と末尾の両方に同じマージンを適用します。
2 つの値が指定された場合は、 1 つ目のマージンが先頭に、 2 つ目のマージンが末尾に指定されます。

値

margin-inline プロパティは、 margin プロパティと同じ値を取ります。

公式定義

初期値	一括指定の次の各プロパティとして `margin-inline-start`: `0` `margin-inline-end`: `0`
適用対象	`margin` と同じ
継承	なし
パーセント値	レイアウトモデルに依存
計算値	一括指定の次の各プロパティとして `margin-inline-start`: 長さで指定されると相当する絶対的な長さ、パーセント値として指定されると指定値、それ以外では `auto` `margin-inline-end`: 長さで指定されると相当する絶対的な長さ、パーセント値として指定されると指定値、それ以外では `auto`
アニメーションの種類	length

形式文法

margin-inline = 
  <'margin-top'>{1,2}  

<margin-top> = 
  <length-percentage>  |
  auto                 |
  <anchor-size()>      

<length-percentage> = 
  <length>      |
  <percentage>  

<anchor-size()> = 
  anchor-size( [ <anchor-name> || <anchor-size> ]? , <length-percentage>? )  

<anchor-name> = 
  <dashed-ident>  

<anchor-size> = 
  width        |
  height       |
  block        |
  inline       |
  self-block   |
  self-inline

例

インライン方向の先頭と末尾のマージンの設定

CSS

css

div {
  background-color: yellow;
  width: 120px;
  height: auto;
  border: 1px solid green;
}

p {
  margin: 0;
  margin-inline: 20px 40px;
  background-color: tan;
}

.verticalExample {
  writing-mode: vertical-rl;
}

HTML

html

<div>
  <p>テキストの例</p>
</div>
<div class="verticalExample">
  <p>テキストの例</p>
</div>

結果

仕様書

Specification
CSS Logical Properties and Values Level 1 # propdef-margin-inline