Icon 图标
图标用于在有限空间内快速传达含义,常出现在按钮、导航与状态提示中。组件基于图标字体渲染,name 指定具体图标,color 控制颜色,颜色可直接引用主题变量,随明暗模式自动适配。
| 小程序 | APP | Web |
|---|---|---|
| ✓ | ✓ | ✓ |
实例
以下按属性分别说明 mu-icon 的用法,可按需组合。
最简用法只需指定图标名称,名称取自下方的图标列表。
html
<template>
<mu-icon name="search" />
</template>颜色
支持主题变量与任意合法颜色,未设置时继承父级文字颜色。
html
<template>
<mu-icon name="setting" color="var(--mu-color-primary)" />
<mu-icon name="delete" color="#ff4343" />
</template>尺寸
传入数字时按像素处理,也可传入带单位的字符串以跟随字号。
html
<template>
<mu-icon name="setting" :size="24" />
<mu-icon name="setting" size="1.5em" />
</template>加粗
开启后以更粗的字重渲染,用于强调或与常规图标区分。
html
<template>
<mu-icon name="setting" bold />
</template>图标列表
共 269 个图标,名称为 name 属性的取值。
属性
全部属性均可选,未传入时使用默认值;默认值列为 - 表示空字符串。
| 属性名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| name | 图标名称,对应图标字体的 font_class 标识 | string | - |
| color | 图标颜色,可使用主题变量或任意合法颜色 | string | - |
| size | 图标尺寸,数字按像素处理,也可传入带单位的字符串 | string | number | - |
| bold | 是否以更粗的字重渲染图标 | boolean | false |
| customClass | 自定义类名,附加在图标根节点上以覆盖默认样式 | string | - |
| customStyle | 自定义行内样式,直接作用于图标根节点 | any | - |
事件
组件支持以下事件。
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| click | 点击图标时触发,可用于处理图标的点击逻辑 | event: UniEvent |