導覽

v1.0.0
框架

SVG 與 JavaScript

不依賴框架即可使用圖示。

本頁內容

#SVG 檔案

可從圖庫下載單一 SVG 檔案,或下載某一尺寸與圓角的全部圖示 ZIP 壓縮檔,內含授權文件。安裝 @master/icons 後,同樣的檔案位於套件子路徑 @master/icons/svg/{size}/{corner}/{name}.svg,例如 @master/icons/svg/20/soft/search.svg。

Inline SVG 使用 currentColor。透過 <img> 載入的外部 SVG 不會繼承周圍文字的顏色。

#JavaScript 渲染器

import { Search, renderSvg } from '@master/icons';const svg = renderSvg(Search, { size: 20, corner: 'soft', label: 'Search' });

renderSvg 回傳 SVG 標記,請搭配本套件可信任的圖示定義使用。圖示定義的名稱不含元件使用的 Icon 字尾。size 控制顯示尺寸;opticalSize 可明確指定 16、20 或 24,預設選擇最接近的光學圖稿。

選項預設行為
size24顯示尺寸,須為有限正數
opticalSize'auto'16、20 或 24 母版;auto 取最接近者,18 與 22 取較大者
corner'soft''sharp'、'soft' 或 'rounded'
strokeWidth原生線寬,以原生單位與 0.25 為級距
color'currentColor'圖稿的顏色
label無未提供時 SVG 為 aria-hidden;提供時 SVG 加上 role="img" 與標籤
direction'ltr''rtl' 會鏡像具方向性的圖示

設定 direction 為 rtl 時,只有 arrow-left、arrow-right、chevron-left、chevron-right、chevrons-left、chevrons-right、undo 與 redo 會鏡像。