margin-block-start

Baseline Widely available

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

margin-block-start は CSS のプロパティで、要素のインライン方向の論理的な先頭側のマージンを定義し、それが要素の書字方向やテキストの方向に応じて物理的なマージンに対応づけられます。

試してみましょう

構文

css
/* <length> 値 */
margin-block-start: 10px; /* 絶対的な長さ */
margin-block-start: 1em; /* テキストの大きさに対する相対値 */
margin-block-start: 5%; /* 直近のブロックコンテナーの大きさに対する相対値 */

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

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

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

関連プロパティとして、要素の他のマージンを定義する margin-block-end, margin-inline-start, margin-inline-end があります。

値

margin-block-start プロパティは margin-left プロパティと同じ値を取ります。

公式定義

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

形式文法

margin-block-start = 
  <'margin-top'>  

<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

例

ブロック方向の先頭のマージンの設定

HTML

html
<div>
  <p class="exampleText">Example text</p>
</div>

CSS

css
div {
  background-color: yellow;
  width: 120px;
  height: 120px;
}

.exampleText {
  writing-mode: vertical-lr;
  margin-block-start: 20px;
  background-color: #c8c800;
}

結果

仕様書

Specification
CSS Logical Properties and Values Level 1
# margin-properties

ブラウザーの互換性

BCD tables only load in the browser

関連情報