dowebok

Bootstrap 图标库

Bootstrap 图标库是 Bootstrap 官方开源图标库,其设计初衷是与 Bootstrap 组件配合使用,从表单到导航组件等。但是,任何项目也都可以使用。

图标列表 安装 用法 设置样式 GitHub

当前版本 v1.0.0,共 1120 个图标

图标列表

安装

Bootstrap 图标库已经发布到 npm,可以通过 npm 安装,也可以手动下载安装。

通过 npm 安装

npm install bootstrap-icons

下载安装包

GitHub 上可以下载到图标,包含了所有的 SVG 图标。

用法

Bootstrap 图标库的图标都是 SVG 格式的,因此你可以通过以下几种方式将他们应用到你的 HTML 中,具体使用哪种方式取决于你的项目是如何设置的。

内嵌

将图标嵌入你的 HTML 页面中(与引用外部图像文件相反)。

<svg class="bi bi-chevron-right" width="32" height="32" viewBox="0 0 20 20" fill="currentColor" xmlns="http://www.w3.org/2000/svg"><path fill-rule="evenodd" d="M6.646 3.646a.5.5 0 01.708 0l6 6a.5.5 0 010 .708l-6 6a.5.5 0 01-.708-.708L12.293 10 6.646 4.354a.5.5 0 010-.708z"/></svg>

Sprite

利用 SVG sprite 和 <use> 元素即可插入任何图标。使用图标的文件名作为片段标识符(fragment identifier。例如 toggles 就是 #toggles)。SVG sprites 允许你引用类似 <img> 元素的外部文件,并支持 currentColor 的功能以便主题化。

<svg class="bi" width="32" height="32" fill="currentColor">
    <use xlink:href="bootstrap-icons.svg#heart-fill"/>
</svg>

作为外部图像文件引用

将 Bootstrap 图标库的 SVG 文件复制到你所选择的目录中,并像引用普通图像一样使用 <img> 元素引入 SVG 图标。

<img src="/assets/img/bootstrap.svg" alt="" width="32" height="32" title="Bootstrap">

CSS

你还可以在 CSS 中使用 SVG 图标(当指定十六进制颜色值时 务必对某些字符进行转义,例如将 # 字符替换为 %23)。如果未指定 <svg> 元素的 width 和 height 属性,则图标将填满所有可用空间。

如果需要使用 background-size 来调整图标的大小,则必须设置 viewBox 属性。请注意,xmlns 属性是必需的。

.bi::before {
    display: inline-block;
    content: "";
    background-image: url("data:image/svg+xml,<svg viewBox='0 0 16 16' fill='%23333' xmlns='http://www.w3.org/2000/svg'><path fill-rule='evenodd' d='M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3z' clip-rule='evenodd'/></svg>");
    background-repeat: no-repeat;
    background-size: 1rem 1rem;
}

设置样式

可以通过设置 .text-* 类或自定义 CSS 来改变颜色,或自行添加类名设置颜色。

<svg class="bi bi-alert-triangle text-success" width="32" height="32" viewBox="0 0 20 20" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
    ...
</svg>