模板:Fa/doc

本模板可以生成一个FontAwesome符号库中的符号。

请在参数1中填写所需的符号标识。

符号标识可以前往Font Awesome官网查询。

使用方法

在参数1中填写标识即可。

设置

邮箱

历史

警告

选择

*{{fa|cog}}设置
*{{fa|envelope}}邮箱
*{{fa|history}}历史
*{{fa|warning}}警告
*{{fa|check-square}}选择

生成的符号是inline-block对象，颜色和大小与当前区域的文字一致。除了<nowiki>标签之外，你可以像处理文字一样处理这些符号。

为了美观，建议在该模板和文字之间增加一个空格。

你甚至可以将本模板插入链接的显示文本中。

例：请阅读

Font Awesome快速引用模板文档

请阅读[[模板:fa/doc|{{fa|flag}} Font Awesome快速引用模板文档]]

参数说明

核心参数

icon 或参数1: 图标名称（必需）。可在Font Awesome官网查询可用图标。

style 或参数2

图标样式类型。支持以下缩写：

s 或 solid - 实心样式（默认）
r 或 regular - 常规样式
b 或 brands - 品牌样式
l 或 light - 细线样式
d 或 duotone - 双色样式

样式参数

|size: 图标的尺寸。支持单位：em、rem、px、%。纯数字会自动添加em单位。

|color

图标的颜色。支持格式：

十六进制：#ff0000、#f00
RGB：rgb(255,0,0)
颜色名称：red、blue、green等

|spin: 旋转动画效果。设置为任意值启用旋转。

高级参数

|version: FontAwesome版本。支持：4、5、6、7（默认）

|title 或 |aria-label: 无障碍标签和悬浮提示文本。

|class: 自定义CSS类名。多个类名用空格分隔。

|id: HTML元素ID。

|mode: 安全模式。strict启用严格安全检查，enhanced为增强模式（默认）。

样式使用说明

在图标名后的任何位置加入s、r、l、b参数，将对应使用 solid、regular、light、brands 样式。

在图标名后的任何位置加入没有参数名的参数，将视为类（class）。

这种参数只能存在一个。如果你需要使用多个类，请写在同一个参数中，并使用空格分隔。

图标别名

为方便使用，模板内置了图标别名系统：

cog → gear
refresh → sync
trash → trash-alt
envelope → envelope-o

版本支持

版本4: 使用 fa 前缀
版本5-6: 使用 fas/far/fab 前缀
版本7（默认）: 使用 fa-solid/fa-regular/fa-brands 前缀

安全特性

在严格模式（mode=strict）下：

图标尺寸限制在5em以内
颜色限制在安全颜色列表中
图标限制在安全图标列表中

无障碍支持

模板自动添加以下无障碍特性：

role="img" 标识为图像
aria-hidden="true" 对屏幕阅读器隐藏装饰性图标
自动为屏幕阅读器提供隐藏文本说明
支持自定义标题和无障碍标签

范例

{{fa|qrcode}}

{{fa|qq|style=b|size=36px|color=skyblue}}

{{fa|spinner|color=#666600|class=fa-3x fa-spin}}

{{fa|adjust|size=24px|color=red|style=text-shadow: 2px 2px 6px #000; border:solid 1px blue; padding:10px; }}

{{fa|home|mode=strict|title=首页}}

常用图标

anchor

参数列表

Template:Columns-list