我的类库文档
H对象集合处理函数 item()
说明: 用来从H对象集合里选取指定的一个或多个项
语法: H对象.item([num[,num2]])
参数说明:如果没指定参数,则返回H对象中所选元素的个数
num:Number,如果为正数,则在H对象中选取相应的项,1为第一项;如果该参数为负数,则在H对象中选取不包含该参数的正数代表的项的其他剩余的项。[可选]
num2:Number,选取H对象中num-num2的项。暂时不支持负数[可选]
获取下一个兄弟节点 next()
说明: 获取紧邻下一个兄弟节点,会忽略火狐等浏览器的文本节点,如果不存在则返回空
语法: H对象.next()
获取上一个兄弟节点 pre()
说明: 获取紧邻的上一个兄弟节点,会忽略火狐等浏览器的文本节点,如果不存在则返回空
语法: H对象.pre()
css样式设置/获取函数 css()
说明: 用来设置或获取元素的css样式,该函数不支持对透明度样式的处理
语法: H对象.css(cssText[,cover])
参数说明:cssText:String,如果样式字符串中没有冒号,则表示为获取css样式,如果有冒号,则表示设置css样式。例如"font-size:12px;background:red"是用来设置css的,"fontSize","backgroundImage"则用来获取css样式,"fontSize,backgroundImage"像这种有多个属性的,则返回的是一个数组,可以用属性作为键名来引用数组中相应的项,当然也可以使用数字来引用。
cover:Boolean,选取H对象中num-num2的项。暂时不支持负数[可选]
透明度设置/获取函数 opacity()
说明: 用来设置或获取元素的透明度
语法: H对象.opacity([opacity])
参数说明:如果不存在参数则为获取透明度
opacity:Number,透明度值,范围为0~1
HTML设置/获取函数 html()
说明: 用来设置或获取元素的innerHTML
语法: H对象.html([html])
参数说明:如果不存在参数则为获取HTML
html:String,html字符串
文本设置/获取函数 text()
说明: 用来设置或获取元素的innerText/textContent
语法: H对象.text([text])
参数说明:如果不存在参数则为获取text
text:String,text字符串
事件注册函数 on()
说明: 用来给元素注册事件,监听函数中的this是指向注册事件的元素,并且还会自动给监听函数的第一个参数传入一个包装好的event对象
语法: H对象.on(type,listener)
参数说明:type:String,要注册的事件类型,不带前缀on。[必须]
listener:Function,要注册的监听函数。[必须]
事件对象:
说明:事件对象会作为监听函数的第一个参数自动传入,该事件对象并不是原生的时间对象,而是经过包装后的时间对象,处理了很多兼容性问题,目前支持的属性和方法如下:
altKey,ctrlKey,shiftKey,button,clientX,clientY,screenX,screenY,pageX,pageY,layerX,layerY,type,target,currentTarget,which,stopPropagation,preventDefault
其中的含义与用法与w3c标准相同
事件注销函数 off()
说明: 用来注销元素的事件
语法: H对象.off([type[,listener]])
参数说明:type:String,要注销的事件类型,不带前缀on。如果省略该参数则注销该元素所有类型所有事件。[可选]
listener:Function,要注销的监听函数。如果省略该参数则注销该类型事件的所有监听函数。[可选]
页面事件销毁函数 H.off()
说明:可以调用该函数来注销页面内的所有元素的所有事件类型的所有监听函数,简单来说就是移除页面内所有元素的所有事件
语法: H.off() 无参数
动画函数 animate()
说明:在同一个元素上注册的所有该函数构成了一个动画队列,不延迟动画始终是优先于延迟动画执行的,延迟动画在所有不延迟动画执行完毕后才开始执行,如果有多个延迟动画, 则根据书写顺序以及delayTime的取值来执行
语法: H对象.animate(delay,delayTime,property,begin,change,time[,type[,outOrin[,callback]]])
参数说明:dealy:Boolean,是否要延迟执行动画,相当于动画队列,true为是,false为否,这里的延迟的意思是指等上一个动画执行完毕后再开始执行本动画,在同一个元素上,所有不延迟的动画(即该值为false的)是同时执行的,延迟动画在不延迟动画执行完毕后再执行,如果有多个延迟动画,则书写顺序在后的延迟动画会在前一个延迟动画执行完毕后执行。注:延迟的效果只在同一个元素上生效。[必须]
delayTime:Number,取值范围为0~1,指定一个时间点,当本次动画到达这个时间点后即开始执行队列中的下一个动画,0表示本段动画开始执行时下一个动画也开始执行,1表示要等本段动画执行完后再执行下一个动画,0.5表示本段动画执行一半时开始执行下一段动画。如果不是延迟动画,则该值始终是为1的。注:该值影响的是队列中的下一个动画的执行,对本段动画没有影响。[必须]
property:String,要进行动画的属性,目前可用的属性有width,height,top,left,right,bottom,opacity,opacity的范围是0~1。[必须]
begin:Number,要进行动画的属性的初始值。[必须]
change:Number,要改变的量,也就是说是一个相对值。[必须]
time:Number,决定动画所用的时间,单位毫秒,一般来说填数字100就相当于1秒左右。[必须]
type:String,缓动类型,可选值为"t0"~"t7",'"t0"为匀速,默认为"to"。[可选]
outOrin:String,缓入或缓出,可选值为 "o"、"i"、"oi",分别代表缓入、缓出、既缓入又缓出,默认为缓出。[可选]
callback:Function,本段动画执行完毕后的回调函数[可选]
拖拽函数 drag()
说明:调用该方法后,对象便拥有了鼠标拖拽功能
语法: H对象.drag(handle[,parent[,lock]])
参数说明:handle:H对象,该参数指明了一个拖拽的手柄,必须要在要拖动的对象内,如过不使用手柄,则设为null。[必须]
parent:H对象,指定拖动元素定位要参照的父元素(也可能是祖先元素),该元素必须设为动态定位。一般是要把拖动元素限制在某个范围之内才使用该参数。[可选]
lock:Boolean,必须设置了第二个参数才可以使用这个参数,true表示限制拖动范围,false表示不限制拖动范围,默认true。[可选]
解除拖拽函数 undrag()
说明:调用该方法后,对象便不可再拖动(前提是之前调用了drag()方法)。
语法:H对象.undrag() 无参数
鼠标悬停函数 hover()
说明:此函数用来模拟鼠标悬停
语法:H对象.hover(funOver[,funOut])
参数说明: funOver:Function,当鼠标悬停在元素上方时要执行的函数[必须]
funOut:Function,当鼠标移出元素时要执行的函数,如果省略该参数则鼠标移出元素时不执行任何动作。[可选]
隐藏函数 hide()
说明:调用该方法后,对象的display属性变为none。
语法:H对象.hide() 无参数
显示函数 show()
说明:调用该方法后,对象的display属性变为block。
语法:H对象.show() 无参数
-----------------------------------------------------------------------------------------------------
获取元素特征函数 offsetLeft()
说明:获取元素的offserLeft值
语法:H对象.offsetLeft() 无参数
获取元素特征函数 offsetTop()
说明:获取元素的offserTop值
语法:H对象.offsetTop() 无参数
获取元素特征函数 offsetWidth()
说明:获取元素的offserWidth值
语法:H对象.offsetWidth() 无参数
获取元素特征函数 offsetHeight()
说明:获取元素的offserHeigth值
语法:H对象.offsetHeigth() 无参数
获取/设置元素特征函数 scrollLeft()
说明:有参数则为设置元素的scrollLeft值,没有则为获取
语法:H对象.scrollLeft([value])
获取/设置元素特征函数 scrollTop()
说明:有参数则为设置元素的scrollTop值,没有则为获取
语法:H对象.scrollTop([value])
--------------------------------------------------------------------------------------------------------------------