页面弹框

本章节介绍页面弹框操作相关的 API。

openWin

打开页面弹窗。

语法

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() 才能显示

示例

// 打开 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 相同）。

语法

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() 才能显示

示例

// 在顶层页面打开弹窗
openWinTop("<div>这是顶层弹窗</div>", "顶层提示", 0, {width: 400, height: 300});

---

closeWin

关闭指定弹窗（外层调用，子页面调用需加 parent.）。

语法

closeWin(id, withOutCb)

参数

参数名	类型	必填	说明
id	string	是	弹出的 id
withOutCb	boolean	是	为 true 不执行关窗回调

示例

// 关闭指定弹窗
closeWin("win_123", false);

// 关闭弹窗但不执行回调
closeWin("win_123", true);

---

closeWinThis

子页面关闭当前弹窗（直接调用，无需加 parent.）。

语法

closeWinThis(withOutCb)

参数

参数名	类型	必填	说明
withOutCb	boolean	是	为 true 不执行关窗回调

示例

// 子页面关闭当前弹窗
closeWinThis(false);

// 子页面关闭当前弹窗但不执行回调
closeWinThis(true);

---

closeWinAll

关闭所有弹窗（外层调用，子页面调用需加 parent.）。

语法

closeWinAll()

示例

// 关闭所有弹窗
closeWinAll();

---

winIdThis

子页面获取当前弹窗 ID。

语法

winIdThis()

示例

// 获取当前弹窗 id
var winId = winIdThis();
console.log("当前弹窗ID: " + winId);

---

showWin

恢复隐藏的窗口显示（子窗口调用）。

语法

showWin()

示例

// 恢复隐藏窗口的显示
showWin();

---

hideWin

隐藏当前窗口（子窗口调用）。

语法

hideWin()

示例

// 隐藏窗口
hideWin();