将可缩放的矢量图标放置在内容的任何位置。
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>
以下是目前所有可用图标的概览。 随着时间的推移,我们将不断向列表中添加新的图标。
在 uk-icon
属性中添加 ratio: 2
参数可以将其大小加倍 - 或者任何其他数字,具体取决于您希望图标有多大。
<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 角色、状态和属性设置到 Icon 组件。
<a>
元素,请将 aria-label
属性设置为 <a>
元素以描述其含义。<a href="" uk-icon="icon: heart" aria-label="…"></a>