Модуль:RenderSubnotes: различия между версиями

Версия от 13:20, 28 сентября 2024

Описание

Модуль 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 list = {}
    local index = 1

    -- Проходим по параметрам note_1, note_2 и т.д.
    while frame.args['note_' .. index] do
        local note = frame.args['note_' .. index]
        local subnoteIndex = 1
        local subnotes = {}

        -- Проверяем на наличие вложенных примечаний
        while frame.args['note_' .. index .. '_' .. subnoteIndex] do
            table.insert(subnotes, '<li>' .. frame.args['note_' .. index .. '_' .. subnoteIndex] .. '</li>')
            subnoteIndex = subnoteIndex + 1
        end

        -- Добавляем основной пункт и вложенные (если есть)
        if #subnotes > 0 then
            table.insert(list, '<li>' .. note .. '<ul>' .. table.concat(subnotes, '') .. '</ul></li>')
        else
            table.insert(list, '<li>' .. note .. '</li>')
        end

        index = index + 1
    end

    -- Возвращаем список в HTML-формате
    return '<ul>' .. table.concat(list, '') .. '</ul>'
end

return p

@@ Строка 2: / Строка 2: @@
 function p.renderNotes(frame)
-     local rootHtml = mw.html.create('ul')  -- Создаем корневой элемент списка
+     local list = {}
      local index = 1
-     while true do
+     -- Проходим по параметрам note_1, note_2 и т.д.
+     while frame.args['note_' .. index] do
          local note = frame.args['note_' .. index]
+         local subnoteIndex = 1
-        if not note then break end
+         local subnotes = {}
-         local li = rootHtml:tag('li'):wikitext(note)  -- Основное примечание
-        local subIndex = 1
-         local hasSubNotes = false
          -- Проверяем на наличие вложенных примечаний
-         while true do
+         while frame.args['note_' .. index .. '_' .. subnoteIndex] do
-            local subNote = frame.args['note_' .. index .. '_' .. subIndex]
+             table.insert(subnotes, '<li>' .. frame.args['note_' .. index .. '_' .. subnoteIndex] .. '</li>')
+             subnoteIndex = subnoteIndex + 1
-            if not subNote then break end
-            -- Если есть вложенные, создаем вложенный список
-            if not hasSubNotes then
-                hasSubNotes = true
-                subUl = li:tag('ul')
-            end
-            subUl:tag('li'):wikitext(subNote)  -- Вложенное примечание
-             subIndex = subIndex + 1
          end
+         -- Добавляем основной пункт и вложенные (если есть)
+        if #subnotes > 0 then
+            table.insert(list, '<li>' .. note .. '<ul>' .. table.concat(subnotes, '') .. '</ul></li>')
+        else
+            table.insert(list, '<li>' .. note .. '</li>')
+        end
          index = index + 1
      end
-     return tostring(rootHtml)
+     -- Возвращаем список в HTML-формате
+     return '<ul>' .. table.concat(list, '') .. '</ul>'
 end
 return p