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

アイコン付きリンク(Icon link) v5.3.0新設

Bootstrap Iconsや他のアイコンを使ってスタイル化されたハイパーリンクをすばやく作成できる。

※"v5.3.0"での変更はv5.3.0-alpha版での変更も含みます。
このページの項目 v5.3.0新設

アイコンリンクヘルパーコンポーネントは、デフォルトのリンクスタイルを変更して外観を向上させ、アイコンとテキストのペアを素早く整列させる。配置はインラインのflexboxスタイルとデフォルトの gap 値によって設定され、アンダーラインはカスタムオフセットとカスタムカラーでスタイリングされる。アイコンは、関連するテキストの font-size に最も合うように自動的に 1em にサイズ調整される。

アイコンリンクは、Bootstrapアイコン公式サイト)の使用を想定しているが、お好みのアイコンや画像をお使い下さい。

実例(Example)

通常の <a> 要素に .icon-link を追加し、リンクテキストの左側か右側にアイコンを挿入。アイコンは自動的に大きさ、配置、色付けされる。

見本1. 左側にアイコン

SVGスプライトの場合

アイコンリンク

アイコンフォントの場合

アイコンリンク

.icon-link がない場合

アイコンリンク
設定例
SVGスプライトの場合<a class="icon-link" href="#">
  <svg class="bi" fill="currentColor" aria-hidden="true"><use xlink:href="#box-seam"></use></svg>
  アイコンリンク
</a>
アイコンフォントの場合<a class="icon-link" href="#">
  <i class="bi bi-box-seam mb-2" aria-hidden="true"></i>
  アイコンリンク
</a>
見本2. 右側にアイコン

SVGスプライトの場合

アイコンリンク

アイコンフォントの場合

アイコンリンク

.icon-link がない場合

アイコンリンク
設定例
SVGスプライトの場合<a class="icon-link" href="#">
  アイコンリンク
  <svg class="bi" fill="currentColor" aria-hidden="true"><use xlink:href="#arrow-right"></use></svg>
</a>
アイコンフォントの場合<a class="icon-link" href="#">
  アイコンリンク
  <i class="bi bi-arrow-right mb-2" aria-hidden="true"></i>
</a>
【設定】
  • <a>.icon-link を入れる
  • アイコンに .bi を入れると、アイコンのサイズを文字のサイズに合わせられる
【注意】
  • SVGスプライトの場合は <svg>fill="currentColor" の設定がないとリンクのカラーにならない

ホバー状態のスタイル(Style on hover)

.icon-link-hover を追加し、ホバー状態でアイコンを右に移動させるようにする。

見本
設定例
<a class="icon-link icon-link-hover" href="#">
  アイコンリンク
  <svg class="bi" fill="currentColor" aria-hidden="true"><use xlink:href="#arrow-right"></use></svg>
</a>
【設定】
  • a.icon-link.icon-link-hover を追加

カスタマイズ(Customize)

CSS変数、Sass変数、ユーティリティ、カスタムスタイルを使用して、アイコン付きリングのスタイルを変更。

CSS変数(CSS variables)

デフォルトの外観を変更するために、必要に応じて --bs-link-*--bs-icon-link-* のCSS変数を修正。

--bs-icon-link-transform CSS変数を再定義することで、ホバー transform をカスタマイズできる:

見本1. ホバー時にアイコンが上に移動
設定例
<a class="icon-link icon-link-hover" style="--bs-icon-link-transform: translate3d(0, -.125rem, 0);" href="#">
  <svg class="bi" fill="currentColor" aria-hidden="true"><use xlink:href="#clipboard"></use></svg>
  アイコンリンク
</a>

--bs-link-* CSS変数を再定義することで、カラーをカスタマイズできる:

見本2. ホバー時にリンクカラーが任意のものに変わる
設定例
<a class="icon-link icon-link-hover" style="--bs-link-hover-color-rgb: 25, 135, 84;" href="#">
  アイコンリンク
  <svg class="bi" aria-hidden="true"><use xlink:href="#arrow-right"></use></svg>
</a>

Sass変数(Sass variables)

アイコン付きリングのSass変数をカスタマイズして、Bootstrapを使用するプロジェクト全体のアイコンリンクスタイルを変更。

デフォルトの設定
scss/_variables.scss 内 icon-link-variables の設定$icon-link-gap:               .375rem;
$icon-link-underline-offset:  .25em;
$icon-link-icon-size:         1em;
$icon-link-icon-transition:   .2s ease-in-out transform;
$icon-link-icon-transform:    translate3d(.25em, 0, 0);

SassユーティリティAPI(Sass utilities API)

下線の色やオフセット距離を変更するリンクユーティリティを使用して、アイコンリンクを修正。

見本
設定例
<a class="icon-link icon-link-hover link-success link-underline-success link-underline-opacity-25" href="#">
  アイコンリンク
  <svg class="bi" fill="currentColor" aria-hidden="true"><use xlink:href="#arrow-right"></use></svg>
</a>
【設定】