Lua页面栈：界面前进后退的层叠管理

flowchart TD
A[点击进入] --> B{栈满了吗}
B -- 是 --> C[提示到底]
B -- 否 --> D[新页压栈 滑入]
D --> A
E[点击返回] --> F{栈只剩一层}
F -- 是 --> G[提示最底层]
F -- 否 --> H[栈顶出栈 露出下层]
H --> E

 fx-pagestack

-- @file PageStack.lua
-- 页面栈 —— 界面前进后退的层叠管理

local PageStack = {}

local CONST = {
    STACK_CAP     = 4,
    PAGE_HOME     = "主页",
    PAGE_BAG      = "背包",
    PAGE_DETAIL   = "详情",
    PAGE_FORGE    = "强化",

    AUTOINC_BASE  = 1154000,
}

local _stack     = { CONST.PAGE_HOME }
local _pages     = {}
local _autoInc   = 0

local function GenID(prefix)
    _autoInc = _autoInc + 1
    return string.format("%s_%d", prefix or "PGS",
        CONST.AUTOINC_BASE + _autoInc)
end

local function ShowTip(msg)
    if msg and msg ~= "" then SL:ShowSystemTips(msg) end
end

local function PageName(def)
    return def or "未名页"
end

function PageStack.Depth()
    return #_stack
end

function PageStack.Top()
    return _stack[#_stack]
end

-- 压栈：新页入栈，旧页原地睡觉
function PageStack.Push(def)
    if #_stack >= CONST.STACK_CAP then
        ShowTip("到底了——只有四层")
        return false
    end
    local node = GUI:Layout_Create(GUI:GetRootWindow(),
        GenID("Page"), 0, 0, 0, 0, false)
    _pages[#_stack + 1] = node
    _stack[#_stack + 1] = PageName(def)
    SL:PlayPageInFx(node)
    ShowTip("进了" .. _stack[#_stack]
        .. "——栈深" .. #_stack)
    return true
end

-- 出栈：栈顶离场，露出下层
function PageStack.Pop()
    if #_stack <= 1 then
        ShowTip("已经是最底层")
        return false
    end
    local node = _pages[#_stack]
    if node and not GUI:Widget_IsNull(node) then
        GUI:removeFromParent(node)
    end
    _pages[#_stack] = nil
    _stack[#_stack] = nil
    ShowTip("返回" .. _stack[#_stack])
    return true
end

SL:ScheduleOnce(function()
    SL:BindDebugButton("进入下一页", function()
        PageStack.Push(CONST.PAGE_BAG)
    end)
    SL:BindDebugButton("返回", function()
        PageStack.Pop()
    end)
    ShowTip("技能已加载: 页面栈 (调试按钮触发)")
end, 1.0)

function PageStack.Unload()
    for i = #_pages, 1, -1 do
        local node = _pages[i]
        if node and not GUI:Widget_IsNull(node) then
            GUI:removeFromParent(node)
        end
    end
    _pages = {}
    _stack = { CONST.PAGE_HOME }
end

return PageStack