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

4.3 KiB
Raw Blame History

字段分类功能更新

✅ 已完成的修改

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 状态: ✅ 已完成