max-block-size

CSS の max-block-size プロパティは、 writing-mode で指定された書字方向とは逆の向きの要素の最大寸法を指定します。すなわち、書字方向が水平 (横書き) であれば、 max-block-size は max-height と等価になります。書字方向が垂直 (縦書き) であれば、 max-block-size は max-width と同じになります。

もう一方の方向の最大長は、 max-inline-size プロパティを使用して指定します。

max-width は常に水平方向の寸法に使われ、 max-height は常に垂直方向の寸法に使われるため、このプロパティはテキストコンテンツの寸法に基づいて寸法を設定する必要がある場合、書字方向を意識して指定する必要がある場合に便利です。

ふつう max-height または max-width を使用する場面でいつでも、代わりに max-block-size をコンテンツの最大の「高さ」を設定するために使用し (垂直の値でなくても)、 max-inline-sizeをコンテンツの最大の「幅」を設定するために使用してください (これが横書きではなく縦書きである場合であっても)。様々な書字方向を表す例 in writing-modeをご覧ください。

構文

/* <length> 値 */
max-block-size: 300px;
max-block-size: 25em;

/* <percentage> 値 */
max-block-size: 75%;

/* キーワード値 */
max-block-size: none;
max-block-size: max-content;
max-block-size: min-content;
max-block-size: fit-content;
max-block-size: fill-available;

/* グローバル値 */
max-block-size: inherit;
max-block-size: initial;
max-block-size: unset;

値

max-block-size プロパティの値は、 max-width および max-height プロパティで有効なすべての値を取ることができます。

<length>

絶対的な値による最大幅です。

<percentage>

包含ブロックの幅に対するパーセント値で表した最大幅です。

キーワード値

none

幅に最大値を指定しません。

max-content

内容物に合わせた最適な幅です。

min-content

内容物に合わせた最小の幅です。

fill-available

包含ブロックの幅から、水平方向のマージン、境界、パディングを取り除いた寸法です。 (ブラウザーによっては、このキーワードの旧称である available を実装しています。)

fit-content

max-content と同じです。

書字方向が方向にどう影響するのか

writing-mode の値は次のように max-block-size から max-width または max-height への対応付けに影響します。

形式文法

<'max-width'>

例

この例では、同じテキスト (Herman Melville の小説 Moby-Dick の冒頭部分) が horizontal-tb および vertical-rl の両方の書字方向で表示されます。

二つのボックスついてそれ以外の部分はすべて、 max-block-size に使われている値を含めて同じです。

HTML

この HTML では、単純に二つの <div> ブロックを作成し、それぞれの writing-mode を horizontal および vertical クラスを用いて設定しています。両方のボックスで standard-box クラスを共有しており、こちらで単純に色、パディング、それぞれの max-block-size の値を設定しています。

<p>Writing mode <code>horizontal-tb</code> (the default):</p>
<div class="standard-box horizontal">
  Call me Ishmael. Some years ago—never mind how
  long precisely—having little or no money in my
  purse, and nothing particular to interest me on
  shore, I thought I would sail about a little and see
  the watery part of the world. It is a way I have of
  driving off the spleen and regulating the
  circulation.
</div>

<p>Writing mode <code>vertical-rl</code>:</p>
<div class="standard-box vertical">
  Call me Ishmael. Some years ago—never mind how
  long precisely—having little or no money in my
  purse, and nothing particular to interest me on
  shore, I thought I would sail about a little and see
  the watery part of the world. It is a way I have of
  driving off the spleen and regulating the
  circulation.
</div>

CSS

この CSS では3つのクラスを定義しています。最初は standard-box で、両方のボックスに適用され、上にあるものです。これはブロックの最小および最大の寸法、フォントの大きさ、などを指定します。

その後にくるクラス horizontal および vertical は、ボックスに writing-mode プロパティを追加し、値を使われるクラスに応じて horizontal-tb または vertical-rl に設定します。

.standard-box {
  padding: 4px;
  background-color: #abcdef;
  color: #000;
  font: 16px "Open Sans", "Helvetica", "Arial", sans-serif;
  max-block-size: 160px;
  min-block-size: 100px;
}

.horizontal {
  writing-mode: horizontal-tb;
}

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

結果

二つのボックスは最終的にこの様に見えます。

仕様書

ブラウザーの対応

関連情報

• 対応する物理的プロパティ: max-width と max-height
• 他の方向の最大寸法の設定: max-inline-size
• writing-mode