flnxi-Wu/docs/FIELD_CATEGORY_UPDATES.md
WuYongJie 8705b9846a
Some checks failed
CI Check / check (push) Has been cancelled
feat: 统一弹窗样式系统与分类管理优化
- 创建统一的Modal组件,采用Apple风格设计
- 实现毛玻璃效果、圆角、动画和细边框描边
- 修复弹窗打开时背景滚动问题
- 修复分类管理中重复卡片和数组字符串显示问题
- 优化选项解析逻辑,添加去重和过滤机制
2025-11-25 09:37:00 +08:00

141 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 字段分类功能更新
## ✅ 已完成的修改
### 1. 标准字段模板更新
已将以下字段设置为**下拉选择类型**并**默认勾选"添加到分类"**:
| 字段键名 | 字段标签 | 类型 | 添加到分类 | 默认选项 |
|---------|---------|------|-----------|---------|
| `materialType` | 素材类型 | select | ✅ | 默认类型 |
| `categoryName` | 使用店铺 | select | ✅ | 默认店铺 |
| `sceneName` | 场景类别 | select | ✅ | 默认场景 |
| `platformName` | 平台分类 | select | ✅ | 默认平台 |
| `renderer` | 渲染器 | select | ✅ | 默认渲染器 |
| `brandName` | 品牌名称 | select | ✅ | 默认品牌 |
| `seriesName` | 系列/产品线 | select | ✅ | 默认产品线 |
| `materialTexture` | 材质/工艺 | select | ✅ | 默认材质 |
### 2. 默认选项配置
每个勾选"添加到分类"的下拉选择字段都包含一个默认选项:
- **素材类型**: `默认类型` + 原有选项(3DMAX、PSD、AI等)
- **使用店铺**: `默认店铺`
- **场景类别**: `默认场景`
- **平台分类**: `默认平台`
- **渲染器**: `默认渲染器`
- **品牌名称**: `默认品牌`
- **产品线**: `默认产品线`
- **材质工艺**: `默认材质`
## 📋 分类管理卡片显示说明
### 为什么分类管理卡片可能没有内容?
分类管理卡片显示的是**所有启用模板中勾选了"添加到分类"的 select 类型字段**。
如果卡片为空,可能的原因:
1. **没有启用的模板**
- 需要创建模板并设置为"启用"状态
2. **模板中的字段没有勾选"添加到分类"**
- 如果使用的是旧模板,需要重新编辑模板,确保字段勾选了"添加到分类"
3. **字段类型不是 select**
- 确保字段类型是"下拉选择"
### 如何让分类管理卡片显示内容?
#### 方法 1: 创建新模板(推荐)
1. 进入**模板管理**
2. 点击**创建模板**
3. 使用**标准字段**添加以下字段:
- 素材类型
- 使用店铺
- 场景类别
- 平台分类
- 渲染器
- 品牌名称
- 系列/产品线
- 材质/工艺
4. 这些字段会自动:
- 类型设置为"下拉选择"
- 勾选"添加到分类"
- 包含默认选项
5. 保存模板并设置为**启用**状态
6. 进入**分类管理**,应该能看到对应的卡片
#### 方法 2: 编辑现有模板
1. 进入**模板管理**
2. 编辑现有模板
3. 找到需要添加到分类的字段
4. 确保:
- 字段类型为"下拉选择"
- 勾选"添加到分类"复选框
- 至少有一个选项(建议包含默认选项)
5. 保存模板并确保模板状态为**启用**
## 🔍 验证步骤
1. **检查模板状态**
- 进入模板管理
- 确认至少有一个模板状态为"启用"
2. **检查字段配置**
- 打开启用的模板
- 确认有字段类型为"下拉选择"
- 确认这些字段勾选了"添加到分类"
- 确认字段有选项(optionsStatic 不为空)
3. **检查分类管理**
- 进入系统设置 → 分类管理
- 应该能看到"模板分类"卡片
- 每个勾选了"添加到分类"的字段都会显示一个卡片
## 📝 注意事项
1. **默认选项位置**
- 默认选项会出现在选项列表的第一位
- 例如:`['默认类型', '3DMAX', 'PSD', ...]`
2. **选项管理**
- 可以在分类管理中编辑选项
- 编辑后,所有使用该字段的模板都会同步更新
3. **字段键名唯一性**
- 相同 `fieldKey` 的字段会合并到一个分类卡片
- 例如:多个模板都有 `categoryName` 字段,只会显示一个"使用店铺"卡片
4. **模板状态**
- 只有**启用**状态的模板中的字段才会出现在分类管理中
- 草稿或归档状态的模板不会显示
## 🎯 预期效果
修改完成后,当您:
1. **创建新模板**并使用标准字段时:
- 这些字段会自动配置为下拉选择
- 自动勾选"添加到分类"
- 包含默认选项
2. **查看分类管理**时:
- 能看到所有勾选了"添加到分类"的字段卡片
- 每个卡片显示字段名称和选项列表
- 可以编辑选项,同步更新所有模板
3. **上传素材**时:
- 可以选择这些分类字段的值
- 默认选项会出现在下拉列表的第一位
---
**更新日期**: 2025-11-23
**状态**: ✅ 已完成