x库 --原创翻译.koma

译的时候比较毛..大家讲究看吧..反正一看都知道,...

  1X库：
  2    X库是一个可以重用的跨浏览器的javascript库，对象；他包含核心的DHTML函数，公共函数，诸如menus 和 tab panels这样的对象：
  3文档开始：
  4    
  5｜　
  6    参考的版本是x version 3.15.3，此版本对NN4不提供支持。如果您需要NN4的支持的话，请用x_core_nn4.js 和x_event_nn4.js代替 x_core.js和x_event.js;
  7
  8参数：
  9    在方括号中的参数是可选的。参数的名称用以下的数据类型前缀；
 10    　b- Boolean
 11      i– signed integer
 12      u-unsigned integer
 13      f- floating point (real)
 14      s- string 
 15      fn- function reference　
 16      o – object reference
 17    第一个参数一般来说是必须的。Ele参数可能是id string 也可能是对象的引用；
 18｜　全局变量
 19    xVersion – Xversion string 
 20    尽可能地利用对象检测来代替浏览器检测。下面使用的变量是在xlib.js中定义的。
 21    xUA - lowercase user-agent string
 22    xIE4Up - true 如果浏览器在IE4以上；
 23    xIE4 - true 如果浏览器是IE4;
 24    xIE5 - true 如果是IE5
 25    xNN4 - true 如果是NN$
 26    xOp5or6 - true 如果是 5.x or 6.x
 27    xOp7 - true if browser is Opera 7.x xMoz - true if browser is Mozilla, etc. xMac - true如果系统是Mac
 28    
 29    对于一些浏览器来说。resize和scroll event 是相互模仿的。下面的变量可能会被用到。
 30            xPCW - previous clientWidth  宽
 31            xPCH - previous clientHeight 客户端的高
 32            xREL - resize event listener 窗口大小监听器；
 33            xPSL - previous scrollLeft   滚动条；
 34            xPST - previous scrollTop
 35            xSEL - scroll event listener
 36            
 37 FUNCTIONS
 38     -------
 39     xshow(ele)
 40         设置对象的可见性(to visible)(show for nn4).调用xVisibility();
 41         参数：
 42             ele - id string or object 引用
 43         Uses：xVisibility
 44         File: x_core.js
 45     ---------
 46     xHide(ele)
 47         设置对象不可见to hidden (hide for nn4) 调用 xVisibility;
 48         参数：
 49             ele- id string or object 应用
 50         Uses：xVisibility
 51         File: x_core.js
 52     ---------------
 53     xVisibility(ele,bshow)
 54     参数：
 55         ele- id string or object 引用
 56         bshow - true = show;false= hide;
 57     Uses: xGetElementId(),xDef()
 58     File: x_core.js
 59 -------------------
 60 xDisplay (ele,sProp)
 61     返回和选择性的设置元素的display 属性。
 62     参数:
 63         ele = id string or object 引用
 64         sProp = none,inline,block,etc
 65     Users: xGetElementById(),xStr()
 66     File: x_core.js
 67     -------------
 68     xZindex(ele[,uZ])
 69         返回和选择性的设置对象的z-index.
 70             参数：
 71                 ele: id string or object 引用；
 72                 uZ： unsigned integer z-index
 73             Uses: XGetElementById(),xDef(),xNum()
 74             File: x_core.js
 75         -----------
 76         xColor(ele[,sColor])
 77             返回和选择性的设置对象的文本颜色。
 78             参数：
 79                 ele = id string or object reference;
 80                 sColor = color string 
 81             Uses: xGetElementById() xDef() xStr()
 82             File: x_core.js;
 83             -----------
 84             xBackGround(ele[,sBgColor[,sBgImage]])
 85             返回和选择性的设置对象的背景和图片。
 86             参数：
 87                 ele ：同上
 88                 sBgColor = 背景颜色string ;
 89                 xBgImage = 北京图片；
 90             Used: xGetElementById() xDef(),xStr() xOp5or6
 91             File: x_core.js;
 92             ------------
 93             xMoveTo(ele,iX,iY)
 94             设置对象的横纵座标。
 95                 参数：
 96                     ele id string or object 引用
 97                     iX = 整数横坐标；
 98                     iY = 整数纵坐标；
 99                 Uses: xLeft();xTop();
100                 File：x_core.js;
101                 -------------
102             xLeft(ele[,iX])
103             返回或设置对象的横坐标
104             参数：
105                 ele = id string or object 引用
106                 iX = 整数横坐标
107             Uses：xGetElementById();xDef();xStr();xNum()
108             File: x_core.js;
109             --------------
110             xTop(ele[,iY])
111              返回或设置对象的纵坐标
112             参数：
113                 ele = id string or object 引用
114                 iY = 整数总坐标
115             Uses：xGetElementById();xDef();xStr();xNum()
116             File: x_core.js;
117             -----------------------
118             xPageX(ele)
119             返回对象的绝对横坐标
120             参数： 
121                 ele = id string or object 引用；
122             Uses：XGetElementById();xDef();
123             File: x_core.js
124             
125             -----------------
126             xPageY(ele)
127                          返回对象的绝对纵坐标
128             参数： 
129                 ele = id string or object 引用；
130             Uses：XGetElementById();xDef();
131             File: x_core.js
132             -----------------------
133             xOffsetTop(ele)
134             返回对象在父对象上Y方向上的偏移；
135             参数：
136                 ele 
137                 uses: xGetElementById();xDef();
138                 File：x_core.js
139                 ----------
140             xScrollLeft(ele)
141             返回对象水平滚动的像素；
142             参数：
143                 ele = 。。如果是undefine 则返回documnet scrollLeft;
144             Uses: xGetElementById();xDef();xNum();
145             File：x_core.js;
146             -------------
147              xScrollTop(ele)
148             返回对象垂直滚动的像素；
149             参数：
150                 ele = 。。如果是undefine 则返回documnet scrollTop;
151             Uses: xGetElementById();xDef();xNum();
152             File：x_core.js;
153            --------------
154            xSlideTo(ele,iX,iY,iTime)
155            线性的移动，在给定的时间内滑动对象到指定的位置；
156            参数：
157                ele = ..
158                iX = 整；
159                iY = 整；
160                iTime = 滑行的时间；
161            Uses: xGetElementById();xMoveTo();
162            File: x_slide.js;
163            ------------------
164            xResizeTo(ele,uW,uH)
165            设置元素的width和高l
166            参数：
167                ele = ..
168                uW = unsigned inetger width;
169                uH = unsigned inetger height;
170            Uses: xWidth();xHieght;
171            File: x_core.js;
172            ---------------
173            xWidth(ele[,uW])
174            返回或者设置对象的宽；
175            参数：    
176                ele = ..
177                uW = unsigned integer width;
178            Uses: xGetElementById();xDef();xNum();xStr();
179            File: x_core.js;
180            ---------------
181            xHeight(ele[,uH])
182            返回和设置元素的高；
183            参数：
184                ele = 
185                uH = unsigned integer width
186            Uses: xGetElementById();xDef;xNum();xStr();
187            File: x_core.js;
188            ----------
189            xClip(ele[.iTop,iRight,iBottom,iLeft])
190            设置元素的裁剪矩形，如果ele是唯一的 参数，那么剪裁的区域将设置成矩形的大小；return void；
191            参数：
192                ele =     。。。
193                iTop = 左上角的整数Y坐标；
194                iRight = 右下角的x坐标；
195                iBottom = 右下角的y坐标；
196                iLeft = 左上角的x坐标
197            Uses: xGetElementById();xNum();nn4：xWidth(),nnt:xHeight();
198            File: x_core.js;
199            ------------
200            xAddEventListener(ele,sEnentType,fnEnentListener,bCapture)/xRemoveEventListener;
201            在对象上注册一个事件监听器，对于某些浏览器，window.onscroll和window.onresize 的时间是不同的。
202            参数:
203                ele = ..;
204                sEventType = string 时间类型(mousemove,click,resize,etc);
205                fnEventListener = reference to 监听函数；
206                bCapture = boolean 捕捉事件标志；
207            Uses: xGetElementById();
208            File: x_event.js;
209            
210            ------------
211            xEvent(oEvent)
212            在所选择的事件的属性上解决了浏览器的差异，返回包含这些属性的对象，这是一个对象。
213            创建一个实例，使用     new
214                参数：
215                oEvent = 本地事件对象 对于IE来说 = null；
216                下面是当前的事件属性：
217                type：string type of event;
218                target: object 事件的目标；
219                pageX = 鼠标的绝对横坐标；
220                pageY = 鼠标的绝对纵坐标；
221                offsetX = 相对于目标，鼠标的横坐标；
222                offsetY = 相对于目标，鼠标的纵坐标 ；
223                keyCode = unsigned integer;
224            Uses: xDef();xPageX();xPageY();nn4: xLayerFromPoint();
225            File: x_event.js;
226            --------------
227            xStopPropagation(evt)
228            ..
229            参数：evt
230            Uses：..
231            File: x_event.js;
232            --------------
233            xPreventDefault(evt)
234            
235            参数：evt
236            Uses：..
237            File: x_event.js;
238            ----------
239            xClientWidth()
240            返回 window 的 inner 宽；
241            Uses xOp5or6,xDef();
242            Flie: x_core.js;
243            ---------
244            xClientHeight()
245            返回 window 的 inner 高；
246            Uses xOp5or6,xDef();
247            Flie: x_core.js;
248            -------------
249            xGetElementsByAttribute(sTage,sAtt,sRE,fn)
250            返回一个array,这些array的属性=sAtt 的值满足sRE,sAtt也可以是一个
251            property name 但是 属性必须是string类型的；
252                参数：
253                    sTag:-
254                    sAtt:-
255                    sRE:-
256                    fn = callback 函数；
257                Uses: none;
258                file：x_dom.js;
259                -----------------
260                xGetElementByClassName(sClcName,oParentEle,sTagName,fn)
261                返回一个array,这个array是ParentEle的子结点，还具有tagName,和clsName.
262                如果ParentEle为空或不存在，那么将使用document作为父结点。如果Tagname没有或是
263                不存在，那么将使用“*”；
264                参数：
265                sClcName：-
266                oParentEle：-
267                sTagName：-
268                fn： callback函数。
269                File：x_dom.js;
270                ------------------
271                xGetElementsByTagName(sTagname，oParentEle)
272                返回一个array，这个array是oParent的子，并且具有TagName。如果父结点不存在。
273                那么，将使用document，如果sTagName不存在，使用“*” this even work with IE4;
274                 参数：
275                     sTagname
276                     oParentEle
277                     Uses: none;
278                     File: x_dom.js;
279                     --------------
280                 xGetComputedStyle(oEle,sProp,bInt)
281                 sProp使用css属性名，而不是对象名在IE中只能用px；
282                 参数：
283                     oEle = 元素对象；
284                     sProp = css property name;
285                     bInt = if true,返回一个整值；
286                     Uses：none；
287                     File: x_dom.js;
288                -----------
289                xWalkTree(oNode,fnVisit)
290                在给定的节点下，传递每个字节点给fnVisit函数；
291                参数：
292                    oNode = 开始传递的节点；
293                    fnvisit = 韩数
294                Uses: none;
295                File: x_dom.js;
296                -------------------
297                xGetElementById(ele)
298                返回一个对象的引用：如果对象为invalid，则返回null;
299                参数：
300                    ele = id。。。
301                uses： nn4 xLayer()
302                File: x_core.js;
303                ----------------------
304                xLayer(sId)
305                返回一个层的引用；
306                ---------------
307                xLayerFromPoint(iX,iY)
308                返回一个包含（ix,iy）所代表的点的最高层。这个只适用于nn4,被xEvent（）调用
309                参数：
310                    iX = 绝对x坐标
311                    iy = 绝对Y坐标
312                Uses: none;
313                File: x_event_nn4.js;
314                --------------------
315                xParent(ele,bNode)
316                返回一个元素的父元素的引用，null表示没有找到。
317                参数：
318                    ele = 。。
319                    bNode = if true,则返回父，else 则返回一个乡邻的父
320                    File：x_core.js;
321                    ------------
322                    xDef(ref[,])
323                    返回true ，如果所有的参数都是 defined；
324                    -------------------
325                    xNum(ref)
326                    返回true 如果typeof(ref)=='number';
327                    此外，类似的方法有：
328                    xStr,
329                    --------------
330                    xEnableDrag(ele,fnDragStart，fnDrag,fnDragEnd)
331                    使元素具有拖动特性；
332                    参数：
333                        ele = 。。
334                        fnDragSatart = 此函数将调用，当鼠标down在这个元素上；
335                        fnDrag  = 此函数将调用，当拖动
336                        fnDragEnd = 此函数将被调用，当鼠标离开这个元素时；
337                    Uses:
338                            xGetElementById();xAddEventListener()/xRemoveEventListener();xEvent();xParent();
339                            xMoveTo();
340                    File: x_drag.js;
341                    -----------------
342                    xImgRollSetup(sPath,sOvrSuffix,sFileExt,sImgEleId[,..])
343                    图像翻滚。。 只有window.onload之后，才能被调用。每个图像必须要有
344                    一个id，这些图像的命名规则是：
345                    out img = path+ imgEleid+fileExt；
346                    over img= path+ imgEleId+overSuffix+fileExt;
347                    参数：
348                        sPath = 图像的路径；
349                        sOvrSuffix = 如上方的命名规则；
350                        sFileExt = 要求“.”;
351                        sImgEleId = 传递图像的id；
352                    Uses: xGetElementById();
353                    File: x_img.js;
354                    ----------------
355                    xName(ref)
356                    返回一个显示的string 首先try  id,and nodeName,tagName,如果都没有，返回ele；
357                    参数:
358                        ref = 对象的饮用
359                    Uses: none;
360                    File: x_debug.js;
361                    -------------------
362                    xLoasScript(sUrl)
363                    在window.onload后load .js;
364                    ----------------------
365                    xParentChain(ele,sDelim,bNode)
366                    返回一个string显示。
367                    --------------------
368                    xHasPoint(ele,iLeft,iTop,iClpT,iClpR,iClpB,iClpL)
369                    如果，iLeft，iTop被包含在ele 的clipped area;
370                        参数：    
371                            ele = 。。。
372                            。
373                            。
374                            。
375                            uses：xNum();xPageX();xPageY();xWidth();xHeight();
376                        File：x_core.js;
377                    -------------------------
378                    xWindow(sName,uW,uH,iX,iY,loc,men,res,scr,sta,too)
379                    产生一个窗口，width height left top如果设为0的话，那么窗口将会有缺省的设置；；
380                    loc = location field; men = menubar; res = resize;scr = scrollbar;sta = status;
381                    以上为boolean值；
382                    -----------------------------
383                    xBar(sDir,sConStyle,sBarStyle)
384                        参数:
385                            sDir = 方向 string ltr，rtl，ttb，btt 中的一个
386                            sConStyle = bar 容器的classname；
387                            sBarStyle = bar的classname;
388                        File: x_bar.js;
389                    ---------------------------
390                    xPopup(sTmrType.uTimeout,sPosition,sStyle,sId,sUrl)
391                    可选择的popup window；
392                        参数：    
393                            sTmrType = timeout or interval;
394                            uTimeout = time in ms;
395                            sPosition  = cen, e,se,etc;
396                            sStyle = classname
397                            sid = id;
398                            surl = popup url
399                       File: x_popup.js;
400                       --------------------------------
401                       xTimer.set(sTmrType,obj,sMethod,uTime,data)
402                      
403                       注册一个对像的方法去接受一个timeout or interval 的事件。
404                       会接受到一个对象的引用：这个引用包含：start，stop，reset；
405                      elapsed 和 data xTimer 是一个全局的对象，当x_timer.js被包含的时候，
406                      被创建。
407                      
408                      sTmrType = timeout or interval;
409                      obj  = 接收事件的对象；
410                      sMethod = 对象的一个方法的名称；
411                      uTime =     时间 毫秒；
412                      data = 被传递给 事件监听器；
413                      
414                        ------------------------------------
415                        xEvalTextarea()
416                        
417                        append 一个textarea和一个button 到当前的current文档，点击按钮，获得
418                        textarea内的文本；
419                        File：x_debuge.js
420                        -----------------
421                        xTooltipGroup(grpClassOrIdList,tipClass,oringin,xOffSet,yOffSet,textlist)
422                        参数：
423                            grpClassOrIdList = css 目标元素上的classname或者是包含id string 的array;
424                            tipClass = .?
425                            origin = right,top,mouse 中的一个。指tooltip的方向；mouse的情况下，tooltip将
426                            跟随mouse；
427                            xOffset = 相对于origin的偏移；
428                            yOffset = 相对于origin的偏移；
429                            textlist = 具体文本；
430                        File：x_tip.js;
431                        ------------------
432                        xIntersection(ele1,ele2,obj)
433                        返回true ，如果两个元素相交，把相交的部分的属性传递给对象。x y w h ;
434                        
435                        File: x_misc.js;
436                        -------------------
437                        xLinearScale(value,inMin,inMax,outMin,outMax)
438                        
439                        参数：
440                            。。。
441                            。。。
442                            
443                        ---------------------------
444                        xEllipse(ele,xRadius,yRadius,radiusInc
445                                        totalTime,startAngle,stopAngle)
446                         椭圆性的动态图像；
447                        --------------------------
448                        xParaEq(ele,xExpr,yExpr,totalTime)
449                        综合动态图像；
450                        -------------------------
451                        xTableRowDisplay(bshow,sec,nRow)
452                        显示行；
453                        File：x_table.js;
454                        -----------------
455                        xTableCellCisibility(bshow,sec,nRow,nCol)
456                        设置cell的可见性 visibility;
457                        x_table.js;
458                        --------------------
459                        xTableColDisplay(bshow,sec,nCol)
460                        设置列的可见性；
461                        File: x_table.js;
462                        ---------------------
463                        xTableIterate(sec,fnCallback)
464                        参数：
465                            sec = id or table thead tbody tfoot 对象的引用；
466                            fncallback = 对于每个行或单元格调用的函数。如果return false;那么将停止，它将
467                            传递以下参数;
468                            obj = 当前单元格或行的引用；
469                            isRow = 真是对行的引用。否是对单元格的饮用。
470                            row = 第几行；
471                            col = 第几列；
472                            data = 传递给fncallback在每个单元格；
473                        File ：x_table.js;
474                    -------------------------------
475                    xTableCursor(id,inh,def,hov,sel)
476                    鼠标经过来高亮行和格；
477                        参数：
478                            id= table id；
479                            inh = inherit style；
480                            def = 缺省的style；
481                            hov = row 的悬停style；
482                            sel = 单元格被选择时的style；
483                        File：x_table.js;
484                    ------------------
485                    xImgAsyncWait(fbStatus,fnInit,fnError,sErrorImg,sAbortImg,imgArray)
486                    异步等待;
487                    File: x_img.js;
488                    ----------------------
489                    xTriStateImage(idOut,rulOver,urldown，fnUp)
490                    图片翻滚有三个状态 -- mousedown；
491                    --------------
492                    xCapitalize(str)
493                    大写每个字的头字母在str中
494                    x_misc.js
495                    --------------
496(完)
497                            
498                            
499