jQuery - manipulating-elements
Manipulating Elements
For complete documentation of jQuery manipulation methods.
Getting and Setting Information About Elements
There are many ways to change an existing element. Among the most common tasks is changing the inner HTML or attribute of an element. jQuery offers simple, cross-browser methods for these sorts of manipulations. You can also get information about elements using many of the same methods in their getter incarnations. For more information on getters and setters, see the Working with Selections section. Here are a few methods you can use to get and set information about elements:
.html()
– Get or set the HTML contents..text()
– Get or set the text contents; HTML will be stripped..attr()
– Get or set the value of the provided attribute..width()
– Get or set the width in pixels of the first element in the selection as an integer..height()
– Get or set the height in pixels of the first element in the selection as an integer..position()
– Get an object with position information for the first element in the selection, relative to its first positioned ancestor. This is a getter only..val()
– Get or set the value of form elements.
Changing things about elements is trivial, but remember that the change will affect all elements in the selection. If you just want to change one element, be sure to specify that in the selection before calling a setter method.
1
2
|
|
Moving, Copying, and Removing Elements
While there are a variety of ways to move elements around the DOM, there are generally two approaches:
- Place the selected element(s) relative to another element.
- Place an element relative to the selected element(s).
For example, jQuery provides .insertAfter()
and .after()
. The .insertAfter()
method places the selected element(s) after the element provided as an argument. The .after()
method places the element provided as an argument after the selected element. Several other methods follow this pattern: .insertBefore()
and .before()
, .appendTo()
and .append()
, and .prependTo()
and .prepend()
.
The method that makes the most sense will depend on what elements are selected, and whether you need to store a reference to the elements you're adding to the page. If you need to store a reference, you will always want to take the first approach – placing the selected elements relative to another element – as it returns the element(s) you're placing. In this case, .insertAfter()
, .insertBefore()
, .appendTo()
, and .prependTo()
should be the tools of choice.
1
2
3
4
5
6
7
8
9
10
|
|
Cloning Elements
Methods such as .appendTo()
move the element, but sometimes a copy of the element is needed instead. In this case, use .clone()
first:
1
2
3
4
|
|
If you need to copy related data and events, be sure to pass true
as an argument to .clone()
.
Removing Elements
There are two ways to remove elements from the page: .remove()
and .detach()
. Use .remove()
when you want to permanently remove the selection from the page. While .remove()
does return the removed element(s), those elements will not have their associated data and events attached to them if you return them to the page.
Use .detach()
if you need the data and events to persist. Like .remove()
, it returns the selection, but it also maintains the data and events associated with the selection, so you can restore the selection to the page at a later time.
The .detach()
method is extremely valuable if you are doing heavy manipulation on an element. In that case, it's beneficial to .detach()
the element from the page, work on it in your code, then restore it to the page when you're done. This limits expensive "DOM touches" while maintaining the element's data and events.
If you want to leave the element on the page but remove its contents, you can use .empty()
to dispose of the element's inner HTML.
Creating New Elements
jQuery offers a trivial and elegant way to create new elements using the same $()
method used to make selections:
1
2
3
|
|
1
2
3
4
5
6
|
|
Note that the attributes object in the second argument above, the property name class is quoted, although the property names html
and href
are not. Property names generally do not need to be quoted unless they are
reserved words (as class
is in this case).
When you create a new element, it is not immediately added to the page. There are several ways to add an element to the page once it's been created.
1
2
3
4
5
6
7
8
9
|
|
The created element doesn't need to be stored in a variable – you can call the method to add the element to the page directly after the $()
. However, most of the time you'll want a reference to the element you added so you won't have to select it later.
You can also create an element as you're adding it to the page, but note that in this case you don't get a reference to the newly created element:
1
2
|
|
The syntax for adding new elements to the page is easy, so it's tempting to forget that there's a huge performance cost for adding to the DOM repeatedly. If you're adding many elements to the same container, you'll want to concatenate all the HTML into a single string, and then append that string to the container instead of appending the elements one at a time. Use an array to gather all the pieces together, then join them into a single string for appending:
1
2
3
4
5
6
7
8
|
|
Manipulating Attributes
jQuery's attribute manipulation capabilities are extensive. Basic changes are simple, but the .attr()
method also allows for more complex manipulations. It can either set an explicit value, or set a value using the return value of a function. When the function syntax is used, the function receives two arguments: the zero-based index of the element whose attribute is being changed, and the current value of the attribute being changed.
1
2
|
|
1
2
3
4
5
|
|
1
2
3
4
5
6
7
8
9
10
11
|
|
source: http://learn.jquery.com/using-jquery-core/manipulating-elements/