メインコンテンツへスキップ ドキュメントナビゲーションへスキップ

要素の位置をすばやく設定するには、これらのショートハンドユーティリティを使用します。

位置の値

迅速な位置決めクラスは利用できますが、レスポンシブではありません。

<div class="position-static">...</div>
<div class="position-relative">...</div>
<div class="position-absolute">...</div>
<div class="position-fixed">...</div>
<div class="position-sticky">...</div>

要素の配置

エッジ位置ユーティリティを使用して、簡単に要素を配置できます。フォーマットは ` {property}-{position}` です。

ここで、*property* は次のいずれかです。

  • `top` - 垂直方向の `top` 位置
  • `start` - 水平方向の `left` 位置 (LTR の場合)
  • `bottom` - 垂直方向の `bottom` 位置
  • `end` - 水平方向の `right` 位置 (LTR の場合)

ここで、*position* は次のいずれかです。

  • `0` - `0` エッジ位置
  • `50` - `50%` エッジ位置
  • `100` - `100%` エッジ位置

(`$position-values` Sass マップ変数にエントリを追加することで、さらに位置の値を追加できます。)

html
<div class="position-relative">
  <div class="position-absolute top-0 start-0"></div>
  <div class="position-absolute top-0 end-0"></div>
  <div class="position-absolute top-50 start-50"></div>
  <div class="position-absolute bottom-50 end-50"></div>
  <div class="position-absolute bottom-0 start-0"></div>
  <div class="position-absolute bottom-0 end-0"></div>
</div>

要素の中央揃え

さらに、変換ユーティリティクラス ` .translate-middle` を使用して要素を中央揃えすることもできます。

このクラスは、要素に `translateX(-50%)` と `translateY(-50%)` の変換を適用します。これとエッジ位置ユーティリティを組み合わせることで、要素を絶対的に中央に配置できます。

html
<div class="position-relative">
  <div class="position-absolute top-0 start-0 translate-middle"></div>
  <div class="position-absolute top-0 start-50 translate-middle"></div>
  <div class="position-absolute top-0 start-100 translate-middle"></div>
  <div class="position-absolute top-50 start-0 translate-middle"></div>
  <div class="position-absolute top-50 start-50 translate-middle"></div>
  <div class="position-absolute top-50 start-100 translate-middle"></div>
  <div class="position-absolute top-100 start-0 translate-middle"></div>
  <div class="position-absolute top-100 start-50 translate-middle"></div>
  <div class="position-absolute top-100 start-100 translate-middle"></div>
</div>

` .translate-middle-x` または ` .translate-middle-y` クラスを追加することで、要素を水平方向または垂直方向のみに配置できます。

html
<div class="position-relative">
  <div class="position-absolute top-0 start-0"></div>
  <div class="position-absolute top-0 start-50 translate-middle-x"></div>
  <div class="position-absolute top-0 end-0"></div>
  <div class="position-absolute top-50 start-0 translate-middle-y"></div>
  <div class="position-absolute top-50 start-50 translate-middle"></div>
  <div class="position-absolute top-50 end-0 translate-middle-y"></div>
  <div class="position-absolute bottom-0 start-0"></div>
  <div class="position-absolute bottom-0 start-50 translate-middle-x"></div>
  <div class="position-absolute bottom-0 end-0"></div>
</div>

これらのクラスの実際の例をいくつか紹介します。

マーカー
html
<button type="button" class="btn btn-primary position-relative">
  Mails <span class="position-absolute top-0 start-100 translate-middle badge rounded-pill text-bg-secondary">+99 <span class="visually-hidden">unread messages</span></span>
</button>

<div class="position-relative py-2 px-4 text-bg-secondary border border-secondary rounded-pill">
  Marker <svg width="1em" height="1em" viewBox="0 0 16 16" class="position-absolute top-100 start-50 translate-middle mt-1" fill="var(--bs-secondary)" xmlns="http://www.w3.org/2000/svg"><path d="M7.247 11.14L2.451 5.658C1.885 5.013 2.345 4 3.204 4h9.592a1 1 0 0 1 .753 1.659l-4.796 5.48a1 1 0 0 1-1.506 0z"/></svg>
</div>

<button type="button" class="btn btn-primary position-relative">
  Alerts <span class="position-absolute top-0 start-100 translate-middle badge border border-light rounded-circle bg-danger p-2"><span class="visually-hidden">unread messages</span></span>
</button>

これらのクラスは既存のコンポーネントで使用して新しいコンポーネントを作成できます。`$position-values` 変数にエントリを追加することで、機能を拡張できることに注意してください。

html
<div class="position-relative m-4">
  <div class="progress" role="progressbar" aria-label="Progress" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100" style="height: 1px;">
    <div class="progress-bar" style="width: 50%"></div>
  </div>
  <button type="button" class="position-absolute top-0 start-0 translate-middle btn btn-sm btn-primary rounded-pill" style="width: 2rem; height:2rem;">1</button>
  <button type="button" class="position-absolute top-0 start-50 translate-middle btn btn-sm btn-primary rounded-pill" style="width: 2rem; height:2rem;">2</button>
  <button type="button" class="position-absolute top-0 start-100 translate-middle btn btn-sm btn-secondary rounded-pill" style="width: 2rem; height:2rem;">3</button>
</div>

CSS

Sass マップ

デフォルトの位置ユーティリティの値は Sass マップで宣言され、その後、ユーティリティを生成するために使用されます。

$position-values: (
  0: 0,
  50: 50%,
  100: 100%
);

Sass ユーティリティ API

位置ユーティリティは、`scss/_utilities.scss` のユーティリティ API で宣言されています。ユーティリティ API の使用方法について学習してください。

"position": (
  property: position,
  values: static relative absolute fixed sticky
),
"top": (
  property: top,
  values: $position-values
),
"bottom": (
  property: bottom,
  values: $position-values
),
"start": (
  property: left,
  class: start,
  values: $position-values
),
"end": (
  property: right,
  class: end,
  values: $position-values
),
"translate-middle": (
  property: transform,
  class: translate-middle,
  values: (
    null: translate(-50%, -50%),
    x: translateX(-50%),
    y: translateY(-50%),
  )
),