このページの目次

このページの目次

角丸

原則

  • 角丸は要素ごとに決める値ではなく、プロジェクト全体で揃える体系である。少数のトークン段階を一度定義し、すべての角丸をそこから選ぶ。
  • 2 つのルールですべての場面を網羅できる。単一のサーフェスには連続角丸、ネストしたサーフェスには同心の角丸を使う。
  • この 2 つを一貫して適用する。角丸は 1 つだけ見ても違和感は出にくいが、組み合わせがずれると途端に雑に見える。

トークンスケール

:root {
  --radius-s: 6px;       /* dense rows, chips */
  --radius-m: 8px;       /* buttons, inputs — the default control radius */
  --radius-l: 12px;      /* popovers, menus */
  --radius-xl: 20px;     /* cards, sheets, dialogs */
  --radius-full: 9999px; /* circles, pills */
}
  • プロジェクト内のすべての角丸はこのスケールから取る。個別に固定した値(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 {
  /* hover fill */
  content: "";
  position: absolute;
  inset: 0;
  border-radius: inherit; /* concentric by construction */
}

.card {
  --card-inset: 12px;
  border-radius: var(--radius-xl);
  corner-shape: squircle;
  padding: var(--card-inset);
}
.card .media {
  /* 20 - 12 = 8: same center of curvature and same curve family as the card */
  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 を使う。