Icon图标组件

icon组件主要用来展示一个图标,图标的形式不限于iconfont图标字体,还可以是svg、png、jpg等图片;支持theme颜色主题和使用label文本,支持多种图文混搭结构。

简单使用

使用ax-icon标签即可表示一个图标。图标的样式类可写在label属性上或直接写在标签内。

  • 输出
  • HTML
  • _icon-global
  •                 
                    
                

使用图片

本组件虽然是叫做单个图标组件,但是我们经常见到用图片做图标的情况,所以本组件支持使用图片替代图标字体。

通过type参数设置图标类型,默认为icon,可设为disk(圆形图片)和cube(方形图片)。当type设为disk和cube之后,应该将label设为图片地址。

  • 输出
  • HTML
  •                 
                    
                

使用tips

tips属性表示对图标的说明解释。

  • 输出
  • HTML
  • _icon-global
  •                 
                    
                

Attributes属性

属性名 语义类型 可选值 默认值 说明
disabled boolean - - 是否禁用
tips string - 'h2' 提示文本
label string - - 标题文本
type string 'icon'/'cube'/'disk'/'image' 'icon' 图标类型
badge string - - 徽章文本
dir string 'h'/'v' 'h' 布局方向
bg string - - 背景色
href string - - 超链接
target string 同超链接target属性 '_blank' 超链接的target属性
rel string 同超链接rel属性 - 超链接的rel属性
download string - - 超链接的download属性

Methods方法

有组件通用的内置方法:

  • set:设置组件属性,支持一个参数即被设置的属性值键值对{key,value}或其数组
  • reset:重置组件属性,无参数
  • clear:清除属性和值,无参数

基本用法:CompElem.reset();

Events事件

有组件通用的事件:

  • connected:组件连接成功,无参数
  • disconnected:组件断开连接,无参数
  • adopted:组件被转移,无参数
  • set:设置了属性,支持一个参数即设置的值
  • cleared:清除了属性,无参数
  • reset:重置了属性,无参数

基本用法:CompElem.on('connected',()=>{console.log('connected')});