Info Istruzioni per l'uso
Questo è un modulo scritto in Lua. Le istruzioni che seguono sono contenute nella sottopagina Modulo:Infobox/man (modifica · cronologia)
Sandbox: Modulo:Infobox/sandbox (modifica · cronologia) · Sottopagine: lista · Test: Modulo:Infobox/test (modifica · cronologia · esegui)

Modulo in Lua per gestire le funzioni di {{Infobox}}


-- Modulo per implementare le funzionalità di infobox
local p = {} -- per l'esportazione delle funzioni del modulo

local HtmlBuilder = require('Module:HtmlBuilder') -- richiesto per la costruzione del markup html

local args = {}-- variabile che contiene gli argomenti passati al template
local origArgs
local root -- radice del markup html
local dump = {}

function union(t1, t2)
    -- Fonde il contenuto di due liste, per esempio se la prima contiene
    -- [1, 2, 4] e la seconda [3, 7] restituirà [1, 2, 3, 4, 7]
    local vals = {}
    for k, v in pairs(t1) do
        vals[v] = true
    end
    for k, v in pairs(t2) do
        vals[v] = true
    end
    local ret = {}
    for k, v in pairs(vals) do
        table.insert(ret, k)
    end
    return ret
end

local function getArgNums(prefix)
    -- Restituisce una lista che contiene il suffisso numerico  di tutti gli argomenti
    -- che iniziano con il prefisso "prefix"
    -- Per esempio se nella lista argomenti sono valorizzati "Valore1, Valore2 e Valore4"
    -- retistuirà la lista [1, 2, 4]
    local nums = {}
    for k, v in pairs(args) do
        local num = ('' .. k):match('^' .. prefix .. '(%d+)$')
        if num then table.insert(nums, tonumber(num)) end
    end
    table.sort(nums)
    return nums
end

local function addRow(rowArgs)
    -- Aggiunge una riga alla tabella
    -- Se rowArgs.gruppo non è nullo la considera come una riga di testata di gruppo
    -- e ignora eventuali valorizzazioni di rowArgs.valore
    if rowArgs.gruppo then
        root
            .tag('tr')
                .addClass("sinottico_divisione")
                .tag('th')
                    .attr('colspan', 2)
                    .cssText(args.StileGruppo)
                    .wikitext(rowArgs.gruppo)
    -- Altrimenti se rowArgs.valore non è nullo inserisce una riga dati, verificando
    -- se esiste o meno la testata
    elseif rowArgs.valore then
        local row = root.tag('tr')
        local dataCell
        if rowArgs.nome then
            row
                .tag('th')
                    .cssText(args.StileNome)
                    .wikitext(rowArgs.nome)
            dataCell = row.tag('td')
        else
            dataCell = row.tag('td')
                .attr('colspan', 2)
                .css('text-align', 'center')
        end
        dataCell
            .addClass(rowArgs.classe)
            .cssText(args.StileValore)
            .wikitext(rowArgs.valore)
    end
end

local function renderTitle()
    if args.TitoloEst then
        root
            .tag('caption')
            .addClass('sinottico_testata')
            .css("font-weight", "bold")
            .cssText(args.StileTitoloEst)
            .wikitext(args.TitoloEst)
    elseif args.TitoloInt then
        root
            .tag('tr')
            .addClass('sinottico_testata')
            .tag('th')
                .attr('colspan', '2')
                .cssText(args.StileTitoloInt)
                .wikitext(args.TitoloInt)
    end
end

local function renderImage()
    if not args.Immagine then return end
    root.tag('tr')
    local cell_immagine = root.tag('td')
    cell_immagine
        .addClass(args.ClasseImmagine)
        .attr('colspan', '2')
        .css('text-align', 'center')
        .cssText(args.StileImmagine)
        .wikitext(args.Immagine)
     if args.Didascalia then
        cell_immagine
            .tag('br', {selfClosing = true})
                .done()
            .tag('span')
            .cssText(args.StileDidascalia)
            .wikitext(args.Didascalia)
    end
end


local function renderRows()
    local rownums = union(getArgNums('Gruppo'), getArgNums('Valore'))
    table.sort(rownums)
    for k, num in ipairs(rownums) do
        addRow({
            gruppo = args['Gruppo' .. num],
            nome = args['Nome' .. num],
            valore = args['Valore' .. num],
            classe = args['Classe' .. num]
        })
    end
end

local function renderLastRow()
    if not args.Ultima then return end

    root
        .tag('tr')
            .tag('td')
                .attr('colspan', '2')
                .addClass('sinottico_piede')
                .cssText(args.StileUltima)
                .wikitext(args.Ultima)
                .newline()
end

local function renderNavBar()
    if not args.NomeTemplate then return end

    root
        .tag('tr')
            .tag('td')
                .attr('colspan', '2')
                .css('text-align', 'right')
                .wikitext(mw.getCurrentFrame():expandTemplate({
                    title = 'Tnavbar',
                    args = { args.NomeTemplate }
                }))
end

local function _infobox()
    -- Crea l'albero html che rappresenta la tabella del sinottico e restituisce il markup
    root = HtmlBuilder.create('table')

    root
        .addClass('sinottico')
        .cssText(args.StileTabella)

    renderTitle()
    renderImage()
    renderRows()
    renderLastRow()
    renderNavBar()

    return tostring(root)
end

local function preprocessSingleArg(argName)
    -- Se l'argomento esiste e non è una stringa vuota lo aggiunge alla tabella degli argomenti
    -- Argomenti uguali a stringa vuota sono trattati come nulli come da comportamento
    -- precedente del template {{Infobox}}
    if origArgs[argName] and origArgs[argName] ~= '' then
        args[argName] = origArgs[argName]
    end
end

local function preprocessArgs(prefixTable, step)
    -- Assegna i parametri con i dati prefissi alla tabella args, in ordine e secondo lotti di
    -- dimensione specificata. La prefixTable dovrebbe essere un  array contenente tabelle, ognuna
    -- delle quali con due possibili campi, una stringa "prefisso" e una tabella di "dipendenze". La
    -- funsione esamina tutti i parametri contenenti la stringa prefisso, ma esamina quelli della
    -- tabella dipendenti solo se il prefisso da cui dipendono è presente e non nullo.
    if type(prefixTable) ~= 'table' then
        error("Valore non tabella trovato nella tabella prefissi", 2)
    end
    if type(step) ~= 'number' then
        error("Passo di tipo non valido", 2)
    end

    -- Ottiene gli argmenti senza un suffisso numerico e controlla per input errati.
    for i,v in ipairs(prefixTable) do
        if type(v) ~= 'table' or type(v.prefix) ~= "string" or (v.depend and type(v.depend) ~= 'table') then
            error('Valori non validi riscontrati per la tabella di prefissi preprocessArgs', 2)
        end
        preprocessSingleArg(v.prefix)
        -- Esamina i parametri dipendenti solo se il parametro prefisso è presente e non nullo.
        if args[v.prefix] and v.depend then
            for j, dependValue in ipairs(v.depend) do
                if type(dependValue) ~= 'string' then
                    error('Parametro "dipendente"  non valido riscontrato in preprocessArgs')
                end
                preprocessSingleArg(dependValue)
            end
        end
    end
    if passo == 0 then return end
    -- Estrae gli argomenti con un suffisso numerico
    local a = 1 -- Counter variable.
    local moreArgumentsExist = true
    while moreArgumentsExist == true do
        moreArgumentsExist = false
        for i = a, a + step - 1 do
            for j,v in ipairs(prefixTable) do
                local prefixArgName = v.prefix .. tostring(i)
                if origArgs[prefixArgName] then
                    moreArgumentsExist = true -- Aggiunge una passata se un parametro è stato trovato, anche se nullo.
                    preprocessSingleArg(prefixArgName)
                end
                -- Processa la tavola dei dipendenti  se il parametro da cui dipendono esiste e non è nullo
                if v.depend and args[prefixArgName] then
                    for j,dependValue in ipairs(v.depend) do
                        local dependArgName = dependValue .. tostring(i)
                        preprocessSingleArg(dependArgName)
                    end
                end
            end
        end
        a = a + step
    end
end



function p.infobox(frame)
    -- Se chiamata mediante  #invoke, usa gli argomenti passati al template invocante.
    -- Altrimenti a scopo di test assume che gli argomenti siano passati direttamente
    if frame == mw.getCurrentFrame() then
        origArgs = frame:getParent().args
    else
        origArgs = frame.args
    end

    -- Le funzioni Parser considerano la stringa vuota come falsa, così per preservare il
    -- comportamento di {{infobox}} tutti gli argomenti vuoti non vengono memorizzati
    -- nella tabella globale args, così da essere considerati falsi
    -- Nota: args è una variabile globale per il modulo dichiarata al suo inizio
    -- Scandisce i parametri nello stesso ordine in cui lo faceva il vecchio {{infobox}}
    -- così che ref compariranno in posizione e ordine corretto. Parametri che dipendono da
    -- altri parametri sono processati solo se il parametro è presente, così da evitare
    -- la comparsa di riferimenti fantasma in posti inattesi.
    preprocessArgs({
        {prefix='TitoloEst', depend={'StileTitoloEst'}}
         }, 0)
    preprocessArgs({
        {prefix='TitoloInt', depend={'StileTitoloInt'}}
        }, 0)
    preprocessArgs({
        {prefix='Immagine', depend={'ClasseImmagine', 'StileImmagine', 
                        'Didascalia', 'StileDidascalia'}}
        }, 0)
    preprocessSingleArg('StileGruppo')
    preprocessSingleArg('StileNome')
    preprocessSingleArg('StileValore')
    preprocessArgs({
        {prefix = 'Gruppo'},
        {prefix = 'Nome'},
        {prefix = 'Valore'},
        {prefix = 'Classe'},
    }, 50)
    preprocessSingleArg('Ultima')
    preprocessSingleArg('StileUltima')
    preprocessSingleArg('NomeTemplate')

    return _infobox()
end

return p