Conditions.talent.gridWidget

调用方式

Conditions.talent.gridWidget(parent, spec, value, update)

记录依赖项 Conditions.talent.gridWidget，然后按该名称调用。带命名空间的调用不会传入 self：请使用冒号调用，或自行传入该对象。

作用

Builds the TALENT editor controls for the tier-and-column grid talent layout: a talent icon and a dropdown of the client's grid talents (up to 18). Choosing one stores layout "grid" and the talent index in value, clears the tree fields and operator, and calls update; a note warns when the saved reference belongs to another layout.

参数

名称	类型	作用
`parent`	`table`	Condition widget group the control is added to.
`spec`	`number \| nil`	Specialization the editor is for; on progression clients a value from 1 to 4 also selects the talent group to read.
`value`	`table`	Saved TALENT condition settings; the control reads and rewrites its layout, tree, talent, node, entry, operator and value fields.
`update`	`function`	Called with no arguments after every change so the editor can refresh.

返回值

无。

版本

内置辅助函数在每个版本上都会注册。不同的是它们读取的游戏 API；某个 API 缺失时，辅助函数会改用后备方案，或返回 nil 并附上原因。

它不直接读取任何游戏 API。

插件如何调用它

天赋 (widget)

elseif current=="grid" then gridWidget(parent,spec,value,update)

依赖项

GRID_TIER_LEVELS (builtin:Conditions/talent.lua:GRID_TIER_LEVELS)
PLACEHOLDER (builtin:Conditions/talent.lua:PLACEHOLDER)
block → Conditions.talent.block
dropdown → Conditions.talent.dropdown
group → Conditions.talent.group
icon → Conditions.talent.icon
info → Conditions.talent.info
integer → Conditions.talent.integer
platform (builtin:Conditions/talent.lua:platform)
text → Conditions.talent.text

源码

Conditions/talent.lua，第 243 行。在游戏中为只读；“复制”会生成一份可编辑的副本。

Conditions.talent.gridWidget(parent, spec, value, update)

    local tiers,tierOrder={},{}
    for tier,level in ipairs(GRID_TIER_LEVELS) do tiers[tier]=string.format(L["Tier %d (level %d)"],tier,level);tierOrder[tier]=tier end
    local chosen=value.layout=="grid" and integer(value.value,1,18) and value.value or nil
    local shownTier=chosen and math.ceil(chosen/3) or 1
    local choices,order={},{}
    local function load()
        choices,order={},{}
        for column=1,3 do
            local talent=platform:GetGridTalentInfo((shownTier-1)*3+column,group(spec))
            if talent then choices[column]={text=talent.name,icon=talent.icon};order[#order+1]=column end
        end
    end
    load()
    if value.layout~="grid" and (value.tree~=nil or value.value~=nil) then
        text(parent,L["This reference belongs to another talent layout. Selecting a talent explicitly replaces it; viewing does not convert it."])
    end
    local box=block(parent)
    local talentIcon=icon(box,value,spec)
    local tierPicker,picker
    tierPicker=dropdown(box,L["Tier"],function(selected)
        if selected==shownTier then return end
        shownTier=selected;load();picker:SetList(choices,order)
        picker:SetValue(chosen and math.ceil(chosen/3)==shownTier and (chosen-1)%3+1 or nil);picker:SetDisabled(#order==0)
    end)
    tierPicker.configure=function() tierPicker:SetList(tiers,tierOrder);tierPicker:SetValue(shownTier) end
    picker=dropdown(box,L["Talent"],function(selected)
        chosen=(shownTier-1)*3+selected
        value.layout,value.value="grid",chosen
        value.tree,value.talent,value.operator=nil,nil,nil
        local talent=info(value,spec);talentIcon:SetImage(talent and talent.icon or PLACEHOLDER);update()
    end)
    picker:SetDisabled(#order==0)
    picker.configure=function() picker:SetList(choices,order);picker:SetValue(chosen and math.ceil(chosen/3)==shownTier and (chosen-1)%3+1 or nil) end

返回函数参考