将可缩放矢量图标放置在内容中的任何位置。
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-small-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>