Appearance
页面弹框
本章节介绍页面弹框操作相关的 API。
openWin
页面弹窗插件。
语法
javascript
openWin(content, title, type, params)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 是 | 内容 |
| title | string | 是 | 标题 |
| type | number | 是 | 类型（0 或 1：html；2：iframe） |
| params | Object | 是 | 附加参数 |
params 参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| width | string/number | 否 | 宽度（可以百分比，也可以 px） |
| height | string/number | 否 | 高度（可以百分比，也可以 px） |
| noscroll | boolean | 否 | true 不滚动 |
| top | boolean | 否 | true 顶层页面弹窗 |
| move | boolean | 否 | true 可拖动 |
| id | string | 否 | 弹窗 id |
| maximize | boolean | 否 | true 支持最大化 |
| closing | Function | 否 | 关闭前回调方法，方法返回 true 关闭窗口，false 不关闭 |
| closed | Function | 否 | 关闭后回调方法 |
| hide | boolean | 否 | 为 true 窗口隐藏需要调用显示方法 showWin() 才能显示 |
示例
javascript
// 打开 HTML 内容弹窗
openWin("<div>这是弹窗内容</div>", "提示", 0, {width: 400, height: 300});
// 打开 iframe 弹窗
openWin("/user/detail?id=1001", "用户详情", 2, {width: 800, height: 600});
// 在顶层页面打开弹窗（参数加上 top=true）
openWin("<div>这是顶层弹窗</div>", "顶层提示", 0, {width: 400, height: 300, top: true});openWinTop
页面弹窗插件（顶层页面，参数跟 openWin 一样，页面会出现最顶层）。
语法
javascript
openWinTop(content, title, type, params)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 是 | 内容 |
| title | string | 是 | 标题 |
| type | number | 是 | 类型（0 或 1：html；2：iframe） |
| params | Object | 是 | 附加参数 |
params 参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| width | string/number | 否 | 宽度（可以百分比，也可以 px） |
| height | string/number | 否 | 高度（可以百分比，也可以 px） |
| noscroll | boolean | 否 | true 不滚动 |
| move | boolean | 否 | true 可拖动 |
| id | string | 否 | 弹窗 id |
| maximize | boolean | 否 | true 支持最大化 |
| closing | Function | 否 | 关闭前回调方法，方法返回 true 关闭窗口，false 不关闭 |
| closed | Function | 否 | 关闭后回调方法 |
| hide | boolean | 否 | 为 true 窗口隐藏需要调用显示方法 showWin() 才能显示 |
示例
javascript
// 在顶层页面打开弹窗
openWinTop("<div>这是顶层弹窗</div>", "顶层提示", 0, {width: 400, height: 300});closeWin
关闭弹窗（外层调用，内层调用要加 parent）。
语法
javascript
closeWin(id, withOutCb)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 弹出的 id |
| withOutCb | boolean | 是 | 为 true 不执行关窗回调 |
示例
javascript
// 关闭指定弹窗
closeWin("win_123", false);
// 关闭弹窗但不执行回调
closeWin("win_123", true);closeWinThis
子页面关闭当前弹窗（内层直接调用，无需加 parent）。
语法
javascript
closeWinThis(withOutCb)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| withOutCb | boolean | 是 | 为 true 不执行关窗回调 |
示例
javascript
// 子页面关闭当前弹窗
closeWinThis(false);
// 子页面关闭当前弹窗但不执行回调
closeWinThis(true);
// 内层直接调用 closeWinThis() 关闭当前弹窗closeWinAll
关闭所有弹窗（外层调用，内层调用要加 parent）。
语法
javascript
closeWinAll()示例
javascript
// 关闭所有弹窗
closeWinAll();winIdThis
内层页面获取弹窗 id。
语法
javascript
winIdThis()示例
javascript
// 获取当前弹窗 id
var winId = winIdThis();
console.log("当前弹窗ID: " + winId);showWin
子窗口调用隐藏窗口恢复显示。
语法
javascript
showWin()示例
javascript
// 恢复隐藏窗口的显示
showWin();hideWin
子窗口调用隐藏窗口。
语法
javascript
hideWin()示例
javascript
// 隐藏窗口
hideWin();