Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Module:LinkGridBanner: Difference between revisions

From Jules RNG Wiki
No edit summary
No edit summary
Line 6: Line 6:
     local i = 1
     local i = 1


     -- Loop to gather data (same logic as before)
     -- Loop to gather data
     while args['title' .. i] do
     while args['title' .. i] do
         table.insert(cards, {
         table.insert(cards, {
             link  = args['link' .. i] or args['title' .. i],
             link  = args['link' .. i] or args['title' .. i],
             title = args['title' .. i],
             title = args['title' .. i],
             image = args['image' .. i] or 'Default.png', -- Ensure you have a fallback image!
             image = args['image' .. i] or 'Default.png',
             body  = args['body' .. i] or ''
             body  = args['body' .. i] or ''
         })
         })
Line 17: Line 17:
     end
     end


     -- 1. CONTAINER
     -- 1. CONTAINER STYLE
     local containerStyle = {
     local containerStyle = {
         ['display'] = 'flex',
         ['display'] = 'flex',
Line 26: Line 26:
     }
     }


     -- 2. CARD
     -- 2. CARD STYLE
     local cardStyle = {
     local cardStyle = {
         ['flex'] = '1 1 300px',        -- Grow/Shrink, Base width 300px
         ['flex'] = '1 1 300px',         
         ['max-width'] = '32%',        -- Desktop: 3 per row
         ['max-width'] = '32%',         
         ['border'] = '1px solid var(--border-color-base)',
         ['border'] = '1px solid var(--border-color-base)',
         ['border-radius'] = 'var(--border-radius-base, 12px)',
         ['border-radius'] = 'var(--border-radius-base, 12px)',
Line 36: Line 36:
         ['background'] = 'var(--color-surface-1)',
         ['background'] = 'var(--color-surface-1)',
         ['display'] = 'flex',
         ['display'] = 'flex',
         ['flex-direction'] = 'column', -- Stack image on top of text
         ['flex-direction'] = 'column',  
         ['transition'] = 'transform 0.2s ease',
         ['transition'] = 'transform 0.2s ease',
     }
     }


     -- 3. BANNER IMAGE AREA
     -- 3. BANNER IMAGE WRAPPER
     local imageWrapperStyle = {
     local imageWrapperStyle = {
         ['width'] = '100%',
         ['width'] = '100%',
         ['aspect-ratio'] = '16 / 9',  -- Forces the rectangle shape
         ['aspect-ratio'] = '16 / 9',   
         ['overflow'] = 'hidden',
         ['overflow'] = 'hidden',
         ['position'] = 'relative',
         ['position'] = 'relative',
Line 50: Line 50:
     }
     }


     -- 4. TEXT CONTENT
     -- 4. TEXT CONTENT STYLE
     local contentStyle = {
     local contentStyle = {
         ['padding'] = '15px',
         ['padding'] = '15px',
         ['flex-grow'] = '1',          -- Pushes content to fill height
         ['flex-grow'] = '1',           
         ['display'] = 'flex',
         ['display'] = 'flex',
         ['flex-direction'] = 'column',
         ['flex-direction'] = 'column',
Line 78: Line 78:
         local cardDiv = root:tag('div'):css(cardStyle)
         local cardDiv = root:tag('div'):css(cardStyle)
          
          
         -- A. Banner Image
         -- Banner Image
        -- We wrap the image in a div that clips it
         local imgDiv = cardDiv:tag('div'):css(imageWrapperStyle)
         local imgDiv = cardDiv:tag('div'):css(imageWrapperStyle)
        -- Note: We use the class 'linkgrid-banner' here to target it with CSS
        imgDiv:wikitext(string.format('[[File:%s|400px|center|link=%s|class=linkgrid-banner]]', card.image, card.link))
          
          
         -- We insert the file. Note: "class=banner-img" is used by the CSS below
         -- Text Content
        imgDiv:wikitext(string.format('[[File:%s|400px|center|link=%s|class=banner-img]]', card.image, card.link))
       
        -- B. Text Content
         local textDiv = cardDiv:tag('div'):css(contentStyle)
         local textDiv = cardDiv:tag('div'):css(contentStyle)
          
          
Line 93: Line 91:
             :wikitext(string.format('[[%s|%s]]', card.link, card.title))
             :wikitext(string.format('[[%s|%s]]', card.link, card.title))
              
              
         -- Body (Description/Stats)
         -- Body
         textDiv:tag('div')
         textDiv:tag('div')
             :css(bodyStyle)
             :css(bodyStyle)
Line 99: Line 97:
     end
     end


     -- 6. CSS FIX (Crucial for 16:9 cropping)
     -- 6. CSS FIX (The Safe Way)
     -- This CSS forces the image to cover the area (object-fit: cover)
     -- We use frame:extensionTag to inject the CSS so it doesn't show as text
     local styles = mw.html.create('style')
     local css = [[
    styles:wikitext([[
         .linkgrid-banner img {
        /* Force image to fill the 16:9 box */
         .banner-img img {
             width: 100% !important;
             width: 100% !important;
             height: 100% !important;
             height: 100% !important;
             object-fit: cover !important;
             object-fit: cover !important;
             object-position: center;
             object-position: center;
             display: block;
             display: block !important;
         }
         }
        /* Mobile: Cards become full width */
         @media (max-width: 768px) {  
         @media (max-width: 768px) {  
             .citizen-card-grid > div { max-width: 100% !important; }
             .citizen-card-grid > div { max-width: 100% !important; }
         }
         }
     ]])
     ]]


     return tostring(styles) .. tostring(root)
     return frame:extensionTag('style', css) .. tostring(root)
end
end


return p
return p

Revision as of 05:00, 27 January 2026

Documentation for this module may be created at Module:LinkGridBanner/doc

local p = {}

function p.render(frame)
    local args = frame:getParent().args
    local cards = {}
    local i = 1

    -- Loop to gather data
    while args['title' .. i] do
        table.insert(cards, {
            link  = args['link' .. i] or args['title' .. i],
            title = args['title' .. i],
            image = args['image' .. i] or 'Default.png',
            body  = args['body' .. i] or ''
        })
        i = i + 1
    end

    -- 1. CONTAINER STYLE
    local containerStyle = {
        ['display'] = 'flex',
        ['flex-wrap'] = 'wrap',
        ['gap'] = '1rem',
        ['justify-content'] = 'center',
        ['margin-top'] = '1rem'
    }

    -- 2. CARD STYLE
    local cardStyle = {
        ['flex'] = '1 1 300px',        
        ['max-width'] = '32%',         
        ['border'] = '1px solid var(--border-color-base)',
        ['border-radius'] = 'var(--border-radius-base, 12px)',
        ['box-shadow'] = 'var(--box-shadow-level-1)',
        ['overflow'] = 'hidden',
        ['background'] = 'var(--color-surface-1)',
        ['display'] = 'flex',
        ['flex-direction'] = 'column', 
        ['transition'] = 'transform 0.2s ease',
    }

    -- 3. BANNER IMAGE WRAPPER
    local imageWrapperStyle = {
        ['width'] = '100%',
        ['aspect-ratio'] = '16 / 9',   
        ['overflow'] = 'hidden',
        ['position'] = 'relative',
        ['background'] = 'var(--color-surface-2)',
        ['border-bottom'] = '1px solid var(--border-color-base)'
    }

    -- 4. TEXT CONTENT STYLE
    local contentStyle = {
        ['padding'] = '15px',
        ['flex-grow'] = '1',           
        ['display'] = 'flex',
        ['flex-direction'] = 'column',
        ['gap'] = '8px'
    }

    local titleStyle = {
        ['font-weight'] = 'bold',
        ['font-size'] = '1.3em',
        ['color'] = 'var(--color-base)',
        ['line-height'] = '1.2'
    }

    local bodyStyle = {
        ['color'] = 'var(--color-subtle)',
        ['font-size'] = '0.95em',
        ['line-height'] = '1.5'
    }

    -- 5. BUILD HTML
    local root = mw.html.create('div'):css(containerStyle)

    for _, card in ipairs(cards) do
        local cardDiv = root:tag('div'):css(cardStyle)
        
        -- Banner Image
        local imgDiv = cardDiv:tag('div'):css(imageWrapperStyle)
        -- Note: We use the class 'linkgrid-banner' here to target it with CSS
        imgDiv:wikitext(string.format('[[File:%s|400px|center|link=%s|class=linkgrid-banner]]', card.image, card.link))
        
        -- Text Content
        local textDiv = cardDiv:tag('div'):css(contentStyle)
        
        -- Title
        textDiv:tag('div')
            :css(titleStyle)
            :wikitext(string.format('[[%s|%s]]', card.link, card.title))
            
        -- Body
        textDiv:tag('div')
            :css(bodyStyle)
            :wikitext(card.body)
    end

    -- 6. CSS FIX (The Safe Way)
    -- We use frame:extensionTag to inject the CSS so it doesn't show as text
    local css = [[
        .linkgrid-banner img {
            width: 100% !important;
            height: 100% !important;
            object-fit: cover !important;
            object-position: center;
            display: block !important;
        }
        @media (max-width: 768px) { 
            .citizen-card-grid > div { max-width: 100% !important; }
        }
    ]]

    return frame:extensionTag('style', css) .. tostring(root)
end

return p