flex

CSS の flex プロパティは、フレックスアイテムをフレックスコンテナーの領域に収めるために、どのように伸長・収縮させるかを指定します。これは flex-grow, flex-shrink, flex-basis を設定する一括指定プロパティです。

この対話型サンプルのソースファイルは GitHub リポジトリに格納されています。対話型サンプルプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。

多くの場合、 flex には auto、 initial、 none、 または単位のない正の数を設定してください。これらの値の効果を確認するには、以下のフレックスコンテナーの大きさを変更してみてください。

<div class="flex-container">
  <div class="item auto">auto</div>
  <div class="item auto">auto</div>
  <div class="item auto">auto</div>
</div>

<div class="flex-container">
  <div class="item auto">auto</div>
  <div class="item initial">initial</div>
  <div class="item initial">initial</div>
</div>

<div class="flex-container">
  <div class="item auto">auto</div>
  <div class="item auto">auto</div>
  <div class="item none">none</div>
</div>

<div class="flex-container">
  <div class="item initial">initial</div>
  <div class="item none">none</div>
  <div class="item none">none</div>
</div>

<div class="flex-container">
  <div class="item four">4</div>
  <div class="item two">2</div>
  <div class="item one">1</div>
</div>

* {
  box-sizing: border-box;
}

.flex-container {
  background-color: #F4F7F8;
  resize: horizontal;
  overflow: hidden;
  display: flex;
  margin: 1em;
}

.item {
  margin: 1em;
  padding: 0.5em;
  width: 110px;
  min-width: 0;
  background-color: #1B5385;
  color: white;
  font-family: monospace;
  font-size: 13px;
}

.initial {
  flex: initial;
}

.auto {
  flex: auto;
}

.none {
  flex: none;
}

.four {
  flex: 4;
}

.two {
  flex: 2;
}

.one {
  flex: 1;
}

構文

/* 基本の値 */
flex: auto;
flex: initial;
flex: none;
flex: 2;

/* 単位がない数値を1つ指定: flex-grow */
flex: 2;

/* 幅または高さを1つ指定: flex-basis */
flex: 10em;
flex: 30px;

/* 値を2つ指定: flex-grow | flex-basis */
flex: 1 30px;

/* 値を2つ指定: flex-grow | flex-shrink */
flex: 2 2;

/* 値を3つ指定: flex-grow | flex-shrink | flex-basis */
flex: 2 2 10%;

/* グローバル値 */
flex: inherit;
flex: initial;
flex: unset;

flex プロパティは1つ、2つ、3つの値を取ることがあります。

値1つの構文: 値は以下のうちの1つです。

• 単位なしの 数値: <flex-grow> として解釈されます。
• width として有効な値: <flex-basis> として解釈されます。
• none, auto, initial のキーワード値のいずれか。

値2つの構文: 最初の値は単位なしの <number> でなければならず、 <flex-grow> として解釈されます。2つ目の値は以下のうちの1つです。

• 単位なしの <number>: <flex-shrink> として解釈されます。
• width として有効な値: <flex-basis> として解釈されます。

値3つの構文:

• 最初の値は単位なしの <number> でなければならず、 <flex-grow> として解釈されます。
• 2つ目の値は単位なしの <number> でなければならず、 <flex-shrink> として解釈されます。
• 3つ目の値は width として有効な値でなければならず、 <flex-basis> として解釈されます。

値

<'flex-grow'>

フレックスアイテムの flex-grow を定義します。詳しくは <number> をご覧ください。負の値は無効とみなされます。省略時の既定値は 0 です。

<'flex-shrink'>

フレックスアイテムの flex-shrink を定義します。詳しくは <number> をご覧ください。負の値は無効とみなされます。省略時の既定値は 1 です。

<'flex-basis'>

フレックスアイテムの flex-basis を定義します。width プロパティおよび height プロパティで有効な値を受け入れます。希望サイズが 0 ならば、フレキシビリティとして解釈されないように単位をつけなければなりません。省略時の既定値は 0 です。

none

このキーワードは 0 0 auto を算出します。

形式構文

none | [ <'flex-grow'> <'flex-shrink'>? || <'flex-basis'> ]

例

#flex-container {
  display: flex;
  flex-direction: row;
}

#flex-container > .flex-item {
  flex: auto;
}

#flex-container > .raw-item {
  width: 5rem;
}

<div id="flex-container">
  <div class="flex-item" id="flex">Flex box (click to toggle raw box)</div>
  <div class="raw-item" id="raw">Raw box</div>
</div>

var flex = document.getElementById("flex");
var raw = document.getElementById("raw");
flex.addEventListener("click", function() {
  raw.style.display = raw.style.display == "none" ? "block" : "none";
});

#flex-container {
  width: 100%;
  font-family: Consolas, Arial, sans-serif;
}

#flex-container > div {
  border: 1px solid #f00;
  padding: 1rem;
}

#flex-container > .raw-item {
  border: 1px solid #000;
}

結果

仕様書

ブラウザーの対応

このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。

関連情報

• CSS フレックスボックスガイド: フレックスボックスの基本概念
• CSS フレックスボックスガイド: 主軸に沿ったフレックスアイテムの比率の制御