原型 - 元素对象


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

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

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

原型元素法

注意- 确保您至少拥有 prototype.js 版本 1.6。

编号 方法及说明
1. 绝对化()

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

2. 添加类名()

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

3. 添加方法()

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

4. 邻近的()

查找当前元素与给定选择器匹配的所有同级元素。

5. 祖先()

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

6. 子元素()

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

7.

类名()

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

8. 干净的空白()

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

9. 克隆位置()

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

10. 累积偏移量()

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

11. 累积滚动偏移()

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

12. 后代()

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

13. 后人()

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

14. 向下()

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

15. 空的()

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

16. 延长()

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

17. 火()

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

18. 第一个后代()

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

19. 获取尺寸()

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

20.

按类名获取元素

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

21.

通过选择器获取元素

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

22. 获取高度()

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

23. getOffsetParent()

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

24. 获取样式()

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

25. 获取宽度()

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

26. 有类名()

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

27. 隐藏()

隐藏并返回元素。

28. 确认()

返回元素的 id 属性(如果存在),或者设置并返回唯一的自动生成的 id。

29.

直接后代()

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

30. 插入()

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

31. 检查()

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

32. makeClipping()

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

33. 使定位()

如果元素的初始位置是“静态”或未定义,则可以通过将元素的 CSS 位置设置为“相对”来轻松创建 CSS 包含块。返回元素。

34. 匹配()

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

35. 下一个()

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

36. 下一个兄弟姐妹()

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

37. 观察()

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

38. 定位偏移()

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

39. 以前的 ()

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

40. 以前的兄弟姐妹()

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

41. 读取属性()

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

42. 递归收集()

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

43. 相对化()

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

44. 消除 ()

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

45. 删除类名()

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

46. 代替 ()

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

47. 滚动到()

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

48. 选择()

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

49. 设置不透明度()

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

50. 设置样式()

修改元素的 CSS 样式属性。

51. 展示()

显示并返回元素。

52. 兄弟姐妹()

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

53. 停止观察()

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

54. 切换()

切换元素的可见性。

55. 切换类名()

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

56. 撤消剪辑()

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

57. 撤消定位()

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

58. 向上()

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

59. 更新()

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

60. 视口偏移()

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

61. 可见的()

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

62. 裹()

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

63. 写属性()

添加、指定或删除作为散列或名称/值对传递的属性。