将可缩放矢量图标放置在内容中的任何位置。
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-small-right" uk-icon="icon: check; ratio: 2"></span>
<span uk-icon="icon: check; ratio: 3.5"></span>
若要将图标作为锚点,并且需要将默认链接样式重置为更柔和的颜色,请添加.uk-icon-link
class。
<a href="" class="uk-icon-link" uk-icon="heart"></a>
<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>
在<a>
元素上使用.uk-icon-button
类创建可用于社交图标的图标按钮。
<a href="" class="uk-icon-button" uk-icon="twitter"></a>
<a href="" class="uk-icon-button uk-margin-small-right" uk-icon="twitter"></a>
<a href="" class="uk-icon-button uk-margin-small-right" uk-icon="facebook"></a>
<a href="" class="uk-icon-button" uk-icon="google-plus"></a>
您还可以使任何背景图像缩放到图标大小。只需添加.uk-icon-image
类和背景图像路径即可。
<span class="uk-icon uk-icon-image" style="background-image: url(/skin/ukv3/images/dark.jpg);"></span>
下面选项中的任何一个都可以应用于组件属性。用分号分隔多个选项。 了解更多
Option | Value | Default | Description |
---|---|---|---|
icon |
String | '' |
需显示的图标。 |
ratio |
Number | 1 |
图标大小比例。 |
icon
是Primary选项,如果它是属性值中的唯一选项,则可以省略其键。
<span uk-icon="heart"></span>
了解关于JavaScript 组件的更多信息。
UIkit.icon(element, options);
可以通过添加的SVG节点解析的JavaScript Promise。
UIkit.icon(element).svg.then(function(svg) { svg.querySelector('path').style.stroke = 'red'; })