模板: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