flex-wrap:フレックス・コンテナに入り切らないアイテムの折り返し方法を指定する

初期値 nowrap
適用対象 フレックス・コンテナ
継承 しない
アニメーション 離散値
対応ブラウザ caniuseで確認

flex-wrapプロパティの説明

flex-wrapは、フレックス・コンテナに入り切らないアイテムの折り返し方法を指定します。アイテムの基準となる寸法の合計がコンテナのサイズを上回った場合に、単一行に押し込むように縮めるのか、複数行に折り返すのかを指定します。

折り返しを許可する場合は、交差軸の方向へ重なる向きも制御できます。折り返しを許可しない場合は、アイテムやコンテンツのはみ出しを制御するプロパティの値によって、ボックスの挙動が変わります。

flex-wrapは、flex-directionの機能と密接に関わっています。これらを一括で指定する場合は、ショートハンド・プロパティのflex-flowを使用して下さい。

これらの機能の関係性を把握したい方は、フレックス・ボックスの解説を参照して下さい。

flex-wrapに指定できる値

nowrap
アイテムの折り返しを許可しません。コンテナの寸法が狭まった時、アイテムは最小値まで縮まり、収まりきらなかった部分が途中で見切れたりはみ出すようになります。交差軸は、flex-directionの値に応じてstartまたはbeforeと同一になります。
wrap
アイテムの折り返しを許可します。コンテナの寸法が狭まった時、アイテムは寸法を保つために折り返して配置されます。交差軸は、flex-directionの値に応じてstartまたはbeforeと同一になり、cross-endは指定された cross-startの反対側になります。

flex-wrapの使い方とサンプル

flex-wrapプロパティの構文は以下の通りです。

CSS
/* キーワード値 */
flex-wrap: nowrap;
flex-wrap: wrap;
flex-wrap: wrap-reverse;

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

flex-wrapの実例

それでは実際にflex-wrapプロパティの書き方を見ていきましょう。以下の例は、単純な水平方向の主軸を持つフレックス・ボックスです。上の段のコンテナはアイテムを折り返す指定、下の段のコンテナはアイテムを折り返さない指定になっています。

resizeに対応しているブラウザであれば、コンテナのサイズを変更できます。コンテナの右下に表示されるハンドルを掴んで、横幅を伸縮させてみて下さい。

表示確認
CSS
h2 {
	margin-top: 1rem;
	font-size: 1rem;
}
.flex_box {
	overflow: auto;
	display: flex;
	flex-direction: row;
	gap: 1rem;
	margin-top: 1rem;
	padding: 1rem;
	background: #eee;
	resize: horizontal;
}
.flex_item {
	width: 100px;
	padding: .3rem;
	background: #09f;
	color: #fff;
	flex: 1 1 auto;
}
.fw_1 {
	flex-wrap: wrap;
}
.fw_2 {
	flex-wrap: nowrap;
}
HTML
<h2>flex-wrap: wrap;</h2>
<div class="flex_box fw_1">
	<div class="flex_item">1</div>
	<div class="flex_item">2</div>
	<div class="flex_item">3</div>
</div>

<h2>flex-wrap: nowrap;</h2>
<div class="flex_box fw_2">
	<div class="flex_item">1</div>
	<div class="flex_item">2</div>
	<div class="flex_item">3</div>
</div>

続いて、垂直方向の主軸を持つコンテナの挙動です。アイテムは縦に並びますが、コンテナの寸法が縮まって空き領域が無くなった時にレイアウトを変えて収めようとするのか、そのままにするのかを指定できます。先ほどのサンプルと同じように、コンテナの右下に表示されているハンドルを上下に操作して、コンテナの高さを変えてみて下さい。

フレックス・アイテムの並び方や折り返しは、ボックスの寸法やコンテンツがはみ出した時の挙動に関する指定によって大きく変わります。これらは複数のプロパティの相互作用によって成立するものなので、関連するプロパティの機能も必用に応じて理解を深めて下さい。

表示確認
CSS
h2 {
	margin-top: 1rem;
	font-size: 1rem;
}
.flex_box {
	overflow: auto;
	display: flex;
	flex-direction: column;
	gap: 1rem;
	margin-top: 1rem;
	padding: 1rem;
	background: #eee;
	resize: vertical;
}
.flex_item {
	padding: .3rem;
	background: #09f;
	color: #fff;
	flex: 1 1 auto;
}
.fw_1 {
	flex-wrap: wrap;
}
.fw_2 {
	flex-wrap: nowrap;
}
HTML
<h2>flex-wrap: wrap;</h2>
<div class="flex_box fw_1">
	<div class="flex_item">1</div>
	<div class="flex_item">2</div>
	<div class="flex_item">3</div>
</div>

<h2>flex-wrap: nowrap;</h2>
<div class="flex_box fw_2">
	<div class="flex_item">1</div>
	<div class="flex_item">2</div>
	<div class="flex_item">3</div>
</div>

に関連するCSSプロパティ