Appearance
页面导航
本章节介绍页面跳转和导航相关的 API。
openPage
在管理后台打开新页签。
语法
js
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 进行自动判断 |
示例
js
// 打开新页签
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
覆盖当前页面加载指定页面。
语法
js
jumpPage(pageid, url)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| pageid | string | 是 | 页面 id(填入 back 为后退) |
| url | string | 是 | 地址 |
示例
js
// 跳转到 6481 页面
jumpPage("6481");
// 带参数跳转到 6481 页面
jumpPage("6481&det_id=123456");
// 页面后退
jumpPage("back", "");jumpError
覆盖当前页面显示错误信息页面。
语法
js
jumpError(content, title)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 是 | 错误内容 |
| title | string | 是 | 错误标题 |
示例
js
try {
// 一些可能出错的操作
performOperation();
} catch (error) {
jumpError(`操作失败: ${error.message}`, "系统错误");
}getPages
获取所有已打开的页签列表。
语法
js
getPages(title, pageid)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 否 | 过滤页面名称 |
| pageid | string | 否 | 过滤页面 id |
返回值
json
[{"title":"标题","pageid":123,"page":obj}]返回值说明:
- title:页面名称(标题)
- pageid:页面 id(只有本系统的页面才有)
- page:页面对象
示例
js
// 获取所有打开的页签(不传参数,默认返回所有打开的页面)
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
关闭当前页面的页签。
语法
js
closePage()示例
js
// 哪个页面调用,即关闭哪个页面的页签窗口
closePage()