基础用法

查看代码
1
2
3
4
{% icon default:goback %}
{% icon default:leftbar %}
{% icon default:rightbar %}
{% icon solar:planet-bold-duotone %}

语法格式

1
{% icon key [text] [color] [style] %}

支持在任意位置插入图标,key 支持icons.yml中配置好的图标,也可支持外链图标

跟随文本

icon后可以跟随文本,设置文本后将独立为行元素

返回
查看代码
1
{% icon default:goback 返回 %}{% icon default:goback %}

上边两个图标即使写在同一行,第一个也会单独为行元素

使用外链图标

查看代码
1
2
3
{% icon https://api.iconify.design/fluent-emoji-flat/alarm-clock.svg %}
{% icon https://api.iconify.design/noto-v1/christmas-tree.svg %}
{% icon https://api.iconify.design/noto-v1/camel.svg %}

icon外链网站

指定图标颜色

查看代码
1
2
3
{% icon default:goback color:blue %}
{% icon default:leftbar color:blue %}
{% icon default:rightbar color:blue %}

添加color:blue指定图标颜色

修改默认图标颜色

_config.stellar.yml
1
2
3
4
tag_plugins:
icon:
# 留空时,图标和文字颜色相同
default_color: accent # theme, accent, red, orange, yellow, green, cyan, blue, purple

自定义样式

查看代码
1
{% icon https://api.iconify.design/mdi/access-point.svg?color=red style:height:80px;width:80px %}

通过指定style属性,可以自定义图标样式,只对外链图标生效style参数中间不能有空格

属性

属性名 说明
key 在icons.yml中配置的图标key,或者外链图标地址
text icon跟随文本
color 图标颜色
style 自定义图标样式