Модуль:RenderSubnotes

Описание

Модуль RenderSubnotes используется для рендеринга примечаний и действий с изображениями в карточках героев или других информационных блоках. Этот модуль предоставляет две основные функции: renderNotes для отображения примечаний и renderItemsAction для рендеринга действий с изображениями.

Использование

Функция renderNotes

Функция renderNotes используется для отображения примечаний, где примечания могут быть как основными, так и вложенными. Основные примечания задаются параметрами вида note_1, note_2 и так далее. Вложенные примечания задаются параметрами вида note_1_1, note_1_2 и так далее.

Пример использования:

{{#invoke:RenderSubnotes|renderNotes
| note_1 = Примечание 1
| note_1_1 = Подпримечание 1.1
| note_1_2 = Подпримечание 1.2
| note_2 = Примечание 2
}}

Функция renderItemsAction

Функция renderItemsAction используется для отображения действий с изображениями. Описание действия задается параметром вида itemsActionDescr_1, а изображение – параметром itemsActionImage_1_1, где числа после символа подчеркивания должны совпадать для правильной привязки изображения к действию.

Пример использования:

{{#invoke:RenderSubnotes|renderItemsAction
| itemsActionDescr_1 = Описание действия 1
| itemsActionImage_1_1 = action_image_1.png
| itemsActionImage_1_2 = action_image_2.png
| itemsActionDescr_2 = Описание действия 2
| itemsActionImage_2_1 = action_image_3.png
}}

Параметры

Параметры для renderNotes

• note_X – основное примечание, где X – порядковый номер.
• note_X_Y – вложенное примечание, где X – номер основного примечания, а Y – номер вложенного примечания.

Параметры для renderItemsAction

• itemsActionDescr_X – описание действия, где X – порядковый номер.
• itemsActionImage_X_Y – изображение для действия, где X – номер действия, а Y – номер изображения для данного действия.

Примечания

• Основные примечания могут иметь несколько уровней вложенности.
• Изображения для действий должны быть привязаны к правильным действиям с помощью одинаковых порядковых номеров в параметрах.

---

local p = {}

-- Основная функция для рендеринга примечаний
function p.renderNotes(frame)
    local parent = frame:getParent()
    local notes = {}
    local noteOrder = {}

    -- Собираем основные примечания и сохраняем их порядок
    for key, value in pairs(parent.args) do
        if key:match("^note_%d+$") and value ~= "" then
            notes[key] = {value = value, subNotes = {}}
            table.insert(noteOrder, key) -- Сохраняем порядок ключей
        end
    end

    -- Собираем вложенные примечания и добавляем к соответствующим основным
    for key, value in pairs(parent.args) do
        if key:match("^note_%d+_%d+$") and value ~= "" then
            local mainKey = key:match("^(note_%d+)")
            if notes[mainKey] then
                table.insert(notes[mainKey].subNotes, value)
            end
        end
    end

    -- Сортируем `noteOrder` для корректного отображения по порядку ключей
    table.sort(noteOrder, function(a, b)
        local aNum = tonumber(a:match("%d+"))
        local bNum = tonumber(b:match("%d+"))
        return aNum < bNum
    end)

    -- Если нет примечаний, выводим сообщение
    if next(notes) == nil then
        return "Примечаний нет."
    end

    -- Формируем список примечаний с учетом порядка
    local result = '<ul>'
    for _, noteKey in ipairs(noteOrder) do
        local note = notes[noteKey]
        result = result .. '<li>' .. note.value

        -- Проверяем, есть ли вложенные примечания
        if #note.subNotes > 0 then
            result = result .. '<ul>'
            for _, subNote in ipairs(note.subNotes) do
                result = result .. '<li>' .. subNote .. '</li>'
            end
            result = result .. '</ul>'
        end

        result = result .. '</li>'
    end
    result = result .. '</ul>'

    return result
end

-- Новая функция для рендеринга действий с изображениями
function p.renderItemsAction(frame)
    local parent = frame:getParent()
    local items = {}
    local itemsImage = {}
    local itemOrder = {}
    local itemImageOrder = {}

    -- Собираем основные действия и их описания
    for key, value in pairs(parent.args) do
        if key:match("^itemsActionDescr_%d+$") and value ~= "" then
            items[key] = {description = value, images = {}}
            table.insert(itemOrder, key) -- Сохраняем порядок ключей
        end
    end
    local test = {}
    -- Собираем изображения для каждого действия
    for key, value in pairs(parent.args) do
	   local mainKey = key:match("^(itemsActionDescr_%d+)")
       test[key] = key:match("^(itemsActionDescr_%d+)")
       if key:match("^itemsActionDescrImage_%d+_%d+$") and value ~= "" then
       
       table.insert(itemImageOrder, value)
       end
    end

    -- Сортируем `itemOrder` для корректного отображения по порядку ключей
    table.sort(itemOrder, function(a, b)
        local aNum = tonumber(a:match("%d+"))
        local bNum = tonumber(b:match("%d+"))
        return aNum < bNum
    end)
    
    table.sorm(itemImageOrder, function (a, b)
        local aNum = tonumber(a:match("%d+"))
        local bNum = tonumber(b:match("%d+"))
        return aNum < bNum	
    end)

    -- Если нет действий, выводим сообщение
    if next(items) == nil then
        return "Действия не указаны."
    end

    -- Формируем список действий с изображениями
    local result = '<ul>'

    for _, itemKey in ipairs(itemOrder) do
        local item = items[itemKey]
        
        result = result .. '<li>' 
        
        for _, itemImageKey in ipairs(itemOrderImage) do
        	result = result .. 	'<span>[[File:' .. image .. '|50px]]</span>'
        end

        -- Проверяем, есть ли изображения для текущего действия
        if #item.images > 0 then
            result = result
            for _, image in ipairs(item.images) do

                result = result
            end
            result = result .. '</span>'
        end

        result = result .. '</li>'
    end
    result = result .. '</ul>'
	result = mw.dumpObject(test)
    return result
end

return p