# 设置UI引擎前端页面标签组件属性
标签组件适用于信息分类、状态标记与筛选操作，可通过不同样式（颜色、尺寸、主题）直观区分设备状态、工单类型、工艺阶段等信息，适配设备列表状态标注、生产数据筛选、告警等级标识等前端场景（如"运行中"、"故障停机"、"待审核工单"等标签），帮助用户快速识别关键信息，提升界面信息密度与交互效率。
#### 前提条件
已在当前页面添加"标签"组件，具体操作请参见[为UI引擎前端页面添加物料组件](https://support.huaweicloud.com/usermanual-idme/idme_ui_0016.html)。
#### 配置入口
1. 在页面设计器的中心画布区，单击选中"标签"组件。
2. 在右侧设置面板中，单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002503567318.png)，即可展开"属性"设置面板。
 
#### 基础信息
| 属性名称  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 是否支持变量绑定 |
|:---|:---|:---|
| 显示文字  | 标签展示的核心文本内容，建议简短精炼（1-6个字符）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 是        |
| 显示类型  | 标签的预设样式类型，不同类型对应专属视觉风格（颜色）。可选项： - success：成功/正常（绿色系）。  - info：信息/常规（蓝色系）。  - warning：警告/待处理（黄色系）。  - danger：危险/故障（红色系）。   | 是        |
| 尺寸    | 标签的显示大小。可选项： - medium：中等尺寸，默认为"medium"。  - small：小尺寸。   清除配置后恢复默认大小。                                                                                                                                                                                                                                                | 是        |
| 主题    | 标签的视觉效果风格。可选项： - dark：深色背景，基于对应类型的主色。无类型时填充黑色背景。  - light：浅色背景，基于对应类型的主色。无类型时填充浅灰色背景。  - plain：无背景色，仅带边框，边框颜色基于对应类型的颜色。                                                                                         | 是        |
| 禁用    | 控制标签是否禁用（禁用后不可交互，样式置灰）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 是        |
| 颜色    | 自定义标签文本色和背景色，支持颜色单词、十六进制色值（如"#ff0000"）或RGB色值（如"rgb(255, 0, 0)"）。 使用此属性时需清除"显示类型"和"主题"属性的值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 是        |
| 是否可关闭 | 控制标签是否显示关闭图标。启用后，标签右上角会显示关闭图标，单击图标可移除标签组件，配合"onClose"事件实现动态移除功能。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 是        |
   
#### 其他
如下属性适用于UI引擎所有组件，用于精细化控制。
| 属性名称   | 说明                                                                                                                                 | 是否支持变量绑定 |
|:---|:---|:---|
| 元素id值  | 对应HTML标签的"id"属性，同一页面内必须唯一。                                                                                                         | 是        |
| 样式类    | 对应HTML标签的"class"属性，为空格分隔的类名列表，用于自定义组件样式。默认为"component-base-style"。                                                                 | 是        |
| ref引用类 | 对应Vue的"ref"属性，用于注册模板引用以访问组件实例方法。 如果为"数据源表单"组件，会自动填充默认值。 | 是        |
   
#### 组件事件
| 事件名称        | 类型定义                            | 说明                              |
|:---|:---|:---|
| onClose     | ``` (e: Event) => void ```      | 单击关闭按钮时触发的事件，适用于动态移除标签的功能。      |
| onClick     | ``` (e: Event) => void ```      | 单击标签时触发的事件，可用于跳转页面、弹出详情窗口等交互逻辑。 |
| onChange    | ``` (e: MouseEvent) => void ``` | 浏览器原生事件，值改变时触发，不适用于标签组件本身。      |
| onFocus     | ``` (e: MouseEvent) => void ``` | 浏览器原生事件，组件获取焦点时触发，不适用于标签组件本身。   |
| onMousemove | ``` (e: MouseEvent) => void ``` | 浏览器原生事件，鼠标移动时触发，可用于实现悬停提示等功能。   |