WTag 组件
标签组件,基于 WinDesignNext WTag 封装,用于展示标记和分类信息。
基础用法
Props API
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
id | string | - | 组件唯一标识(必填) |
component | string | WTag | 组件类型(必填) |
type | string | object | '' |
size | string | '' | 标签尺寸 |
effect | string | 'light' | 标签效果 |
closable | boolean | false | 是否可关闭 |
round | boolean | false | 是否圆角 |
hit | boolean | false | 是否有边框描边 |
disableTransitions | boolean | false | 是否禁用过渡动画 |
child | string | - | 子组件 ID(标签内容) |
path 支持说明
通用绑定格式见 path 数据绑定速查。
| 属性 | 支持 path | 说明 |
|---|---|---|
type | ✅ | 动态标签类型(含 @row.tagType 作用域) |
size / effect / closable 等 | ❌ | 静态配置 |
绑定示例:
json
{ "type": { "path": "@row.tagType" }, "child": "status-tag-text" }effect 效果
| 值 | 说明 |
|---|---|
light | 浅色背景 |
dark | 深色背景 |
plain | 朴素样式 |
使用示例
基础标签
json
{
"id": "tag_001",
"component": "WTag",
"type": "success",
"size": "small",
"effect": "light",
"child": "tag_001_text"
}数据驱动标签类型
在列表、单选框、复选框等数据驱动场景中,type 可通过数据绑定动态设置:
json
{
"id": "status-tag",
"component": "WTag",
"type": { "path": "@row.tagType" },
"child": "status-tag-text"
}对应数据中每项可指定不同的 tagType:
json
[
{ "label": "已完成", "tagType": "success" },
{ "label": "进行中", "tagType": "warning" },
{ "label": "已驳回", "tagType": "danger" }
]