调用方式
Functions.presentation.nullable_value(value, array, default)
将其记录为名为 Functions.presentation.nullable_value 的依赖项（接受自动补全即可完成），然后按该名称调用。
也接受以前的命名空间 utils 下的名称。
作用
查找表中的键用于显示，保留非 nil 的结果；无效的表、缺失的键和 nil 键会使用可空占位文本。
参数
| 名称 | 类型 | 作用 |
|---|---|---|
value | any | 要查找的键。 |
array | table | nil | 显示查找表。 |
default | string | nil | 缺失值的显示文本；省略时使用本地化的值占位符。 |
返回值
| 1 | any | 原始的非 nil 查找结果，或一个带颜色的占位字符串。 |
|---|
版本
内置辅助函数在每个版本上都会注册。不同的是它们读取的游戏 API；某个 API 缺失时，辅助函数会改用后备方案，或返回 nil 并附上原因。
它不直接读取任何游戏 API。
插件如何调用它
- 扩展角色属性 (print)
stat = Functions.presentation.nullable_value(value.stat, ecs_state.stats, L["<stat>"]), - 扩展角色属性百分比 (print)
stat = Functions.presentation.nullable_value(value.stat, ecs_state.percentages, L["<stat>"]), - 角色属性 (print)
Functions.presentation.nullable_value(value.stat, addon.stats, L["<stat>"])), Functions.presentation.nullable(value.value))
依赖项
color(builtin:utils.lua:color)
源码
Functions/presentation.lua，第 40 行。在游戏中为只读；“复制”会生成一份可编辑的副本。
Functions.presentation.nullable_value(value, array, default)
if value == nil or array == nil or type(array) ~= "table" then
if default ~= nil then
return color.RED .. default .. color.RESET
else
return color.RED .. L["<value>"] .. color.RESET
end
end
return addon.nullable(array[value], default)