模块:CSS

概述

CSS 用于按需注入 TemplateStyles，并确保同一页面上同一路径的样式只加载一次。

用法

{{#invoke:CSS|main|Item}}

local css = require('Module:CSS')
return css.quickCall('Item')

示例

{{#invoke:CSS|main|Item|10}}

函数

• call：按名称、命名空间代码和文件名拼出样式页路径并注入。
• quickCall：call 的简写封装。
• main：供 #invoke 直接调用的入口。

---

local common = require('Module:Common')

local p = {}

local LUACACHE_NAMESPACE = 'css:templatestyles'
local LUACACHE_VERSION = '2026-03-09'

local function trim(value)
    if value == nil then
        return ''
    end
    return mw.text.trim(tostring(value))
end

local function get_args(frame)
    if frame == mw.getCurrentFrame() then
        return require('Module:ProcessArgs').merge(true)
    end
    return frame
end

local function namespace_prefix(code)
    local normalized = trim(code)
    if normalized == '828' then
        return 'Module:'
    end
    if normalized == '4' then
        return 'Project:'
    end
    if normalized == '0' then
        return ':'
    end
    return 'Template:'
end

local function get_fullpagename()
    local title = mw.title.getCurrentTitle()
    return title and title.prefixedText or ''
end

function p.call(name, ns_code)
    local frame = mw.getCurrentFrame()
    local target = trim(name)
    if target == '' then
        target = get_fullpagename()
    end

    local ts_path = namespace_prefix(ns_code) .. target .. '/styles.css'
    local page_key = get_fullpagename()
    local cache_key = common.buildLuaCacheKey(LUACACHE_NAMESPACE, LUACACHE_VERSION, page_key .. '|' .. ts_path)
    local loaded = common.luaCacheGet(cache_key)
    if loaded ~= nil then
        return ''
    end

    common.luaCacheSet(cache_key, '1')
    return frame:extensionTag('templatestyles', '', { src = ts_path })
end

function p.main(frame)
    local args = get_args(frame)
    return p.call(args[1], args[2])
end

return p