Модуль: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

    -- Если нет примечаний, выводим сообщение
    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

return p