DOMAssistantContent Module

The DOMAssistantContent module offers various methods for adding and removing content and elements to the page.

create(name, attr, append, content)

Creates an element, and optionally sets attributes on it, appends it to the current element and adds content to it.

Parameters

name
Tag name for the new element. Required.
attr
An object containing attributes and their values. Optional.
append
Boolean if the new element should be appended right away. Optional.
content
A string or HTML object that will become the content of the newly created element. Optional.

Return value

Element created by the method.

Example calls

$("container").create("div");

$("container").create("div", {
id : "my-div",
className : "my-class"
});

$("container").create("div", null, false, "Hello!");

$("container").create("div", {
id : "my-div",
className : "my-class"
}, true, "Hi there!");

setAttributes(attr)

Sets attributes on the current element.

Parameters

attr
An object containing attributes and their values. Required.

Return value

Element which called the method.

Example calls

$("container").setAttributes({
id : "my-div",
className : "my-class"
});

addContent(content)

Adds content to the current element.

Parameters

content
Can either be a string, a number, or an HTML object.

Return value

Element which called the method.

Example calls

$("container").addContent("<p>A new paragraph</p>");

$("container").addContent(document.createElement("p"));

replaceContent(newContent)

Replaces the content of the current element with new content.

Parameters

newContent
Can either be a string, a number, or a HTML object.

Return value

Element which called the method.

Example calls

$("container").replaceContent("<p>A new paragraph</p>");

$("container").replaceContent(document.createElement("p"));

replace(content, returnNew)

Replaces the current element with a new one.

Parameters

content
New content that can be specified either through an element, string or number reference.
returnNew
If set to true, the new element is returned; otherwise the replaced element is returned. Optional.

Return value

Either the replaced element or the new element.

Example calls

$("container").replace("<div><em>Way</em> cooler content!</div>");

var newElem = $$("placeholder").replace(elementRef, true);

remove()

Removes the current element.

Parameters

None.

Return value

Null.

Example calls

$("container").remove();

Get your copy