# 标签

### icon

> 基础库 1.0.0 开始支持，低版本需做兼容处理。

图标。组件属性的长度单位默认为px，2.4.0起支持传入单位(rpx/px)。

| 属性    | 类型            | 默认值 | 必填 | 说明                                                                                             | 最低版本  |
| ----- | ------------- | --- | -- | ---------------------------------------------------------------------------------------------- | ----- |
| type  | string        |     | 是  | icon的类型，有效值：success, success\_no\_circle, info, warn, waiting, cancel, download, search, clear | 1.0.0 |
| size  | number/string | 23  | 否  | icon的大小                                                                                        | 1.0.0 |
| color | string        |     | 否  | icon的颜色，同css的color                                                                             | 1.0.0 |

![](/files/-MGXTE96HuigkdWy2tIK)

### **text**

> 基础库 1.0.0 开始支持，低版本需做兼容处理。

文本。

| 属性          | 类型      | 默认值   | 必填 | 说明                               | 最低版本   |
| ----------- | ------- | ----- | -- | -------------------------------- | ------ |
| selectable  | boolean | false | 否  | 文本是否可选 (已废弃)                     | 1.1.0  |
| user-select | boolean | false | 否  | 文本是否可选，该属性会使文本节点显示为 inline-block | 2.12.1 |
| space       | string  |       | 否  | 显示连续空格                           | 1.4.0  |
| decode      | boolean | false | 否  | 是否解码                             | 1.4.0  |

**space 的合法值**

| 值    | 说明          | 最低版本 |
| ---- | ----------- | ---- |
| ensp | 中文字符空格一半大小  |      |
| emsp | 中文字符空格大小    |      |
| nbsp | 根据字体设置的空格大小 |      |

### Bug & Tip <a href="#bug-tip" id="bug-tip"></a>

1. `tip`: decode可以解析的有 `&nbsp;` `&lt;` `&gt;` `&amp;` `&apos;` `&ensp;` `&emsp;`
2. `tip`: 各个操作系统的空格标准并不一致。
3. `tip`:text 组件内只支持 text 嵌套。
4. `tip`: 除了文本节点以外的其他节点都无法长按选中。
5. `bug`: 基础库版本低于 `2.1.0` 时， text 组件内嵌的 text style 设置可能不会生效。

### Progress

> 基础库 1.0.0 开始支持，低版本需做兼容处理。

进度条。组件属性的长度单位默认为px，2.4.0起支持传入单位(rpx/px)。

| 属性              | 类型            | 默认值       | 必填 | 说明                                    | 最低版本  |
| --------------- | ------------- | --------- | -- | ------------------------------------- | ----- |
| percent         | number        |           | 否  | 百分比0\~100                             | 1.0.0 |
| show-info       | boolean       | false     | 否  | 在进度条右侧显示百分比                           | 1.0.0 |
| border-radius   | number/string | 0         | 否  | 圆角大小                                  | 2.3.1 |
| font-size       | number/string | 16        | 否  | 右侧百分比字体大小                             | 2.3.1 |
| stroke-width    | number/string | 6         | 否  | 进度条线的宽度                               | 1.0.0 |
| color           | string        | #09BB07   | 否  | 进度条颜色（请使用activeColor）                 | 1.0.0 |
| activeColor     | string        | #09BB07   | 否  | 已选择的进度条的颜色                            | 1.0.0 |
| backgroundColor | string        | #EBEBEB   | 否  | 未选择的进度条的颜色                            | 1.0.0 |
| active          | boolean       | false     | 否  | 进度条从左往右的动画                            | 1.0.0 |
| active-mode     | string        | backwards | 否  | backwards: 动画从头播；forwards：动画从上次结束点接着播 | 1.7.0 |
| duration        | number        | 30        | 否  | 进度增加1%所需毫秒数                           | 2.8.2 |
| bindactiveend   | eventhandle   |           | 否  | 动画完成事件                                | 2.4.1 |

### rich-text

> 基础库 1.4.0 开始支持，低版本需做兼容处理。

富文本。

| 属性    | 类型           | 默认值 | 必填 | 说明               | 最低版本  |
| ----- | ------------ | --- | -- | ---------------- | ----- |
| nodes | array/string | \[] | 否  | 节点列表/HTML String | 1.4.0 |
| space | string       |     | 否  | 显示连续空格           | 2.4.1 |

**space 的合法值**

| 值    | 说明          | 最低版本 |
| ---- | ----------- | ---- |
| ensp | 中文字符空格一半大小  |      |
| emsp | 中文字符空格大小    |      |
| nbsp | 根据字体设置的空格大小 |      |

### nodes <a href="#nodes" id="nodes"></a>

现支持两种节点，通过type来区分，分别是元素节点和文本节点，默认是元素节点，在富文本区域里显示的HTML节点 *元素节点：type = node*\*

| 属性       | 说明    | 类型     | 必填 | 备注                       |
| -------- | ----- | ------ | -- | ------------------------ |
| name     | 标签名   | string | 是  | 支持部分受信任的 HTML 节点         |
| attrs    | 属性    | object | 否  | 支持部分受信任的属性，遵循 Pascal 命名法 |
| children | 子节点列表 | array  | 否  | 结构和 nodes 一致             |

*文本节点：type = text*\*

| 属性   | 说明 | 类型     | 必填 | 备注         |
| ---- | -- | ------ | -- | ---------- |
| text | 文本 | string | 是  | 支持entities |

### 受信任的HTML节点及属性 <a href="#shou-xin-ren-de-html-jie-dian-ji-shu-xing" id="shou-xin-ren-de-html-jie-dian-ji-shu-xing"></a>

全局支持class和style属性，**不支持id属性**。

| 节点         | 属性                           |
| ---------- | ---------------------------- |
| a          |                              |
| abbr       |                              |
| address    |                              |
| article    |                              |
| aside      |                              |
| b          |                              |
| bdi        |                              |
| bdo        | dir                          |
| big        |                              |
| blockquote |                              |
| br         |                              |
| caption    |                              |
| center     |                              |
| cite       |                              |
| code       |                              |
| col        | span，width                   |
| colgroup   | span，width                   |
| dd         |                              |
| del        |                              |
| div        |                              |
| dl         |                              |
| dt         |                              |
| em         |                              |
| fieldset   |                              |
| font       |                              |
| footer     |                              |
| h1         |                              |
| h2         |                              |
| h3         |                              |
| h4         |                              |
| h5         |                              |
| h6         |                              |
| header     |                              |
| hr         |                              |
| i          |                              |
| img        | alt，src，height，width         |
| ins        |                              |
| label      |                              |
| legend     |                              |
| li         |                              |
| mark       |                              |
| nav        |                              |
| ol         | start，type                   |
| p          |                              |
| pre        |                              |
| q          |                              |
| rt         |                              |
| ruby       |                              |
| s          |                              |
| section    |                              |
| small      |                              |
| span       |                              |
| strong     |                              |
| sub        |                              |
| sup        |                              |
| table      | width                        |
| tbody      |                              |
| td         | colspan，height，rowspan，width |
| tfoot      |                              |
| th         | colspan，height，rowspan，width |
| thead      |                              |
| tr         | colspan，height，rowspan，width |
| tt         |                              |
| u          |                              |
| ul         |                              |

### Bug & Tip <a href="#bug-tip" id="bug-tip"></a>

1. `tip`: nodes 不推荐使用 String 类型，性能会有所下降。
2. `tip`: `rich-text` 组件内屏蔽所有节点的事件。
3. `tip`: attrs 属性不支持 id ，支持 class 。
4. `tip`: name 属性大小写不敏感。
5. `tip`: 如果使用了不受信任的HTML节点，该节点及其所有子节点将会被移除。
6. `tip`: img 标签仅支持网络图片。
7. `tip`: 如果在自定义组件中使用 `rich-text` 组件，那么仅自定义组件的 wxss 样式对 `rich-text` 中的 class 生效。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.luckydesigner.space/wechat/biao-qian.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
