# tag-list-render LLMs.txt

> 供 LLM 快速理解 `@flatbiz/antd/tag-list-render` 的使用方式。

## 模块定位

在列表数据dataList中通过value匹配数据，以Tag形式展示

## 导入方式

```ts
import { TagListRender } from '@flatbiz/antd/tag-list-render';
// 也可以从主入口导入：import { ... } from '@flatbiz/antd';
```

## 公开导出

- `* from ./tag-list.jsx`
- `TagListRender` - 在列表数据dataList中通过value匹配数据，以Tag形式展示
- `TagListRenderValue`
- `TagListRenderDataItem`
- `TagListRenderProps`

## 依赖的 antd 能力

`Popover`、`Tag`

## Props / 配置要点

### TagListRenderDataItem

- `label`（必填）：: string
- `value`（必填）：: TagListRenderValue
- `color`（可选）：: string

### TagListRenderProps

- `dataList`（必填）：: TagListRenderDataItem[]
- `colorMap`（可选）：: Record<string | number, string>；颜色配置数据，例如：{ 1:'red', 2: 'blue'} key值与 dataList中value相同
- `value`（可选）：: TagListRenderValue | TagListRenderValue[]
- `forceMatch`（可选）：: boolean；是否强制匹配，默认值false
- `maxShowCount`（可选）：: number；最大显示Tag数量，超出折叠隐藏
- `foldShowAllTag`（可选）：: boolean；触发maxShowCount后，被折叠的内容是否显示完整tag，默认值：false
- `tagColor`（可选）：: string；所有tag背景匹配此颜色，在colorMap为空、dataList中未配置color的情况下有效果
- `noColorShowTag`（可选）：: boolean；未匹配到color时，是否显示Tag效果，默认值：true

## 使用规则与行为

- 颜色配置数据，例如：{ 1:'red', 2: 'blue'} key值与 dataList中value相同
- 是否强制匹配，默认值false
- 最大显示Tag数量，超出折叠隐藏
- 触发maxShowCount后，被折叠的内容是否显示完整tag，默认值：false
- 所有tag背景匹配此颜色，在colorMap为空、dataList中未配置color的情况下有效果
- 未匹配到color时，是否显示Tag效果，默认值：true
- 在列表数据dataList中通过value匹配数据，以Tag形式展示

## 基础示例

```tsx
import { TagListRender, type TagListRenderProps } from '@flatbiz/antd/tag-list-render';

const props: TagListRenderProps = {
  // 按业务传入必要参数
};

<TagListRender {...props} />;
```

## 源码索引

- `src/tag-list-render/index.ts`
- `src/tag-list-render/tag-list.tsx`

## 给 LLM 的注意事项

- 优先使用 `@flatbiz/antd/tag-list-render` 或主入口 `@flatbiz/antd` 的公开导出，不要引用内部实现文件。
- 当 Props 与 antd 原组件同名能力冲突时，以本模块导出的 Props 类型为准。
- 若文档未覆盖某个边缘参数，请读取上方源码索引中的类型定义和 JSDoc。