Module:ImasIcon/ML

模块文档  

local getArgs = require('Module:Arguments').getArgs
local data = require('Module:ImasIcon/ML/Data')  -- 引入角色数据

local p = {}

-- 预建小写名称到ID的映射表
local nameToId = {}
for name, id in pairs(data) do
    nameToId[name:lower()] = id
end

-- 常量定义
local DEFAULT_SIZE = 146
local MIN_SIZE = 20  -- 允许生成的最小尺寸
local MAX_SIZE = 300  -- 允许生成的最大尺寸
local DEFAULT_ID = 0
local SPRITE_COLS = 16
local BORDER_RATIO = 1/18  -- 圆角矩形边框比例
local CONTENT_RATIO = 1 - 2 * BORDER_RATIO  -- 内容区域比例

-- 根据输入获取角色编号，支持编号或名称
local function getCharacterId(input)
    if not input or input == "" then
        return DEFAULT_ID, "未提供角色参数"
    end
    -- 尝试直接转换为数字
    local num = tonumber(input)
    if num then
        -- 处理负值和0的情况
        if num <= 0 then
            return DEFAULT_ID, "无效角色ID：" .. input
        end
        return num, nil
    end
    -- 从预建索引中查找名称
    local id = nameToId[input:lower()]
    if id then
        return id, nil
    end

    return DEFAULT_ID, "无效角色信息：" .. input
end

function p.main(frame)
    local args = getArgs(frame)
    -- 获取角色编号和错误信息
    local id, errorMsg = getCharacterId(args[1])
    local isValidId = id > 0  -- 只接受正整数ID
    
    -- 处理尺寸参数，并限制范围
    local size = tonumber(args[2]) or DEFAULT_SIZE
    size = math.max(MIN_SIZE, math.min(size, MAX_SIZE))
    
    -- 处理形状参数
    local shape = args.shape or ""
    local validShapes = {
        circle = true,
        roundedrect = true
    }
    local isCircle = validShapes[shape] and shape == "circle"
    local isRoundedRect = validShapes[shape] and shape == "roundedrect"
    
    -- 边框处理
    local hasBorder = args.border and true or false
    
    -- 计算实际显示尺寸
    local dimension = size
    if hasBorder and isRoundedRect then
        dimension = size * CONTENT_RATIO
    end
    
    -- 构建class属性
    local classes = {"imas-ml-sprite"}
    -- 添加形状类，传入非有效形状默认无形状
    if isCircle then
        table.insert(classes, "ml-sprite-circle")
    elseif isRoundedRect then
        table.insert(classes, "ml-sprite-roundedrect")
    end
    -- 添加边框类
    if hasBorder then
        table.insert(classes, "ml-sprite-bordered")
    end
    -- 添加错误状态类
    if not isValidId then
        table.insert(classes, "ml-sprite-error")
    end
    -- 添加用户自定义类（如果存在）
    if args.class and args.class ~= "" then
        table.insert(classes, args.class)
    end
    
    -- 计算背景位置 - 使用改进后的计算方法
    local bgSize, bgPos
    if isValidId then
        -- 计算精灵图中的位置
        local typeOffset = args.type == "N+" and 1 or 0
        local positionId = 2 * id - 1 + typeOffset
        
        -- 计算行列位置
        local col = (positionId - 1) % SPRITE_COLS
        local row = math.floor((positionId - 1) / SPRITE_COLS)
        
        -- 计算背景图总宽度
        local bgWidth = SPRITE_COLS * size
        bgSize = string.format("%dpx auto", bgWidth)
        bgPos = string.format("%dpx %dpx", -col * size, -row * size)
        
        -- 圆角矩形边框位置微调
        if hasBorder and isRoundedRect then
            -- 转换为像素偏移量
            local borderOffset = size * BORDER_RATIO
            bgPos = string.format("%dpx %dpx", 
                -col * size - borderOffset, 
                -row * size - borderOffset)
        end
    else
        -- 无效ID处理：显示透明区域
        bgSize = "0 0"
        bgPos = "0 0"
    end
    
    -- 边框宽度处理
    local borderStyle = ""
    if hasBorder then
        borderStyle = isRoundedRect and 
            string.format("border-width: %.2fpx;", size * BORDER_RATIO) or 
            "border-width: medium;"
    end
    
    -- 组合所有样式
    local styles = {
        string.format("height: %.2fpx;", dimension),
        string.format("width: %.2fpx;", dimension),
        string.format("background-size: %s;", bgSize),
        string.format("background-position: %s;", bgPos),
        borderStyle,
        args.style or ""
    }
    
    -- 生成最终HTML
    return string.format(
        '<span class="%s" style="%s" title="%s"></span>',
        table.concat(classes, " "),
        table.concat(styles, ""),
        errorMsg or ""  -- 错误提示（鼠标悬停显示）
    )
end

return p