Prototype - 元素对象

元素对象提供各种实用函数来操作 DOM 中的元素。

以下是所有实用函数的列表,并附有示例。此处定义的所有方法都会自动添加到使用 $() 函数访问的任何元素中。

因此,编写 Element.show('firstDiv'); 与编写 $('firstDiv').show(); 相同

Prototype 元素方法

注意 − 确保您至少拥有 1.6 版的prototype.js。

S.No. 方法 &描述
1. absolutize()

将元素转换为绝对定位元素,而不改变其在页面布局中的位置。

2. addClassName()

将给定的 CSS 类名添加到元素的类名中。

3. addMethods()

可以混合您自己的方法到 Element 对象,稍后您可以将其用作扩展元素的方法。

4. adjacent()

查找当前元素中与给定选择器匹配的所有兄弟元素。

5. ancestors()

收集元素的所有祖先并将它们作为扩展元素数组返回。

6. childElements()

收集元素的所有子元素并将它们作为扩展元素数组返回。

7.

classNames()

已弃用。返回 ClassNames 的新实例,这是一个用于读取和写入元素的 CSS 类名的 Enumerable 对象。

8. cleanWhitespace()

删除元素的所有仅包含空格的文本节点。返回元素。

9. clonePosition()

根据可选参数选项的定义,将源的位置和/或尺寸克隆到元素上。

10. cumulativeOffset()

返回元素与文档左上角的偏移量。

11. cumulativeScrollOffset()

计算嵌套滚动容器中元素的累积滚动偏移量。

12. descendantOf()

检查元素是否是祖先的后代。

13. descendants()

收集元素的所有后代并将它们作为扩展元素数组返回。

14. down()

返回元素的第一个与 cssRule 匹配的后代。如果没有提供 cssRule,则考虑所有后代。如果没有后代符合这些条件,则返回 undefined。

15. empty()

测试元素是否为空(即仅包含空格)。

16. extend()

使用 Element.Methods 和 Element.Methods.Simulated 中包含的所有方法扩展元素。

17. fire()

以当前元素为目标触发自定义事件。

18. firstDescendant()

返回第一个子元素。这与 firstChild DOM 属性相反,后者将返回任何节点。

19. getDimensions()

查找元素的计算宽度和高度,并将它们作为对象的键/值对返回。

20.

getElementsByClassName

已弃用。获取元素的所有后代,这些后代具有 CSS 类 className,并将它们作为扩展元素数组返回。请使用 $$()。

21.

getElementsBySelector

已弃用。获取任意数量的 CSS 选择器(字符串)并返回与其中任何一个匹配的元素的扩展子元素数组。请使用$$()。

22. getHeight()

查找并返回元素的计算高度。

23. getOffsetParent()

返回元素最近定位的祖先。如果未找到,则返回 body 元素。

24. getStyle()

返回元素的给定 CSS 属性值。属性可以以 CSS 或驼峰格式指定。

25. getWidth()

查找并返回元素的计算宽度。

26. hasClassName()

检查元素是否具有给定的 CSS className。

27. hide()

隐藏并返回元素。

28. identify()

如果元素的 id 属性存在,则返回该属性,否则设置并返回一个唯一的、自动生成的 id。

29.

immediateDescendants()

已弃用。收集元素的所有直接后代(即子元素)并将它们作为扩展元素数组返回。请使用 childElements()。

30. insert()

在元素之前、之后、顶部或底部插入内容。

31. inspect()

返回元素的面向调试的字符串表示形式。

32. makeClipping()

模拟效果不佳的通过将元素的溢出值设置为"隐藏",支持 CSS 剪辑属性。返回元素。

33. makePositioned()

如果元素的初始位置为"静态"或未定义,则允许通过将元素的 CSS 位置设置为"相对",轻松创建包含块的 CSS。返回元素。

34. match()

检查元素是否与给定的 CSS 选择器匹配。

35. next()

返回与给定 cssRule 匹配的元素的下一个同级元素。

36. nextSiblings()

收集元素的所有下一个兄弟元素并将它们作为扩展元素数组返回。

37. observe()

在元素上注册事件处理程序并返回元素。

38. positionedOffset()

返回元素相对于其最近定位祖先的偏移量。

39. previous ()

返回元素的与给定 cssRule 匹配的上一个兄弟元素。

40. previousSiblings()

收集元素的所有上一个兄弟元素并将它们作为扩展元素数组返回。

41. readAttribute()

返回元素属性的值,如果未指定属性,则返回 null。

42. recursivelyCollect()

递归收集由属性指定关系的元素。

43. relativize()

将元素转换为相对定位元素,而不改变其在页面布局中的位置。

44. remove ()

从文档中完全删除元素并返回它。

45. removeClassName()

删除元素的 CSS className 并返回元素。

46. replace ()

用 html 参数的内容替换元素并返回已删除的元素。

47. scrollTo ()

滚动窗口,使元素出现在视口顶部。返回元素。

48. select()

获取任意数量的 CSS 选择器(字符串)并返回与其中任何一个匹配的元素的扩展后代数组。

49. setOpacity()

设置元素的视觉不透明度,同时解决各种浏览器中的不一致问题。

50. setStyle()

修改元素的 CSS 样式属性。

51. show()

显示并返回元素。

52. siblings()

收集元素的所有兄弟元素并将它们作为扩展元素数组返回。

53. stopObserving()

取消注册处理程序并返回元素。

54. toggle()

切换元素的可见性。

55. toggleClassName()

切换元素的 CSS className 并返回元素。

56. undoClipping()

将元素的 CSS overflow 属性设置回应用 Element.makeClipping() 之前的值。返回元素。

57. undoPositioned()

将元素设置回应用 Element.makePositioned 之前的状态。返回元素。

58. up()

返回与给定 cssRule 匹配的元素的第一个祖先。

59. update()

使用提供的 newContent 参数替换元素的内容并返回元素。

60. viewportOffset()

返回元素的 X/Y 坐标相对于视口。

61. visible()

返回一个布尔值,指示元素是否可见。

62. wrap()

将一个元素包装在另一个元素中,然后返回包装器。

63. writeAttribute()

添加、指定或删除作为哈希或一个名称/值对。