BASE Element | base Object
| |
Specifies an explicit URL used to resolve links and references to external sources such as images and style sheets.
Members Table
The following table lists the members exposed by the
base
object. Click a tab on the left to choose the type of member you want to view.
Attributes/Properties
| Attribute | Property | Description |
|---|
| canHaveHTML |
Sets or retrieves the value indicating whether the object can contain rich HTML markup. |
| firstChild |
Retrieves a reference to the first child in the childNodes collection of the object. |
| HREF | href |
Sets or retrieves the baseline URL on which relative links will be based. |
| ID | id |
Retrieves the string identifying the object. |
| isContentEditable |
Retrieves the value indicating whether the user can edit the contents of the object. |
| isDisabled |
Retrieves the value indicating whether the user can interact with the object. |
| isMultiLine |
Retrieves the value indicating whether the content of the object contains one or more lines. |
| isTextEdit |
Retrieves whether a TextRange object can be created using the object. |
| lastChild |
Retrieves a reference to the last child in the childNodes collection of an object. |
| nextSibling |
Retrieves a reference to the next child of the parent for the object. |
| nodeName |
Retrieves the name of a particular type of node. |
| nodeType |
Retrieves the type of the requested node. |
| nodeValue |
Sets or retrieves the value of a node. |
| ownerDocument |
Sets or retrieves the document object associated with the node. |
| parentElement |
Retrieves the parent object in the object hierarchy. |
| parentNode |
Retrieves the parent object in the document hierarchy. |
| parentTextEdit |
Retrieves the container object in the document hierarchy that can be used to create a TextRange containing the original object. |
| previousSibling |
Retrieves a reference to the previous child of the parent for the object. |
| readyState |
Retrieves the current state of the object. |
| scopeName |
Retrieves the namespace defined for the element. |
| sourceIndex |
Retrieves the ordinal position of the object, in source order, as the object appears in the document's all collection. |
| tagName |
Retrieves the tag name of the object. |
| tagUrn |
Sets or retrieves the Uniform Resource Name (URN) specified in the namespace declaration. |
| TARGET | target |
Sets or retrieves the window or frame at which to target content. |
| uniqueID |
Retrieves an autogenerated, unique identifier for the object. |
Behaviors
| Behavior | Description |
|---|
| clientCaps |
Provides information about features supported by Internet Explorer, as well as a way for installing browser components on demand. |
| download |
Downloads a file and notifies a specified callback function when the download is complete. |
| homePage |
Contains information about a user's homepage. |
Collections
| Collection | Description |
|---|
| all |
Returns a reference to the collection of elements contained by the object. |
| attributes |
Retrieves a collection of attributes of the object. |
| behaviorUrns |
Returns a collection of Uniform Resource Name (URN) strings identifying the behaviors attached to the element. |
| childNodes |
Retrieves a collection of HTML Elements and TextNode objects that are direct descendants of the specified object. |
| children |
Retrieves a collection of DHTML Objects that are direct descendants of the object. |
Events
| Event | Description |
|---|
| onlayoutcomplete |
Fires when the print or print preview layout process finishes filling the current LayoutRect object with content from the source document. |
| onmouseenter |
Fires when the user moves the mouse pointer into the object. |
| onmouseleave |
Fires when the user moves the mouse pointer outside the boundaries of the object. |
| onreadystatechange |
Fires when the state of the object has changed. |
Methods
| Method | Description |
|---|
| addBehavior |
Attaches a behavior to the element. |
| applyElement |
Makes the element either a child or parent of another element. |
| attachEvent |
Binds the specified function to an event, so that the function gets called whenever the event fires on the object. |
| clearAttributes |
Removes all attributes and values from the object. |
| cloneNode |
Copies a reference to the object from the document hierarchy. |
| componentFromPoint |
Returns the component located at the specified coordinates via certain events. |
| contains |
Checks whether the given element is contained within the object. |
| detachEvent |
Unbinds the specified function from the event, so that the function stops receiving notifications when the event fires. |
| fireEvent |
Fires a specified event on the object. |
| getAdjacentText |
Returns the adjacent text string. |
| getAttribute |
Retrieves the value of the specified attribute. |
getAttributeNode |
Retrieves an attribute object referenced by the attribute.name property. |
| getBoundingClientRect |
Retrieves an object that specifies the bounds of a collection of TextRectangle objects. |
| getClientRects |
Retrieves a collection of rectangles that describes the layout of the contents of an object or range within the client. Each rectangle describes a single line. |
| getElementsByTagName |
Retrieves a collection of objects based on the specified element name. |
| hasChildNodes |
Returns a value that indicates whether the object has children. |
| insertAdjacentElement |
Inserts an element at the specified location. |
| mergeAttributes |
Copies all read/write attributes to the specified element. |
normalize |
Merges adjacent TextNode objects to produce a normalized document object model. |
| removeAttribute |
Removes the given attribute from the object. |
removeAttributeNode |
Removes an attribute object from the object. |
| removeBehavior |
Detaches a behavior from the element. |
| replaceAdjacentText |
Replaces the text adjacent to the element. |
| setAttribute |
Sets the value of the specified attribute. |
setAttributeNode |
Sets an attribute object node as part of the object. |
| swapNode |
Exchanges the location of two objects in the document hierarchy. |
Styles
Remarks
When used, the base element must appear within the head of the document, before any elements that refer to an external source.
This element is available in HTML as of Internet Explorer 3.0, and in script as of Internet Explorer 4.0.
This element is not rendered.
This element does not require a closing tag.
Examples
This example sets the base URL of the document to a reference folder. Internet Explorer uses the base element to resolve the link to ../../../../../workshop/author/dhtml/reference/properties/href_2.asp.
<HTML>
<HEAD>
<BASE HREF="../../../../../workshop/author/dhtml/reference/"/>
</HEAD>
<BODY>
k &l>here</A> to learn about the
href property.
</BODY>
</HTML>
This example retrieves the base URL from the document if a valid base element is specified in the document. Otherwise, the function returns
null.
<SCRIPT>
function GetBase()
{
var oBaseColl = document.all.tags('BASE');
return ( (oBaseColl && oBaseColl.length) ? oBaseColl[0].href :
null );
}
</SCRIPT>
Standards Information
object is defined in
HTML 3.2
.