页面导航

本章节介绍页面跳转和导航相关的 API。

openPage

打开新页签。

语法

openPage(url, param)

参数

参数名	类型	必填	说明
url	string	是	pageid 或完整的网址
param	Object	是	参数

param 参数说明

参数名	类型	必填	说明
tab_id	string	否	窗口页签 id（仅在正式环境有效）
tab_name	string	否	窗口页签名称（仅在正式环境有效）
new	boolean	否	true 表示不管任何环境，新开窗口
manual	boolean	否	true 表示手动 url，不会对 url 传的路径和 pageid 进行自动判断

示例

// 打开新页签
openPage("6481", {status: "active"});

// 使用 pageid 打开新页签
openPage("6481", {status: "active"});

// 新开窗口打开页签
openPage("6481&det_id=123456", {new: true});

// 手动 URL 方式打开
openPage("http://example.com/page.html?page_id=6481", {manual: true});

jumpPage

当前页面跳转。

语法

jumpPage(pageid, url)

参数

参数名	类型	必填	说明
pageid	string	是	页面 id（填入 back 为后退）
url	string	是	地址

示例

// 跳转到 6481 页面
jumpPage("6481");

// 带参数跳转到 6481 页面
jumpPage("6481&det_id=123456");

// 页面后退
jumpPage("back", "");

getPages

获取所有打开的页签。

语法

getPages(title, pageid)

参数

参数名	类型	必填	说明
title	string	否	过滤页面名称
pageid	string	否	过滤页面 id

返回值

[{"title":"标题","pageid":123,"page":obj}]

返回值说明：

• title：页面名称（标题）
• pageid：页面 id（只有本系统的页面才有）
• page：页面对象

示例

// 获取所有打开的页签（不传参数，默认返回所有打开的页面）
var pages = getPages();
console.log(pages);

// 根据标题过滤页签
var userPages = getPages("用户");
console.log(userPages);

// 根据 pageid 过滤页签
var specificPage = getPages("", "userList");
console.log(specificPage);

// 如果传入参数，可以根据参数筛选
var filteredPages = getPages("用户管理", "userPage");
console.log(filteredPages);

closePage

关闭当前页签。

语法

closePage()

示例

// 哪个页面调用，即关闭哪个页面的页签窗口
closePage()