- 角丸は要素ごとに決める値ではなく、プロジェクト全体で揃える体系である。少数のトークン段階を一度定義し、すべての角丸をそこから選ぶ。
- 2 つのルールですべての場面を網羅できる。単一のサーフェスには連続角丸、ネストしたサーフェスには同心の角丸を使う。
- この 2 つを一貫して適用する。角丸は 1 つだけ見ても違和感は出にくいが、組み合わせがずれると途端に雑に見える。
トークンスケール#
:root {
--radius-s: 6px;
--radius-m: 8px;
--radius-l: 12px;
--radius-xl: 20px;
--radius-full: 9999px;
}
- プロジェクト内のすべての角丸はこのスケールから取る。個別に固定した値(
13px)は、ネストした角丸の計算に使う共通トークンに基づかないため、不整合が生じやすい。
- 隣接する段階は区別できる差を保つ(このサイズでは 2px 以上)。
単一のサーフェス:連続角丸#
border-radius だけでは、直線の縁と円弧が接合する。この曲率の急変こそ、普通のウェブの角丸が Apple の連続角丸より硬く見える原因である。
- 既存の
border-radius に corner-shape を組み合わせる。border-radius は引き続き角の大きさを決め、corner-shape は曲線の形だけを変える。背景、ボーダー、アウトライン、シャドウ、overflow: hidden、backdrop-filter はすべて結果の形状に追従する。clip-path も SVG マスクも不要である。
- プロジェクト全体で
squircle(= superellipse(2))の 1 値に統一する。角の形状はトークン体系の一部であり、要素ごとに変えない。
- 角丸の形状が見た目に影響する場所に適用する。カード、シート、ダイアログ、タイル、メディア、アプリレベルのサーフェス(≥
--radius-l)。約 6px 未満では round との差が見えないため、そこには設定しない。
- プログレッシブエンハンスメントのみに使う。2026 年後半時点では Chromium 系ブラウザ(139+)だけが
corner-shape を描画し、Safari と Firefox は無視して通常の角丸にフォールバックする。このフォールバックは許容できる。JS や SVG のポリフィルを決して導入しない。
border-radius が 0 に解決される場合、corner-shape は効果を持たない。
.card {
border-radius: var(--radius-xl);
corner-shape: squircle;
}
ボタンとコントロール:中程度の角丸#
- ボタン、入力、セレクトはデフォルトで中程度のトークン(
--radius-m、36〜40px のコントロールで約 8px)を使う。密なレイアウトでは浅い段階(--radius-s)を下限として使える。
- 中程度の角丸は、テキストと隣接コントロールの整列に使える直線の縁を残し、コントロール内側の hover と押下状態が同心を保つ余地を作る。
- 完全な円(
--radius-full)のボタンはチップ、タグ、アイデンティティ要素(アバター、トグル)に限る。アクションボタンには使わない。
ネストされたサーフェス:同心ルール#
- 外側の半径
R のサーフェスの内側に p px 入り込んだ層の半径は r = R − p(下限 0)でなければならない。こうすると両方の角が同じ曲率中心を共有し、内側の層も同じサーフェスの一部として見える。
- このルールは hover と押下のオーバーレイ(
::before / ::after)、フォーカスリング、カード上のバッジ、パディングを持つサーフェスの内側にあるメディアとコントロール、セグメントコントロール、ツールチップに適用する。
- 内側と外側の半径を同じにしたり、内側の値を任意に決めたりすると同心性が崩れ、hover 状態やバッジが周囲のサーフェスから浮いて見える。
よくあるケース#
inset: 0 のオーバーレイ:border-radius: inherit を使う。
- 表面のパディング分だけ内側に入る層:同じトークンから
calc() で計算する。
- コントロールの外側のフォーカスリング:
outline か box-shadow を使う。どちらも外側の半径に自動的に追従する。
- 幅
w のボーダーを角丸のボックスに引く場合:内側の縁はすでに R − w で描かれる。追加の角丸を設定しない。
corner-shape を設定したサーフェスの内側に入る層:corner-shape: inherit で内側にも同じ形状を設定する。このプロパティは既定では継承されない。外側が squircle で内側が通常の角丸では、同心の見え方が壊れる。
.button {
border-radius: var(--radius-m);
}
.button::before {
content: "";
position: absolute;
inset: 0;
border-radius: inherit;
}
.card {
--card-inset: 12px;
border-radius: var(--radius-xl);
corner-shape: squircle;
padding: var(--card-inset);
}
.card .media {
border-radius: calc(var(--radius-xl) - var(--card-inset));
corner-shape: inherit;
}
- 画像の端や特殊な図形などで厳密に合わせられない場合は、内側の角丸を小さめに寄せる(
r ≤ R − p)。内側の角がわずかに締まって見えるぶんには自然だが、大きすぎると崩れて見える。
確認項目#
- diff 内のすべての角丸がトークンスケールから取られている。
- コントロールは中程度のトークンを使い、完全な円はチップ、タグ、アイデンティティ要素にしか現れない。
- すべてのネストされた層は
r = R − p を満たすか、半径を継承するか、outline / box-shadow を使っている。
corner-shape を設定したサーフェスの内側の層は、同じ角の形状を使っている(corner-shape: inherit)。
- ≥
--radius-l のサーフェスに corner-shape: squircle が設定されている。ポリフィルは導入していない。
- コーディング標準——文脈:トークンスケールはマジックナンバー禁止ルールの一例である。
- Tailwind CSS——併用(条件付き):Tailwind を使うプロジェクトではスケールをテーマトークンとして表現する。同心ルールは変わらない。
- Liquid Glass デザイン——文脈:Apple プラットフォームではウェブの近似ではなく、システムの連続角丸 API を使う。