模块:ItemCommon/doc：修订间差异
来自星砂岛百科
更多语言
更多操作
同步更新 |
强化物品通用字段与显示规则 |
||
| （未显示同一用户的1个中间版本） | |||
| 第8行： | 第8行： | ||
* <code><nowiki>resolveItemName</nowiki></code>：返回统一中文名。 | * <code><nowiki>resolveItemName</nowiki></code>：返回统一中文名。 | ||
* <code><nowiki>resolveItemNameEn</nowiki></code>：返回统一英文名。 | * <code><nowiki>resolveItemNameEn</nowiki></code>：返回统一英文名。 | ||
* <code><nowiki>sortItemKeys</nowiki></code>：按物品类型、系列、等级/稀有度对物品键进行稳定排序。 | |||
* <code><nowiki>sortRecordsByItemKey</nowiki></code>：按记录中的物品键复用同一套排序规则，适合商店、配方等列表域。 | |||
* <code><nowiki>buildRecipeDomain</nowiki></code>：为子域模块挂接 <code><nowiki>getField / processRecipeList / productionRecipeList / machineList</nowiki></code>。 | * <code><nowiki>buildRecipeDomain</nowiki></code>：为子域模块挂接 <code><nowiki>getField / processRecipeList / productionRecipeList / machineList</nowiki></code>。 | ||
* <code><nowiki>getField</nowiki></code>：会统一处理部分显示映射与“0 视为空值”规则，例如宠物类型、摆放类型、可食用布尔值、发射类型等。 | |||
== 排序规则 == | |||
* 先按物品类型聚合，再按系列分组。 | |||
* 同一系列内优先按等级或稀有度从低到高排列。 | |||
* 如果基础款没有 <code><nowiki>Lv1</nowiki></code> 后缀，会按同系列最低档处理，便于把 <code><nowiki>简易制造台 / 标准制造台 / 精良制造台</nowiki></code> 这类条目排在一起。 | |||
== 数据来源 == | == 数据来源 == | ||
2026年4月2日 (四) 12:10的最新版本
概述
ItemCommon 提供物品域共享的查找、身份回退与配方域构建能力，供各子域模块复用。
常用函数
loadItemIdentityData：读取 数据:Item/item_name_index.json 与 数据:Item/item_mapping.json。findItemRecord：按中文名、英文名或 ID 查找物品身份记录。resolveItemId：返回统一物品 ID。resolveItemName：返回统一中文名。resolveItemNameEn：返回统一英文名。sortItemKeys：按物品类型、系列、等级/稀有度对物品键进行稳定排序。sortRecordsByItemKey：按记录中的物品键复用同一套排序规则，适合商店、配方等列表域。buildRecipeDomain：为子域模块挂接getField / processRecipeList / productionRecipeList / machineList。getField：会统一处理部分显示映射与“0 视为空值”规则，例如宠物类型、摆放类型、可食用布尔值、发射类型等。
排序规则
- 先按物品类型聚合，再按系列分组。
- 同一系列内优先按等级或稀有度从低到高排列。
- 如果基础款没有
Lv1后缀，会按同系列最低档处理，便于把简易制造台 / 标准制造台 / 精良制造台这类条目排在一起。