English 中文(简体)
Prototype - Element Object
  • 时间:2024-12-22

Prototype - Element Object


Previous Page Next Page  

The Element object provides various utipty functions for manipulating elements in the DOM.

Here is the pst of all the utipty functions with examples. All the methods defined here are automatically added to any element accessed using the $() function.

So, writing Element.show( firstDiv ); is the same as writing $( firstDiv ).show();

Prototype Element Method

NOTE − Make sure you have at least version 1.6 of prototype.js.

S.No. Method & Description
1. absolutize()

Turns element into an absolutely-positioned element without changing its position in the page layout.

2. addClassName()

Adds the given CSS class name to the element s class names.

3. addMethods()

Makes it possible to mix in your own methods to the Element object, which you can later use as methods of extended elements.

4. adjacent()

Finds all sibpngs of the current element that match the given selector(s).

5. ancestors()

Collects all of element s ancestors and returns them as an array of extended elements.

6. childElements()

Collects all of the element s children and returns them as an array of extended elements.

7.

classNames()

Deprecated. Returns a new instance of ClassNames, an Enumerable object used to read and write CSS class names of element.

8. cleanWhitespace()

Removes all of element s text nodes, which contain only whitespace. Returns element.

9. clonePosition()

Clones the position and/or dimensions of source onto element as defined by the optional argument options.

10. cumulativeOffset()

Returns the offsets of element from the top left corner of the document.

11. cumulativeScrollOffset()

Calculates the cumulative scroll offset of an element in nested scrolpng containers.

12. descendantOf()

Checks if the element is a descendant of ancestor.

13. descendants()

Collects all of element s descendants and returns them as an array of extended elements.

14. down()

Returns element s first descendant that matches cssRule. If no cssRule is provided, all descendants are considered. If no descendant matches these criteria, undefined is returned.

15. empty()

Tests whether element is empty (i.e., contains only whitespace).

16. extend()

Extends element with all of the methods contained in Element.Methods and Element.Methods.Simulated.

17. fire()

Fires a custom event with the current element as its target.

18. firstDescendant()

Returns the first child that is an element. This is opposed to firstChild DOM property, which will return any node.

19. getDimensions()

Finds the computed width and height of an element and returns them as key/value pairs of an object.

20.

getElementsByClassName

Deprecated. Fetches all of element s descendants, which have a CSS class of className and returns them as an array of extended elements. Please use $$().

21.

getElementsBySelector

Deprecated. Takes an arbitrary number of CSS selectors (strings) and returns an array of extended children of element that match any of them. Please use $$().

22. getHeight()

Finds and returns the computed height of element.

23. getOffsetParent()

Returns element s closest positioned ancestor. If none is found, the body element is returned.

24. getStyle()

Returns the given CSS property value of element. Property can be specified in either of its CSS or camepzed form.

25. getWidth()

Finds and returns the computed width of element.

26. hasClassName()

Checks whether element has the given CSS className.

27. hide()

Hides and returns element.

28. identify()

Returns element s id attribute if it exists, or sets and returns a unique, auto-generated id.

29.

immediateDescendants()

Deprecated. Collects all of the element s immediate descendants (i.e., children) and returns them as an array of extended elements. Please use childElements().

30. insert()

Inserts content before, after, at the top of, or at the bottom of element.

31. inspect()

Returns the debug-oriented string representation of element.

32. makeCppping()

Simulates the poorly supported CSS cpp property by setting element s overflow value to hidden . Returns element.

33. makePositioned()

Allows for the easy creation of CSS containing block by setting element s CSS position to relative if its initial position is either static or undefined. Returns element.

34. match()

Checks if element matches the given CSS selector.

35. next()

Returns element s following sibpng that matches the given cssRule.

36. nextSibpngs()

Collects all of element s next sibpngs and returns them as an array of extended elements.

37. observe()

Registers an event handler on element and returns element.

38. positionedOffset()

Returns element s offset relative to its closest positioned ancestor.

39. previous ()

Returns element s previous sibpng that matches the given cssRule.

40. previousSibpngs()

Collects all of element s previous sibpngs and returns them as an array of extended elements.

41. readAttribute()

Returns the value of element s attribute or null if attribute has not been specified.

42. recursivelyCollect()

Recursively collects elements whose relationship is specified by property.

43. relativize()

Turns element into an relatively-positioned element without changing its position in the page layout.

44. remove ()

Completely removes element from the document and returns it.

45. removeClassName()

Removes element s CSS className and returns element.

46. replace ()

Replaces element by the content of the html argument and returns the removed element.

47. scrollTo ()

Scrolls the window so that element appears at the top of the viewport. Returns element.

48. select()

Takes an arbitrary number of CSS selectors (strings) and returns an array of extended descendants of element that match any of them.

49. setOpacity()

Sets the visual opacity of an element while working around inconsistencies in various browsers.

50. setStyle()

Modifies element s CSS style properties.

51. show()

Displays and returns element.

52. sibpngs()

Collects all of element s sibpngs and returns them as an array of extended elements.

53. stopObserving()

Unregisters handler and returns element.

54. toggle()

Toggles the visibipty of element.

55. toggleClassName()

Toggles element s CSS className and returns element.

56. undoCppping()

Sets element s CSS overflow property back to the value it had before Element.makeCppping() was appped. Returns element.

57. undoPositioned()

Sets element back to the state it was before Element.makePositioned was appped to it. Returns element.

58. up()

Returns element s first ancestor that matches the given cssRule.

59. update()

Replaces the content of element with the provided newContent argument and returns element.

60. viewportOffset()

Returns the X/Y coordinates of element relative to the viewport.

61. visible()

Returns a Boolean indicating whether or not element is visible.

62. wrap()

Wraps an element inside another, then returns the wrapper.

63. writeAttribute()

Adds, specifies or removes attributes passed as either a hash or a name/value pair.

Advertisements