將可縮放的向量圖示放置在您的內容中的任何位置。
UIkit 帶有自己的 SVG 圖示系統和一個綜合圖庫,其中包含越來越多的精美輪廓圖示。此元件將 SVG 注入到網站中,以便它們採用顏色並可以使用 CSS 設定樣式。
請務必包含圖示庫腳本,更多詳細資訊請參閱安裝說明。
<script src="uikit/dist/js/uikit-icons.min.js"></script>
若要應用此元件,請將 uk-icon
屬性新增至 <span>
或 <a>
元素。若要顯示實際圖示,您需要將 icon: NAME
參數附加到屬性。瞧!您就有了一個繼承顏色 (就像您的文字一樣) 的向量圖示。
<span uk-icon="icon: check"></span>
<a href="" uk-icon="icon: heart"></a>
如果 icon
是屬性值中唯一的選項,您也可以使用 uk-icon="NAME"
<span uk-icon="heart"></span>
以下是目前所有可用圖示的概觀。隨著時間的推移,我們會不斷將新圖示新增到列表中。
將 ratio: 2
參數加入 uk-icon
屬性中,即可將其大小加倍 – 或使用任何其他數字,取決於您希望圖示顯示多大。
<span uk-icon="icon: check; ratio: 2"></span>
<span class="uk-margin-xsmall-right" uk-icon="icon: check; ratio: 2"></span>
<span uk-icon="icon: check; ratio: 3.5"></span>
若要在錨點內使用圖示時,將預設連結樣式重置為較柔和的顏色,請加入 .uk-icon-link
類別。
<a href="" class="uk-icon-link" uk-icon="heart"></a>
<div>
<a href="#" class="uk-icon-link uk-margin-small-right" uk-icon="copy"></a>
<a href="#" class="uk-icon-link uk-margin-small-right" uk-icon="file-edit"></a>
<a href="#" class="uk-icon-link" uk-icon="trash"></a>
</div>
在 <a>
元素上使用修飾符 .uk-icon-button
類別來建立圖示按鈕,可用於社群圖示。
<a href="" class="uk-icon-button" uk-icon="instagram"></a>
<div>
<a href="" class="uk-icon-button uk-margin-small-right" uk-icon="instagram"></a>
<a href="" class="uk-icon-button uk-margin-small-right" uk-icon="facebook"></a>
<a href="" class="uk-icon-button" uk-icon="youtube"></a>
</div>
您也可以讓任何背景圖片縮放至圖示的大小。只需加入 .uk-icon-image
類別和背景圖片路徑即可。
任何這些選項都可以應用於元件屬性。使用分號分隔多個選項。了解更多
選項 | 值 | 預設值 | 描述 |
---|---|---|---|
icon |
字串 | 要顯示的圖示。 | |
ratio |
數字 | 1 |
圖示大小比例。 |
icon
是主要選項,如果它是屬性值中唯一的選項,則可以省略其鍵。
<span uk-icon="heart"></span>
了解更多關於 JavaScript 元件 的資訊。
UIkit.icon(element, options);
一個 JavaScript Promise,它將解析為已新增的 SVG 節點。
UIkit.icon(element).svg.then(function(svg) { svg.querySelector('path').style.stroke = 'red'; })
設定適當的 WAI-ARIA 角色、狀態和屬性給圖示元件。
<a>
元素,請將 aria-label
屬性設定為 <a>
元素,以描述其含義。<a href="" uk-icon="icon: heart" aria-label="…"></a>