嵌入式GUI页面栈链表实现：头插法push/pop与双向数据传参

static uint8_t current_page = PAGE_HOME;

void key_event_handler(uint8_t key)
{
    switch (current_page) {
        case PAGE_HOME:
            if (key == KEY_ENTER) {
                page_home_exit();
                page_setting_enter();
                current_page = PAGE_SETTING;
            }
            break;
        case PAGE_SETTING:
            if (key == KEY_ENTER) {
                page_setting_exit();
                page_wifi_enter();
                current_page = PAGE_WIFI;
            } else if (key == KEY_BACK) {
                page_setting_exit();
                page_home_enter();
                current_page = PAGE_HOME;
            }
            break;
        /* ... 每加一个页面，这里就多一坨 */
    }
}

typedef void (*page_callback_t)(void *user_data);
typedef void (*page_event_handler_t)(uint8_t event, void *user_data);

typedef struct page_node {
    struct page_node      *next;       /* 链表指针，指向下一个页面 */
    const char            *name;       /* 页面名称，方便调试 */
    page_callback_t        on_create;  /* 页面创建时调用 */
    page_callback_t        on_show;    /* 页面显示时调用 */
    page_callback_t        on_hide;    /* 页面隐藏时调用 */
    page_callback_t        on_destroy; /* 页面销毁时调用 */
    page_event_handler_t   on_event;   /* 按键/触摸等事件处理 */
    void                  *user_data;  /* 页面私有数据，页面间交互载体 */
} page_node_t;

typedef struct {
    page_node_t *top;        /* 栈顶页面（当前显示的页面） */
    uint8_t      page_count;
} page_manager_t;

static page_manager_t g_page_mgr = { .top = NULL, .page_count = 0 };

int page_push(page_node_t *page, void *user_data)
{
    if (page == NULL) return -1;

    /* 先隐藏当前栈顶 */
    if (g_page_mgr.top && g_page_mgr.top->on_hide) {
        g_page_mgr.top->on_hide(g_page_mgr.top->user_data);
    }

    page->user_data = user_data;
    page->next = g_page_mgr.top;   /* 头插法：新页面成栈顶 */
    g_page_mgr.top = page;
    g_page_mgr.page_count++;

    if (page->on_create) page->on_create(user_data);
    if (page->on_show)   page->on_show(user_data);
    return 0;
}

int page_pop(void)
{
    page_node_t *top = g_page_mgr.top;
    if (top == NULL) return -1;

    if (top->on_hide)    top->on_hide(top->user_data);
    if (top->on_destroy) top->on_destroy(top->user_data);

    g_page_mgr.top = top->next;
    top->next = NULL;
    g_page_mgr.page_count--;

    /* 恢复显示上一个页面 */
    if (g_page_mgr.top && g_page_mgr.top->on_show) {
        g_page_mgr.top->on_show(g_page_mgr.top->user_data);
    }
    return 0;
}

void page_dispatch_event(uint8_t event)
{
    if (g_page_mgr.top && g_page_mgr.top->on_event) {
        g_page_mgr.top->on_event(event, g_page_mgr.top->user_data);
    }
}

typedef struct {
    char     ssid[32];
    char     password[64];
    uint8_t  signal_strength;
    bool     is_connected;
} wifi_cfg_t;

void on_home_enter_wifi(void)
{
    static wifi_cfg_t wifi_data;
    strcpy(wifi_data.ssid, "MyRouter_5G");
    wifi_data.signal_strength = 75;
    wifi_data.is_connected = true;
    page_push(&page_wifi_setting, &wifi_data);
}

void wifi_page_on_create(void *user_data)
{
    wifi_cfg_t *cfg = (wifi_cfg_t *)user_data;
    label_set_text(lbl_ssid, cfg->ssid);
    progressbar_set_value(bar_signal, cfg->signal_strength);
}