为什么要捐赠
API 浏览器
安装图标库

提示

本页介绍的仅为使用 webfont 图标 Svg 图标 不需要任何安装步骤。

您很可能希望在您的网站/应用程序中使用图标,Quasar 为以下图标库提供了开箱即用的简便方法:Material 图标Material 符号Font AwesomeIoniconsMDIEva 图标Themify 图标Line AwesomeBootstrap 图标。但您可以 自行添加其他支持

提示

对于 webfont 图标,您可以选择安装一个或多个这些图标库。

安装 Webfonts

如果您只构建网站,那么使用 CDN(内容交付网络)方法可能是您可以遵循的一种选择。但是,在构建移动应用程序或 Electron 应用程序时,您很可能不希望依赖于互联网连接,Quasar 提供了解决此问题的方案。

编辑 /quasar.config 文件

extras: [
  'material-icons'
]

Webfont 图标可通过 @quasar/extras 包获取。您不需要在您的应用程序中导入它,只需按照上面所示配置 /quasar.config 文件即可。

添加多个集

extras: [
  'material-icons',
  'mdi-v7',
  'ionicons-v4', // last webfont was available in v4.6.3
  'eva-icons',
  'fontawesome-v6',
  'themify',
  'line-awesome',
  'bootstrap-icons'
]

有关所有可用选项,请访问 GitHub 存储库。

现在,您已准备好使用 QIcon 组件。

使用 CDN 作为替代方案

如果您要使用 CDN(内容交付网络),您需要做的就是在您的 /index.html 或 /src/index.template.html 文件中包含指向 CDN URL 的样式标记。

如果您遵循此路径,请不要在 /quasar.config 文件 > extras 中添加您想要的图标集。请尝试使用 UMD 安装指南 并按照那里的描述编辑 /index.html 或 /src/index.template.html。

使用 Fontawesome-Pro

如果您拥有 Fontawesome v6 Pro 许可证,并且想使用它而不是 Fontawesome 免费版本,请遵循以下说明。

  1. 在 Fontawesome 的用户帐户页面打开 链接帐户部分 获取 npm TOKENID(如有必要,请登录)。
  2. .npmrc 文件(文件路径与 package.json 相同)中创建或追加 TOKENID。
@fortawesome:registry=https://npm.fontawesome.com/
//npm.fontawesome.com/:_authToken=TOKENID
  1. 安装 Fontawesome 网页字体

$ yarn add @fortawesome/fontawesome-pro
  1. 创建新的启动文件
$ quasar new boot fontawesome-pro [--format ts]
  1. 编辑 /quasar.config 文件
boot: [
  ...
  'fontawesome-pro' // Add boot file
],
extras: [
  // 'fontawesome-v6' // Disable free version!
],
framework: {
  // if you want Quasar to use Fontawesome for its icons
  iconSet: 'fontawesome-v6-pro'
}
  1. 编辑 /src/boot/fontawesome-pro.js
// required
import '@fortawesome/fontawesome-pro/css/fontawesome.css'
import '@fortawesome/fontawesome-pro/css/light.css'
// do you want these too?
// import '@fortawesome/fontawesome-pro/css/thin.css'
// import '@fortawesome/fontawesome-pro/css/duotone.css'
// import '@fortawesome/fontawesome-pro/css/brands.css'
// import '@fortawesome/fontawesome-pro/css/solid.css'
// import '@fortawesome/fontawesome-pro/css/regular.css'
  1. (可选) 覆盖默认图标

由于 fontawesome-pro 的默认 font-weightlightfal,框架组件使用的某些图标可能不理想。处理此问题的最佳方法是在您创建的启动文件中覆盖它。

例如,要覆盖芯片关闭图标的 fal 版本,请执行以下操作

首先,找到 Quasar Fontawesome v6 Pro 中用于芯片关闭的图标 图标集源代码.

(或者,您可以在要覆盖的组件的渲染函数中进行检查。)

示例

chip: {
  remove: 'fal fa-times-circle'

然后,在您的 /src/boot/fontawesome-pro.js 中覆盖它。

import '@fortawesome/fontawesome-pro/css/fontawesome.min.css'
import '@fortawesome/fontawesome-pro/css/solid.min.css'
import '@fortawesome/fontawesome-pro/css/light.min.css'

// example
export default ({ app }) => {
  app.config.globalProperties.$q.iconSet.chip.remove = 'fas fa-times-circle'
}