UI.condition_layout.layoutIconRows

Call as

UI.condition_layout.layoutIconRows(content, children, width)

Record the dependency UI.condition_layout.layoutIconRows, then call it by that name. A namespaced call does not pass self: use a colon call or pass the object yourself.

What it does

Lays out the "RM-IconRows" container: an icon on the left, vertically centered beside the rows of fields, and an optional side widget (marked with the side user data) that sits beside the last row when there is room and below the rows when there is not. Positions every child under content.

Arguments

Name	Type	What it does
`content`	`table`	Frame the children are positioned in.
`children`	`table`	Child widgets: the icon first, then the field rows, and at most one side widget.
`width`	`number`	Available width in pixels.

Returns

1	`number`	The total height used, in pixels; 0 when there is no icon or no row.

Editions

Built In helpers are registered on every edition. What differs is the game API they read; where one is missing the helper falls back or returns nil with a reason.

It reads no game API directly.

How the addon calls it

UI.condition_layout.constructor

y=layoutIconRows(frame,self.children,width)

Dependencies

ICON_ROWS_GAP (builtin:UI/condition_layout.lua:ICON_ROWS_GAP)
ICON_ROWS_MINIMUM (builtin:UI/condition_layout.lua:ICON_ROWS_MINIMUM)

Source

UI/condition_layout.lua, line 56. Read only in game; Duplicate makes an editable copy.

UI.condition_layout.layoutIconRows(content, children, width)

    local icon,side,rows=children[1],nil,{}
    for index=2,#children do
        local child=children[index]
        if child.GetUserData and child:GetUserData('side') then side=child else rows[#rows+1]=child end
    end
    if not icon or #rows==0 then return 0 end
    local iconWidth=icon.frame:GetWidth() or 0
    local left=iconWidth+ICON_ROWS_GAP
    local fieldWidth=math.max(1,width-left)
    local sideWidth=side and math.ceil(side.label and side.label:GetStringWidth() or 0)+30 or 0
    local inline=side~=nil and fieldWidth-sideWidth-ICON_ROWS_GAP>=ICON_ROWS_MINIMUM
    local y,bottom=0,0
    for index,row in ipairs(rows) do
        local rowWidth=fieldWidth
        local last=index==#rows
        if last and inline then rowWidth=fieldWidth-sideWidth-ICON_ROWS_GAP end
        row:SetWidth(math.max(1,rowWidth))
        row.frame:ClearAllPoints();row.frame:SetPoint('TOPLEFT',content,'TOPLEFT',left,-y)
        local height=row.frame:GetHeight() or 0
        if last and side and inline then
            side:SetWidth(sideWidth);side.frame:ClearAllPoints()
            side.frame:SetPoint('BOTTOMLEFT',content,'TOPLEFT',left+rowWidth+ICON_ROWS_GAP,-(y+height))
        end
        bottom=y+height;y=y+height+ICON_ROWS_GAP
    end
    local iconHeight=icon.frame:GetHeight() or 0
    icon.frame:ClearAllPoints();icon.frame:SetPoint('TOPLEFT',content,'TOPLEFT',0,-math.max(0,(bottom-iconHeight)/2))
    local total=math.max(bottom,iconHeight)
    if side and not inline then
        side:SetWidth(math.max(1,math.min(sideWidth,fieldWidth)));side.frame:ClearAllPoints();side.frame:SetPoint('TOPLEFT',content,'TOPLEFT',left,-(total+ICON_ROWS_GAP))
        total=total+ICON_ROWS_GAP+(side.frame:GetHeight() or 0)
    end
    return total

Back to Function reference