- Discuz common.js 内置（AJAX）函数帮助文档
- 作者：cr180 / 最后更新：2016-11-21
function showMenu(v)
参数 v 格式：{'key1':'value1','key2':'value2','key3':'value3'}
目前，数组 v 支持传递的 key 有：
| key | 默认值 | 含义 | 可选值及解释 |
| ctrlid | (必填) | 控制菜单的 id | |
| showid | ctrlid | 弹出菜单的 id | |
| menuid | showid + '_menu' | 显示菜单的 id | |
| evt | 'mouseover' | 响应函数的事件 | click: ctrlObj 的 onclick 触发
mouseover: ctrlObj 的 onmouseover 触发 |
| pos | '43' | 菜单位置 | 详见 setMenuPosition() 中对 pos 的解释 |
| layer | 1 | 菜单层级 | 大于 0 的任意整数 |
| duration | 2 | 菜单显示方式 | 3:菜单一直显示，除非执行 hideMenu()，或者页面 unload
2:鼠标移开 ctrlObj 及 menuObj 即开始计时 timeout 毫秒后消失 1:鼠标移开 ctrlObj 即开始计时 timeout 毫秒后消失 0:菜单显示即开始计时 timeout 毫秒后消失 |
| timeout | 250 | 菜单持续时间 | 单位：毫秒 |
| mtype | 'menu' | 菜单类型 | menu:普通菜单
win:浮窗 prompt:提示信息 dialog:对话框 |
| maxh | 600 | 菜单最大高度，实际高度超过 maxh 时菜单将出现垂直滚动条 | |
| cache | 1 | 是否缓存菜单 | 1:是
0:否 |
| drag | 拖拽菜单对象的 id，如果希望整个菜单都可以拖拽 请设置 drag 等于1 | ||
| fade | 0 | 淡入淡出效果 | 1:是
0:否 |
| cover | 0 | 是否显示一个遮罩覆盖整个页面 | 1:是
0:否 |
| zindex | JSMENU['zIndex']['menu'] | 菜单层叠顺序 | |
| ctrlclass | 控制对象在菜单弹出后的 class 值，duration = 2 时有效 |
function showDialog(msg, mode, t, func, cover, funccancel, leftmsg, confirmtxt, canceltxt, closetime, locationtime)
| key | 默认值 | 含义 | 可选值及解释 |
| msg | (必填) | 提示信息内容 | |
| mode | 'alert' | 对话框模式 | alert/right:有确定按钮
confirm:有确定和取消按钮 notice:有确定按钮 info:没有按钮 |
| t | '提示信息' | 对话框标题 | |
| func | 点"确定"执行的函数 | ||
| cover | 1 (mode = 'info' 时为 0) | 是否显示一个遮罩覆盖整个页面 | 1:是
0:否 |
| funccancel | 点"取消"执行的函数 | ||
| leftmsg | 底部左侧信息 | ||
| confirmtxt | '确定' | 确定按钮的文字 | |
| canceltxt | '取消' | 取消按钮的文字 | |
| closetime | 自动关闭的时间，单位"秒"
leftmsg 强制更改为"n 秒后窗口关闭" |
||
| locationtime | 自动跳转时间，单位"秒"
leftmsg 强制更改为"n 秒后页面跳转" |
showWindow(k, url, mode, cache, v)
| key | 默认值 | 含义 | 可选值及解释 |
| k | (必填) | 浮窗的 key | |
| url | (必填) | get 方式 url 表示浮窗请求的地址
post 方式 url 表示浮窗提交的表单 id |
|
| mode | 'get' | 弹窗请求类型 | get: ajaxget 方式请求 url
post: ajaxpost 方式请求 url |
| cache | 1 | 是否缓存弹窗内容 | 1:是
0:否 |
| v | 由于 showWindow() 是以 showMenu() 函数为内核，因此此处可微调 showMenu() 参数，如不指定则使用 showWindow() 的默认值 |
注意：
- 同一页面同时可以弹出多个浮窗，但 k 及 url 相同的浮窗同时只能显示一个
- 浮窗标题区域支持拖拽
- 关闭浮窗请使用 hideWindow(k);
setMenuPosition(showid, menuid, pos)
| key | 默认值 | 含义 | 可选值及解释 |
| showid | (必填) | 弹出菜单的 id | |
| menuid | (必填) | 菜单 id | |
| pos | '43' | 菜单弹出位置及方向，必须是字串类型
格式"BD"，B 为基点 D 为方向。方向设定后，函数会根据实际弹出的位置及浏览器窗口大小进行二次调整，取消二次调整请以"!"结尾表示强制 |
BD:自定义 B: D: 1:左上角 1:左上方 2:右上角 2:右上方 3:右下角 3:右下方 4:左下角 4:左下方 00:屏幕居中
|
ajaxget(url, showid, waitid, loading, display, recall)
| key | 默认值 | 含义 |
| url | (必填) | 请求的 url |
| showid | (必填) | ajax 返回信息显示区域的 id |
| waitid | showid | ajax 请求过程中显示等待信息区域的 id |
| display | 信息返回后 showId 的 style.display 值 | |
| recall | 信息返回后执行的代码 |
ajax返回内容中的<A>标记可增加如下几个属性，可让<A>链接自动实现ajaxget功能
ajaxtarget: 属性含义同 ajaxget() 的 showid
ajaxwaitid: 属性含义同 ajaxget() 的 waitid
ajaxloading: 属性含义同 ajaxget() 的 loading
ajaxdisplay: 属性含义同 ajaxget() 的 display
ajaxfunc：属性含义同 ajaxget() 的 recall
function ajaxpost(formid, showid, waitid, showidclass, submitbtn, recall)
| key | 默认值 | 含义 |
| formid | (必填) | ajax 提交的表单 id |
| showid | (必填) | ajax 返回信息显示区域的 id |
| waitid | showid | ajax 请求过程中显示等待信息区域的 id |
| showidclass | 表单提交后返回信息显示区域的样式 | |
| submitbtn | 表单提交按钮 ajax 请求发出后将会禁用这个按钮 | |
| recall | 信息返回后执行的代码 |
function ajaxmenu(ctrlObj, timeout, cache, duration, pos, recall, idclass, contentclass)
| key | 默认值 | 含义 | 可选值及解释 |
| ctrlObj | (必填) | 控制菜单的对象 | |
| timeout | 3000 | 菜单持续时间 | |
| cache | 1 | 是否缓存菜单 | 1:是
0:否 |
| duration | 0 (timeout = 0 时为 3) | 菜单显示方式 | 3:菜单一直显示，除非执行 hideMenu()，或者页面 unload
2:鼠标移开 ctrlObj 及 menuObj 即开始计时 timeout 毫秒后消失 1:鼠标移开 ctrlObj 即开始计时 timeout 毫秒后消失 0:菜单显示即开始计时 timeout 毫秒后消失 |
| pos | '43' | 菜单位置 | 详见 setMenuPosition() 中对 pos 的解释 |
| recall | 信息返回后执行的代码 | ||
| idclass | 'p_pop' | 菜单的 class 属性值 | |
| contentclass | 'p_opt' | 菜单内容的 class 属性值 |