Discuz common.js 内置(AJAX)函数帮助文档
-
作者:
cr180 / 整理日期:1970-01-01 / 个人站点:
www.cr180.com /
Discuz超级管家
showMenu() 显示弹出菜单
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 时有效 | |
showDialog() 显示对话框
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() AJAX弹窗
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() 菜单定位
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() AJAX/GET请求
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
ajaxpost() AJAX/POST请求
function ajaxpost(formid, showid, waitid, showidclass, submitbtn, recall)
key | 默认值 | 含义 |
formid | (必填) | ajax 提交的表单 id |
showid | (必填) | ajax 返回信息显示区域的 id |
waitid | showid | ajax 请求过程中显示等待信息区域的 id |
showidclass | | 表单提交后返回信息显示区域的样式 |
submitbtn | | 表单提交按钮 ajax 请求发出后将会禁用这个按钮 |
recall | | 信息返回后执行的代码 |
ajaxmenu() AJAX/GET请求 显示弹出菜单
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 属性值 | |