<#def title = "静态对象"/> <#def keyword = "ZhiqimUI"/> <#def desc = "静态对象是把一系列常用的对象定义成静态属性和函数。目前包括有浏览器对象(Z.B)、文档对象(Z.D)、"/> <#def prevUrl = "js.htm"/> <#def nextUrl = "util.htm"/> ${zhiqim_com_header()} ${zhiqim_com_topnav()}
${zhiqim_com_ui("tutorial", "ui", "js", "static")}
${zhiqim_com_breadcrumb("文库", "教程", "静态对象")}
<#-- 标题 -->

静态对象:

静态对象是把一系列常用的对象定义成静态属性和函数。目前包括有浏览器对象(Z.B)、文档对象(Z.D)、 事件对象(Z.E)、元素对象(Z.EL)、HTML对象(Z.H)、地址对象(Z.L)、COOKIE对象(Z.CK)。

<#-- 浏览器对象(Z.B) -->
浏览器对象(Z.B/Z.Browser)
属性/函数 值范围 说明
Z.B.win64 true/false 是否是64位系统
Z.B.mobile true/false 是否是移动端
Z.B.firefox true/false 是否是firefox浏览器
Z.B.webkit true/false 是否是webkit浏览器
Z.B.safari true/false 是否是safari浏览器
Z.B.chrome true/false 是否是chrome浏览器
Z.B.opera true/false 是否是opera浏览器
Z.B.msie true/false 是否是msie浏览器(含trident)
Z.B.msieOnly true/false 是否是msie浏览器(不含trident)
Z.B.msie11 true/false 是否是msie11浏览器
Z.B.msie10 true/false 是否是msie10浏览器
Z.B.msie9 true/false 是否是msie9浏览器
Z.B.msie8 true/false 是否是msie8浏览器
Z.B.msie7 true/false 是否是msie7浏览器
Z.B.msie6 true/false 是否是msie6浏览器
Z.B.msieVer 6,7,8,9,10,11,12,100 IE版本号,100表示不是IE
<#-- 文档对象 -->
文档对象(Z.D/Z.Document)
函数 说明 参数 参数说明
Z.D.id(id, doc) 通过ID获取元素
document.getElementById(id);
id 元素id编码
doc 所在的文档对象,未传入取当前document
Z.D.has(id, doc) 通过ID获取元素判断是否存在
document.getElementById(id)!=null;
id 元素id编码
doc 所在的文档对象,未传入取当前document
Z.D.create(tag, doc) 通过tag创建元素
document.createElement(tag);
tag 元素标签,如div
doc 所在的文档对象,未传入取当前document
Z.D.tagNames(name, doc) 获取指定标记名称的对象列表
document.getElementsByTagName(name);
name 名称
doc 所在的文档对象,未传入取当前document
Z.D.names(name, doc) 获取指定名称的对象列表
document.getElementsByName(name);
name 指定名称
doc 所在的文档对象,未传入取当前document
Z.D.classNames(name, doc) 获取指定类名的对象列表
document.getElementsByClassName(name);
name 指定类名
doc 所在的文档对象,未传入取当前document
Z.D.attrs(name, value, doc) 获取指定属性名和属性值相等的对象列表 name 指定属性名
value 指定属性值
doc 所在的文档对象,未传入取当前document
Z.D.scrollTop(doc) 窗口垂直滚动条上偏移值 doc 指定的文档对象
Z.D.scrollLeft(doc) 窗口水平滚动条左偏移值 doc 所在的文档对象,未传入取当前document
Z.D.scrollWidth(doc) 可滚动展示宽度 doc 所在的文档对象,未传入取当前document
Z.D.scrollHeight(doc) 可滚动展示高度 doc 所在的文档对象,未传入取当前document
Z.D.clientWidth(doc) 窗口可视宽度(看得见的宽度) doc 所在的文档对象,未传入取当前document
Z.D.clientHeight(doc) 窗口可视高度(看得见的高度) doc 所在的文档对象,未传入取当前document
Z.D.offsetWidth(doc) 可操作宽度(由元素决定,和窗口无关) doc 所在的文档对象,未传入取当前document
Z.D.offsetHeight(doc) 可操作高度(由元素决定,和窗口无关) doc 所在的文档对象,未传入取当前document
<#-- 事件对象 -->
事件对象(Z.E/Z.Event)
函数 说明 参数 参数说明
Z.E.KEY { ESC: 27, LEFT: 37, UP: 38, RIGHT: 39, DOWN: 40, DELETE: 46 } 事件键值属性
Z.E.add(target, name, listener, $this) 增加事件 target 目标地址
name 事件名称
listener 事件侦听器
$this 事件侦听器对应的this指针
Z.E.remove(target, name, listener, $this) 移除事件 target 目标地址
name 事件名称
listener 事件侦听器
$this 事件侦听器对应的this指针
Z.E.event(e) 对事件对象作适配,IE取window.event e 事件对象
Z.E.key(e) 产生事件的键值 e 事件对象
Z.E.target(e) 产生事件的目标对象 e 事件对象
Z.E.current(e) 产生事件的当前目标对象 e 事件对象
Z.E.cancel(e) 取消缺省事件 e 事件对象
Z.E.stop(e) 停止冒泡 e 事件对象
Z.E.forbidden(e) 停止冒泡和取消缺省事件 e 事件对象
Z.E.clientX(e) 点击位置相对于浏览器的X坐标 e 事件对象
Z.E.clientY(e) 点击位置相对于浏览器的Y坐标 e 事件对象
Z.E.screenX(e) 点击位置相对于屏幕的X坐标 e 事件对象
Z.E.screenY(e) 点击位置相对于屏幕的Y坐标 e 事件对象
Z.E.wheelDelta() 滚轮增量 e 事件对象
Z.E.isCtrl(e) 是否按住了Ctrl键 e 事件对象
Z.E.isEsc(e) 是否退出键 e 事件对象
Z.E.isBackspace(e) 是否退格键 e 事件对象
Z.E.isEnter(e) 是否回车键 e 事件对象
Z.E.isCtrlC(e) 是否复制 e 事件对象
Z.E.isCtrlV(e) 是否粘贴 e 事件对象
<#-- 元素对象 -->
元素对象(Z.EL/Z.Element)
函数 说明 参数 参数说明
Z.EL.has(elem, name) 是否有属性 elem 元素
name 属性名称
Z.EL.get(elem, name) 获取属性值 elem 元素
name 属性名称
Z.EL.set(elem, name, value) 设置属性值 elem 元素
name 属性名称
value 需要传入的值
Z.EL.equals(elem, name, value) 判断属性值是否等于指定值 elem 元素
name 属性名称
value 传入的值
Z.EL.style(elem, style) 获取或设置样式字符串 elem 元素
style 未传值表示获取样式,传值表示设置样式
Z.EL.css(elem, name, value) 获取或设置一个样式 elem 元素
name 样式名称
value 未传值表示获取样式,传值表示设置样式
Z.EL.cssNum(elem, name) 获取样式数值型的值 elem 元素
name 样式名称
Z.EL.opacity(elem, value) 获取和设置透明度值0-1之间 elem 元素
value 未传值表示获取,传值表示设置
Z.EL.className(elem) 获取类样式名称值 elem 元素
className 类样式名称
Z.EL.addClass(elem, className) 增加类样式 elem 元素
className 类样式名称
Z.EL.removeClass(elem, className) 删除类样式 elem 元素
className 类样式名称
Z.EL.hasClass(elem, className) 判断是否有类样式 elem 元素
className 类样式名称
Z.EL.toggleClass(elem, className) 切换类样式,没有则加入,有则删除 elem 元素
className 类样式名称
Z.EL.select(elem) 选中对象文本 elem 元素
Z.EL.selection(elem) 选中对象的文本内容 elem 元素
Z.EL.focus(elem) 设置元素获取焦点 elem 元素
Z.EL.focusEnd(elem, len) 设置元素获取焦点,并把光标定位到结尾 elem 元素
len 长度
Z.EL.parent(elem) 获取元素父元素 elem 元素
Z.EL.parentIndex(elem) 获取元素在父元素的索引号 elem 元素
Z.EL.childs(elem) 获取元素子节点列表
elem.childNodes
elem 元素
Z.EL.children(elem) 获取元素子元素列表
elem.children
elem 元素
Z.EL.html(elem, value) 获取和设置HTML代码 elem 元素
value 未传值表示获取,传值表示设置
Z.EL.text(elem, value) 获取或设置元素文本 elem 元素
value 未传值表示获取,传值表示设置
Z.EL.append(elem, child) 增加子元素 elem 本元素
child 子元素
Z.EL.remove(elem, name) 删除元素或删除属性 elem 元素
name 未传值表示删除元素,传值表示删除元素的属性
Z.EL.replace(elem, newElem) 替代元素 elem 原元素
newElem 新元素
Z.EL.offsetLeft(elem) 获取相对于父对象的左偏移 elem 元素
Z.EL.offsetTop(elem) 获取相对于父对象的上偏移 elem 元素
Z.EL.offsetLeftBody(elem) 获取相对body的左偏移(绝对左偏移) elem 元素
Z.EL.offsetTopBody(elem) 获取相对body的上偏移(绝对上偏移) elem 元素
<#-- HTML对象 -->
HTML对象(Z.H/Z.Html)
函数 说明 参数 参数说明
Z.H.createElement(html) 通过HTML文本创建元素列表 html HTML文本
Z.H.displayDefault(tag) 获取HTML标签缺省的display值 tag HTML标签名
<#-- 地址对象 -->
地址对象(Z.L/Z.Location)
函数 说明 参数 参数说明
Z.L.reload(target) 刷新 target 目标对象,为空表示当前window
Z.L.access(url, target) 访问URL url URL地址
target 目标对象,为空表示当前window
Z.L.check(url, name, form, target) 带检测访问URL url URL地址
name 单选框或多选框名称
form 指定表单内的单选或多选框
target 目标对象
Z.L.confirm(url, message, name, form, target) 带询问访问URL
url URL地址
message 询问的显示信息
name 单选框或多选框名称
form 确认的形式
target 目标对象
Z.L.href(param, param2) 含对象参数的访问URL
param 参数1:
字符串时表示URL,功能同access函数
对象时取值{url:url,target:target,name:name,form:form,message:message},相应地判断是check|confirm方法
param2 参数2:
传值时为target,优先于参数1中对象target
<#-- COOKIE对象 -->
COOKIE对象(Z.CK/Z.Cookie)
函数 说明 参数 参数说明
Z.Cookie.all() 设置或返回当前文档有关的所有Cookie,等同document.cookie
Z.Cookie.add(cookie) 添加Cookie cookie Cookie对象:
name:Cookie名称,value:Cookie值
expires:Cookie到期时长,单位秒,未传值表示随浏览器关闭失效
path:Cookie有效路径,建议/结尾
domain:Cookie有效域名
secure:安全标识true|false,HTTPS时有效

如:{name:"test", value:"value", expires=3600, path="/", domain="127.0.0.1", secure:false}
Z.Cookie.remove(name) 删除Cookie name Cookie名称
Z.Cookie.get(name) 获取Cookie name Cookie名称
${zhiqim_com_chapter()}
${zhiqim_com_footer()}