Childnodes 1

Index

A - B - C - D - E - F - G - H - I - J - K - L - M - N - O - P - Q - R - S - T - U - V - W - X - Y - Z Index

Symbols

_content 1

addEventListener 1

alert() 1

align 1

alinkColor 1

anchors 1

appCodeName 1

appendChild 1

applets 1

appName 1

appVersion 1

attributes 1, 2

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (1 de 20) [09/06/2003 9:55:09] Index

availLeft 1

availTop 1

availWidth 1

back() 1

bgColor 1

blur 1

blur() 1

body 1

captureEvents() 1

characterSet 1

childNodes 1

clear 1

clearInterval() 1

clearTimeout() 1

click 1

cloneContents 1

cloneNode 1

cloneRange 1

close 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (2 de 20) [09/06/2003 9:55:09] Index close() 1

closed 1

collapse 1

collapsed 1

colorDepth 1

commonAncestorContainer 1

compareBoundaryPoints 1

Components 1

confirm() 1

contentDocument 1, 2

contentWindow 1, 2

controllers 1

cookie 1

cookieEnabled 1

createAttribute 1

createDocumentFragment 1

createElement 1

createRange 1

createTextNode 1

crypto 1

cssRule 1

cssRule Object 1 http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (3 de 20) [09/06/2003 9:55:09] Index

cssRules 1

cssText 1

defaultStatus 1

deleteContents 1

deleteRule 1

detach 1

directories 1

disabled 1

dispatchEvent 1

doctype 1

document 1

documentElement 1

DOM 1, 2

DOM 2 Range Interface 1

DOM window Interface 1

domain 1

dump() 1

Elements Interface 1

embeds 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (4 de 20) [09/06/2003 9:55:09] Index

endContainer 1

endOffset 1

escape() 1

extractContents 1

fgColor 1

firstChild 1, 2

focus 1

focus() 1

forms 1

forward() 1

FRAME 1

frameBorder 1

FRAMESET 1

GetAttention() 1

getAttribute 1

getAttributeNode 1, 2

getElementById 1

getElementsByName 1

getElementsByTagName 1, 2, 3, 4, 5, 6

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (5 de 20) [09/06/2003 9:55:09] Index getSelection() 1

hasChildNodes 1, 2, 3, 4

height 1, 2

history 1

home() 1

href 1

id 1

IFRAME 1

images 1

innerHeight 1

innerHTML 1

innerWidth 1

insertBefore 1

insertNode 1

insertRule 1

item 1

javaEnabled() 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (6 de 20) [09/06/2003 9:55:09] Index lang 1

language 1

lastChild 1

lastModified 1

left 1

length 1, 2

linkColor 1

links 1

localName 1

location 1, 2

locationbar 1

longDesc 1, 2

marginHeight 1, 2

marginWidth 1, 2

media 1, 2

menubar 1

mimeTypes 1

moveBy() 1

moveTo() 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (7 de 20) [09/06/2003 9:55:09] Index name 1, 2, 3

namespaceURI 1, 2

navigator 1

navigator.appCodeName 1

navigator.appName 1

navigator.appVersion 1

navigator.cookieEnabled 1

navigator.javaEnabled() 1

navigator.language 1

navigator.mimeTypes 1

navigator.oscpu 1

navigator.platform 1

navigator.plugins 1

navigator.product 1

navigator.productSub 1

navigator.userAgent 1

navigator.vendor 1

navigator.vendorSub 1

nextSibling 1, 2, 3

nodeName 1, 2

nodeType 1, 2

nodeValue 1 http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (8 de 20) [09/06/2003 9:55:09] Index

normalize 1

offsetHeight 1

offsetLeft 1

offsetParent 1

offsetTop 1

offsetWidth 1

onabort 1

onBlur 1, 2

onblur 1

onchange 1

onClick 1, 2

onclick 1

onclose 1

onDblClick 1, 2

onFocus 1, 2

onKeyDown 1, 2

onKeyPress 1, 2

onKeyUp 1, 2

onkeyup 1

onMouseDown 1, 2

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (9 de 20) [09/06/2003 9:55:09] Index onMouseMove 1, 2

onmousemove 1

onMouseOut 1, 2

onmouseout 1

onMouseOver 1, 2

onmouseover 1

onMouseUp 1, 2

onmouseup 1

onResize 1, 2

onscroll 1

onselect 1

onsubmit 1

open 1

opener 1

oscpu 1

outerHeight 1

ownerDocument 1, 2

ownerNode 1

ownerRule 1

pageXOffset 1

pageYOffset 1 http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (10 de 20) [09/06/2003 9:55:09] Index

parentNode 1, 2

parentStyleSheet 1, 2

personalbar 1

pixelDepth 1

pkcs11 1

platform 1

plugins 1, 2

prefix 1

previousSibling 1, 2

product 1

productSub 1

prompter 1

referrer 1

releaseEvents() 1

removeAttribute 1

removeAttributeNode 1

removeChild 1

removeEventListener 1

replaceChild 1

resizeBy() 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (11 de 20) [09/06/2003 9:55:09] Index

resizeTo() 1

rows 1

screen 1

screen.availHeight 1

screen.availLeft 1

screen.availTop 1

screen.availWidth 1

screen.colorDepth 1

screen.height 1

screen.left 1

screen.pixelDepth 1

screen.top 1

screen.width 1

screenX 1

screenY 1

scroll() 1

scrollbars 1

scrollBy() 1

scrollByLines() 1

scrollByPages() 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (12 de 20) [09/06/2003 9:55:09] Index scrolling 1, 2

scrollTo() 1

scrollX 1

scrollY 1

selectNode 1

selectNodeContents 1

selectorText 1

self 1

setAttribute 1, 2

setAttributeNode 1, 2

setCursor() 1

setEndAfter 1

setEndBefore 1

setInterval() 1

setStart 1

setStartAfter 1

setTimeout() 1

sidebar 1

sizeToContent() 1

src 1, 2

startContainer 1

startOffset 1 http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (13 de 20) [09/06/2003 9:55:09] Index

status 1

statusbar 1

stop() 1

STYLE 1

style 1, 2

styleSheet 1

styleSheet Object 1

styleSheets 1

supports 1

surroundContents 1

tabIndex 1

tagName 1

title 1, 2, 3

toolbar 1

top 1, 2

toString 1

type 1, 2

unescape() 1

updateCommands() 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (14 de 20) [09/06/2003 9:55:09] Index

URL 1

userAgent 1

vendor 1

vendorSub 1

vlinkColor 1

width 1, 2

window 1

window.alert() 1

window.clearInterval() 1

window.clearTimeout() 1

window.close() 1

window.closed 1

window.Components 1

window.confirm() 1

window.controllers 1

window.crypto 1

window.defaultStatus 1

window.directories 1

window.document 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (15 de 20) [09/06/2003 9:55:09] Index window.dump() 1

window.escape() 1

window.focus() 1

window.forward() 1

window.GetAttention() 1

window.getSelection() 1

window.history 1

window.home() 1

window.innerHeight 1

window.innerWidth 1

window.length 1

window.location 1

window.locationbar 1

window.menubar 1

window.moveBy() 1

window.moveTo() 1

window.name 1

window.navigator 1

window.navigator.appCodeName 1

window.navigator.appName 1

window.navigator.appVersion 1

window.navigator.cookieEnabled 1 http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (16 de 20) [09/06/2003 9:55:09] Index

window.navigator.javaEnabled() 1

window.navigator.language 1

window.navigator.mimeTypes 1

window.navigator.oscpu 1

window.navigator.platform 1

window.navigator.plugins 1

window.navigator.product 1

window.navigator.productSub 1

window.navigator.userAgent 1

window.navigator.vendor 1

window.navigator.vendorSub 1

window.onabort 1

window.onblur 1

window.onchange 1

window.onclick 1

window.onclose 1

window.ondragdrop 1

window.onerror 1

window.onfocus 1

window.onkeydown 1

window.onkeypress 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (17 de 20) [09/06/2003 9:55:09] Index window.onkeyup 1

window.onload 1

window.onmousedown 1

window.onmousemove 1

window.onmouseover 1

window.onmouseup 1

window.onpaint 1

window.onreset 1

window.onresize 1

window.onscroll 1

window.onselect 1

window.onsubmit 1

window.onunload 1

window.open() 1

window.opener 1

window.outerHeight 1

window.outerWidth 1

window.pageXOffset 1

window.pageYOffset 1

window.parent 1

window.personalbar 1

window.pkcs11 1 http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (18 de 20) [09/06/2003 9:55:09] Index

window.prompt() 1

window.prompter 1

window.releaseEvents() 1

window.resizeBy() 1

window.resizeTo() 1

window.screen 1

window.screen.availHeight 1

window.screen.availLeft 1

window.screen.availTop 1

window.screen.width 1

window.screenX 1

window.screenY 1

window.scroll() 1

window.scrollbars 1

window.scrollBy() 1

window.scrollByLines() 1

window.scrollByPages() 1

window.scrollTo() 1

window.scrollX 1

window.scrollY 1

window.self 1

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (19 de 20) [09/06/2003 9:55:09] Index window.setCursor() 1

window.setInterval() 1

window.setTimeout() 1

window.sidebar 1

window.sizeToContent() 1

window.status 1

window.statusbar 1

window.stop() 1

window.toolbar 1

window.top 1

window.unescape() 1

window.updateCommands() 1

window.window 1

write 1

writeln 1

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_shortIX.html (20 de 20) [09/06/2003 9:55:09] window._content

window._content

Returns a reference to the content element in the current window.

Syntax

cHolder = window._content

Parameters

cHolder is an object reference.

Example

// for HTML

// type="content-primary"

// src="blur.html" />

function cont() {

loc = window._content.location.href;

alert(loc);

}

Notes

If there is no particular element or subframe given as the content element, this method returns a reference to the window itself. Also note that this does not give you a very good way to refer to a number of different content elements. In this case, you may want to use the getElementById method to get references to the subframes you want.

http://www.mozilla.org/docs/dom/domref/dom_window_ref3.html (1 de 2) [09/06/2003 9:55:34] window._content This property is effectively the same as window.content. It's generally used to get the content from a browser window.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref3.html (2 de 2) [09/06/2003 9:55:34] addEventListener

addEventListener

addEventListener allows the registration of event listeners on the event target.

Syntax

element.addEventListener( type, listener, useCapture )

Parameters

The addEventListener() method takes the following parameters:

type A string representing the event type being registered.

The listener parameter takes an interface implemented by the user which listener contains the methods to be called when the event occurs.

If true, useCapture indicates that the user wishes to initiate capture. After initiating capture, all events of the specified type will be dispatched to the registered EventListener before being dispatched to any EventTargets useCapture beneath them in the tree. Events which are bubbling upward through the tree will not trigger an EventListener designated to use capture.

Example

http://www.mozilla.org/docs/dom/domref/dom_el_ref31.html (1 de 3) [09/06/2003 9:56:47] addEventListener

DOM Event Examples

one

two

Notes

If an EventListener is added to an EventTarget while it is processing an event, it will not be triggered by the current actions but may be triggered during a later stage of event flow, such as the bubbling phase.

If multiple identical EventListeners are registered on the same EventTarget with the same parameters the duplicate instances are discarded. They do not cause the

http://www.mozilla.org/docs/dom/domref/dom_el_ref31.html (2 de 3) [09/06/2003 9:56:47] addEventListener EventListener to be called twice and since they are discarded they do not need to be removed with the removeEventListener method.

Specification

addEventListener

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_el_ref31.html (3 de 3) [09/06/2003 9:56:47] window.alert()

window.alert()

Display an alert dialog with the specified text.

Syntax

window.alert(text)

Parameters

text is a string of the text you want displayed in the alert dialog.

Example

window.alert("I'm a Scorpio!");

Notes

The alert dialog should be used for messages which do not require any response of the part of the user. See also window.confirm(), window.prompt().

Specification

http://www.mozilla.org/docs/dom/domref/dom_window_ref2.html (1 de 2) [09/06/2003 9:56:55] window.alert()

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref2.html (2 de 2) [09/06/2003 9:56:55] align

align

Specifies how the IFRAME is to be aligned in the containing element.

Syntax

sAlign = iFrameElement.align

iFrameElement.align = sAlign

Parameters

sAlign is a string with one of the values given in the Notes section below.

Example

i = document.getElementById("first-frame");

i.align = "top";

Notes

Possible values for align are "top", "middle", "bottom", "left" and "right." The latter two cause the IFRAME to float to the current right or left margin. The default value for align is bottom. The align attribute is deprecated in HTML 4.0

Specification

DOM Level 2 -- HTMLIFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref14.html (1 de 2) [09/06/2003 9:57:08] align

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref14.html (2 de 2) [09/06/2003 9:57:08] alinkColor

alinkColor

Returns or sets the color of active links in the document body.

Syntax

color = HTMLBodyElement.aLinkColor

HTMLBodyElement.aLinkColor = color

Parameters

color is a string containing the name of the color (e.g., "blue", "darkblue", etc., or the octal value of the color (e.g., FFFFF)

Example

example here

Notes

extra information

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_doc_ref3.html (1 de 2) [09/06/2003 9:57:15] alinkColor

http://www.mozilla.org/docs/dom/domref/dom_doc_ref3.html (2 de 2) [09/06/2003 9:57:15] anchors

anchors

anchors returns a list of all of the anchors in the document.

Syntax

a_list = document.anchors

Parameters

a_list is a nodeList of all of the anchor elements within the document

Example

if ( document.anchors.length >= 5 ) {

dump("dump found too many anchors");

window.location = "http://www.getoutahere.com";

}

Notes

For reasons of backwards compatibility, the returned set of anchors only contains those anchors created with the name attribute, not those created with the id attribute.

Specification

anchor

http://www.mozilla.org/docs/dom/domref/dom_doc_ref4.html (1 de 2) [09/06/2003 9:57:20] anchors

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_doc_ref4.html (2 de 2) [09/06/2003 9:57:20] window.navigator.appCodeName

window.navigator.appCodeName

Returns the internal "code" name of the current browser.

Syntax

codeName = window.navigator.appCodeName

Parameters

codeName is the internal name of the browser as a string.

Example

dump(window.navigator.appCodeName);

Notes

Mozilla, Netscape 6, and IE5 all use the internal name "Mozilla."

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref37.html (1 de 2) [09/06/2003 9:57:30] window.navigator.appCodeName

http://www.mozilla.org/docs/dom/domref/dom_window_ref37.html (2 de 2) [09/06/2003 9:57:30] mozilla.org

mozilla.org Mozilla News 04 June 2003 Status Update 6 June 2003 At A Glance Why Use Mozilla New Book - This status update contains news on Creating XPCOM Mozilla Thunderbird, the removal of License Terms Components the MNG/JNG image decoder, Get Involved Creating XPCOM secure mail server authentication Newsgroups Components, a book and more. more... Feedback about Gecko and about creating Development XPCOM Download Mozilla Roadmap components for Gecko-based Projects applications, is now Mozilla is an open-source web Module Owners available online. browser and toolkit, designed for Hacking Hardcopies will be standards compliance, performance and portability. Mozilla.org provides Get the Source available in August. binaries for testing and feedback. Build It Mozilla 1.4 Release For more about mozilla.org, read Testing Candidate 1 Mozilla at a Glance. Releases Mozilla 1.4 RC 1 is out. We've added Mozilla 1.3.1 Nightly Builds lots of features and This is our latest stable release. New Report A Bug fixed lots of bugs to Mozilla? Get this. Tools since Mozilla 1.3. Help us shake it ● Download Bugzilla down in preparation ❍ Win (11 MB) Tinderbox for Mozilla 1.4 final. ❍ MacOS X (15 MB)

Bonsai More information is ❍ Linux (14 MB) available in the LXR ● Release Notes release notes. FAQ Mozilla 1.4 Release Candidate 1 Search Mozilla Firebird 0.6 This is our first 1.4 release Mozilla Firebird 0.6 candidate. Get it and let us know if (formerly Phoenix) is you find problems. If the idea of available for filing a bug report doesn't appeal to download. This you, then you'll probably be happier release features a with 1.3.1. fresh new look, a redesigned ● Download preferences window, ❍ Win (13 MB) preliminary support for Mac OS X and ❍ MacOS X (14.9 MB) much more. ❍ Linux (14 MB) ● Release Notes Mozilla 1.3.1 Available Nightly Builds

http://www.mozilla.org/ (1 de 4) [09/06/2003 9:58:06] mozilla.org Mozilla 1.3.1 is Created most weekdays from the available for previous day's work, these will download. This probably work, but may not. Use follow-up to Mozilla them to verify that a bug you're 1.3 restores tracking has been fixed. MacOS X, XPInstall i386 Linux, Windows, Linux PPC, functionality for Mac Solaris (2.7/SPARC, 2.6/SPARC, OS X users. 2.6/x86), FreeBSD, Irix, BeOS, HPUX, OS/2, etc. Using Breakpoints in Venkman more... Netscape Devedge has just published a second Venkman article, all about breakpoints. In other Venkman news, as of 0.9.63, views can now be stacked in a tab container to save space. Check out the screenshots.

Mozilla Branding Strategy mozilla.org's Mozilla Branding Strategy document explains our long term product naming strategy.

New Mozilla Roadmap mozilla.org has published a new development roadmap, detailing the plans for the future development of the Mozilla codebase.

Camino 0.7 Released Camino™ (formerly http://www.mozilla.org/ (2 de 4) [09/06/2003 9:58:06] mozilla.org Chimera) 0.7 is available for download. Along with the new name, Camino has a new history sidebar, a new download manager and a new text encoding menu. To learn more about what's new in Camino 0.7, check out the release notes.

Browser Innovation Article Mitchell Baker has written an article about browser innovation and why open, standards- compliant, cross- platform technologies like Gecko matter for the future of the World Wide Web.

Gecko Embedding Guides Check out the newest documentation for Gecko, Mozilla's layout engine. Gecko Embedding Basics offers a high level description of how to embed Gecko in your application. Gecko Embedding API Reference is a first cut at documenting Gecko's frozen interfaces.

more... http://www.mozilla.org/ (3 de 4) [09/06/2003 9:58:06] mozilla.org

http://www.mozilla.org/ (4 de 4) [09/06/2003 9:58:06] the mozilla.org projects list

mozilla.org projects At A Glance Why Use Mozilla The primary mission of mozilla.org is to coordinate and integrate the work of License Terms others. Here are all of the ongoing projects. If you have a new project you'd like us Get Involved to host on our CVS server, consult the guidelines on hacking mozilla for info on obtaining a CVS account and interacting with our tree. Newsgroups Feedback Browser Components Development SeaMonkey Roadmap SeaMonkey is the codename for the current Mozilla browser. It includes the NGLayout/Gecko layout engine, is built atop the Projects XPCOM component architecture and generally follows the plan Module Owners described in the roadmap. Hacking User Interface Get the Source The user interface for Mozilla has a new look and feel. Check out Build It the list of available UI specifications for details. Editor Testing The editor project is focused on developing an HTML 4.0 compliant Releases WYSIWYG editor. Composer is designed to be easy to use, fast and Nightly Builds reliable; facilitating web page authors to make quick edits to their web pages. Composer is also the underlying editor within Report A Bug Mail/News. Tools Instant Messaging & Chat Bugzilla Our goal is to make it possible for Mozilla to support Instant Messaging and Chat with a variety of different protocols. As a proof Tinderbox of concept, Rob Ginda has written an IRC client he calls ChatZilla. Bonsai Help Viewer LXR The help viewer is a separate browser window in which user FAQ documentation (and other types of documentation?) can be navigated. The help viewer includes an index, an RDF-based table Search of contents, HTML content, a skinnable chrome, and context- sensitive loading. Java Integration Open JVM Integration The Open JVM Integration (OJI) project is extending the plug-in architecture to allow Java virtual machines to be plugged into Mozilla-based browser releases. Blackwood The goal of the Blackwood project is to provide a set of facilities to better integrate the Java platform with Mozilla. These include a bridge to XPCOM, a Java DOM API, the Open JVM Integration (OJI) facility, a Java WebClient API, and Plug-ins implemented in Java, called 'Pluglets'. JavaScript JavaScript is a Netscape-originated programming language designed http://www.mozilla.org/projects/ (1 de 7) [09/06/2003 9:58:09] the mozilla.org projects list for scripting object systems (HTML, Java, CORBA, your own) and embedding in a wide range of applications. It is the basis of the ECMA-262/ECMAScript specification (and subsequent ISO-16262 standard), and is the most widely-used client-side programming language on the Web by a large margin. Both C and Java implementations are available. Mail/News The Mail/News project is focused on developing a new application based on new mozilla technologies such as XPFE, XPCOM and RDF. We're bringing over most of our features for POP, SMTP, IMAP, NNTP, as well as making some key improvements. MathML An implementation of the W3C's Mathematical Markup Language. Netscape Portable Runtime (NSPR) NSPR provides platform independence for non-GUI operating system facilities, including threads, thread synchronization, normal file and network I/O, interval timing and calendar time, basic memory management (malloc and free) and shared library linking. Platform for Privacy Preferences (P3P) An implementation of the W3C P3P specification. Plug-ins The implementation of Netscape's Plug-in Application Programming Interface (API) within Mozilla. Embedding The Embedding project is focused on allowing easy reuse of the Mozilla browser components and providing an SDK for an embeddable browser and HTML editor. Scalable Vector Graphics (SVG) An implementation of the W3C's Scalable Vector Graphics Language. Web Services Simple Object Access Protocol (SOAP) and Web Services Description Language (WSDL) support in Mozilla. XML Extras In XML Extras module we have implemented XML functionality that is not part of the mainline XML infrastructure, like the XMLHttpRequest object copied from Microsoft. XML-RPC XML-RPC module implements the XML-RPC specification as a JavaScript component. Xprint Very advanced print module for Unix/Linux which supports automatic printer and printer feature lookup, TrueType font support, support for international printing (including languages and scripts like Arabic, Chinese, Cyrillic, Greek, Hebrew, Indic (Devanagari, Tamil, etc.), Japanese, Korean, Polish, etc.) and MathML. XSL Transformations (XSLT) http://www.mozilla.org/projects/ (2 de 7) [09/06/2003 9:58:09] the mozilla.org projects list The TransforMiiX module implements both a XSLT component for Mozilla, and a standalone commandline tool. Search The internet search component provides support for aggregating search results (via RDF) from one or multiple search engines and is used by the sidebar's "Search" panel. SQL Integration: Native Database Support The Native Database Support project allows Mozilla to directly connect to and query SQL servers. Browser Infrastructure Netlib (Necko) The main function of the netlib kernel (AKA Necko) is to act as an efficient data pipe between multiple physical transports (ie. file system, network, etc.) and a standardized stream abstraction which protocol handlers consume. The three main design goals in the netlib kernel architecture are footprint, maintainability and performance. New Layout (Gecko) The goal of the New Layout project is to create a fast, small, standards-based layout engine designed for performance and portability. RDF RDF, or Resource Description Framework, is a W3C standard for representing meta-information. In Mozilla, we're using this to aggregate and display information about all kinds of Internet resources, including email, UseNet news, site maps, bookmarks, and browser history. XPCOM Our Cross-Platform scheme for turning objects into discrete components. XPConnect XPConnect is the binding between XPCOM and JavaScript. PyXPCOM Python Cross-Platform COM (PyXPCOM) is ActiveState's bindings between Python and XPCOM. XPToolkit The XPToolkit design documents live here. This cross-platform UI abstraction provides web browsing and scripting UI and application logic for the New Layout engine. XPInstall XPInstall is a technology for doing cross-platform installations, packaging, and software updates. XPNet XPNet is a cross-platform, lightweight download library used by the native installers. It has support for HTTP/1.1, FTP, pause/resume/cancel and HTTP proxies. Footprint http://www.mozilla.org/projects/ (3 de 7) [09/06/2003 9:58:09] the mozilla.org projects list

Information on work that's underway to reduce Mozilla's runtime footprint, both as a full-fledged browser suite and as an embeddable layout engine. Internationalization And Localization Internationalization (I18N) The Internationalization group is responsible for making it possible for Mozilla to deal with various writing systems. This page describes the current activities in this area. Localization (L10N) Many different people and groups are planning to localize the Mozilla user interface into their own languages. This page describes how to localize Mozilla Browser and Mail/News client. BiDi A project to enable bi-directional text. This feature will enable Mozilla to render Arabic, Persian and Hebrew. Security Projects Mozilla includes several security-related projects: Open Source PKI Projects Thanks to relaxed US export regulations, mozilla.org can now host security and cryptographic code. Open source PKI projects include: Network Security Services (NSS) NSS supports cross-platform development of security- enabled server applications. Applications built with NSS can support PKCS #5, PKCS #7, PKCS #11, PKCS #12, S/MIME, TLS, SSL v2 and v3, X.509 v3 certificates, and other security standards. Network Security Services for Java (JSS) A Java interface to NSS that supports most of the security standards and encryption technologies supported by NSS. JSS also provides a pure Java interface for ASN.1 types and BER/DER encoding. Personal Security Manager (PSM) PSM supports cross-platform development of security- enabled client applications. PSM includes libraries (built on top of NSS) and a daemon that performs cryptographic operations on behalf of a client application--operations such as setting up an SSL connection, object signing and signature verification, certificate management, and other common PKI functions. PKCS #11 Conformance Testing Test suites designed to test PKCS #11 implementations. Component Security Component security supports the addition of Java and JavaScript security to Mozilla components, mainly in terms of mobile code and the browser interfaces available to programs from those languages. For cryptographic security projects, see Open Source PKI Projects.

http://www.mozilla.org/projects/ (4 de 7) [09/06/2003 9:58:09] the mozilla.org projects list Other Browser Projects Main Accessibility Page This is the official accessibility page. We talk about our work to support screen readers and other 3rd party accessibility software. This is also where Mozilla's keyboard FAQ and list of planned keystrokes lives. Access-Mozilla Integration Project The goal of Access-Mozilla is to provide built-in accessibility solutions (text-to-speech, magnification, high/low contrast themes, speech-input, braille display support), rather than require users with special needs to buy and learn 3rd party accessibility software. This would create the first truly seamless accessibility solution for the internet. Current accessible internet solutions require expert knowledge of both the application and the 3rd party accessibility tool. This makes the learning curve difficult for new users. It's also expensive, and a bit awkward for future internet appliances built from Mozilla technology. ColorSync The ColorSync project, sponsored by Apple Computer, attempts to manage color displayed from source html to destination browsers, compensating for various viewing conditions. It allows for pages to viewed as intended with the correct colors. Performance The Performance project is an umbrella for many small features and enhancements that are intended to make Mozilla the fastest browser around. Unix Unix Front End. GTK 1.1, Linux/glibc2 is the reference developer platform. Support for other OS's and toolkits also exists. Ports Many different groups are planning ports of Mozilla to new platforms and toolkits. The Ports page list all of the known, active porting projects. SilentDownload SilentDownload is a background transfer method that allows files to be downloaded to the users machine without interfering with their network performance. SilentDownload does this by only downloading while the network library is not busy. In this way, users can "silently download" large files over a period of time and be notified when the file transfer is complete. Non-Browser Projects Calendar The Calendar project is a standards-based calendar client effort. CCK Client Customization Kit provides tools that simplify customization and distribution of the client. Directory (LDAP)

http://www.mozilla.org/projects/ (5 de 7) [09/06/2003 9:58:09] the mozilla.org projects list The Directory pages include Java class library source, C SDK library source, and PerLDAP source. Each of these libraries provides access to Directory Services via LDAP (Lightweight Directory Access Protocol). This project covers only the LDAP library, and not LDAP access from the mailnews project. Mozilla Documentation Project The Mozilla Documentation Project is the central clearinghouse for documentation-related issues at Mozilla.org. Mstone The mstone test suite allows performance testing of many of the internet protocols used by Mozilla. This allows servers (and the services built on them) to be performance tested under a high load simulation before being publicly deployed. The current protocols tests are: SMTP, POP, IMAP, HTTP, and WMAP (Netscape Messenger Express). Rhino Rhino is the Java implementation of JavaScript that conforms to the ECMA standard and is written entirely in Java. Technology Evangelism Mozilla Technology Evangelism actively promotes Mozilla as the premier Internet client technology in the world. It accomplishes its mission through working within the mozilla.org community to develop working examples, author documentation, perform general education, and educate Web site authors through one-on-one contacts. JavaScript Debugging The JavaScript Debugging project includes a cross platform debugging support module for the Netscape JavaScript engine, a Java-based GUI debugger for JavaScript, a JavaScript logging tool, and a console debugger. Work is beginning on a new debugger, written in JavaScript, for the XPFE/NGLayout Mozilla. DOM Inspector DOM Inspector is a tool that allows you to debug, and edit HTML, XML, and XUL documents. ElectricalFire ElectricalFire is a Java Virtual Machine that uses JIT (Just In Time) compilation techniques to accelerate Java code execution. ElectricalFire was designed from the start to generate high- performance machine code and to be portable to many different processor architectures. Grendel In 1997, Netscape embarked on a project to rewrite Navigator/Communicator in Java. This project was cancelled before completion, but the mail/news component of it was nearly finished. Grendel is that mail/news client. Recently, work has been restarted on Grendel. Tools

http://www.mozilla.org/projects/ (6 de 7) [09/06/2003 9:58:09] the mozilla.org projects list Besides the browser, we've also released our home-grown development tools. Bonsai is for keeping track of the CVS repository, letting you view checkins, log messages and diffs. Tinderbox monitors the progress of our automated continuous-build machines, letting engineers know when a checkin breaks the build. Bugzilla is our online bug database. Its web interface allows entry of bugs, queries, reports and dependency graphs. Mozbot In addition to our web-based development tools, we have also developed mozbot, a modular IRC bot.

Browser Distributions Browsers based on the Gecko layout engine. Other This page lists links to other Mozilla-related projects of which we are aware, but which are not currently a part of Mozilla itself.

http://www.mozilla.org/projects/ (7 de 7) [09/06/2003 9:58:09] Mozilla Documentation

Introductory Material End User

FAQs, Videos... Customizing, Release Notes...

Core Architecture Core Modules & Libraries

NSPR, XPCOM, XUL... Mail/News, Editor, Image Library...

Development Events

Compiling, Guides, mozilla.org Website... CodeStock '99, Open Source Convention 2001...

Other Projects Web Development

Bonsai, Bugzilla, Tinderbox... Evangelism, HTML, Sidebar Tabs...

Old Documentation Layout

http://www.mozilla.org/catalog/ [09/06/2003 9:58:10] Mozilla Jargon File (Glossary)

mozilla.org Mozilla Jargon File At A Glance Why Use Mozilla Here is a list of some of the jargon used by mozilla hackers: License Terms Get Involved ASN.1 Abstract Syntax Notation One. A formal Newsgroups language for describing messages to be Feedback exchanged between distributed computer systems. Along with an encoding like Development BER/DER, ASN.1 can be used to generate Roadmap and process complex data structures in a Projects standardized and OS-independent manner. For an overview, see A Layman's Guide to a Module Owners Subset of ASN.1, BER, and DER. Hacking Get the Source BAM The Netscape internal code-name for our code modularization effort. It stands for Build It "Born Again Modularization." It hinges Testing upon XPCOM. Releases bidi Bi-di is short for bi-directional, which Nightly Builds means a combination of left-to-right (LTR) Report A Bug and right-to-left (RTL) writing in the same document. LTR writing systems include Tools Latin, Russian, and Greek alphabets, and Bugzilla Hindu/Arabic numerals. RTL includes Arabic and Hebrew alphabets in texts Tinderbox without Hindu/Arabic numerals. The Bonsai Unicode standard includes an algorithm for LXR bidi rendering, which is required for Unicode conformance. In informal use FAQ among habitual LTR users, the term bidi Search includes unmixed, unidirectional RTL writing. branch This is a branch off the trunk. It is a development area for big or customized changes so the trunk does not break. carpool Checking in code with the tree closed to make sure that major widespread changes compile cleanly. Checking into a closed tree ensures others don't check in changes that conflict with yours. Normally this isn't a problem but problems arise sometimes when checking in a large number of files. Schedule carpools with the build team.

http://www.mozilla.org/docs/jargon.html (1 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

CCP Cut, Copy and Paste (clipboard operations) certificate Digital data, formatted according to the X.509 standard, that specifies the name of an individual, company, or other entity (the subject name of the certificate) and certifies that a public key, which is also included in the certificate, belongs to that entity. A certificate is issued and digitally signed by a certificate authority (CA). A certificate's validity can be verified by checking the CA's digital signature using the techniques of public-key cryptography. To be trusted within a public-key infrastructure (PKI), a certificate must be issued and signed by a CA that is trusted by other entities enrolled in the PKI. Also called digital ID, digital passport, public-key certificate X.509 certificate, and security certificate. CA Certificate authority. A service that issues a certificate after verifying the identity of the person or entity the certificate is intended to identify. A CA also renews and revokes certificates and generates CRLs. The entity named in the issuer field of a certificate is always a CA. Certificate authorities can be independent third parties or a person or organization using certificate-issuing server software. ClassObject Same object as factory. component An implementation of a set of interfaces identified by a CLSID ComponentManager Central Object of XPCOM that provides API for object creation and management. content node A content node is a baseclass for all nodes in the document tree. For HTML pages this means that each content node represents a HTML tag in the HTML document. Content nodes can be manipulated by the DOM.

http://www.mozilla.org/docs/jargon.html (2 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

content sink The terms "sink" and "source" are commonly used to describe the flow of data. A data source, such as a netlib stream, provides data to a listener, whereas a datasink (such as an observer) is an object that absorbs data provided (often by a source). In Mozilla, the content sink is an interface that sits between the parsing engine and the code that actually builds the content model. It is useful to keep these systems separate so that they can vary independently, while the interface they use to communicate remains (fairly) constant. CMMF Certificate Management Message Formats. A PKIX format used to convey certificate requests and revocation requests from end entities to certificate authorities and to send a variety of information from certificate authorities to end entities. CMMF is subsumed by another proposed standard, Certificate Management Messages over CMS (CMC). For information about CMC and related standards, see the PKIX Charter. CRMF Certificate Request Message Format. A PKIX format used for messages related to life-cycle management of X.509 certificates. This format is a subset of CMMF. For details, see CMMF. CSS Cascading Style Sheets: A W3C standard for defining presentation in Web documents. NGLayout supports CSS1 and most of CSS2. CVS CVS is the version control system we use. Use CVS to keep your development tree in sync with the latest changes. D11N Documentation. DND Drag and Drop

http://www.mozilla.org/docs/jargon.html (3 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

dogfood Interim software used internally for testing. To eat one's own dogfood means to use the software one is developing, as part of one's everyday development environment. The idea is that developers who are using their own software will quickly learn what's missing or broken. Dogfood is typically not even of beta quality. (From Eric Raymond's Jargon File 4.1.4, June 1999) DOM The Document Object Model. A W3C standard for accessing and modifying the content tree. DTD Document Type Definition - specifies a set of elements, their relationships and the tag set to mark the document. A good introduction to SGML concepts can be found at pineapplesoft.com. In mozilla, DTD is also a class used by the parser inheriting from nsIDTD. encumbered code Code that cannot be released as open source for legal reasons. For example, patented encryption code licensed from RSA Security by Netscape cannot be released as part of the NSS project on Mozilla. ender A code name for Mozilla's editor module. factory An object whose sole purpose is creation of objects of a particular component. There exists only one factory for every Component (CLSID). The IID and definition has been carefully choosen so as to be binary compatible with COM. nsIFactory frame The lowest level object in the layout model. Each content node maps to one or more frames during reflow. The frame handles the rendering of the content. A frame is pretty closely tied to the box concept in CSS2. frame hierarchy The hierarchy of frames that represents a laid-out document. gfx The lowest cross platform layer for drawing. Contains support for fonts, colors, images and drawing graphical primitives. Implemented once for each platform and used by the rest of Mozilla.

http://www.mozilla.org/docs/jargon.html (4 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

horked Broken. He checked in without testing on the Mac and now the tree is horked. HTML Hypertext Markup Language - NGLayout implements HTML 4.0 IDL Interface Description Language. A language- independent way to describe a module interface. IDL is compiled by an IDL compiler to generate C++ header files which describe XPCOM interfaces. Mozilla uses both DOM IDL (compiled by idlc), for DOM and parts of layout, and XPIDL (compiled by xpidl), for everything else. In the future, DOM IDL will be replaced by XPIDL. IID Interface ID {xxxxx-xxx-xxx-xxxxxx}. A unique number that identifies a given interface. imglib Image library Interface Contract betwen the implementation and usage. A pure virtual abstract base class with no data members. eg. nsIZipReaderInterface internationalization Designing and developing a software product to function in multiple locales. This process involves identifying the locales that must be supported, designing features which support those locales, and writing code that functions equally well in any of the supported locales. i18n Acronym for "internationalization" ("i" + 18 letters + "n"; lower case i is used to distinguish it from the numeral 1 (one)). js JavaScript libfont Font library libpr0n Synonym for imglib

http://www.mozilla.org/docs/jargon.html (5 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

localization Modifying or adapting a software product to fit the requirements of a particular locale. This process includes (but may not be limited to) translating the user interface, documentation and packaging, changing dialog box geometries, customizing features (if necessary), and testing the translated product to ensure that it still works (at least as well as the original). localizability The degree to which a software product can be localized. Localizable products separate data from code, correctly display the target language and function properly after being localized. L10n Acronym for "localization" ("L" + 10 letters + "n"; upper case L is used to distinguish it from the numeral 1 (one)). L12y Acronym for "localizability" ("L" + 12 letters + "y"; upper case L is used to distinguish it from the numeral 1 (one)). Locale A set of conventions affected or determined by human language and customs, as defined within a particular geo-political region. These conventions include (but are not necessarily limited to) the written language, formats for dates, numbers and currency, sorting orders, etc. module A packaging of a set of Components (ie) a DLL. necko Mozilla's networking library. Responsible for parsing urls, handling connections to webservers, handling transfer protocols and delivering a data stream to the parser. netlib Networking Library. The current networking library is called necko. nglayout Next Generation Layout Engine.

http://www.mozilla.org/docs/jargon.html (6 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

nsCOMPtr nsCOMPtr is a `smart-pointer'. It is a template class that acts, syntactically, just like an ordinary pointer in C or C++, i.e., you can apply * or -> to it to `get to' what it points at. nsCOMPtr is smart in that, unlike a raw COM interface pointer, nsCOMPtr manages AddRef, Release, and QueryInterface for you. nsISupports The mother of all interfaces. All interfaces ultimately inherit from this. Provides refcounting. The IID and definition has been carefully choosen so as to be binary compatible with COM. object An instance of a Component OCSP Online Certificate Status Protocol. A PKIX protocol used for determining the current status of a digital certificate. For details, see OCSP. PDT The Product Delivery Team keeps track of bugs that most affect the usability of the browser. The idea is that after the PDT bugs are fixed, mozilla will have reached dogfood. That is, it will be usable enough for developers and testers to use every day as their main browser and mail client even if it isn't perfect yet. Bugs are marked [Dogfood] when someone believes that the bug keeps mozilla from being usable as dogfood. The PDT team marks the bug [PDT+] if they agree and [PDT-] if not. PKIX Public-Key Infrastructure (X.509). A working group of the Internet Engineering Task Force (IETF) that is developing Internet standards needed to support a PKI based on X.509 certificates. For more information, see PKIX Charter. PKCS #5 Public-Key Cryptography Standard #5. The standard developed by RSA Laboratories that governs password-based cryptography, for example to encrypt private keys for storage. For details published by RSA, see PKCS #5.

http://www.mozilla.org/docs/jargon.html (7 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

PKCS #7 Public-Key Cryptography Standard #7. The standard developed by RSA Laboratories that governs the application of cryptography to data, for example digital signatures. For details published by RSA, see PKCS #7. PKCS #11 Public-Key Cryptography Standard #11. The standard developed by RSA Laboratories that governs communication with cryptographic tokens (such as smart cards). For details published by RSA, see PKCS #11. PKCS #12 Public-Key Cryptography Standard #12. The PKCS standard developed by RSA Laboratories that governs the format used to store or transport private keys, certificates, and other secret material. For details published by RSA, see PKCS #12. porkjockey The porkjockeys are a group of people taking time to fix major architectural issues that are the source of bugs and usability problems throughout the codebase. The name was coined at an architecture meeting one dark day, when someone asked when the beta would ship. The answer? When pigs fly. Thus began a hopefully-not-quixotic quest to launch pork. presentation context An object that provide a context for a presentation shell. It is a means for the presentation shell to get at external settings and data. presentation shell Presentation shells are the controlling object during the presentation of a document. It owns the document, the frame hierarchy, stylesheets and the presentation context. It also controls and initiates the reflow of the document. private key One of a pair of keys used in public-key cryptography. The private key is kept secret and is used to decrypt data encrypted with the corresponding public key. ProgID A String name for a Component.

http://www.mozilla.org/docs/jargon.html (8 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

public key One of a pair of keys used in public-key cryptography. The public key is distributed freely and published as part of a certificate. It is typically used to encrypt data sent to the public key's owner, who then decrypts the data with the corresponding private key. public-key cryptography A set of well-established techniques and standards that allow an entity to verify its identity electronically or to sign and encrypt electronic data. Two keys are involved: a public key and a private key. A public key is published as part of a certificate, which associates that key with a particular identity. The corresponding private key is kept secret. Data encrypted with the public key can be decrypted only with the private key. public-key infrastructure (PKI) The standards and services that facilitate the use of public-key cryptography and X.509 v3 certificates in a networked environment. raptor Former code-name for NGLayout. We were asked to stop using it in public due to trademark problems. RDF Resource Description Framework reflow The act of laying out the content tree and creating/updating the corresponding frame hierarchy is called reflowing. reflow mapped Reflowing content that already has a frame. reflow unmapped Reflowing content that doesn't yet have a frame. registry A hierarchical attribute-value pair storage. RFE This was a keyword used to mark a bug as a "request for enhancement." It has been replaced with the "enhancement" severity setting in Bugzilla. service A component that is used as a singleton. That means there exist only one instantiation of the component, and all request for it returns the same object.

http://www.mozilla.org/docs/jargon.html (9 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

ServiceManager A singleton manager. Holds and manages singleton references to objects for application. Going to be merged with the ComponentManager. S/MIME Secure/Multipurpose Internet Mail Extensions. A message specification (based on the popular Internet MIME standard) that provides a consistent way to send and receive signed and encrypted MIME data. For complete specifications, see S/MIME version 2 and S/MIME version 3. SSL Secure Sockets Layer. A protocol that allows mutual authentication between a client and server and the establishment of an authenticated and encrypted connection. SSL runs above TCP/IP and below HTTP, LDAP, IMAP, NNTP, and other high-level network protocols. For complete SSL specifications, see SSL v3 and SSL v2. subject name A distinguished name (DN) that uniquely describes the subject of a certificate. talkback This is a crash data capturing program that Mozilla uses so that crashes can more efficiently be fixed. TLS Transport Layer Security. A protocol from the IETF based on SSL. It will eventually supersede SSL while remaining backward- compatible with SSL implementations. For more information, see The TLS Protocol. tracking A tracking bug many related bugs to be monitored from a single bug. They should have the meta keyword and/or be placed in the Tracking component. triage This term is derived from how doctors triage patients into different priorities. Mozilla applies it to the bug quality assurance process. QA volunteers triage bugs into appropriate priorities and severities. trunk This is where the primary Mozilla development occurs.

http://www.mozilla.org/docs/jargon.html (10 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

typelib Storage for type information about interfaces. Interfaces expressed in IDL have their type information maintained in Typelib automatically. UI User Interface Venkman Javascript Debugger webshell A container that knows how to load and render web pages. Frameset pages has a root webshell and one webshell per frame. widget Primitive user interface part (button, menu, radiobutton, etc). There are two kinds of widgets: Native and gfx. Native widgets are implemented differently for each platform, but gfx widgets are implemented using gfx and is thus the same for all platforms. X.509 A standard defined by the International Telecommunication Union (ITU) that governs the format of certificates used for authentication in public-key cryptography. XIF XML Interchange Format - used internally by NGLayout for all I/O to clipboard, etc. XML Extensible Markup Language - see the W3C's XML site for more info XP Cross-Platform XPCOM Cross Platform Component Object Model XPConnect Ability to call C++ implementations of interfaces expressed in IDL from javascript and vice versa. XPFE The cross-platform front end. The part of Mozilla that implements the user interface of mozilla. Everything that makes a browser a browser except the rendering of pages is considered xpfe (bookmarks, toolbars, menus etc). XPIDL Cross Platform Interface Definition Language. A language for expressing interfaces.

http://www.mozilla.org/docs/jargon.html (11 de 12) [09/06/2003 9:58:12] Mozilla Jargon File (Glossary)

xpidl A compiler for XPIDL. xpidl generates C++ interfaces, .xpt files describing interfaces at runtime for XPConnect, and Java interface files. XUL XML-based User Interface Language. XUL (pronounced "zuul") is the user interface description language used for creating user interfaces with Mozilla's Cross Platform Front End.

Feel free to add new items to this file and make corrections. If you don't have access to the tree, send your suggestions to [email protected]. For the canonical list of hacker slang, see Eric Raymond's Jargon File. Copyright © 1998-2003 The Mozilla Organization Last modified April 18, 2003 Document History Edit this Page (or via CVS)

http://www.mozilla.org/docs/jargon.html (12 de 12) [09/06/2003 9:58:12] mozilla.org Bugzilla -- the Mozilla bug database

Bugzilla Version 2.17.1 Bugzilla What's all this, then?

This is mozilla.org's bug-tracking system, Report A Bug - Use the Bugzilla Helper. our database for recording bugs in Mozilla View Bugs Already Reported Today and other mozilla.org projects. For more information about Bugzilla, see our bug Enter a bug # or some search terms: page. [Help] This is not the place to report bugs about commercial Netscape products. For that, try Netscape's own bug reporting ● Query Page (Search existing bug reports) form instead. Netscape bugs reported here ● Summary reports and charts will be ignored. (Netscape browsers ● Enter a new bug report (Advanced) usually have a blue and black `N' logo in the top right of the window.) ● Log in to an existing account ● Open a new Bugzilla account When reporting a ● Add to Sidebar (Requires Mozilla or Netscape 6/7) bug

● Read the Bugzilla fact sheet so you know what you're doing. ● Open a Bugzilla account if you don't have one already. ● Make sure you can reproduce the bug, and explain to others how to reproduce it as well. If engineers can't reproduce your bug, they won't be able to fix it. ● Read the bug reporting guidelines to learn how to write bug reports that get bugs fixed. ● Make sure your bug hasn't already been reported. Consult the lists of most frequently reported bugs, most recently duplicated bugs, and search for bugs matching the one you've found. ● Use the Bugzilla Helper to report bugs. This form helps you write

http://bugzilla.mozilla.org/ (1 de 2) [09/06/2003 9:58:18] mozilla.org Bugzilla -- the Mozilla bug database well written bug reports.

http://bugzilla.mozilla.org/ (2 de 2) [09/06/2003 9:58:18] Mozilla Cross-Reference

Mozilla Cross-Reference

This is a cross referenced display of the Mozilla source code. The sources displayed are those that are currently checked in to the mainline of the Starting Points: mozilla.org CVS server; these pages are updated many times a day, so they should be pretty close SeaMonkey to the latest-and-greatest. This module is SeaMonkeyAll, the trunk of the Mozilla browser project. (updated hourly) It's possible to search through the entire Mozilla source text; or to search for files whose name Mozilla 1.0 matches a pattern; or to search for the definitions This is the Mozilla 1.0 branch. (updated every of particular functions, variables, etc. 6 hours) The individual files of the source code are NSPR formatted on the fly and presented with clickable This module is NSPR, a cross platform library identifiers. An identifier is a macro, typedef, for operating system facilities including struct, enum, union, function, function prototype threads, I/O, timing and memory management. or variable. Clicking on them shows you a (updated nightly) summary of how and where they are used.

Security The free-text search command is implemented This module contains code related to Open using Glimpse, so all the capabilities of Glimpse Source PKI including NSS. (updated three are available. Regular expression searches are times per day) especially useful.

Electrical Fire (Don't use use a web-crawler to try and This is /mozilla/ef, a multi-platform Just-In- download all of these pages; the CGIs will feed Time Java compiler. (updated nightly) you several gigabytes worth of generated HTML!) Mozilla This contains the entre current CVS repository. The pages here are generated by the LXR tool, (updated nightly) which was originally written to display the source code of the Linux kernel (LXR stands for Classic ``Linux Cross Reference.'') Check out the main This is Mozilla Classic. Its a snapshot of the LXR site for more information. MozillaSource module from Oct 26, 1998 just before the change was made to xpfe. This is Thanks to Arne Georg Gleditsch and Per here for reference. No work is done on this Kristian Gjermshus, the authors of the LXR tool, branch. for writing it and making it available to the

http://lxr.mozilla.org/ (1 de 2) [09/06/2003 9:58:20] Mozilla Cross-Reference world.

http://lxr.mozilla.org/ (2 de 2) [09/06/2003 9:58:20] tinderbox: SeaMonkey

tinderbox tree: SeaMonkey (01:02 PDT)

Checkin requirements Help

● DO NOT CHECK IN ON RED. ● Tips on working with Mozilla ● Please run the pre-checkin tests, and if you have time the smoketests. ● See Bonsai for checkin details ● Do not checkin until you have appropriate reviews, super-reviews, and approvals. ● mailto:hook, mailto:sheriffs ● Your checkin comment should include the reviewer, the super-reviewer, the approver, ● sheriff schedule a clear explanation of the fix, and the bug number. Reviewers and approvers are ● smoketest blockers considered to be 'on the hook'! ● Performance Regression Policy ● Add new files to Mac/Win/Unix packages! ● Txul/Ts/Tp perf, Lk/Bl Docs ● Please be mindful of the other tinderboxes: Testerbox, Ports, MozillaTest, Phoenix, Camino ● 1.0 Branch tinderbox ● 1.4 Branch tinderbox ● Netscape employees: In addition to these rules, you must watch the Commercial Tinderbox. ● Add this tinderbox to your sidebar ● Upcoming landings

● Smoketesting Schedule

● Install tbox status icon

● Roadmap

Sheriff for Thursday 6/5 is #mozilla Build Engineer for Friday 6/6 is leaf - AIM: leafn

We are branched for Mozilla 1.4 (Tinderbox here) and the tree is open for Mozilla 1.5a development. Trunk checkins require the normal r= and sr=. Branch checkins require approval from [email protected].

The tree is open Build Guilty Time MacOSX MacOSX Click Linux brad Clbr Linux btek Linux comet WINNT 5.0 WINNT 5.0 Click time to Linux luna Dep Darwin 6.3 Darwin 6.6 name to (info) Dep Dep beast Dep creature Clbr see changes silverstone Clbr monkey Dep see what since then they did 06/09 00:47 L/ L/ 00:37 L/ L L/ 00:23 L/ L/ Z:19.01MB 00:16 mZ:12.23MB L 00:13 Tp:1097ms Tp:623ms 00:09 L Txul:904ms Txul:505ms L Z:20.00MB Ts:3439ms L/ C 06/08 23:48 L C Ts:6069ms Z:14.44MB Lk:244B mZ:12.87MB mZ:8.139MB 23:36 Txul:459ms Bl:14.2MB L Txul:313ms 23:31 Ts:1437ms L Ts:1547ms Lk:297KB Tp:1020ms 23:22 MH:7.72MB L Z:19.01MB Z:20.00MB mZ:12.23MB L 23:15 A:246K Z:21.07MB mZ:12.87MB Tp:1096ms Tp:634ms 23:04 Txul:461ms Txul:900ms Txul:505ms L 06/08 22:50 Warn:44684 Ts:1440ms Ts:3436ms Ts:6088ms Z:14.44MB mZ:8.139MB 22:48 L L C Txul:312ms 22:39 Tp:1023ms Z:20.00MB L C Ts:1500ms 22:36 mZ:12.87MB Z:19.01MB

http://tinderbox.mozilla.org/showbuilds.cgi?tree=SeaMonkey (1 de 3) [09/06/2003 9:58:32] tinderbox: SeaMonkey

22:31 Txul:461ms mZ:12.23MB L L C Ts:1438ms Tp:1095ms Tp:559ms Tp:624ms 22:23 L C L Txul:897ms Txul:542ms Txul:504ms 22:05 Z:14.44MB Lk:244B Ts:3433ms Ts:3688ms Ts:6074ms 06/08 21:55 mZ:8.139MB Bl:14.1MB L L C Txul:313ms 21:45 Lk:299KB Tp:1020ms Z:20.00MB L Ts:1156ms 21:42 MH:7.72MB mZ:12.87MB Z:19.01MB 21:34 A:248K Txul:457ms mZ:12.23MB Ts:1438ms 21:20 scott Z:21.07MB Tp:1093ms L Tp:628ms 21:07 Txul:897ms L Warn:44681 L Txul:505ms Ts:3430ms Z:14.44MB 06/08 20:55 Z:20.00MB Ts:6054ms mZ:8.139MB 20:54 mZ:12.87MB L Txul:458ms Txul:313ms 20:46 Tp:1024ms Ts:1125ms Ts:1436ms L 20:45 Z:19.01MB L 20:39 L mZ:12.23MB Z:20.00MB Lk:244B Tp:1094ms L 20:38 mZ:12.87MB Bl:14.1MB Txul:901ms Txul:457ms Tp:634ms Ts:3435ms L L 20:03 Lk:299KB Txul:507ms Ts:1439ms Z:14.44MB MH:7.73MB L Tp:564ms Ts:6015ms 06/08 19:56 A:248K Tp:1024ms L Txul:542ms mZ:8.139MB 19:53 Z:21.07MB Z:20.00MB Ts:3719ms Txul:328ms Ts:860ms 19:49 mZ:12.87MB L Warn:44675 Z:19.01MB L/ C 19:44 Txul:463ms L Ts:1441ms mZ:12.23MB 19:22 Tp:1025ms Tp:1098ms L 19:10 Txul:897ms Tp:630ms L 19:07 L Ts:3429ms Txul:502ms Z:14.44MB mZ:8.139MB 06/08 18:57 Z:20.00MB Ts:6113ms 18:52 mZ:12.87MB Txul:328ms Ts:797ms 18:49 Txul:463ms L Ts:1437ms 18:45 L L Lk:244B Tp:1021ms 18:38 Z:19.01MB Bl:14.1MB L mZ:12.23MB Lk:299KB L 18:24 Z:20.00MB Tp:1099ms L MH:7.72MB Z:14.44MB mZ:12.87MB Txul:897ms Tp:642ms A:248K mZ:8.139MB Txul:458ms Ts:3433ms Txul:503ms 06/08 17:57 Z:21.07MB L Txul:328ms Ts:1435ms Ts:6086ms Tp:553ms Ts:1516ms L 17:53 Warn:44682 Txul:542ms Tp:1017ms L 17:47 Ts:3679ms Z:20.00MB 17:45 mZ:12.87MB L L 17:36 Txul:465ms Z:19.01MB Z:14.44MB 17:31 Ts:1436ms mZ:12.23MB mZ:8.139MB L 17:20 Tp:1097ms Txul:313ms L Txul:899ms Tp:634ms Ts:906ms 17:01 L Tp:1020ms Ts:3430ms Txul:503ms 06/08 16:52 Z:20.00MB Ts:6034ms L mZ:12.87MB 16:50 Z:14.44MB Txul:455ms 16:40 mZ:8.139MB Ts:1439ms 16:34 L Txul:312ms L- L L Z:19.01MB Ts:1703ms 16:16 Tp:1020ms Warn:44676 Z:20.00MB mZ:12.23MB L 16:07 mZ:12.87MB Tp:1095ms Tp:629ms Txul:459ms Txul:896ms L C Txul:506ms L 06/08 15:48 Ts:1440ms Ts:3431ms Tp:555ms Ts:6102ms Z:14.44MB Txul:541ms mZ:8.139MB

http://tinderbox.mozilla.org/showbuilds.cgi?tree=SeaMonkey (2 de 3) [09/06/2003 9:58:32] tinderbox: SeaMonkey

15:46 L Ts:3722ms Txul:313ms Tp:1026ms Ts:1422ms 15:43 L Z:20.00MB 15:37 mZ:12.87MB L 15:27 Txul:458ms Z:19.01MB L 15:19 mZ:12.23MB Tp:630ms L C Ts:1438ms Tp:1099ms Txul:501ms 15:05 Lk:244B Txul:898ms Ts:6072ms 06/08 14:54 Bl:14.1MB L Ts:3436ms 14:45 Lk:299KB L Z:14.44MB mZ:8.139MB 14:41 MH:7.73MB Tp:1024ms L A:278K Z:20.00MB Txul:328ms 14:32 Z:21.07MB mZ:12.87MB Ts:1235ms 14:31 Zdiff:-311 Txul:462ms L C L C (+794/- Ts:1437ms Z:19.01MB 14:28 1105) Zdiff:-347 Tp:628ms L! C Txul:504ms 14:20 (+726/- Warn:44675 1073) Ts:5997ms L C mZ:12.23MB 06/08 13:47 L C Z:14.44MB Z:20.00MB mZdiff:- Zdiff:-85 347 (+726/- 13:46 mZ:12.87MB (+433/- 1073) L Txul:457ms 518) Tp:1099ms Tp:555ms 13:45 Ts:1439ms mZ:8.139MB L L Txul:900ms Txul:542ms mZdiff:-85 Tp:275ms Lk:244B L C Ts:3433ms Ts:3711ms (+433/- Ts:1591ms 13:41 Bl:14.2MB Tp:1019ms L C 518) Lk:297KB Z:20.00MB Txul:313ms L C MH:7.72MB Zdiff:-208 L C Ts:797ms 13:35 Z:19.01MB A:247K (+816/- Tp:627ms 1024) Zdiff:+14 Z:21.07MB Txul:506ms mZ:12.87MB (+14/+0) 13:26 brendan Zdiff:+8 mZ:12.23MB Ts:6089ms L C (+8/+0) mZdiff:- 208 (+816/-mZdiff:+14 Z:14.44MB 13:13 sspitzer Warn:44680 1024) (+14/+0) mZ:8.139MB L C Txul:456ms Tp:1095ms Txul:313ms Tp:1019ms Ts:1439ms Txul:897ms Ts:1360ms 13:08 Ts:3434ms Show previous 12 hours Show previous 24 hours

Administrate Tinderbox Trees

http://tinderbox.mozilla.org/showbuilds.cgi?tree=SeaMonkey (3 de 3) [09/06/2003 9:58:32] mozilla.org Feedback

mozilla.org Feedback At A Glance Why Use Mozilla Listen, kid, we're all in it together! License Terms -- Harry Tuttle in Brazil. Get Involved Mozilla is an open-source web browser, designed for standards compliance, Newsgroups performance and portability. This site is here for mozilla developers and testers. If Feedback it's not helping you, let us know how it can! Development Roadmap Projects This is not a help site for Netscape Navigator. For help with Netscape Module Owners products, visit their help site or post a question to to one of their Hacking newsgroups. Use the Netscape bug reporting form to report bugs with Get the Source products that use Netscape's blue N logo. Build It The Open Directory Project is also not connected with mozilla.org Testing (although they do display an affection for everyone's favorite green lizard). Releases Nightly Builds Report A Bug For most suggestions about our site, or future directions of the project, or whatever, use one of the public mozilla.org mailing lists or newsgroups. We all Tools read those lists, and we strongly recommend that you post your suggestions there. Bugzilla Tinderbox If you have a suggestion about some feature you'd like to see added to the client, Bonsai post to the appropriate newsgroup or to the wishlist group. LXR To report bugs with binaries downloaded from ftp.mozilla.org, use our bug FAQ reporting page. Search Notify [email protected] of technical problems with the web site itself.

To suggest something to the mozilla.org staff privately about the content of the site or the way we do things, use the address [email protected]. Note that messages sent to that address will reach those of us who coordinate mozilla.org, but it will not reach the developers who are actually writing code so don't submit feature requests to this list. Use the wishlist. Likewise, we can't help you with Netscape Communicator questions.

http://www.mozilla.org/feedback.html [09/06/2003 9:58:33] mozilla.org FAQs

mozilla.org mozilla.org FAQs (frequently At A Glance Why Use Mozilla asked questions) License Terms Get Involved Here are pointers to a few FAQs relevant to what we're up to here at mozilla.org. Newsgroups Mozilla 1.0 FAQ Feedback Development FAQ about Mozilla 1.0; good all-round coverage of important questions. Roadmap Unofficial Mozilla and Netscape 6 FAQ (Newzilla) Projects A little bit outdated, but most of its information is still relevant (also in Module Owners Japanese). Hacking Mozilla FAQ Get the Source Build It Pat Gunn has put together this FAQ of introductory materials, common build problems, etc. Testing Mozilla Build FAQ Releases Nightly Builds Answers specific questions concerning the Mozilla build proecess. Report A Bug Debugging Mozilla on Windows FAQ Tools Tips on debugging Mozilla. See also the Linux debugging FAQ. Bugzilla Gecko Embedding FAQ Tinderbox Bonsai Answers to commonly questions about embedding Gecko, Mozilla's layout LXR engine. NGLayout/Gecko FAQ FAQ Search Answers to questions about Mozilla's layout engine. Netscape Public License FAQ

Answers to questions about the Netscape Public License, the license under which the Mozilla source code is shipped. Mozilla Relicensing FAQ

Information on relicensing the Mozilla source code, specifically on compatiblity issues with GNU General Public License (GPL). Code Review FAQ

Answers about mozilla.org's code review process. Sheriff FAQ

http://www.mozilla.org/faq.html (1 de 2) [09/06/2003 9:58:34] mozilla.org FAQs Information on sheriffs, people who watch over the tree. Mozilla Web Author FAQ

Mozilla FAQ for Web designers Wishlist FAQ

A list of commonly requested features from our wishlist newsgroup.

The following is a list of public documents pertaining to Netscape's announcement to release the Communicator source code and the creation of mozilla.org.

Free Navigator FAQ

Answers to general questions regarding Netscape's January 22, 1998 announcement that Netscape Communicator and Navigator are now free, as well as very general Q&A about the plans to release source code. Open Source FAQ

Answers to some specific questions from the developer community regarding Netscape's plan to release source code for its next major release of Netscape Communicator and Navigator. See also Netscape's own FAQ. The mozilla.org Press Release

Netscape's announcement of the creation of mozilla.org.

Can't find the information you are looking for? Try our documntation catalog or the search page

http://www.mozilla.org/faq.html (2 de 2) [09/06/2003 9:58:34] search mozilla.org

Search mozilla.org with Google mozilla.org At A Glance Why Use Mozilla License Terms Can't find the information you want? Try our search tips page. Get Involved Newsgroups Feedback Development Roadmap Projects Module Owners Hacking Get the Source Build It Testing Releases Nightly Builds Report A Bug Tools Bugzilla Tinderbox Bonsai LXR FAQ Search

http://mozilla.org/search.html [09/06/2003 9:58:35] Gecko DOM Reference

Gecko DOM Reference

Preface

About This Reference

Who Should Read This Guide

What is Gecko?

API Syntax

Using the Examples

Introduction to the DOM

What is the DOM?

DOM vs. JavaScript

How Do I Access the DOM?

Important Data Types

DOM Interfaces

Testing the DOM API

DOM Element Reference

DOM Elements Interface

http://www.mozilla.org/docs/dom/domref/dom_shortTOC.html (1 de 3) [09/06/2003 9:58:37] Gecko DOM Reference Properties

Methods

Event Handlers

DOM window Reference

DOM window Interface

DOM Document Reference

The document Interface

Properties

Methods

Event Handlers

DOM Event Reference

DOM Event Interface

Properties

Methods

DOM Event Handler List

DOM Style Reference

DOM Style Object

DOM styleSheet Object

DOM cssRule Object

DOM CSS Properties List

DOM HTML Elements Reference

http://www.mozilla.org/docs/dom/domref/dom_shortTOC.html (2 de 3) [09/06/2003 9:58:37] Gecko DOM Reference DOM Range Reference

DOM 2 Range Interface

Properties

Creation Methods

Editing Methods

Other Methods

Gecko Range Interface Extensions

Methods

DOM Examples

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_shortTOC.html (3 de 3) [09/06/2003 9:58:37] window.navigator

window.navigator

Returns a reference to the navigator object.

Syntax

nav = window.navigator

Parameters

nav is a navigator object reference.

Example

nav = window.navigator;

if ( nav.language != en ) {

res = window.confirm(lang_warn);

}

Notes

The navigator object is used to examine the actual browser being used. It includes properties like appName, appCore, plugins (described below) for getting information about the browser itself.

All of the properties and methods available from window.navigator can also be referenced simple with navigator.

Specification

DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref36.html (1 de 2) [09/06/2003 9:58:39] window.navigator

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref36.html (2 de 2) [09/06/2003 9:58:39] window.navigator.appName

window.navigator.appName

Returns the official name of the browser.

Syntax

appName = window.navigator.appName

Parameters

appName is the name of the browser as a string.

Example

dump(window.navigator.appName);

// prints "Navigator" to the console for NS6

Notes

None.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref38.html (1 de 2) [09/06/2003 9:58:40] window.navigator.appName

http://www.mozilla.org/docs/dom/domref/dom_window_ref38.html (2 de 2) [09/06/2003 9:58:40] appendChild

appendChild

The appendChild method inserts the specified node into the list of nodes on the current document.

Syntax

element.appendChild(newChild)

Parameters

newChild is a node.

Example

// puts the new, empty paragraph at the end

// of the document

p = document.createElement("p");

element.appendChild(p);

Notes

appendChild is one of the fundamental methods of web programming using the DOM. The appendChild method inserts a new node into the DOM structure of the HTML document, and is the second part of the one-two, create-and-append process so central to building web pages programmatically. The example above illustrates this basic process.

Specification

appendChild

http://www.mozilla.org/docs/dom/domref/dom_el_ref32.html (1 de 2) [09/06/2003 10:00:17] appendChild

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_el_ref32.html (2 de 2) [09/06/2003 10:00:17] applets

applets

applets returns an ordered list of the applets within a document.

Syntax

app_list = document.applets

Parameters

app_list is a nodeList of the applets within the document.

Example

// ( When you know the second applet is the one

// you want )

my_java_app = document.applets[1];

Notes

None.

Specification

applets

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_doc_ref5.html (1 de 2) [09/06/2003 10:00:32] applets

http://www.mozilla.org/docs/dom/domref/dom_doc_ref5.html (2 de 2) [09/06/2003 10:00:32] window.navigator.appVersion

window.navigator.appVersion

Returns the version of the browser as a string.

Syntax

ver = window.navigator.appVersion

Parameters

ver is the version number of the browser as a string.

Example

if ( navigator.appVersion.charAt(0) == "5" ) {

// browser is putatively a v5 browser

}

Notes

The window.navigator.userAgent property also contains the version number (example: "Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape 6/6.1"), but you should be aware of how easy it is to change the user agent string and "spoof" other browsers, platforms, or user agents, and also how cavalier the browser vendor themselves are with these properties.

The window.navigator.appVersion and window.navigator.userAgent properties are quite often used in "browser sniffing" code: scripts that attempt to find out what kind of browser you are using and adjust pages accordingly.

Specification

http://www.mozilla.org/docs/dom/domref/dom_window_ref39.html (1 de 2) [09/06/2003 10:00:55] window.navigator.appVersion

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref39.html (2 de 2) [09/06/2003 10:00:55] window.navigator.cookieEnabled

window.navigator.cookieEnabled

Returns a boolean value indicating whether cookies are enabled or not.

Syntax

res = window.navigator.cookieEnabled

Parameters

res is a boolean True or False.

Example

if (window.navigator.cookieEnabled) {

// set a cookie

}

Notes

None.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref40.html (1 de 2) [09/06/2003 10:01:07] window.navigator.cookieEnabled

http://www.mozilla.org/docs/dom/domref/dom_window_ref40.html (2 de 2) [09/06/2003 10:01:07] window.navigator.javaEnabled()

window.navigator.javaEnabled()

This method indicates whether the current browser is Java-enabled or not.

Syntax

bool = window.navigator.javaEnabled

Parameters

bool is a boolean value.

Example

if ( window.navigator.javaEnabled() ) {

// browser has java

}

Notes

The return value for this method indicates whether the preference that controls Java is on or off-not whether the browser offers Java support in general.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref41.html (1 de 2) [09/06/2003 10:01:13] window.navigator.javaEnabled()

http://www.mozilla.org/docs/dom/domref/dom_window_ref41.html (2 de 2) [09/06/2003 10:01:13] window.navigator.language

window.navigator.language

Returns a string representing the language version of the browser.

Syntax

lang = window.navigator.language

Parameters

lang is a two character string (e.g., "en" or "ja") representing the language version.

Example

if ( window.navigator.language != "en" ) {

doLangSelect(window.navigator.language);

}

Notes

This property also shows up as part of the window.navigator.userAgent string.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref42.html (1 de 2) [09/06/2003 10:01:18] window.navigator.language

http://www.mozilla.org/docs/dom/domref/dom_window_ref42.html (2 de 2) [09/06/2003 10:01:18] window.navigator.mimeTypes

window.navigator.mimeTypes

Returns a list of the MIME types supported by the browser.

Syntax

syntax code

Parameters

blah is a blah.

Example

// example code here

Notes

Addtional notes.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref43.html (1 de 2) [09/06/2003 10:01:22] window.navigator.mimeTypes

http://www.mozilla.org/docs/dom/domref/dom_window_ref43.html (2 de 2) [09/06/2003 10:01:22] window.navigator.oscpu

window.navigator.oscpu

Returns a string that identifies the current operating system.

Syntax

oscpuInfo = window.navigator.oscpu

Parameters

oscpu is a string that takes the following form.

Example

function osInfo() {

alert(window.navigator.oscpu);

}

// returns: Win98

Notes

None.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref44.html (1 de 2) [09/06/2003 10:01:25] window.navigator.oscpu

http://www.mozilla.org/docs/dom/domref/dom_window_ref44.html (2 de 2) [09/06/2003 10:01:25] window.navigator.platform

window.navigator.platform

Returns a string representing the platform of the browser.

Syntax

plat = window.navigator.platform

Parameters

plat is a string with one of the following values:

Win95 Windows 95

WinNT Windows NT

MacPPC Macintosh PowerPC

SunOS Solaris

....

Example

http://www.mozilla.org/docs/dom/domref/dom_window_ref45.html (1 de 2) [09/06/2003 10:01:27] window.navigator.platform

function osInfo() {

alert(window.navigator.platform);

}

// returns: win32

Notes

None.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref45.html (2 de 2) [09/06/2003 10:01:27] window.navigator.plugins

window.navigator.plugins

Returns an array of the plugins installed in the browser.

Syntax

plugins = window.navigator.plugins

Parameters

plugins is an array of plugin objects.

Example

function pluginInfo() {

alert(window.navigator.plugins.item(0).name);

}

// returns "Shockwave for Director"

Notes

The plugin objecct exposes a small interface for getting information about the various plugins installed in your browser.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref46.html (1 de 2) [09/06/2003 10:01:29] window.navigator.plugins

http://www.mozilla.org/docs/dom/domref/dom_window_ref46.html (2 de 2) [09/06/2003 10:01:29] window.navigator.product

window.navigator.product

This property returns the product name of the current browser.

Syntax

productName = window.navigator.product

Parameters

productName is a string.

Example

// returns "Gecko"

Notes

product is that portion of the full user agent string that comes directly after the platform. In the user agent for Netscape 6.1, for example, the product is "Gecko" and the full agent string is the following:

http://www.mozilla.org/docs/dom/domref/dom_window_ref47.html (1 de 2) [09/06/2003 10:01:32] window.navigator.product

Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref47.html (2 de 2) [09/06/2003 10:01:32] window.navigator.productSub

window.navigator.productSub

productSub returns the build number of the current browser.

Syntax

prodSub = window.navigator.productSub

Parameters

prodSub is a string.

Example

// returns: 20010725

Notes

On IE, this property returns undefined.

http://www.mozilla.org/docs/dom/domref/dom_window_ref48.html (1 de 2) [09/06/2003 10:01:34] window.navigator.productSub Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref48.html (2 de 2) [09/06/2003 10:01:34] window.navigator.userAgent

window.navigator.userAgent

Returns the user agent string for the current browser.

Syntax

uaString = window.navigator.userAgent

Parameters

uaString is a string.

Example

window.navigator.userAgent

// returns Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1

Notes

None.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref49.html (1 de 2) [09/06/2003 10:01:37] window.navigator.userAgent

http://www.mozilla.org/docs/dom/domref/dom_window_ref49.html (2 de 2) [09/06/2003 10:01:37] window.navigator.vendor

window.navigator.vendor

Returns the name of the browser vendor for the current browser.

Syntax

venString = window.navigator.vendor

Parameters

venString is a string.

Example

window.navigator.vendor

// returns "Netscape6"

Notes

vendor is another portion of the userAgent string. The product and the vendor can be different--as when Netscape 6.1 uses the Gecko product to do its rendering.

See also window.navigator.product, window.navigator.userAgent

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref50.html (1 de 2) [09/06/2003 10:01:39] window.navigator.vendor

http://www.mozilla.org/docs/dom/domref/dom_window_ref50.html (2 de 2) [09/06/2003 10:01:39] window.navigator.vendorSub

window.navigator.vendorSub

vendorSub is the substring of the vendor having to do with the vendor version number.

Syntax

venSub = window.navigator.vendorSub

Parameters

venSub is a string.

Example

window.navigator.vendorSub

// returns "6.1" where the vendor part of userAgent is

// Netscape6/6.1

Notes

vendorSub is yet another component of the full user agent string. It refers to the version number that the vendor themselves have given the current browser (as opposed to the version of the product, which may be different). In Netscape 6.1, the productSub is given as "5.0" and the vendorSub is "6.1."

See also window.navigator.productSub, window.navigator.userAgent, window.navigator.vendor

Specification

DOM Level 0. Not part of specification.

http://www.mozilla.org/docs/dom/domref/dom_window_ref51.html (1 de 2) [09/06/2003 10:01:42] window.navigator.vendorSub

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref51.html (2 de 2) [09/06/2003 10:01:42] window.onabort

window.onabort

An event handler for abort events sent to the window.

Syntax

window.onabort = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onabort = resetThatServerThing

Notes

None.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref52.html (1 de 2) [09/06/2003 10:01:44] window.onabort

http://www.mozilla.org/docs/dom/domref/dom_window_ref52.html (2 de 2) [09/06/2003 10:01:44] window.onblur

window.onblur

The onblur property returns the onBlur event handler code, if any, that exists on the window.

Syntax

window.onblur = funcRef

Parameters

funcRef is a reference to the function to be executed.

Example

warnFunc = window.onblur;

Notes

The blur event is raised when a window loses focus.

Specification

Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref53.html [09/06/2003 10:01:47] window.onchange

window.onchange

An event handler for change events sent to the window.

Syntax

window.onchange = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onchange = resetThatServerThing

Notes

None.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref54.html (1 de 2) [09/06/2003 10:01:51] window.onchange

http://www.mozilla.org/docs/dom/domref/dom_window_ref54.html (2 de 2) [09/06/2003 10:01:51] window.onclick

window.onclick

An event handler for click events sent to the window.

Syntax

window.onclick = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onclick = doPopup;

Notes

The click event is raised when the user clicks on the window.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref55.html (1 de 2) [09/06/2003 10:01:53] window.onclick

http://www.mozilla.org/docs/dom/domref/dom_window_ref55.html (2 de 2) [09/06/2003 10:01:53] window.onclose

window.onclose

An event handler for close events sent to the window.

Syntax

window.onclose = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onclose = resetThatServerThing

Notes

None.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref56.html (1 de 2) [09/06/2003 10:01:55] window.onclose

http://www.mozilla.org/docs/dom/domref/dom_window_ref56.html (2 de 2) [09/06/2003 10:01:55] window.ondragdrop

window.ondragdrop

An event handler for drag & drop events sent to the window.

Syntax

window.ondragdrop = funcRef

Parameters

funcRef is a reference to a function.

Example

window.ondragdrop = examineItem;

Notes

None.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref57.html (1 de 2) [09/06/2003 10:01:58] window.ondragdrop

http://www.mozilla.org/docs/dom/domref/dom_window_ref57.html (2 de 2) [09/06/2003 10:01:58] window.onerror

window.onerror

An event handler for error events sent to the window.

Syntax

window.onerror = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onerror = null;

Notes

The error event is raised when an error occurs in the script. The example above prevents error dialogs from displaying-which is the window's normal behavior-by overriding the default event handler for error events that go to the window.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref58.html (1 de 2) [09/06/2003 10:02:01] window.onerror

http://www.mozilla.org/docs/dom/domref/dom_window_ref58.html (2 de 2) [09/06/2003 10:02:01] window.onfocus

window.onfocus

An event handler for focus events sent to the window.

Syntax

window.onfocus = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onfocus = startTimer;

Notes

The focus event is raised when the user sets focus on the current window.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref59.html (1 de 2) [09/06/2003 10:02:03] window.onfocus

http://www.mozilla.org/docs/dom/domref/dom_window_ref59.html (2 de 2) [09/06/2003 10:02:03] window.onkeydown

window.onkeydown

An event handler for the keydown event on the window.

Syntax

window.onkeydown = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onkeydown = doFunc;

Notes

The keydown event is raised when the user presses any key.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref60.html (1 de 2) [09/06/2003 10:02:04] window.onkeydown

http://www.mozilla.org/docs/dom/domref/dom_window_ref60.html (2 de 2) [09/06/2003 10:02:04] window.onkeypress

window.onkeypress

An event handler for the keypress event on the window.

Syntax

window.onkeypress = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onkeypress = doFunc;

Notes

The keypress event is raised when the user presses and releases any key on the keyboard.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref61.html (1 de 2) [09/06/2003 10:02:06] window.onkeypress

http://www.mozilla.org/docs/dom/domref/dom_window_ref61.html (2 de 2) [09/06/2003 10:02:06] window.onkeyup

window.onkeyup

An event handler for the keyup event on the window.

Syntax

window.onkeyup = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onkeyup = doFunc;

Notes

The keyup event is raised when a key that has been pressed is released.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref62.html (1 de 2) [09/06/2003 10:02:08] window.onkeyup

http://www.mozilla.org/docs/dom/domref/dom_window_ref62.html (2 de 2) [09/06/2003 10:02:08] window.onload

window.onload

An event handler for the load event on the window.

Syntax

window.onload = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onload = init;

Notes

The load event is fired at the end of the document loading process. At this point, all of the objects in the document are in the DOM.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref63.html (1 de 2) [09/06/2003 10:02:10] window.onload

http://www.mozilla.org/docs/dom/domref/dom_window_ref63.html (2 de 2) [09/06/2003 10:02:10] window.onmousedown

window.onmousedown

An event handler for the mousedown event on the window.

Syntax

window.onmousedown = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onmousedown = doFunc;

Notes

The mousedown event is raised when the user clicks the left mouse button anywhere in the document.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref64.html (1 de 2) [09/06/2003 10:02:13] window.onmousedown

http://www.mozilla.org/docs/dom/domref/dom_window_ref64.html (2 de 2) [09/06/2003 10:02:13] window.onmousemove

window.onmousemove

An event handler for the mousemove event on the window.

Syntax

window.onmousemove = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onmousemove = doFunc;

Notes

The mousemove event is raised when the user moves the mouse at all.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref65.html (1 de 2) [09/06/2003 10:02:15] window.onmousemove

http://www.mozilla.org/docs/dom/domref/dom_window_ref65.html (2 de 2) [09/06/2003 10:02:15] window.onmouseout

window.onmouseout

An event handler for the mousedown event on the window.

Syntax

window.onmouseout = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onmouseout = doFunc;

Notes

The mouseout event is raised when the mouse leaves the area of the specified element (in this case the window itself).

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref66.html (1 de 2) [09/06/2003 10:02:17] window.onmouseout

http://www.mozilla.org/docs/dom/domref/dom_window_ref66.html (2 de 2) [09/06/2003 10:02:17] window.onmouseover

window.onmouseover

An event handler for the mouseover event on the window.

Syntax

window.onmouseover = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onmouseover = doFunc;

Notes

The mouseover event is raised when the moves over the current element (in this case the window itself).

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref67.html (1 de 2) [09/06/2003 10:02:19] window.onmouseover

http://www.mozilla.org/docs/dom/domref/dom_window_ref67.html (2 de 2) [09/06/2003 10:02:19] window.onmouseup

window.onmouseup

An event handler for the mousedown event on the window.

Syntax

window.onmousedown = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onmousedown = doFunc;

Notes

The mousedown event is raised when the user clicks the left mouse button anywhere in the document.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref68.html (1 de 2) [09/06/2003 10:02:22] window.onmouseup

http://www.mozilla.org/docs/dom/domref/dom_window_ref68.html (2 de 2) [09/06/2003 10:02:22] window.onpaint

window.onpaint

An event handler for the paint event on the window.

Syntax

window.onpaint = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onpaint = doFunc;

Notes

The paint event is raised when the window is rendered. This event occurs after the load event for a window, and reoccurs each time the window needs to be rerendered, as when another window obscures it and is then cleared away.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref69.html (1 de 2) [09/06/2003 10:02:24] window.onpaint

http://www.mozilla.org/docs/dom/domref/dom_window_ref69.html (2 de 2) [09/06/2003 10:02:24] window.onreset

window.onreset

An event handler for the reset event on the window.

Syntax

window.onreset = funcRef

Parameters

funcRef is a reference to a function.

Example

http://www.mozilla.org/docs/dom/domref/dom_window_ref70.html (1 de 2) [09/06/2003 10:02:26] window.onreset

Notes

The reset event is raised when the user clicks a reset button in a form ().

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref70.html (2 de 2) [09/06/2003 10:02:26] window.onresize

window.onresize

An event handler for the resize event on the window.

Syntax

window.onresize = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onresize = doFunc;

Notes

The resize event is fired when the window is resized.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref71.html (1 de 2) [09/06/2003 10:02:27] window.onresize

http://www.mozilla.org/docs/dom/domref/dom_window_ref71.html (2 de 2) [09/06/2003 10:02:27] window.onscroll

window.onscroll

An event handler for the scroll event on the window.

Syntax

window.onscroll = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onscroll = doFunc;

Notes

The scroll event is raised when the window is scrolled.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref72.html (1 de 2) [09/06/2003 10:02:29] window.onscroll

http://www.mozilla.org/docs/dom/domref/dom_window_ref72.html (2 de 2) [09/06/2003 10:02:29] window.onselect

window.onselect

An event handler for the select event on the window.

Syntax

window.onselect = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onselect = textToCell;

Notes

The select event is raised when text in the window is selected.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref73.html (1 de 2) [09/06/2003 10:02:31] window.onselect

http://www.mozilla.org/docs/dom/domref/dom_window_ref73.html (2 de 2) [09/06/2003 10:02:31] window.onsubmit

window.onsubmit

An event handler for the submit event on the window.

Syntax

window.onsubmit = funcRef

Parameters

funcRef is a reference to a function.

Example

http://www.mozilla.org/docs/dom/domref/dom_window_ref74.html (1 de 2) [09/06/2003 10:02:33] window.onsubmit

Notes

The submit event is raised when the user clicks a submit button in a form ().

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref74.html (2 de 2) [09/06/2003 10:02:33] window.onunload

window.onunload

An event handler for the unload event on the window.

Syntax

window.onunload = funcRef

Parameters

funcRef is a reference to a function.

Example

window.onunload = saveStuff;

Notes

The unload event is raised as one document is unloaded and another is about to be loaded into the browser.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref75.html (1 de 2) [09/06/2003 10:02:35] window.onunload

http://www.mozilla.org/docs/dom/domref/dom_window_ref75.html (2 de 2) [09/06/2003 10:02:35] window.open()

window.open()

Opens a new window.

Syntax

window.open("URL", "name" [, "windowfeatures"])

Parameters

URL is a string that points to the window you want to open.

name is a string that names the new window.

windowfeatures is one or more of the following in a comma-separated list:

toolbar Toolbar is present

location Locationbar is present

directories

status

menubar XXX have to update this whole list XXX

scrollbars

http://www.mozilla.org/docs/dom/domref/dom_window_ref76.html (1 de 2) [09/06/2003 10:02:37] window.open()

resizable

copyhistory

width

height

Example

window.open("btest2.html", "bwin", "toolbar,status");

Notes

The name attribute is not a reference or the title of the window. It is used as a target to links and forms.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref76.html (2 de 2) [09/06/2003 10:02:37] window.opener

window.opener

Returns a reference to the window that opened this current window.

Syntax

wObj = window.opener

Parameters

wObj is an object reference.

Example

if window.opener != indexWin {

referToTop(window.opener);

}

Notes

When a window is opened from another window, it maintains a reference to that first window as window.opener. If the current window has no opener, this method returns NULL.

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref77.html (1 de 2) [09/06/2003 10:02:39] window.opener

http://www.mozilla.org/docs/dom/domref/dom_window_ref77.html (2 de 2) [09/06/2003 10:02:39] window.outerHeight

window.outerHeight

Gets/sets the height of the outside of the browser window.

Syntax

window.outerHeight = iPx

iPx = window.outerHeight

Parameters

iPx is an integer representing the number of pixels.

Example

window.outerHeight = ( window.screen.availHeight );

Notes

As the snippet above demonstrates, the outerHeight property is very often used to size the browser to the available screen area. Contrast this with the innerHeight property, which controls the size of the content area of the browser.

See also window.screen, window.innerHeight, window.outerWidth

Specification

DOM Level 0. Not part of specification.

http://www.mozilla.org/docs/dom/domref/dom_window_ref78.html (1 de 2) [09/06/2003 10:02:41] window.outerHeight

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref78.html (2 de 2) [09/06/2003 10:02:41] window.outerWidth

window.outerWidth

Gets/sets the width of the outside of the browser window.

Syntax

window.outerWidth = iPx

iPx = window.outerWidth

Parameters

iPx is an integer representing the number of pixels.

Example

window.outerWidth = ( window.screen.availWidth );

Notes

As the snippet above demonstrates, the outerWidth property is very often used to size the browser to the available screen area. Contrast this with the innerWidth property, which controls the size of the content area of the browser.

See also window.screen, window.innerHeight, window.outerHeight

Specification

DOM Level 0. Not part of specification.

http://www.mozilla.org/docs/dom/domref/dom_window_ref79.html (1 de 2) [09/06/2003 10:02:44] window.outerWidth

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_window_ref79.html (2 de 2) [09/06/2003 10:02:44] window.pageXOffset

window.pageXOffset

Gets the amount of content that has been hidden by scrolling to the right.

Syntax

hScroll = window.pageXOffset

Parameters

hScroll is the number of pixels scrolled as an integer.

Example

var hScroll = pageXOffset;

var vScroll = pageYOffset;

Notes

If the user has scrolled to the right and 200 pixels of the content is hidden by this, then the pageXOffset property returns 200.

window.pageYOffset

Specification

DOM Level 0. Not part of specification.

Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref80.html (1 de 2) [09/06/2003 10:02:45] window.pageXOffset

http://www.mozilla.org/docs/dom/domref/dom_window_ref80.html (2 de 2) [09/06/2003 10:02:45] window.pageYOffset

window.pageYOffset

Gets the amount of content that has been hidden by scrolling down.

Syntax

vScroll = window.pageYOffset

Parameters

vScroll is the number of pixels as an integer.

Example

var hScroll = pageXOffset;

var vScroll = pageYOffset;

Notes

If the user has scrolled down and 400 pixels of the content is hidden by this, then the pageYOffset property returns 400.

See also: the Element style property.

You can check the syntax for the values of these attributes by consulting the DOM CSS specification.

accelerator font pause

azimuth fontFamily pauseAfter

background fontSize pauseBefore

backgroundAttachment fontSizeAdjust pitch

backgroundColor fontStretch pitchRange

backgroundImage fontStyle playDuring

backgroundPosition fontVariant position

backgroundRepeat fontWeight quotes

border height richness

borderBottom left right

http://www.mozilla.org/docs/dom/domref/dom_style_ref18.html (3 de 7) [09/06/2003 10:08:58] DOM CSS Properties List

borderBottomColor length size

borderBottomStyle letterSpacing speak

borderBottomWidth lineHeight speakHeader

borderCollapse listStyle speakNumeral

borderColor listStyleImage speakPunctuation

borderLeft listStylePosition speechRate

borderLeftColor listStyleType stress

borderLeftStyle margin tableLayout

borderLeftWidth marginBottom textAlign

borderRight marginLeft textDecoration

borderRightColor marginRight textIndent

borderRightStyle marginTop textShadow

borderRightWidth markerOffset textTransform

http://www.mozilla.org/docs/dom/domref/dom_style_ref18.html (4 de 7) [09/06/2003 10:08:58] DOM CSS Properties List

borderSpacing marks top

borderStyle maxHeight unicodeBidi

borderTop maxWidth verticalAlign

borderTopColor minHeight visibility

borderTopStyle minWidth voiceFamily

borderTopWidth MozBinding volume

borderWidth MozOpacity whiteSpace

bottom orphans widows

captionSide outline width

clear outlineColor wordSpacing

clip outlineStyle zIndex

color outlineWidth

content overflow

http://www.mozilla.org/docs/dom/domref/dom_style_ref18.html (5 de 7) [09/06/2003 10:08:58] DOM CSS Properties List

counterIncrement padding

counterReset paddingBottom

cssFloat paddingLeft

cssText paddingRight

cue paddingTop

cueAfter page

cueBefore pageBreakAfter

cursor pageBreakBefore

direction pageBreakInside

display parentRule

elevation

emptyCells

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_style_ref18.html (6 de 7) [09/06/2003 10:08:58] DOM CSS Properties List

http://www.mozilla.org/docs/dom/domref/dom_style_ref18.html (7 de 7) [09/06/2003 10:08:58] FRAMESET

DOM Frame Reference

This document contains reference information for the following DOM objects:

● FRAMESET

● FRAME

● IFRAME FRAMESET

The FRAMESET element is a structure for containing subframes in HTML. It manages FRAME elements but not IFRAMES, which are inserted "in-line" into the document. In HTML, a frameset takes the following basic structure:

The DOM frameset object provides minimal programmatic access to the FRAMESET HTML element. Its interface-the two optional properties cols and rows-are a way to indicate the dimensions of the frame set, how many subframes it manages. Note that the frameset object does not provide interfaces for getting to the subframes it manages.

To get the frames in a document, you must ask the document itself, using the document.getElementById() method and the id of the frame(s) you want, or the document.getElementsByTagName("FRAME"), which returns a NamedNodeList array:

http://www.mozilla.org/docs/dom/domref/dom_frame_ref.html (1 de 2) [09/06/2003 10:09:00] FRAMESET

f1 = document.getElementById("frame1");

alert(f1.src); // print the src of the first frame

frames = document.getElementsByTagName("FRAME");

for (var i = 0; i < frames.length; i++) {

// do something with each frame as frames[i]

}

Properties

cols This property sets or returns the size of the columns of frames in the frameset..

rows This property sets or returns the number of rows of frames in the frameset.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref.html (2 de 2) [09/06/2003 10:09:00] cols

cols

This property sets or returns the size of the columns of frames in the frameset.

Syntax

cols = frameSetElement.cols

frameSetElement.cols = cols

Parameters

cols is the size of columns in the frameset as a comma-separated list.

Example

// element in HTML:

fs = document.getElementById("fset");

fs.cols = "200, *"; // two columns of frames, first 200px

Notes

The cols and rows properties are often used together to lay out the dimensions of a frameset in HTML. If these are not specified, then the frameset simply counts the number of frames it manages. The number of values in the cols attribute determines how many frames there are; the "*" specifies that the column take up all of the remaining space.

Specification

DOM Level 2 -- HTMLFrameSetElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref2.html (1 de 2) [09/06/2003 10:09:03] cols

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref2.html (2 de 2) [09/06/2003 10:09:03] FRAME

rows

This property sets or returns the number of rows of frames in the frameset.

Syntax

rows = frameSetElement.rows

frameSetElement.rows = rows

Parameters

rows is the number of rows in the frameset.

Example

// element in HTML:

fs = document.getElementById("fset");

fs.rows = 8; // eight rows of frames

Notes

The cols and rows properties are often used together to lay out the dimensions of a frameset in HTML. If these are not specified, then the frameset simply counts the number of frames it manages. For example, if you have a frameset like the one below, then blah blah...

Specification

DOM Level 2 -- HTMLFrameSetElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref3.html (1 de 2) [09/06/2003 10:09:06] FRAME FRAME

The frame object provides methods and properties for manipulating the HTML FRAME element. While many of the properties (e.g., frameBorder, marginWidth) handle the FRAME itself, the contentDocument property allows you to get the actual document contained in the subframe, which can then be futher manipulated.

Properties

contentDocument The contentDocument property returns the document the frame contains, if any.

contentWindow The contentWindow property returns the window object for the frame.

frameBorder gets/sets the border around the current frame. frameBorder

longDesc The longDesc property specifies a url for a longer description of the contents of the current frame.

marginHeight Gets/sets the height of the frame's margin in pixels.

marginWidth Gets/sets the width of the frame's margin in pixels.

name The name of the frame element.

noResize Gets/sets whether the user can resize the current frame.

scrolling The scrolling property specifies whether the current frame should provide scrollbars or not.

src The src property provides a url to load as content into the current frame.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref3.html (2 de 2) [09/06/2003 10:09:06] contentDocument

contentDocument

The contentDocument property returns the document the frame contains, if any.

Syntax

document = frameElement.contentDocument

Parameters

document is an object reference to the document contained in the given frame.

Example

f = document.getElementById("frame");

if ( f.contentDocument ) {

src_doc = f.contentDocument;

working_title = src_doc.title;

}

Notes

This property returns NULL if there is no current document

Specification

DOM Level 2 -- HTMLFrameElement

Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_frame_ref4.html (1 de 2) [09/06/2003 10:09:08] contentDocument

http://www.mozilla.org/docs/dom/domref/dom_frame_ref4.html (2 de 2) [09/06/2003 10:09:08] contentWindow

contentWindow

The contentWindow property returns the window object for the frame.

Syntax

frameWindow = frameElement.contentWindow

Parameters

frameWindow is an object reference to the window object for this frame.

Example

f = document.getElementById("frame");

f.contentWindow.location = "http://mozilla.org";

f.contentWindow.history.back();

Notes

You can also get to the window object through a named frame. For example, a frame with the name="myFrame" can refer back to the window object as window.frames["myFrame"].

Specification

DOM Level 2 -- HTMLFrameElement

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref5.html (1 de 2) [09/06/2003 10:09:09] contentWindow

http://www.mozilla.org/docs/dom/domref/dom_frame_ref5.html (2 de 2) [09/06/2003 10:09:09] frameBorder

frameBorder

frameBorder gets/sets the border around the current frame.

Syntax

border = frameElement.frameBorder

frameElement.frameBorder = border

Parameters

border gives the border width in number of pixels as string.

Example

// create a border around the current frame

f = document.getElementById("frame-1");

f.frameBorder = 2;

Notes

Note that the data type for the value of the frameBorder is a string. This is because the value may be specified as either a number of pixels (e.g., "2") or a percentage, in which case the percent sign is included. A value of "0" means no border at all.

Specification

DOM Level 2 -- HTMLFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref6.html (1 de 2) [09/06/2003 10:09:13] frameBorder

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref6.html (2 de 2) [09/06/2003 10:09:13] longDesc

longDesc

The longDesc property specifies a url for a longer description of the contents of the current frame.

Syntax

url = frameElement.longDesc

frameElement.longDesc = url

Parameters

The url string provides a url where a longer description of the current frame can be found.

Example

f = document.getElementById("main-frame");

f.longDesc = "http://www.netcape.com/supplements/more.html";

Notes

In the case of FRAME elements, the longDesc property is a way to point to a longer description than the title of the FRAME provides

Specification

DOM Level 2 -- HTMLFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref7.html (1 de 2) [09/06/2003 10:09:15] longDesc

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref7.html (2 de 2) [09/06/2003 10:09:15] marginHeight

marginHeight

Gets/sets the height of the frame's margin in pixels.

Syntax

sHeight = frameElement.marginHeight

frameElement.marginHeight = sHeight

Parameters

The sHeight string gives the height of the frame's margin in pixels.

Example

f = document.getElementById("frame1");

f.marginHeight = 3;

Notes

None.

Specification

DOM Level 2 -- HTMLFrameElement

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref8.html (1 de 2) [09/06/2003 10:09:17] marginHeight

http://www.mozilla.org/docs/dom/domref/dom_frame_ref8.html (2 de 2) [09/06/2003 10:09:17] marginWidth

marginWidth

Gets/sets the width of the frame's margin in pixels.

Syntax

sWidth = frameElement.marginWidth

frameElement.marginWidth = sWidth

Parameters

The sWidth string gives the width of the frame's margin in pixels.

Example

f = document.getElementById("frame1");

f.marginWidth = 3;

Notes

None.

Specification

DOM Level 2 -- HTMLFrameElement

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref9.html (1 de 2) [09/06/2003 10:09:19] marginWidth

http://www.mozilla.org/docs/dom/domref/dom_frame_ref9.html (2 de 2) [09/06/2003 10:09:19] name

name

The name of the current frame.

Syntax

framename = frameElement.name

Parameters

frameName is a string.

Example

f = document.getElementById("main-frame");

if (f.name != "main") {

}

Notes

In the HTML, you can set the FRAME name attribute directly: and then refer to that frame in the DOM with window.frames["f1"].

Specification http://www.mozilla.org/docs/dom/domref/dom_frame_ref10.html (1 de 2) [09/06/2003 10:09:24] name

DOM Level 2 -- HTMLFrameElement

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref10.html (2 de 2) [09/06/2003 10:09:24] noResize

noResize

Gets/sets whether the user can resize the current frame.

Syntax

bool = frameElement.noResize

frameElement.noResize = bool

Parameters

bool is a boolean value indicating whether the current frame is resizable or not.

Example

f = document.getElementById("main-frame");

if ( user_level == "barney" ) {

f.noResize = true;

}

Notes

None.

Specification

DOM Level 2 -- HTMLFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref11.html (1 de 2) [09/06/2003 10:09:29] noResize

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref11.html (2 de 2) [09/06/2003 10:09:29] scrolling

scrolling

The scrolling property specifies whether the current frame should provide scrollbars or not.

Syntax

sBars = frameElement.scrolling

frameElement.scrolling = sBars

Parameters

sBars is a string with the value "auto", "no," or "yes."

Example

f = document.getElementById("main-frame");

f.scrolling = yes;

Notes

The default value for this property is "auto," which specifies that scrollbars be added whenever necessary. "yes" means that they are always present, and "no" means that they are never present.

Specification

DOM Level 2 -- HTMLFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref12.html (1 de 2) [09/06/2003 10:09:32] scrolling

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref12.html (2 de 2) [09/06/2003 10:09:32] IFRAME

src

The src property provides a url to load as content into the current frame.

Syntax

frameElement.src = sURL

Parameters

sURL is a string containing a URL.

Example

f = document.getElementById("content-frame");

f.src = "www.netscape.com";

Notes

None.

Specification

DOM Level 2 -- HTMLFrameElement IFRAME

http://www.mozilla.org/docs/dom/domref/dom_frame_ref13.html (1 de 2) [09/06/2003 10:09:37] IFRAME

The IFRAME element is very much like a FRAME. The difference is that an IFRAME can be inserted in-line, hence the name IFRAME. Regular FRAME elements take up as much space as they can (given the dimensions of the FRAMESET, the presence of other frames, and the confines of the document itself). But iframes can be aligned in their containing elements, given a specific height and width, etc.

Properties

align Specifies how the IFRAME is to be aligned in the containing element.

The contentDocument property returns the document the frame contains, if any. contentDocument

The contentWindow property returns the window parent of the iframe. contentWindow

frameBorder frameBorder gets/sets the border around the current IFRAME.

longDesc The longDesc property points to a long description of the current iframe.

marginHeight Gets/sets the height of the frame's margin in pixels.

marginWidth Gets/sets the width of the frame's margin in pixels.

name The name of the IFRAME element.

The scrolling property specifies whether the current frame should provide scrollbars or not. scrolling

src The src property provides a url to load as content into the current frame.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref13.html (2 de 2) [09/06/2003 10:09:37] contentDocument

contentDocument

The contentDocument property returns the document the frame contains, if any.

Syntax

document = iFrameElement.contentDocument

Parameters

document is an object reference to the document contained in the given frame.

Example

i= document.getElementById("my-iframe");

if (i.contentDocument ) {

src_doc = i.contentDocument;

working_title = src_doc.title;

}

Notes

This property returns NULL if there is no current document.

Specification

DOM Level 2 -- HTMLFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref15.html (1 de 2) [09/06/2003 10:09:42] contentDocument

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref15.html (2 de 2) [09/06/2003 10:09:42] contentWindow

contentWindow

The contentWindow property returns the window object for the iframe.

Syntax

iframeWindow = iframeElement.contentWindow

Parameters

iframeWindow is an object reference to the window object for this iframe.

Example

i = document.getElementById("iframe");

i.contentWindow.location = "http://mozilla.org";

i.contentWindow.history.back();

Notes

You can also get to the window object through a named iframe. For example, an iframe with the name="myFrame" can refer back to the window object as window.frames["myFrame"].

Specification

None.

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref16.html (1 de 2) [09/06/2003 10:09:45] contentWindow

http://www.mozilla.org/docs/dom/domref/dom_frame_ref16.html (2 de 2) [09/06/2003 10:09:45] frameBorder

frameBorder

frameBorder gets/sets the border around the current IFRAME.

Syntax

sBorder = iFrameElement.frameBorder

iFrameElement.frameBorder = sBorder

Parameters

sBorder gives the border width in number of pixels as string.

Example

// create a border around the current iframe

i= document.getElementById("iframe-1");

i.frameBorder = 2;

Notes

Specification

DOM Level 2 -- HTMLFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref17.html (1 de 2) [09/06/2003 10:09:48] frameBorder

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref17.html (2 de 2) [09/06/2003 10:09:48] longDesc

longDesc

The longDesc property points to a long description of the current iframe.

Syntax

url = IFrameElement.longDesc

Parameters

The url string provides a url where a longer description of the current frame can be found.

Example

f = document.getElementById("main-frame");

f.longDesc = "http://www.netcape.com/suppl/more.html";

Notes

The "long description" is meant to provide more information about the contents of a frame element. In the case of an element, which also uses the longDesc property, it is meant to accompany alt descriptions.

Specification

DOM Level 2 -- HTMLIFrameElement

Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_frame_ref18.html (1 de 2) [09/06/2003 10:09:50] longDesc

http://www.mozilla.org/docs/dom/domref/dom_frame_ref18.html (2 de 2) [09/06/2003 10:09:50] marginHeight

marginHeight

Gets/sets the height of the frame's margin in pixels.

Syntax

sHeight = iFrameElement.marginHeight

iFrameElement.marginHeight = sHeight

Parameters

The sHeight string gives the height of the frame's margin in pixels.

Example

i= document.getElementById("iframe1");

i.marginHeight = 3;

Notes

Note that the data type for the value of the marginHeight is a string. This is because the value may be specified as either a number of pixels (e.g., "2") or a percentage, in which case the percent sign is included. A value of "0" means no margin at all.

Specification

DOM Level 2 -- HTMLIFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref19.html (1 de 2) [09/06/2003 10:09:53] marginHeight

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref19.html (2 de 2) [09/06/2003 10:09:53] marginWidth

marginWidth

Gets/sets the width of the frame's margin in pixels.

Syntax

sWidth = iFrameElement.marginWidth

iFrameElement.marginWidth = sWidth

Parameters

The sWidth string gives the width of the frame's margin in pixels.

Example

i = document.getElementById("iframe1");

i.marginWidth = 3;

Notes

Note that the data type for the value of the marginWidth is a string. This is because the value may be specified as either a number of pixels (e.g., "2") or a percentage, in which case the percent sign is included. A value of "0" means no margin at all.

Specification

DOM Level 2 -- HTMLIFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref20.html (1 de 2) [09/06/2003 10:09:55] marginWidth

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref20.html (2 de 2) [09/06/2003 10:09:55] name

name

The name of the current iframe.

Syntax

iframename = iframeElement.name

Parameters

iframeName is a string.

Example

i = document.getElementById("main-frame");

if (i.name != "main") {

}

Notes

In the HTML, you can set the IFRAME name attribute directly: and then refer to that frame in the DOM with window.frames["f1"].

Specification

DOM Level 2 -- HTMLIFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref21.html (1 de 2) [09/06/2003 10:09:57] name

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref21.html (2 de 2) [09/06/2003 10:09:57] scrolling

scrolling

The scrolling property specifies whether the current frame should provide scrollbars or not.

Syntax

sBars = iFrameElement.scrolling

iFrameElement.scrolling = sBars

Parameters

sBars is a string with the value "auto", "no," or "yes."

Example

i= document.getElementById("iframe");

i.scrolling = yes;

Notes

The default value for this property is "auto," which specifies that scrollbars be added whenever necessary. "yes" means that they are always present, and "no" means that htey are never present.

Specification

DOM Level 2 -- HTMLFrameElement

http://www.mozilla.org/docs/dom/domref/dom_frame_ref22.html (1 de 2) [09/06/2003 10:10:00] scrolling

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref22.html (2 de 2) [09/06/2003 10:10:00] src

src

The src property provides a url to load as content into the current frame.

Syntax

iFrameElement.src = sURL

sURL= iFrameElement.src

Parameters

sURL is a string containing a URL.

Example

i = document.getElementById("content-frame");

i.src = "www.netscape.com";

Notes

None.

Specification

DOM Level 2 -- HTMLIFrameElement

Netscape Communications http://developer.netscape.com

http://www.mozilla.org/docs/dom/domref/dom_frame_ref23.html (1 de 2) [09/06/2003 10:10:03] src

http://www.mozilla.org/docs/dom/domref/dom_frame_ref23.html (2 de 2) [09/06/2003 10:10:03] HTMLFormElement Interface

DOM HTML Elements Reference

This chapter provides reference information for several specific HTMLElement interfaces.

● HTMLFormElement Interface

● HTMLTableElement Interface

● [under construction...] HTMLFormElement Interface

As HTML elements, FORM elements expose all of the properties and methods described in the DOM Elements Reference chapter. They also expose the specialized interface described here.

The APIs for manipulating FORM elements described here allow you to create and fully configure FORM elements using the DOM. The following snippet gives you some idea of how you might create a new form element and equip it with some of the attributes that the form submission process requires.

f = document.createElement("form");

body.appendChild(f);

f.action = "\cgi-bin\some.cgi";

f.method = "POST"

...

f.submit(); // submit the newly-created form!

In addition, the following complete HTML document shows how to extract info from an existing form element and how to set some of the read/write properties on that FORM.

http://www.mozilla.org/docs/dom/domref/dom_html_ref.html (1 de 3) [09/06/2003 10:10:06] HTMLFormElement Interface

form tests

http://www.mozilla.org/docs/dom/domref/dom_html_ref.html (2 de 3) [09/06/2003 10:10:06] HTMLFormElement Interface

style="min-height:300;min-width:300" /></form></body></html>Properties elements elements returns an array of all the form controls contained in the FORM element. length length returns the number of controls in the FORM element. name name returns the name of the current FORM element as a string. acceptCharset elements returns a list of the supported character sets for the current FORM element. action action gets/sets the action of the FORM element. enctype enctype gets/sets the content type of the FORM element. encoding encoding gets/sets the content type of the FORM element. method method gets/sets the HTTP method used to submit the form. target target gets/sets the target of the action (i.e., the frame to render its output in).Methods submit() submit() submits the form. reset() reset() resets the form to its initial state.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref.html (3 de 3) [09/06/2003 10:10:06] elementsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search elements elements returns an array of all the form controls contained in the FORM element. Syntax controls = form.elementsParameters controls is a nodeList.Example inputs = document.getElementById("form1").elementsNotes None. Specification elements Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref2.html (1 de 2) [09/06/2003 10:10:08] elementsCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref2.html (2 de 2) [09/06/2003 10:10:08] lengthHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search length length returns the number of controls in the FORM element. Syntax num = form.elementsParameters num is an integer.Example if (document.getElementById("form1").length > 1) {// more than one form control here}Notes None. Specification length Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref3.html (1 de 2) [09/06/2003 10:10:12] lengthCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref3.html (2 de 2) [09/06/2003 10:10:12] nameHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search name name returns the name of the current FORM element as a string. Syntax name = form.name form.name = nameParameters name is a string.Example form1 = document.getElementById("form1").name; if (form1 != document.form.form1) {// browser doesn't support this form of reference}Notes Note that this property is read/write, which means that you can change the name of a form or set it if it hasn't been set alreaDY. Specification name http://www.mozilla.org/docs/dom/domref/dom_html_ref4.html (1 de 2) [09/06/2003 10:10:18] nameNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref4.html (2 de 2) [09/06/2003 10:10:18] acceptCharsetHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search acceptCharset elements returns a list of the supported character sets for the current FORM element. Syntax charSets = form.acceptCharset;Parameters charSets is a string.Example inputs = document.forms["myform"].acceptCharsetNotes None. Specification acceptCharset Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref5.html (1 de 2) [09/06/2003 10:10:25] acceptCharsetCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref5.html (2 de 2) [09/06/2003 10:10:25] actionHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search action action gets/sets the action of the FORM element. Syntax action = form.action form.action = actionParameters action is a string.Example form.action = "/cgi-bin/publish";Notes The action of a form is the program that is executed on the server when the form is submitted. This property can be retrieved or set. Specification action Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref6.html (1 de 2) [09/06/2003 10:10:29] actionCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref6.html (2 de 2) [09/06/2003 10:10:29] enctypeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search enctype enctype gets/sets the content type of the FORM element. Syntax enctype = form.enctype form.enctype = enctypeParameters enctype is a string.Example form.enctype = "application/x-www-form-urlencoded";Notes The encoding type is generally "application/x-www-form-urlencoded". Specification enctype Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref7.html (1 de 2) [09/06/2003 10:10:34] enctypeCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref7.html (2 de 2) [09/06/2003 10:10:34] encodingHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search encoding encoding gets/sets the content type of the FORM element. Syntax encoding = form.enctype form.enctype = encodingParameters encoding is a string.Example form.encoding = "application/x-www-form-urlencoded";Notes The encoding type is generally "application/x-www-form-urlencoded". Specification encoding Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref8.html (1 de 2) [09/06/2003 10:10:41] encodingCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref8.html (2 de 2) [09/06/2003 10:10:41] methodHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search method method gets/sets the HTTP method used to submit the form. Syntax meth = form.method form.method = methParameters meth is a string.Example document.forms["myform"].method = "POST";Notes None. Specification method Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref9.html (1 de 2) [09/06/2003 10:10:47] methodCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref9.html (2 de 2) [09/06/2003 10:10:47] targetHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search target target gets/sets the target of the action (i.e., the frame to render its output in). Syntax targ = form.target form.target = targParameters targ is a string.Example myForm.target = document.frames[1].name;Notes None. Specification target Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref10.html (1 de 2) [09/06/2003 10:10:51] targetCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref10.html (2 de 2) [09/06/2003 10:10:51] submit()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search submit() submit() submits the form. Syntax form.submit()Parameters None.Example document.forms["myform"].submit()Notes This method does the same as the form submit button. * can "automatically" submit things this way without having to hit the submit button. ?But do you have to pass in the form parameters? Specification submit Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref11.html (1 de 2) [09/06/2003 10:10:53] submit()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref11.html (2 de 2) [09/06/2003 10:10:53] HTMLTableElement InterfaceHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search reset() reset() resets the form to its initial state. Syntax form.reset()Parameters None.Example document.forms["myform"].reset();Notes This method is the same as the form reset button. Specification reset HTMLTableElement Interface http://www.mozilla.org/docs/dom/domref/dom_html_ref12.html (1 de 3) [09/06/2003 10:10:58] HTMLTableElement Interface table objects expose the HTMLTableElement interface, which provides special properties and methods (beyond the regular element object interface they also have available to them by inheritance) for manipulating the layout and presentation of tables in HTML. Properties caption caption returns the table caption. tHead tHead returns the table head. tFoot tFoot returns the table footer. rows rows returns the rows in the table. tBodies tBodies returns the table bodies. align align gets/sets the alignment of the table. bgColor bgColor gets/sets the background color of the table. border border gets/sets the table border. cellPadding cellPadding gets/setst the cell padding. cellSpacing cellSpacing gets/set the spacing around the table. frame frame specifies which sides of the table have borders. rules rules specifies which interior borders are visible. summary summary gets/sets the table summary. width width gets/sets the width of the table.Methods createTHead() createTHead() creates a table header. deleteTHead() deleteTHead() removes the table header. createTFoot() createTFoot() creates a table footer. deleteTFoot() deleteTFoot() removes a table footer. createCaption() createCaption() creates a new caption for the table. deleteCaption() deleteCaption() removes the table caption. insertRow() insertRow() inserts a new row. deleteRow() deleteRow() removes a row. http://www.mozilla.org/docs/dom/domref/dom_html_ref12.html (2 de 3) [09/06/2003 10:10:58] HTMLTableElement InterfaceNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref12.html (3 de 3) [09/06/2003 10:10:58] captionHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search caption caption returns the table caption. Syntax caption = table.captionParameters caption is a string.Example if (table.caption) {// do something with the caption}Notes This property returns void if no caption exists on the table. Specification caption Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref13.html (1 de 2) [09/06/2003 10:11:02] captionCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref13.html (2 de 2) [09/06/2003 10:11:02] tHeadHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search tHead tHead returns the table's THEAD. Syntax th_el = table.tHeadParameters th_el is a HTMLTableSectionElement.Example if (table.tHead == my_head_el) {...}Notes This property returns VOID if no THEAD element exists. Specification tHead Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref14.html (1 de 2) [09/06/2003 10:11:05] tHeadCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref14.html (2 de 2) [09/06/2003 10:11:05] tFootHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search tFoot tFoot returns the table's TFOOT element. Syntax th_el = table.tFootParameters tf_el is a HTMLTableSectionElement.Example if (table.tFoot == my_foot) {...}Notes This property returns VOID if no TFOOT element exists. Specification tFoot Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref15.html (1 de 2) [09/06/2003 10:11:08] tFootCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref15.html (2 de 2) [09/06/2003 10:11:08] rowsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search rows rows returns a collection of the rows in the table. Syntax rows = table.rowsParameters rows is an HTMLCollection.Example myrows = mytable.rows;Notes The collection returned by this property includes the THEAD and TFOOT and TBODY elements, if any, on the current table. Specification rows Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref16.html (1 de 2) [09/06/2003 10:11:17] rowsCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref16.html (2 de 2) [09/06/2003 10:11:17] tBodiesHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search tBodies tBodies returns a collection of the table bodies. Syntax bodies = table.tBodiesParameters bodies is an HTMLCollection.Example length(mytable.tBodies);Notes None. Specification tBodies Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref17.html (1 de 2) [09/06/2003 10:11:20] tBodiesCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref17.html (2 de 2) [09/06/2003 10:11:20] alignHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search align align gets/sets the alignment of the table. Syntax alignment = table.align table.align = alignmentParameters alignment is a string with one of the following values: left center rightExample mytable.align = "center";Notes The align attribute is deprecated in HTML4.0. Specification http://www.mozilla.org/docs/dom/domref/dom_html_ref18.html (1 de 2) [09/06/2003 10:11:28] align align Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref18.html (2 de 2) [09/06/2003 10:11:28] bgColorHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search bgColor bgcolor gets/sets the background color of the table. Syntax color = table.bgColor table.bgColor = colorParameters color is a string representing a color value.Example mytable.bgColor = "lightblue";Notes The bgColor attribute is deprecated in HTML 4.0. Specification bgColor Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref19.html (1 de 2) [09/06/2003 10:11:33] bgColorCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref19.html (2 de 2) [09/06/2003 10:11:33] borderHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search border border gets/sets the border width. Syntax table.border = width width = table.borderParameters width is a string representing the width in pixels.Example mytable.border="2";Notes This attribute is deprecated in HTML 4.0. Specification border Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref20.html (1 de 2) [09/06/2003 10:11:36] borderCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref20.html (2 de 2) [09/06/2003 10:11:36] cellSpacingHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search cellPadding cellPadding gets/sets the padding around the individual cells of the table. Syntax table.cellPadding = padding padding = table.cellPaddingParameters padding is a string representing the padding in pixels.Example mytable.cellPadding = "10";Notes None. Specification cellPadding cellSpacing http://www.mozilla.org/docs/dom/domref/dom_html_ref21.html (1 de 2) [09/06/2003 10:11:38] cellSpacing cellSpacing gets/sets the spacing around the individual cells of the table. Syntax table.cellSpacing = spacing spacing = table.cellSpacingParameters spacing is a string representing the spacing around the table in pixels.Example mytable.cellSpacing = "10";Notes None. Specification cellSpacing Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref21.html (2 de 2) [09/06/2003 10:11:38] frameHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search frame frame specifies which external table borders to render. Syntax table.frame = side side = table.frameParameters side is a string with one of the following values: void no sides. this is the default. above top side below bottom side hsides top and bottom only vsides right and left sides only lhs left-hand side only rhs right-hand side only box all four sides border all four sidesExample http://www.mozilla.org/docs/dom/domref/dom_html_ref22.html (1 de 2) [09/06/2003 10:11:40] frame mytable.frame = "border"; mytable.border = "2px";Notes None. Specification frame Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref22.html (2 de 2) [09/06/2003 10:11:40] http://www.mozilla.org/docs/dom/domref/dom_html_ref23.htmlHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search rules rules specifies which cell borders to render in the table. Syntax table.rules = rules rules = table.rulesParameters rules is a string with one of the following values: none no rules groups lines between groups only rows lines between rows cols lines between cols all lines between all cellsExample t = document.getElementById("mytable"); t.rules = "all"; // turn on all the internal bordersNotes http://www.mozilla.org/docs/dom/domref/dom_html_ref23.html (1 de 2) [09/06/2003 10:11:43] http://www.mozilla.org/docs/dom/domref/dom_html_ref23.htmlNone. Specification rules Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref23.html (2 de 2) [09/06/2003 10:11:43] summaryHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search summary summary gets/sets a table description. Syntax table.summary = summary summary = table.summaryParameters summary is a string.Example t.rules = "none"; t.summary = "removed internal borders";Notes None. Specification summary Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref24.html (1 de 2) [09/06/2003 10:11:46] summaryCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref24.html (2 de 2) [09/06/2003 10:11:46] createTHead()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search width width specifies the desired width of the table. Syntax table.width = width width = table.widthParameters width is a string representing the width in number of pixels or as a percentage value.Example mytable.width="75%"Notes None. Specification width createTHead() http://www.mozilla.org/docs/dom/domref/dom_html_ref25.html (1 de 2) [09/06/2003 10:11:50] createTHead() createTHead() creates a new THEAD for the table. Syntax th = table.createTHead()Parameters th is an HTMLElement.Example myhead = mytable.createTHead();//checking: myhead == mytable.tHeadNotes If the element already exists on the table, then this method returns that element Specification createTHead() Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref25.html (2 de 2) [09/06/2003 10:11:50] deleteTHead()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search deleteTHead() deleteTHead() removes a THEAD from the table. Syntax table.deleteTHead()Parameters None.Example mytable.deleteTHead();Notes None. Specification deleteTHead() Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref26.html (1 de 2) [09/06/2003 10:11:52] deleteTHead()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref26.html (2 de 2) [09/06/2003 10:11:52] createTFoot()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search createTFoot() createTFoot() creates a new TFOOT for the table. Syntax tf = table.createTFoot()Parameters tf is an HTMLElement.Example myfoot = mytable.createTFoot();//checking: myfoot == mytable.tFootNotes If the element already exists on the table, then this method returns that element Specification createTFoot() Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref27.html (1 de 2) [09/06/2003 10:11:55] createTFoot()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref27.html (2 de 2) [09/06/2003 10:11:55] deleteTFoot()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search deleteTFoot() deleteTFoot() removes a TFOOT from the table. Syntax table.deleteTFoot()Parameters None.Example mytable.deleteTFoot();Notes None. Specification deleteTFoot() Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref28.html (1 de 2) [09/06/2003 10:11:57] deleteTFoot()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref28.html (2 de 2) [09/06/2003 10:11:57] createCaption()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search createCaption() createCaption() creates a new caption for the table. Syntax tcap = table.createCaption()Parameters tcap is an HTMLElement.Example mycap = mytable.createCaption();Notes If the element already exists on the table, then this method returns that element. Specification createCaption() Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref29.html (1 de 2) [09/06/2003 10:11:59] createCaption()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref29.html (2 de 2) [09/06/2003 10:11:59] deleteCaption()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search deleteCaption() deleteCaption() removes the caption from the table. Syntax table.deleteCaption()Parameters None.Example mytable.deleteCaption();Notes None. Specification deleteCaption() Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref30.html (1 de 2) [09/06/2003 10:12:04] deleteCaption()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref30.html (2 de 2) [09/06/2003 10:12:04] insertRow()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search insertRow() insertRow() inserts a new row in the table. Syntax row = table.insertRow(index)Parameters index is a number representing where in the table to insert the new row. row is an HTMLElementExample newrow = mytable.insertRow(0); // insert a new first rowNotes None. Specification insertRow() Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref31.html (1 de 2) [09/06/2003 10:12:07] insertRow()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref31.html (2 de 2) [09/06/2003 10:12:07] deleteRow()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search deleteRow() deleteRow() removes a row from the table. Syntax table.deleteRow(index)Parameters index is a number representing the row that should be deleted.Example mytable.deleteRow(1); // delete the second rowNotes None. Specification deleteRow() Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_html_ref32.html (1 de 2) [09/06/2003 10:12:12] deleteRow()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_html_ref32.html (2 de 2) [09/06/2003 10:12:12] DOM 2 Range InterfaceHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search DOM Range ReferenceThis chapter provides reference information for the DOM Range interface. ● DOM 2 Range Interface ● Gecko Range Interface Extensions DOM 2 Range Interface Properties Returns a boolean indicating whether a range is collapsed. collapsedReturns the deepest Node that contains the startContainer and endContainer commonAncestorContainer Nodes. Returns the Node within which the Range ends. endContainerReturns a number representing where in the endContainer the Range ends. endOffsetReturns the Node within which the Range starts. startContainerReturns a number representing where in the startContainer the Range starts. startOffsetCreation Methods http://www.mozilla.org/docs/dom/domref/dom_range_ref.html (1 de 3) [09/06/2003 10:12:16] DOM 2 Range InterfaceReturns a new Range object. createRangeSets the start position of a Range. setStartSets the end position of a Range. setEndSets the start position of a Range relative to another Node. setStartBeforeSets the start position of a Range relative to another Node. setStartAfterSets the end position of a Range relative to another Node. setEndBeforeSets the end position of a Range relative to another Node. setEndAfterSets the Range to contain the node and its contents. selectNodeSets the Range to contain the contents of a Node. selectNodeContentsEditing Methods Collapses the Range to one of its boundary points. collapseReturns a document fragment copying the nodes of a Range. cloneContentsRemoves the contents of a Range from the document. deleteContentsMoves contents of a Range from the document tree into a document fragment extractContentsInsert a node at the start of a Range. insertNodeMoves content of a Range into a new node. surroundContentsOther Methods http://www.mozilla.org/docs/dom/domref/dom_range_ref.html (2 de 3) [09/06/2003 10:12:16] DOM 2 Range InterfaceCompares the boundary points of two Ranges. compareBoundaryPointsReturns a Range object with boundary points identical to the cloned Range. cloneRangeReleases Range from use to improve performance. detachReturns the text of the Range. toStringNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref.html (3 de 3) [09/06/2003 10:12:16] collapsedHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search collapsed Returns a boolean indicating whether a range is collapsed. Syntax isCollapsed = range.collapsed;Parameters isCollapsed is boolean with values of true or false Example range = document.createRange(); range.setStart(startNode,startOffset); range.setEnd(endNode,endOffset); isCollapsed = range.collapsed;Notes Returns a boolean of true if the start and end boundary points of the Range are the same point in the DOM, false if not. A collapsed Range is empty, containing no content, specifying a single-point in a DOM tree. The collapsed property is read-only. To collapse a range, see the collapse method Specification: http://www.mozilla.org/docs/dom/domref/dom_range_ref2.html (1 de 2) [09/06/2003 10:12:32] collapsed collapsed Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref2.html (2 de 2) [09/06/2003 10:12:32] commonAncestorContainerHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search commonAncestorContainer Returns the deepest Node that contains the startContainer and endContainer Nodes. Syntax rangeAncestor = range.commonAncestorContainer;Parameters rangeAncestor is a Node of type Document, DocumentFragment, or Attr Example range = document.createRange(); range.setStart(startNode,startOffset); range.setEnd(endNode,endOffset); rangeAncestor = range.commonAncestorContainer;Notes Returns the deepest, or further down the document tree, Node that contains both the startContainer and endContainer nodes. Since a Range need not be continuous, and may also partially select Nodes, this is a convenient way to find a Node which encloses a Range. This property is read-only. To change the ancestor container of a Node, consider using the various methods to set the start and end positions of the Range. http://www.mozilla.org/docs/dom/domref/dom_range_ref3.html (1 de 2) [09/06/2003 10:12:36] commonAncestorContainerSpecification: commonAncestorContainer Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref3.html (2 de 2) [09/06/2003 10:12:36] endContainerHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search endContainer Returns the Node within which the Range ends. Syntax endRangeNode = range.endContainer;Parameters endRangeNode is a reference to a Node. Example range = document.createRange(); range.setStart(startNode,startOffset); range.setEnd(endNode,endOffset); endRangeNode = range.endContainer;Notes Returns a reference to the Node in the document within which the Range ends This property is read-only. To change the end position of a node, use one of the setEnd methods. Specification: endParent http://www.mozilla.org/docs/dom/domref/dom_range_ref4.html (1 de 2) [09/06/2003 10:12:38] endContainerNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref4.html (2 de 2) [09/06/2003 10:12:38] endOffsetHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search endOffset Returns a number representing where in the endContainer the Range ends. Syntax endRangeOffset = range.endOffset;Parameters endRangeOffset is the number characters or child Node index where the Range ends in the endContainer Example range = document.createRange(); range.setStart(startNode,startOffset); range.setEnd(endNode,endOffset); endRangeOffset = range.endOffset;Notes endOffset has two meanings. If the endContainer is a Node of type Text, Comment, or CDATASection, then the offset is the number of characters from the start of the endContainer to the boundary point of the Range. For other Node types, the endOffset is the number of child nodes between the start of the endContainer and the boundary point of the Range. This property is read-only. To change the endOffset of a Range, use one of the setEnd methods. http://www.mozilla.org/docs/dom/domref/dom_range_ref5.html (1 de 2) [09/06/2003 10:12:40] endOffset Specification: endOffset Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref5.html (2 de 2) [09/06/2003 10:12:40] startContainerHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search startContainer Returns the Node within which the Range starts. Syntax startRangeNode = range.startContainer;Parameters startRangeNode is a reference to a Node Example range = document.createRange(); range.setStart(startNode,startOffset); range.setEnd(endNode,endOffset); startRangeNode = range.startContainer;Notes Returns a reference to the Node in the document within which the Range starts. This property is read-only. To change the start position of a node, use one of the setStart methods. Specification: startParent http://www.mozilla.org/docs/dom/domref/dom_range_ref6.html (1 de 2) [09/06/2003 10:12:42] startContainerNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref6.html (2 de 2) [09/06/2003 10:12:42] startOffsetHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search startOffset Returns a number representing where in the startContainer the Range starts. Syntax startRangeOffset = range.startOffset;Parameters startRangeOffset is the number characters or a child Node index where the Range starts in the startContainer Example range = document.createRange(); range.setStart(startNode,startOffset); range.setEnd(endNode,endOffset); startRangeOffset = range.startOffset;Notes startOffset has two meanings. If the startContainer is a Node of type Text, Comment, or CDATASection, then the offset is the number of characters from the start of the startContainer to the boundary point of the Range. For other Node types, the startOffset is the number of child nodes between the start of the startContainer and the boundary point of the Range. This property is read-only. To change the startOffset of a Range, use one of the setStart methods. http://www.mozilla.org/docs/dom/domref/dom_range_ref7.html (1 de 2) [09/06/2003 10:12:43] startOffsetSpecification startOffset Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref7.html (2 de 2) [09/06/2003 10:12:43] createRangeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search createRange Returns a new Range object. Syntax range = document.createRange();Parameters range is a new instance of the Range object Example range = document.createRange(); range.setStart(startNode,startOffset); range.setEnd(endNode,endOffset);Notes Once a Range is created, you need to set its boundary points before you can make use of most of its methods. Specification: createRange http://www.mozilla.org/docs/dom/domref/dom_range_ref8.html (1 de 2) [09/06/2003 10:12:45] createRangeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref8.html (2 de 2) [09/06/2003 10:12:45] setStartHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setStart Sets the start position of a Range. Syntax range.setStart(startNode,startOffset);Parameters The setStart method takes the following parameters: The Node to start the Range startNodeAn integer greater than or equal to zero representing the offset for the start of the Range from the start of startOffset startNode.Example range = document.createRange(); startNode = document.getElementsByTagName("p").item(2); startOffset = 0; range.setStart(startNode,startOffset);Notes If the startNode is a Node of type Text, Comment, or CDATASection, then http://www.mozilla.org/docs/dom/domref/dom_range_ref9.html (1 de 2) [09/06/2003 10:12:47] setStart startOffset is the number of characters from the start of startNode. For other Node types, startOffset is the number of child nodes between the start of the startNode. Specification: setStart Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref9.html (2 de 2) [09/06/2003 10:12:47] setEndHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setEnd Sets the end position of a Range. Syntax range.setEnd(endNode,endOffset);Parameters The setEnd method takes the following parameters: endNode The Node to end the Range endOffset An integer greater than or equal to zero representing the offset for the end of the Range from the start of endNode. Example range = document.createRange(); endNode = document.getElementsByTagName("p").item(3); endOffset = document.getElementsByTagName("p").item(3).childNodes.length; range.setEnd(endNode,endOffset); http://www.mozilla.org/docs/dom/domref/dom_range_ref10.html (1 de 2) [09/06/2003 10:12:49] setEnd Notes If the endNode is a Node of type Text, Comment, or CDATASection, then endOffset is the number of characters from the start of endNode. For other Node types, endOffset is the number of child nodes between the start of the endNode. Specification: setEnd Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref10.html (2 de 2) [09/06/2003 10:12:49] setStartBeforeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setStartBefore Sets the start position of a Range relative to another Node. Syntax range.setStartBefore(referenceNode);Parameters The setStartBefore method takes the following parameters: referenceNode The Node to start the Range before Example range = document.createRange(); referenceNode = document.getElementsByTagName("div").item(0); range.setStartBefore(referenceNode);Notes The parent Node of the start of the Range will be the same as that for the referenceNode. Specification: http://www.mozilla.org/docs/dom/domref/dom_range_ref11.html (1 de 2) [09/06/2003 10:12:51] setStartBefore setStartBefore Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref11.html (2 de 2) [09/06/2003 10:12:51] setStartAfterHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setStartAfter Sets the start position of a Range relative to another Node. Syntax range.setStartAfter(referenceNode);Parameters The setStartBefore() method takes the following parameters: referenceNode The Node to start the Range after Example range = document.createRange(); referenceNode = document.getElementsByTagName("div").item(0); range.setStartAfter(referenceNode);Notes The parent Node of the start of the Range will be the same as that for the referenceNode. Specification: http://www.mozilla.org/docs/dom/domref/dom_range_ref12.html (1 de 2) [09/06/2003 10:12:52] setStartAfter setStartAfter Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref12.html (2 de 2) [09/06/2003 10:12:52] setEndBeforeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setEndBefore Sets the end position of a Range relative to another Node. Syntax range.setEndBefore(referenceNode);Parameters The setEndBefore() method takes the following parameters: referenceNode The Node to end the Range before Example range = document.createRange(); referenceNode = document.getElementsByTagName("div").item(0); range.setEndBefore(referenceNode);Notes The parent Node of end of the Range will be the same as that for the referenceNode. Specification setEndBefore http://www.mozilla.org/docs/dom/domref/dom_range_ref13.html (1 de 2) [09/06/2003 10:12:54] setEndBeforeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref13.html (2 de 2) [09/06/2003 10:12:54] setEndAfterHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setEndAfter Sets the end position of a Range relative to another Node. Syntax range.setEndAfter(referenceNode);Parameters The setEndAfter() method takes the following parameters: referenceNode The Node to end the Range after Example range = document.createRange(); referenceNode = document.getElementsByTagName("div").item(0); range.setEndAfter(referenceNode);Notes The parent Node of end of the Range will be the same as that for the referenceNode. Specification http://www.mozilla.org/docs/dom/domref/dom_range_ref14.html (1 de 2) [09/06/2003 10:12:56] setEndAfter setEndAfter Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref14.html (2 de 2) [09/06/2003 10:12:56] selectNodeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search selectNode Sets the Range to contain the node and its contents. Syntax range.selectNode(referenceNode);Parameters The selectNode() method takes the following parameters: referenceNode The Node to select within a Range Example range = document.createRange(); referenceNode = document.getElementsByTagName("div").item(0); range.selectNode(referenceNode);Notes The parent Node of the start and end of the Range will be the same as the parent of the referenceNode. Specification http://www.mozilla.org/docs/dom/domref/dom_range_ref15.html (1 de 2) [09/06/2003 10:13:00] selectNode selectNode Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref15.html (2 de 2) [09/06/2003 10:13:00] selectNodeContentsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search selectNodeContents Sets the Range to contain the contents of a Node. Syntax range.selectNodeContents(referenceNode);Parameters The selectNodeContents method takes the following parameters: referenceNode The Node whose contents will be selected within a Range Example range = document.createRange(); referenceNode = document.getElementsByTagName("div").item(0); range.selectNodeContents(referenceNode);Notes The parent Node of the start and end of the Range will be the referenceNode. The startOffset is 0, and the endOffset is the number of child Nodes or number of characters contained in the reference node. http://www.mozilla.org/docs/dom/domref/dom_range_ref16.html (1 de 2) [09/06/2003 10:13:03] selectNodeContentsSpecification selectNodeContents Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref16.html (2 de 2) [09/06/2003 10:13:03] collapseHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search collapse Collapses the Range to one of its boundary points. Syntax range.collapse(toStart);Parameters The collapse method takes the following parameters: toStart A boolean, true collapses the Range to its start, false to its end. Example range = document.createRange(); referenceNode = document.getElementsByTagName("div").item(0); range.selectNode(referenceNode); range.collapse(true);Notes A collapsed Range is empty, containing no content, specifying a single-point in a DOM tree. To determine if a Range is already collapsed, see the collapsed property. http://www.mozilla.org/docs/dom/domref/dom_range_ref17.html (1 de 2) [09/06/2003 10:13:05] collapseSpecification collapse Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref17.html (2 de 2) [09/06/2003 10:13:05] cloneContentsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search cloneContents Returns a document fragment copying the nodes of a Range. Syntax documentFragment = range.cloneContents();Parameters documentFragment is a document fragment Example range = document.createRange(); range.selectNode(document.getElementsByTagName("div"). item(0)); documentFragment = range.cloneContents(); document.body.appendChild(documentFragment);Notes Event Listeners added using DOM Events are not copied during cloning. HTML attribute events are duplicated as they are for the DOM Core cloneNode method. HTML id attributes are also cloned, which can lead to an invalid document through cloning. Partially selected nodes include the parent tags necessary to make the document fragment valid. http://www.mozilla.org/docs/dom/domref/dom_range_ref18.html (1 de 2) [09/06/2003 10:13:07] cloneContents Specification cloneContents Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref18.html (2 de 2) [09/06/2003 10:13:07] deleteContentsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search deleteContents Removes the contents of a Range from the document. Syntax range.deleteContents()Parameters None. Example range = document.createRange(); range.selectNode( document.getElementsByTagName("div").item(0)); range.deleteContents();Notes Unlike extractContents, this method does not return a documentFragment containing the deleted content. Specification deleteContents http://www.mozilla.org/docs/dom/domref/dom_range_ref19.html (1 de 2) [09/06/2003 10:13:09] deleteContentsNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref19.html (2 de 2) [09/06/2003 10:13:09] extractContentsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search extractContents Moves contents of a Range from the document tree into a document fragment. Syntax documentFragment = range.extractContents();Parameters documentFragment is a document fragment Example range = document.createRange(); range.selectNode(document.getElementsByTagName("div").item(0)); documentFragment = range.extractContents(); document.body.appendChild(documentFragment);Notes Event Listeners added using DOM Events are not retained during extraction. HTML attribute events are retained or duplicated as they are for the DOM Core cloneNode method. HTML id attributes are also cloned, which can lead to an invalid document if a partially-selected node is extracted and appened to the document. Partially selected nodes are cloned to include the parent tags necessary to make the document fragment valid. http://www.mozilla.org/docs/dom/domref/dom_range_ref20.html (1 de 2) [09/06/2003 10:13:11] extractContentsSpecification: extractContents Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref20.html (2 de 2) [09/06/2003 10:13:11] insertNodeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search insertNode Insert a node at the start of a Range. Syntax range.insertNode(newNode);Parameters newNode is a Node. Example range = document.createRange(); newNode = document.createElement("p"): newNode.appendChild(document.createTextNode("New Node Inserted Here")); range.selectNode(document.getElementsByTagName("div").item(0)); range.insertNode(newNode);Notes newNode is inserted at the start boundary point of the Range. If the newNodes is to be added to a text Node, that Node is split at the insertion point, and the insertion occurs between the two text Nodes (Blocked by http://bugzilla.mozilla.org/show_bug.cgi?id=135922 ) If newNode is a document fragment, the children of the document fragment are inserted instead. http://www.mozilla.org/docs/dom/domref/dom_range_ref21.html (1 de 2) [09/06/2003 10:13:12] insertNodeSpecification insertNode Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref21.html (2 de 2) [09/06/2003 10:13:12] surroundContentsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search surroundContents Moves content of a Range into a new node. Syntax range.surroundContents(newNode);Parameters newNode a Node Example range = document.createRange(); newNode = document.createElement("p"): range.selectNode(document.getElementsByTagName("div").item(0)); range.surroundContents(newNode);Notes surroundContents is equivalent to newNode.appendChild(range.extractContents());range.insertNode(newNode). After surrounding, the boundary points of the Range include newNode. (Hindered by http://bugzilla.mozilla.org/show_bug.cgi?id=135928 ) Specification surroundContents http://www.mozilla.org/docs/dom/domref/dom_range_ref22.html (1 de 2) [09/06/2003 10:13:14] surroundContentsNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref22.html (2 de 2) [09/06/2003 10:13:14] compareBoundaryPointsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search compareBoundaryPoints Compares the boundary points of two Ranges. Syntax compare = range.compareBoundaryPoints(how,sourceRange);Parameters The compareBoundaryPoints method takes the following parameters: compare A number, 1, 0, -1. how A constant describing the comparison method sourceRange A Range to boundary points with range Example http://www.mozilla.org/docs/dom/domref/dom_range_ref23.html (1 de 2) [09/06/2003 10:13:17] compareBoundaryPoints range = document.createRange(); range.selectNode( document.getElementsByTagName("div").item(0)); sourceRange = document.createRange(); sourceRange.selectNode(document.getElementsByTagName( "div").item(1)); compare = range.compareBoundaryPoints( START_TO_END,sourceRange);Notes END_TO_END compares the end boundary-point of sourceRange to the end boundary-point of range. END_TO_START compares the end boundary-point of sourceRange to the start boundary- point of range. START_TO_END compares the start boundary-point of sourceRange to the end boundary- point of range. START_TO_START compares the start boundary-point of sourceRange to the start boundary- point of range. Specification compareBoundaryPoints Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref23.html (2 de 2) [09/06/2003 10:13:17] cloneRangeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search cloneRange Returns a Range object with boundary points identical to the cloned Range. Syntax clone = range.cloneRange();Parameters clone is a Range object. Example range = document.createRange(); range.selectNode( document.getElementsByTagName("div").item(0)); clone = range.cloneRange();Notes clone is copied by value, not reference, so a change in either Range does not effect the other. Specification cloneRange http://www.mozilla.org/docs/dom/domref/dom_range_ref24.html (1 de 2) [09/06/2003 10:13:20] cloneRangeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref24.html (2 de 2) [09/06/2003 10:13:20] detachHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search detach Releases Range from use to improve performance. Syntax range.detach();Parameters None. Example range = document.createRange(); range.selectNode( document.getElementsByTagName("div").item(0)); range.detach();Notes Allows mozilla to relinquish resources associated with this Range. Subsequent attempts to use the detached range will result in a DOMException being thrown with an error code of INVALID_STATE_ERR. Specification detach http://www.mozilla.org/docs/dom/domref/dom_range_ref25.html (1 de 2) [09/06/2003 10:13:21] detachNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref25.html (2 de 2) [09/06/2003 10:13:21] isPointInRangeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search toString Returns the text of the Range. Syntax text = range.toString();Parameters text is the text contained in range. Example range = document.createRange(); range.selectNode( document.getElementsByTagName("div").item(0)); text = range.toString();Notes Alerting the contents of a Range makes an implicit toString() call, so comparing range and text through an alert dialog is ineffective Specification toString http://www.mozilla.org/docs/dom/domref/dom_range_ref26.html (1 de 6) [09/06/2003 10:13:24] isPointInRange Gecko Range Interface Extensions This section describes Range methods that are particular to Mozilla and not part of the W3 DOM specifications. Methods compareNode Returns a constant. comparePoint Returns -1, 0, or 1. createContextualFragment Returns a document fragment. intersectsNode Returns a boolean indicating whether the given point intersects the range. isPointInRange Returns a boolean indicating whether the given point is in the range. compareNode Returns a constant (see notes) Syntax returnValue = range.compareNode( referenceNode );Paramaters Example range = document.createRange(); range.selectNode(document.getElementsByTagName("div").item(0)); returnValue = range.compareNode(document.getElementsByTagName("p").item(0));Notes http://www.mozilla.org/docs/dom/domref/dom_range_ref26.html (2 de 6) [09/06/2003 10:13:24] isPointInRangeNODE_BEFORE = 0 Node starts before the RangeNODE_AFTER = 1 Node starts after the RangeNODE_BEFORE_AND_AFTER = 2 Node starts before and ends after the RangeNode starts after and ends before the Range, i.e. the Node is completely selected NODE_INSIDE = 3 by the Range.Specification This method is not part of specification. comparePoint comparePoint() Returns -1, 0, or 1 Syntax returnValue = range.comparePoint( referenceNode, offset )Parameters returnValue -1, 0, or 1 depending on whether the referenceNode is before, the same as, or after the range. referenceNode The Node to compare with the Range. offset An integer greater than or equal to zero representing the offset inside the referenceNode.Example range = document.createRange(); range.selectNode(document.getElementsByTagName("div").item(0)); returnValue = range.comparePoint(document.getElementsByTagName("p").item(0),1); http://www.mozilla.org/docs/dom/domref/dom_range_ref26.html (3 de 6) [09/06/2003 10:13:24] isPointInRangeNotes If the referenceNode is a Node of type Text, Comment, or CDATASection, then offset is the number of characters from the start of referenceNode. For other Node types, offset is the number of child nodes between the start of the referenceNode. Specification This method is not part of a specification. createContextualFragment Returns a document fragment Syntax documentFragment = range.createContextualFragment( tagString ) Parameters tagString is text that contains text and tags to be converted to a document fragment Example tagString = "<div>I am a div node</div>"; range = document.createRange(); range.selectNode(document.getElementsByTagName("div").item(0)); documentFragment = range.createContextualFragment(tagString); document.body.appendChild(documentFragment); Notes This method takes a string and uses mozilla's parser to convert it to a DOM tree. Specification This method is not part of a specification. intersectsNode http://www.mozilla.org/docs/dom/domref/dom_range_ref26.html (4 de 6) [09/06/2003 10:13:24] isPointInRangeReturns a boolean indicating whether the given point intersects the range. Syntax bool = range.intersectsNode( referenceNode )Parameters bool is true if the referenceNode intersects the Range, false if not. referenceNode is the Node to compare with the Range. Example range = document.createRange(); range.selectNode(document. getElementsByTagName("div").item(0)); bool = range.intersectsNode(document. getElementsByTagName("p").item(0),1);Notes None Specification This method is not part of a specification. isPointInRange Returns a boolean indicating whether the given point is in the range. Syntax http://www.mozilla.org/docs/dom/domref/dom_range_ref26.html (5 de 6) [09/06/2003 10:13:24] isPointInRange bool = range.intersectsNode( referenceNode )Parameters bool is true if the referenceNode intersects the Range, false if not. referenceNode is the Node to compare with the Range. Example range = document.createRange(); range.selectNode(document.getElementsByTagName("div").item(0)); bool = range.intersectsNode(document. getElementsByTagName("p").item(0),1);Notes None Specification This method is not part of a specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_range_ref26.html (6 de 6) [09/06/2003 10:13:24] Example 7: Displaying Event Object ConstantsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search DOM ExamplesThis chapter provides some longer examples of web and XML development using the DOM. Wherever possible, the examples use common APIs, tricks, and patterns in JavaScript for manipulating the document object. ● Example 1: height and width ● Example 2: Image Attributes ● Example 3: Manipulating Styles ● Example 4: Using Stylesheets ● Example 5: Event Propagation ● Example 6: getComputedStyle ● Example 7: Displaying Event Object Constants Example 1: height and width The following example shows the use of the height and width properties alongside images of varying dimensions: <html><head><title>image example</title><script language="javascript"> function init(){ var image = new Array(); image[0] = document.getElementById('image1'); image[1] = document.getElementById('image2'); image[2] = document.getElementById('image3'); var output = document.getElementById('output'); var html = ''; var i; html = '<ul>'; http://www.mozilla.org/docs/dom/domref/examples.html (1 de 11) [09/06/2003 10:13:33] Example 7: Displaying Event Object Constants for (i = 0; i < image.length; i++) html += '<li>image' + (i+1) + ': height=' + image[i].height + ', width=' + image[i].width + ', style.height=' + image[i].style.height + ', style.width=' + image[i].style.width + '</li>'; html += '</ul>'; output.innerHTML = html;}</script></head><body onload="init()">Image 1: no height, width, or style Image 2: height=50, width=500, but no style Image 3: no height, width, but style="height: 50px; width: 500px;" <div id="output"></div> height and width are also properties of the EMBED, OBJECT, and APPLET objects. Example 2: Image Attributes <html><head><title>border</title><script TYPE="text/javascript"> http://www.mozilla.org/docs/dom/domref/examples.html (2 de 11) [09/06/2003 10:13:33] Example 7: Displaying Event Object Constants</script><style TYPE="text/css"></style></head><body>*border<hr><form NAME="FORM"><input TYPE="button" VALUE="Change" onClick="border1()"><input TYPE="button" VALUE="Return" onClick="border2()"></form><hr>Made by <a HREF="http://www.bekkoame.ne.jp/~hamba/webimage/java/java.html">MasahitoHamba</a>(<a HREF="mailto:hamba@bekkoame.ne.jp">hamba@bekkoame.ne.jp</a>). It's free to copy and arrange this sample.But please keep to regulation of <a HREF="http://cgi.din.or.jp/~hagi3/JavaScript/JSTips/Mozilla/MDSProject.htm" TARGET=msg>MDSProject</a>. Last update 2001.01.14</body></html>Example 3: Manipulating Styles In this simple example, some basic style properties of an HTML paragraph element are accessed using the style object on the element and that object's CSS style properties, which can be retrieved and set from the DOM. In this case, you are manipulating the individual styles directly. In the next example (see Example 4), you can use stylesheets and their rules to change styles for whole documents. http://www.mozilla.org/docs/dom/domref/examples.html (3 de 11) [09/06/2003 10:13:33] Example 7: Displaying Event Object Constants <html><head><script> function changeText() { p = document.getElementById("pid"); p.style.color = "blue" p.style.fontSize = "18pt"}</script></head><body>linker<form><input value="rec" type="button" onclick="changeText();" /></form></body></html>Example 4: Using Stylesheets The styleSheets property on the document object returns a list of the stylesheets that have been loaded on that document. You can access these stylesheets and their rules individually using the stylesheet, style, and CSSRule objects, as demonstrated in this example, which prints out all of the style rule selectors to the console. ss = document.styleSheets; for(<a href="/tags/Ii_(IRC_client)/" rel="tag">ii</a>=0;ii<ss.length;ii++) { for(i=0;i<ss[0].cssRules.length;i++) { dump( ss[ii].cssRules[i].style.selectorText + "\n" );}For a document with a single stylesheet in which the following three rules are defined: BODY { background-color: darkblue; }P { font-face: Arial; font-size: 10pt; margin-left: .125in; } http://www.mozilla.org/docs/dom/domref/examples.html (4 de 11) [09/06/2003 10:13:33] Example 7: Displaying Event Object Constants #lumpy { display: none; }This script outputs the following:BODYP#LUMPYExample 5: Event Propagation This example demonstrates how events fire and are handled in the DOM in a very simple way. When the BODY of this HTML document loads, an event listener is registered with the top row of the TABLE. The event listener handles the event by executing the function l_func, which changes the value in the bottom cell of the table. However, l_func also calls an event object method, stopPropagation, which keeps the event from bubbling any further up into the DOM. Note that the table itself has an onclick event handler that ought to display a message when the table is clicked. But the l_func method has stopped propagation, and so after the data in the table is updated, the event phase is effectively ended. <html><head><style>#t-daddy { border: 1px solid red }#t1 { background-color: pink; }</style><script> function l_func(e) { t2 = document.getElementById("t2"); t2.innerHTML = "three"; e.stopPropagation(); // this ought to keep t-daddy from getting the click. } function load() { el = document.getElementById("t"); el.addEventListener("click", l_func, false);}</script> http://www.mozilla.org/docs/dom/domref/examples.html (5 de 11) [09/06/2003 10:13:33] Example 7: Displaying Event Object Constants</head><body onload="load();"><table id="t-daddy" onclick="alert('hi');"><tr id="t"><td id="t1">one</td></tr><tr><td id="t2">two</td></tr></table></body></html>Example 6: getComputedStyle This example demonstrates how the DOM document.defaultView.getComputedStyle() method can be used to get the styles on an element that aren't set in-line or with JavaScript (e.g., element.style.backgroundColor="lightblue"). These latter types of styles can be retrieved with the more direct style = element.style property, a list of which properties is listed in the DOM Style Reference of this book (see DOM CSS Properties List). See also the style property in the DOM Elements Reference. getComputedStyle() returns a ComputedCSSStyleDeclaration object, whose individual style properties can be referenced with this object's getPropertyValue() method, as the following example document shows. <html><head><title>getComputedStyle</title><script> function cStyles() { div = document.getElementById("d1"); t1 = document.getElementById("t1"); h_style = document.defaultView.getComputedStyle(div, '').getPropertyValue("height"); t1.setAttribute("value", h_style); t2 = document.getElementById("t2"); w_style = document.defaultView.getComputedStyle(div, '').getPropertyValue("width"); http://www.mozilla.org/docs/dom/domref/examples.html (6 de 11) [09/06/2003 10:13:33] Example 7: Displaying Event Object Constants t2.setAttribute("value", w_style); t3 = document.getElementById("t3"); b_style = document.defaultView.getComputedStyle(div, '').getPropertyValue("background-color"); t3.setAttribute("value", b_style);}</script><style>.d { margin-left: 10px; background-color: lightblue; height: 20px; max-width: 20px; }</style></head><body><div id="d1" class="d"> </div> <blockquote><button onclick="cStyles();">getComputedStyle</button> height<input id="t1" type="text" value="1" /> max-width<input id="t2" type="text" value="2" /> bg-color<input id="t3" type="text" value="3" /></pre></blockquote></body></html>Example 7: Displaying Event Object Constants This example shows how to use the DOM to create a table in which all of the constants in the event object and their values are displayed. It shows off several useful aspects of the DOM, including the Event.prototype property, which allows you to get to the properties of a particular object, a good pattern for iterating over the properties in that prototype, and the values of the constants themselves displayed in the table. Note that the middle range of these constants are the character codes that represent the actual keys pressed during the event (and fetchable with the charCode property). http://www.mozilla.org/docs/dom/domref/examples.html (7 de 11) [09/06/2003 10:13:33] Example 7: Displaying Event Object ConstantsLoad the following code as a web page to see the event object constants. <?xml version="1.0" ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "DTD/xhtml1- transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml" ><head><title></title><script language="JavaScript" type="text/javascript"></script></head><body onload="respond()"><!-Results after clicking on the button:The this object is myInput. http://www.mozilla.org/docs/dom/domref/examples.html (10 de 11) [09/06/2003 10:13:33] Example 7: Displaying Event Object ConstantsIndex Property Name Property Value0 type click1 target [object HTMLInputElement]...--></body></html>Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/examples.html (11 de 11) [09/06/2003 10:13:33] blurHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search blur The blur method removes keyboard focus from the current element. Syntax element.blur()Parameters None.Example None.Notes None. Specification blurNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref33.html (1 de 2) [09/06/2003 10:13:48] blurCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref33.html (2 de 2) [09/06/2003 10:13:48] window.clearInterval()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.clearInterval() Clears a delay that's been set for a specific function. Syntax window.clearInterval(intervalID)Parameters intervalID is the ID of the specific interval you want to clear.Example window.clearInterval(animID);Notes See also window.setInterval(). Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref7.html (1 de 2) [09/06/2003 10:14:01] window.clearInterval()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref7.html (2 de 2) [09/06/2003 10:14:01] window.back()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.back() Returns the window to the previous item in the history. Syntax window.back()Parameters None.Example function goBack() { if ( canGoBack ) window.back();}Notes None. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref4.html (1 de 2) [09/06/2003 10:14:49] window.back()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref4.html (2 de 2) [09/06/2003 10:14:49] clickHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search click The click method excecutes a click on the current element. Syntax element.click()Parameters None.Example example hereNotes The click method simulates a click event on the current element. This is frequently used to execute event handlers that have been placed on the current element or on elements above it in the "event chain." Specification clickNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref34.html (1 de 2) [09/06/2003 10:15:11] clickCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref34.html (2 de 2) [09/06/2003 10:15:11] cloneNodeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search cloneNode The cloneNode method returns a duplicate of the current node. Syntax dupNode = element.cloneNode(deep)Parameters deep is a boolean value indicating whether the clone is a deep clone or not (see notes below).Example p = document.getElementById("para1"); p_prime = p.cloneNode(true);Notes The duplicate node returned by cloneNode() has no parent. Cloning a node copies all of its attributes and their values but does not copy any of the text that the node contains, since that text is contained in a child Text node. A deep clone is a clone in which the given node and the whole subtree beneath it (including the text that makes up any child Text nodes) is copied and returned. Specification cloneNode http://www.mozilla.org/docs/dom/domref/dom_el_ref35.html (1 de 2) [09/06/2003 10:15:20] cloneNodeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref35.html (2 de 2) [09/06/2003 10:15:20] dispatchEventHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search dispatchEvent The dispatchEvent method allows the dispatch of events into the implementation's event model. Syntax boolean = element.dispatchEvent(event)Parameters event is an event object that contains information about the type, behavior, and contextual information of the event to be dispatched.Example b = document.getElementById("button1"); res = b.dispatchEvent("click"); if ( res ) {// event dispatch was successful b.disabled = true;}Notes When you create and dispatch an event using this method, the event has the same effect as events dispatched by user interaction. They are "real" events, in other words, and they bubble up the UI in the same way. See the event object interface for more information about the information that is passed in with this method. http://www.mozilla.org/docs/dom/domref/dom_el_ref36.html (1 de 2) [09/06/2003 10:15:23] dispatchEvent Specification dispatchEventNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref36.html (2 de 2) [09/06/2003 10:15:23] focusHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search focus focus sets focus on the current element. Syntax element.focus()Parameters None.Example None.Notes Calling the focus method on an element is equivalent to selecting that element in the user interface. Specification focusNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref37.html (1 de 2) [09/06/2003 10:15:25] focusCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref37.html (2 de 2) [09/06/2003 10:15:25] getAttributeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search getAttribute getAttribute returns the value of the named attribute on the current node. Syntax attribute = element.getAttribute(name)Parameters name is the name of the attribute whose value you want to get.Example div1 = document.getElementById("div1"); a = divvy.getAttribute("align"); alert(a); // shows the value of align for that DIVNotes getAttribute is another very common and useful method for web developers. The corollary to this method is setAttributeNS, which allows you to change the value of a named attribute. Specification getAttributeNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref38.html (1 de 2) [09/06/2003 10:15:30] getAttributeCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref38.html (2 de 2) [09/06/2003 10:15:30] getAttributeNSHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search getAttributeNS getAttributeNS returns the value of the attribute with the given name and namespace. Syntax attribute = element.getAttributeNS(namespace, name)Parameters attribute is an attribute node namespace is the namespace of the requested attribute. name is the name of the attribute whose value you want to get.Example div1 = document.getElementById("div1"); a = divvy.getAttributeNS("www.mozilla.org/ns/specialspace/","special-align"); alert(a); // shows the value of align for that DIVNotes getAttributeNS is another very common and useful method for web developers. It differs from getAttribute in that it allows you to further specify the requested attribute as being part of a particular namespace, as in the example above, where the attribute is part of the fictional "specialspace" namespace on mozilla. http://www.mozilla.org/docs/dom/domref/dom_el_ref39.html (1 de 2) [09/06/2003 10:15:32] getAttributeNSThe corollary to this method is setAttributeNS, which allows you to change the value of a named attribute. Specification getAttributeNSNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref39.html (2 de 2) [09/06/2003 10:15:32] getAttributeNodeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search getAttributeNode Returns the attribute of the current element as a separate node. Syntax attributeNode = element.getAttributeNode(nodeName)Parameters nodeName is a string containing the name of the node. attributeNode is a separate Attribute node.Example // html: <div id="top" /> t = document.getElementById("top"); iNode = t.getAttributeNode("id");// iNode.value = "top"Notes The Attribute node inherits from node, but is not considered a part of the document tree. Common node attributes like parentNode, previousSibling, and nextSibling are NULL for an Attribute node. You can, however, get the element to which the attribute belongs with the ownerElement property. Specification getAttributeNode http://www.mozilla.org/docs/dom/domref/dom_el_ref40.html (1 de 2) [09/06/2003 10:15:38] getAttributeNodeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref40.html (2 de 2) [09/06/2003 10:15:38] getAttributeNodeNSHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search getAttributeNodeNS Returns the attribute with the given namespace and name as a separate node. Syntax attributeNode = element.getAttributeNode(namespace, nodeName)Parameters namespace is a string containing the namespace of the attribute. nodeName is a string containing the name of the node. attributeNode is a separate Attribute node.Example // html: <div id="top" /> t = document.getElementById("top"); specialNode = t.getAttributeNodeNS( "http://www.mozilla.org/ns/specialspace", "id");// iNode.value = "full-top"Notes The Attribute node inherits from node, but is not considered a part of the document tree. Common node attributes like parentNode, previousSibling, and nextSibling are NULL for an Attribute node. http://www.mozilla.org/docs/dom/domref/dom_el_ref41.html (1 de 2) [09/06/2003 10:15:40] getAttributeNodeNS You can, however, get the element to which the attribute belongs with the ownerElement property. getAttributeNodeNS is more specific than getAttributeNode in that it allows you to specify attributes that are part of a particular namespace. The corresponding setter method is setAttributeNodeNS. Specification getAttributeNodeNSNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref41.html (2 de 2) [09/06/2003 10:15:40] getElementsByTagNameHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search getElementsByTagName Returns a list of the child elements of a given name on the current element. Syntax elements = element.getElementsByTagName(Name)Parameters elements is a nodeList of elements. tagName is a string representing the name of the elements.Example // check the alignment on a number of cells in a table. table = document.getElementById("forecast-table"); cells = table.getElementsByTagName("td"); for (var i = 0; i < cells.length; i++) { status = cells[i].getAttribute("status"); if ( status == "open") {// grab the data}}Notes http://www.mozilla.org/docs/dom/domref/dom_el_ref42.html (1 de 2) [09/06/2003 10:15:43] getElementsByTagName getElementsByTagName on the element is the same as getElementsByTagName on the document, except that its search is restricted to those elements which are children of the current element. Specification getElementsByTagNameNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref42.html (2 de 2) [09/06/2003 10:15:43] hasAttributeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search hasAttribute hasAttribute is a boolean value indicating whether the current element has the specified attribute or not. Syntax [ true | false ] = element.hasAttribute(attName)Parameters boolean true | false attName is a string representing the name of the attributeExample // check that the attirbute exists// before you set a value d = document.getElementById("div1"); if d.hasAttribute("align") { d.setAttribute("align", "center");}Notes None. Specification http://www.mozilla.org/docs/dom/domref/dom_el_ref43.html (1 de 2) [09/06/2003 10:15:45] hasAttribute hasAttributeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref43.html (2 de 2) [09/06/2003 10:15:45] hasAttributeNSHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search hasAttributeNS hasAttribute is a boolean value indicating whether the current element has an attribute with the specified name and namespace. Syntax [ true | false ] = element.hasAttribute(namespace, localName)Parameters boolean true | false namespace is a string representing the namespace you are looking for localName is a string representing the name of the attributeExample // check that the attirbute exists// before you set a value d = document.getElementById("div1"); if d.hasAttributeNS("http://www.mozilla.org/ns/specialspace/", "special-align") { d.setAttribute("align", "center"); }Notes http://www.mozilla.org/docs/dom/domref/dom_el_ref44.html (1 de 2) [09/06/2003 10:15:48] hasAttributeNSNone. Specification hasAttributeNSNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref44.html (2 de 2) [09/06/2003 10:15:48] hasAttributesHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search hasAttributes hasAttributes is a boolean value indicating whether the current element has any attributes. Syntax [ true | false ] = element.hasAttributesParameters boolean true | falseExample t1 = document.getElementById("table-data"); if ( t1.hasAttributes ) {// do something with// t1.attributes}Notes None. Specification hasAttributes http://www.mozilla.org/docs/dom/domref/dom_el_ref45.html (1 de 2) [09/06/2003 10:15:49] hasAttributesNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref45.html (2 de 2) [09/06/2003 10:15:49] hasChildNodesHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search hasChildNodes hasChildNodes is a method that returns a boolean value indicating whether the current element has children or not. Syntax [ true | false ] = element.hasChildNodes()Parameters boolean true | falseExample t1 = document.getElementById("table-data"); if ( t1.hasChildNodes() ) {// table has kids}Notes Note that element.hasChildNodes, without the parentheses, is the incorrect usage of this method, and always returns a true value indicating that the method is available on the object. Do not be fooled. Specification hasChildNodes http://www.mozilla.org/docs/dom/domref/dom_el_ref46.html (1 de 2) [09/06/2003 10:15:51] hasChildNodesNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref46.html (2 de 2) [09/06/2003 10:15:51] insertBeforeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search insertBefore The insertBefore method allows you to insert a node before a reference element as a child of the current node. Syntax insertedElement = element.insertBefore( newElement, targetElement)Parameters insertedElement The node being inserted. newElement The node to insert. targetElement The node before which newElement is inserted.Example parentDiv = document.getElementById("parentDiv"); sp2 = document.getElementById("childSpan"); sp1 = document.createElement("span"); parentDiv.insertBefore(sp1, sp2);Notes None. http://www.mozilla.org/docs/dom/domref/dom_el_ref47.html (1 de 2) [09/06/2003 10:15:53] insertBefore Specification insertBeforeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref47.html (2 de 2) [09/06/2003 10:15:53] itemHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search item The item method retrieves a node from the tree by index. Syntax nodeItem = element.item(index)Parameters nodeItem is a node. index is the index of the node to be fetched. Index is zero-based.Example tbls = document.getElementsByTagName("table"); first_table = tbls.item(1);Notes A value of NULL is returned if the index is out of range. Specification itemNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref48.html (1 de 2) [09/06/2003 10:15:55] itemCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref48.html (2 de 2) [09/06/2003 10:15:55] nextSiblingHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search nextSibling Returns the node immediately following the current one in the tree. Syntax node = elementNode.nextSiblingParameters node is a node object.Example // in a table, the cells are siblings cell1 = document.getElementById("td1"); cell2 = cell1.nextSibling;Notes Returns NULL if there are no more nodes. Specification nextSibling Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref49.html (1 de 2) [09/06/2003 10:15:57] nextSiblingCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref49.html (2 de 2) [09/06/2003 10:15:57] normalizeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search normalize The normalize method puts the current node and all of its subtree into a "normalized" form (see below). Syntax element.normalize()Parameters None.Example example hereNotes The normalized form of a subtree is that subtree's nodelist cleansed of extranous and adjacent Text nodes. Specification normalizeNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref50.html (1 de 2) [09/06/2003 10:15:59] normalizeCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref50.html (2 de 2) [09/06/2003 10:15:59] removeAttributeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search removeAttribute The removeAttribute() method removes an attribute from the current element. Syntax element.removeAttribute(attName)Parameters attName is a string that names the attribute to be removed from the current node.Example // <div align="left" width="200px" /> d = document.getElementById("div1"); d.removeAttribute("align");// now: <div width="200px" />Notes removeAttribute allows you to change the attribute list dynamically on the current node. Specification removeAttributeNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref51.html (1 de 2) [09/06/2003 10:16:02] removeAttributeCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref51.html (2 de 2) [09/06/2003 10:16:02] removeAttributeNSHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search removeAttributeNS The removeAttributeNS() method removes an attribute with the specified namespacde and name. Syntax element.removeAttribute(namespace, attName)Parameters namespace is a string that contains the namespace of the specified attribute. attName is a string that names the attribute to be removed from the current node.Example // <div special-align="utterleft" width="200px" /> d = document.getElementById("div1"); d.removeAttributeNS( "http://www.mozilla.org/ns/specialspace","special-align");// now: <div width="200px" />Notes removeAttributeNS allows you to change the attribute list dynamically on the current node. Specification removeAttributeNS http://www.mozilla.org/docs/dom/domref/dom_el_ref52.html (1 de 2) [09/06/2003 10:16:04] removeAttributeNSNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref52.html (2 de 2) [09/06/2003 10:16:04] removeAttributeNodeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search removeAttributeNode removeAttributeNode removes the specified attribute from the current element. Syntax remove_attr = element.removeAttributeNode(attribute)Parameters attribute is the Attribute node that needs to be removed. remove_attr is an Attribute node.Example // <div id="top" align="center" /> d = document.getElementById("top"); d_align = d.getAttributeNode("align"); d.removeAttributeNode(d_align);// align has a default value, center,// so the removed attribute is immediately // replaced: <div id="top" align="center" />Notes If the removed Attribute has a default value it is immediately replaced. The replacing attribute has the same namespace URI and local name, as well as the original prefix, when applicable. Specification http://www.mozilla.org/docs/dom/domref/dom_el_ref53.html (1 de 2) [09/06/2003 10:16:07] removeAttributeNode removeAttributeNodeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref53.html (2 de 2) [09/06/2003 10:16:07] removeChildHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search removeChild The removeChild() method removes a child node from the current element. Syntax oldChild = element.removeChild(child)Parameters oldChild is the node that needs to be removed. child is a node.Example // <div id="top" align="center"><div id="nested"/></div> d = document.getElementById("top"); d_nested = document.getElementById("nested"); throwaway_node = d.removeChild(d_nested);Notes None. Specification removeChild http://www.mozilla.org/docs/dom/domref/dom_el_ref54.html (1 de 2) [09/06/2003 10:16:09] removeChildNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref54.html (2 de 2) [09/06/2003 10:16:09] removeEventListenerHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search removeEventListener removeEventListener() allows the removal of event listeners from the event target. Syntax element.removeEventListener(type, listener, useCapture)Parameters The removeEventListener() method takes the following parameters: type A string representing the event type being registered.The listener parameter takes an interface implemented by the user which listener contains the methods to be called when the event occurs.If true, useCapture indicates that the user wishes to initiate capture. After initiating capture, all events of the specified type will be dispatched to the registered EventListener before being dispatched to any EventTargets useCapture beneath them in the tree. Events which are bubbling upward through the tree will not trigger an EventListener designated to use capture.Example example hereNotes If an EventListener is removed from an EventTarget while it is processing an event, it will not http://www.mozilla.org/docs/dom/domref/dom_el_ref55.html (1 de 2) [09/06/2003 10:16:11] removeEventListener be triggered by the current actions. EventListeners can never be invoked after being removed. Calling removeEventListener with arguments which do not identify any currently registered EventListener on the EventTarget has no effect. See also addEventListener. Specification removeEventListenerNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref55.html (2 de 2) [09/06/2003 10:16:11] replaceChildHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search replaceChild The replaceChild() method replaces one child node on the current element with another. Syntax element.replaceChild(newChild, oldChild)Parameters newChild is a node. oldChild is the existing child node to be replaced.Example <html><head><script language="javascript"> function init(){ d1 = document.getElementById("top"); d2 = document.getElementById("in"); d_new = document.createElement("p"); d1.replaceChild(d_new, d2); alert(d1.childNodes[1].nodeName) }</script></head> http://www.mozilla.org/docs/dom/domref/dom_el_ref56.html (1 de 2) [09/06/2003 10:16:14] replaceChild<body onload="init()"><div id="top" align="left"> <div id="in">in </div> </body></html>Notes extra information Specification replaceChildNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref56.html (2 de 2) [09/06/2003 10:16:14] setAttributeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setAttribute setAttribute adds a new attribute or changes the value of an existing attribute on the current element. Syntax element.setAttribute(name, value)Parameters name is the name of the new attribute as a string. value is the desired value of the new attribute.Example s d = document.getElementById("d1"); d.setAttribute("align", "center");Notes If the attribute named already exists, then the value of that attribute is changed to the value passed in as part of this function. If it does not exist, then a new attribute node is created. Specification setAttribute http://www.mozilla.org/docs/dom/domref/dom_el_ref57.html (1 de 2) [09/06/2003 10:16:16] setAttributeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref57.html (2 de 2) [09/06/2003 10:16:16] setAttributeNSHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setAttributeNS setAttributeNS adds a new attribute or changes the value of an attribute with the given namespace and name. Syntax element.setAttribute(namespace, name, value)Parameters namespace is the namespace of the new attribute as a string. name is the name of the new attribute as a string. value is the desired value of the new attribute.Example This example splits the text in a paragraph element. The new, second child of p2 is the sibling node hat contains the text after the split. data gets the text from the text object. d = document.getElementById("d1"); d.setAttributeNS("http://www.mozilla.org/ns/specialspace","align", "center");Notes http://www.mozilla.org/docs/dom/domref/dom_el_ref58.html (1 de 2) [09/06/2003 10:16:19] setAttributeNSIf the attribute named already exists, then the value of that attribute is changed to the value passed in as part of this function. If it does not exist, then a new attribute node is created. Specification setAttributeNSNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref58.html (2 de 2) [09/06/2003 10:16:19] setAttributeNodeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setAttributeNode setAttributeNode adds a new attribute node to the current element. Syntax replaced_attr = element.setAttributeNode(attribute)Parameters attribute is a node of type Attribute replaced_attr is the replaced attribute node, if any, returned by this functionExample // <div id="one" align="left">one</div>// <div id="two">two</div> d1 = document.getElementById("one"); d2 = document.getElementById("two"); a = d1.getAttributeNode("align"); d2.setAttributeNode(a); alert(d2.attributes[1].value)// returns: `left'Notes If the attribute named already exists on the element, then that attribute is replaced with the new one and the replaced one is returned. http://www.mozilla.org/docs/dom/domref/dom_el_ref59.html (1 de 2) [09/06/2003 10:16:22] setAttributeNodeNote that this function does not the set the value of the new attribute, only creates it on the element. Use setAttribute to set or change the value on an existing node. Specification setAttributeNodeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref59.html (2 de 2) [09/06/2003 10:16:22] setAttributeNodeNSHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search setAttributeNodeNS setAttributeNodeNS adds a new attribute node with the specified namespace and name. Syntax replaced_attr = element.setAttributeNodeNS(namespace, attribute)Parameters namespace is the namespace of the attribute as a string. attribute is a node of type Attribute. replaced_attr is the replaced attribute node, if any, returned by this function.Example // <div id="one" special-align="utterleft">one</div>// <div id="two">two</div> myns = "http://www.mozilla.org/ns/specialspace"; d1 = document.getElementById("one"); d2 = document.getElementById("two"); a = d1.getAttributeNodeNS( myns, "special-align"); d2.setAttributeNodeNS( myns, a); alert(d2.attributes[1].value) http://www.mozilla.org/docs/dom/domref/dom_el_ref60.html (1 de 2) [09/06/2003 10:16:23] setAttributeNodeNS// returns: `utterleft'Notes If the attribute named already exists on the element, then that attribute is replaced with the new one and the replaced one is returned. The corresponding getter method for namespaced attribute nodes is getAttributeNodeNS. Note that this function does not the set the value of the new attribute, only creates it on the element. Use setAttributeNS to set or change the value on an existing node within a particular namespace. Specification setAttributeNodeNSNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref60.html (2 de 2) [09/06/2003 10:16:23] supportsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search supports The supports method tests if this DOM implementation supports a particular feature. Syntax boolean = element.supports(feature[, version])Parameters feature is a string that contains the name of the feature (e.g., "") version is a string containing the version number of the feature.Example if ( document.supports("package", "4.0") ) {// do something that only package 4.0 allows}Notes If version is not supplied, the method returns true is any version of the specified feature is supported. Specification Not part of the specification. Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref61.html (1 de 2) [09/06/2003 10:16:25] supportsCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref61.html (2 de 2) [09/06/2003 10:16:25] onblurHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onblur The onblur property returns the onBlur event handler code, if any, that exists on the current element. Syntax event handling code = element.onblurExample warnFunc = window.onblur;Notes The blur event is raised when an element loses focus. Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref62.html [09/06/2003 10:16:27] onclickHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onclick The onclick property returns the onClick event handler code on the current element. Syntax event handling code = element.onclickExample Perhaps the simplest example of using the onclick DOM property is to retrieve the existing onclick event handler code. The following function sets the event handler code, then gets it and displays it. function pawnClick() { p = document.getElementById("mutable"); p.onclick = "alert('moot!');"; text = p.onclick; alert(text);}Notes The click event is raised when the user clicks on an element. Specification Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_el_ref63.html (1 de 2) [09/06/2003 10:16:32] onclickNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref63.html (2 de 2) [09/06/2003 10:16:32] ondblclickHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search ondblclick The ondblclick property returns the onDblClick event handler code on the current element. Syntax event handling code = element.ondblclickExample // function pawnClick() { i = document.getElementById("img1"); alert(i.ondblclick);}// alerts: function anonymous(event) { movePawn(this) }Notes The dblclick event is raised when a user double-clicks on an element. Specification Not part of specification. Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref64.html (1 de 2) [09/06/2003 10:16:34] ondblclickCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref64.html (2 de 2) [09/06/2003 10:16:34] onfocusHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onfocus The onfocus property returns the onFocus event handler code on the current element. Syntax event handling code = element.onfocusExample None.Notes The focus event is raised when the user sets focus on the given element. Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref65.html [09/06/2003 10:16:36] onkeydownHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onkeydown The onkeydown property returns the onKeyDown event handler code on the current element. Syntax event handling code = element.onkeydownExample None.Notes The keydown event is raised when the user presses a keyboard key. Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref66.html [09/06/2003 10:16:38] onkeypressHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onkeypress The onkeypress property returns the onKeyPress event handler code for the current element. Syntax event handling code = element.onkeypressExample None.Notes The keypress event is raised when the user presses a key on the keyboard. Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref67.html [09/06/2003 10:16:41] onkeyupHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onkeyup The onkeyup property returns the onKeyUp event handler code for the current element. Syntax event handling code = element.onclickExample None.Notes The keyup event is raised when the user releases a key that's been pressed. Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref68.html [09/06/2003 10:16:43] onmousedownHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onmousedown The onmousedown property returns the onMouseDown event handler code on the current element. Syntax event handling code = element.onmousedownExample None.Notes The mousedown event is raised when the user presses the left button button. Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref69.html [09/06/2003 10:16:45] onmousemoveHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onmousemove The onmousemove propety returns the onMouseMove event handler code on the current element. Syntax event handling code = element.onmousemoveExample movement = element.onmousemoveNotes The mousemove event is raised when the user moves the mouse. Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref70.html [09/06/2003 10:16:46] onmouseoutHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onmouseout The onmouseout property returns the onMouseOut event handler code on the current element. Syntax event handling code = element.onmouseoutExample None.Notes The mouseout event is raised when the mouse leaves an element (e.g, when the mouse moves off of an image in the web page, the mouseout event is raised for that image element). Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref71.html [09/06/2003 10:16:48] onmouseoverHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onmouseover The onmouseover property returns the onMouseOver event handler code on the current element. Syntax event handling code = element.onmouseoverExample None.Notes The mouseover event is raised when the user moves the mouse over a particular element. Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref72.html [09/06/2003 10:16:50] onmouseupHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onmouseup The onmouseup property returns the onMouseUp event handler code on the current element. Syntax event handling code = element.onmouseupExample None.Notes The mouseup event is raised when the user releases the left mouse button. Specification Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref73.html [09/06/2003 10:16:51] onresizeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search onresize The onresize property returns the onResize event handler code on the current element. Syntax event handling code = element.onresizeExample // function pawnClick() { i = document.getElementById("img1"); alert(i.onresize);}// alerts: function anonymous(event) { growBoard() }Notes The resize event is raised when the user resizes a resizable element (such as a window). Specification Not part of specification. Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref74.html (1 de 2) [09/06/2003 10:16:53] onresizeCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref74.html (2 de 2) [09/06/2003 10:16:53] DOM window InterfaceHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search DOM window ReferenceThis chapter provides a brief reference for all of the methods, properties, and events available through the DOM window object. The window object represents the window itself. Typically, window contains the document as a child (see DOM Document Reference), provides access to the window.navigator and window.screen objects for manipulating the browsing environment itself, and provides a number of special properties for accessing the object model below it. DOM window Interface The properties, methods, and event handlers of the window object are given here. Properties Returns a reference to the content element in the window._content current window.This property indicates whether the current window is window.closed closed or not.Returns an array of the window.Components components installed in the browser.Returns the XUL controller objects for the current window.controllers chrome window. window.crypto Returns the browser crypto object window.defaultStatus Gets/sets the status bar text for the given window. http://www.mozilla.org/docs/dom/domref/dom_window_ref.html (1 de 8) [09/06/2003 10:16:56] DOM window InterfaceReturns a reference to the directories toolbar in the window.directories current chrome.Returns a reference to the document that the window window.document contains.Returns an array of the subframes in the current window.frames window. window.history Returns a reference to the history object.Gets/sets the height of the content area of the browser window.innerHeight window including the scrollbar, if present.Gets/sets the height of the content area of the browser window.innerWidth window including the scrollbar, if present. window.length Returns the number of frames in the window.Gets/sets the location, or current URL, of the window window.location object.Returns the locationbar object, whose visibility window.locationbar can be toggled in the window.Returns the menubar object, whose visibility can be window.menubar toggled in the window. window.name Gets/sets the name of the window. window.navigator Returns a reference to the navigator object.Returns the internal "code" name of the current window.navigator.appCodeName browser. window.navigator.appName Returns the official name of the browser. window.navigator.appVersion Returns the version of the browser as a string.Returns a boolean indicating whether cookies are window.navigator.cookieEnabled enabled in the browser or not.Returns a string representing the language version of window.navigator.language the browser.Returns a list of the MIME types supported by the window.navigator.mimeTypes browser.Returns a string that represents the current operating window.navigator.oscpu system. http://www.mozilla.org/docs/dom/domref/dom_window_ref.html (2 de 8) [09/06/2003 10:16:56] DOM window InterfaceReturns a string representing the platform of the window.navigator.platform browser. Returns an array of the plugins installed in the window.navigator.plugins browser. Returns the product name of the browser (e.g. window.navigator.product "Gecko") Returns the product version number (e.g. "5.0") window.navigator.productSubReturns the user agent string for the current browser. window.navigator.userAgentReturns the vendor name of the current browser (e.g. window.navigator.vendor "Netscape6") Returns the vendor version number (e.g. "6.1") window.navigator.vendorSubReturns a reference to the window that opened this window.opener current window. Gets/sets the height of the outside of the browser window.outerHeight window. Gets/sets the width of the outside of the browser window.outerWidth window. Gets the amount of content that has been hidden by window.pageXOffset scrolling to the right Gets the amount of content that has been hidden by window.pageYOffset scrolling down. Returns a reference to the parent of the current window.parent window or subframe. http://www.mozilla.org/docs/dom/domref/dom_window_ref.html (3 de 8) [09/06/2003 10:16:56] DOM window InterfaceReturns the personalbar object, whose visibility can window.personalbar be toggled in the window. Returns the pkcs11 object , which can be used to install drivers other software associated with the window.pkcs11 pkcs11 protocol. Returns a reference to the prompt window, if any, window.prompter currently displayed. Returns a reference to the screen object associated window.screen with the window. Specifies the y-coordinate of the first pixel that is not allocated to permanent or semipermanent user window.screen.availHeight interface features. Returns the first available pixel available from the left window.screen.availLeft side of the screen. Specifies the height of the screen, in pixels, minus permanent or semipermanent user interface features window.screen.availTop displayed by the operating system, such as the Taskbar on Windows. Returns the amount of horizontal space in pixels window.screen.availWidth available to the window. Returns the color depth of the screen. window.screen.colorDepthReturns the height of the screen in pixels. window.screen.heightGets/sets the current distance in pixels from the left window.screen.left side of the screen. Getst the bit depth of the screen. window.screen.pixelDepthGets/sets the distance from the top of the screen. window.screen.top http://www.mozilla.org/docs/dom/domref/dom_window_ref.html (4 de 8) [09/06/2003 10:16:56] DOM window InterfaceReturns the width of the screen. window.screen.widthReturns the horizontal distance of the left border of window.screenX the user's browser from the left side of the screen. Returns the vertical distance of the top border of the window.screenY user's browser from the top side of the screen. Returns the scrollbars object, whose visibility can be window.scrollbars toggled in the window. Returns the number of pixels that the document has window.scrollX already been scrolled horizontally. Returns the number of pixels that the document has window.scrollY already been scrolled vertically. Returns an object reference to the window object window.self itself. Returns a reference to the window object of the window.sidebar sidebar. Gets/sets the text in the statusbar at the bottom of the window.status browser. Returns the statusbar object, whose visibility can be window.statusbar toggled in the window. Returns the toolbar object, whose visibility can be window.toolbar toggled in the window. Returns a reference to the topmost window in the window.top window hierarchy. Returns a reference to the current window. window.window http://www.mozilla.org/docs/dom/domref/dom_window_ref.html (5 de 8) [09/06/2003 10:16:56] DOM window Interface Methods window.alert() Displays an alert dialog. window.back() Moves back one in the window history. window.blur() Sets focus away from the window.Registers the window to capture all events of the specified window.captureEvents() type. window.clearInterval() Clears a delay that's been set for a specific function. window.clearTimeout() Clears the delay set by window.setTimeout(). window.close() Closes the current window.Displays a dialog with a message that the user needs to window.confirm() respond to. window.dump() Writes a message to the console. window.escape() Encodes a string. window.focus() Sets focus on the current window. window.forward() Moves the window one document forward in the history. window.GetAttention() Flashes the application icon.Returns the selection object representing the selected window.getSelection() item(s). window.home() Returns the browser to the home page. window.moveBy() Moves the current window by a specified amount. window.moveTo() Moves the window to the specified coordinates. window.open() Opens a new window. window.print() Prints the current document. window.prompt() Returns the text entered by the user in a prompt dialog.Releases the window from trapping events of a specific window.releaseEvents() type. window.resizeBy() Resizes the current window by a certain amount. window.resizeTo() Dynamically resizes window. window.scroll() Scrolls the window to a particular place in the document. http://www.mozilla.org/docs/dom/domref/dom_window_ref.html (6 de 8) [09/06/2003 10:16:56] DOM window Interface window.scrollBy() Scrolls the document in the window by the given amount. window.scrollByLines() Scrolls the document by the given number of lines.Scrolls the current document by the specified number of window.scrollByPages() pages. window.scrollTo() Scrolls to a particular set of coordinates in the document. window.setCursor() Changes the cursor. window.setInterval() Set a delay for a specific function. window.setTimeout() Sets a delay for executing a function. window.sizeToContent() Sizes the window according to its content. window.stop() This method stops window loading.Unencodes a value that has been encoded in hexadecimal window.unescape() (e.g. a cookie). window.updateCommands()Event Handlers window.onabort An event handler property for abort events on the window. window.onblur An event handler property for blur events on the window. window.onchange An event handler property for change events on the window. window.onclick An event handler property for click events on the window. window.onclose An event handler property for handling the window close event.An event handler property for drag and drop events on the window.ondragdrop window. window.onerror An event handler property for errors raised on the window. window.onfocus An event handler property for focus events on the window. window.onkeydown An event handler property for keydown events on the window. window.onkeypress An event handler property for keypress events on the window. window.onkeyup An event handler property for keyup events on the window. window.onload An event handler property for window loading. http://www.mozilla.org/docs/dom/domref/dom_window_ref.html (7 de 8) [09/06/2003 10:16:56] DOM window Interface window.onmousedown An event handler property for mousedown events on the window. window.onmousemove An event handler property for mousemove events on the window. window.onmouseout An event handler property for mouseout events on the window. window.onmouseover An event handler property for mouseover events on the window. window.onmouseup An event handler property for mouseup events on the window. window.onpaint An event handler property for paint events on the window. window.onreset An event handler property for reset events on the window. window.onresize An event handler property for window resizing window.onscroll An event handler property for window scrolling. window.onselect An event handler property for window selection. window.onsubmit An event handler property for submits on window forms window.onunload An event handler property for unload events on the window.Copyright © 1998-2003 The Mozilla Organization Last modified March 11, 2003 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref.html (8 de 8) [09/06/2003 10:16:56] window.captureEvents()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.captureEvents() Registers the window to capture all events of the specified type. Syntax window.captureEvents(Event.eventType)Parameters eventType is a string with one of the following values:Abort LoadBlur MouseDownClick MouseMoveChange MouseOutDblClick MouseOverDragDrop MouseUpError Move http://www.mozilla.org/docs/dom/domref/dom_window_ref6.html (1 de 3) [09/06/2003 10:17:25] window.captureEvents()Focus ResetKeyDown ResizeKeyPress SelectKeyUp SubmitUnloadExample <html><script> function reg() { window.captureEvents(Event.CLICK); window.onclick = hit;} function hit() { alert('hit');}</script><body onload="reg();"><button>test</button><div id="d"> </div></body></html>Notes Events raised in the DOM by user activity (such as clicking buttons or shifting focus away http://www.mozilla.org/docs/dom/domref/dom_window_ref6.html (2 de 3) [09/06/2003 10:17:25] window.captureEvents() from the current document) generally pass through the high-level window and document objects first before arriving at the object that initiated the event. When you call the captureEvents() method on the window, events of the type you specify (for example, Event.CLICK) no longer pass through to "lower" objects in the hierarchy. In order for events to "bubble up" in the way that they normally do, you must call releaseEvents() on the window to keep it from trapping events. Also note that the eventType parameter is case-insensitive, so you can also say, for example, window.releaseEvents(Event.KeyPress). See also window.releaseEvents(). Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref6.html (3 de 3) [09/06/2003 10:17:25] window.clearTimeout()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.clearTimeout() Clears the delay set by window.setTimeout(). Syntax window.clearTimeout(timeoutID)Parameters timeoutID is the ID of the timeout you wish you clear.Example window.clearTimeout(inactive_ID);Notes The ID for the timeout is returned by the window.setTimeout() function. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref8.html (1 de 2) [09/06/2003 10:17:36] window.clearTimeout()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref8.html (2 de 2) [09/06/2003 10:17:36] window.close()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.close() Closes this window. Syntax window.close()Parameters None.Example window.close();Notes None. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref9.html (1 de 2) [09/06/2003 10:17:38] window.close()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref9.html (2 de 2) [09/06/2003 10:17:38] window.closedHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.closed This property indicates whether the current window is closed or not. Syntax bRes = window.closedParameters bRes is a boolean value.Example if ( window.opener.closed ) {// the window that opened me has been closed!}Notes Addtional notes. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref10.html (1 de 2) [09/06/2003 10:17:41] window.closedCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref10.html (2 de 2) [09/06/2003 10:17:41] window.ComponentsHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.Components Returns a reference to the XPCOM components that are installed in Mozilla/Netscape. Syntax componentList = window.ComponentsParameters componentList is a read-only array of XPCOM components accessible via XPConnect.Example // use the Components property to get a particular class// and a related interface var cp = Components.classes['@mozilla.org/preferences;1'] var icp = Components.interfaces.nsIPref;Notes The Components property does not work from HTML and XML pages loaded as content in the browser (i.e., it returns "[object nsXPCComponents]", which can't be further interrogated), since those pages are not typically considered part of the trusted application chrome and content that can use XPConnect. From trusted scripts, however, Components can be used to get and use the XPCOM objects which the browser itself uses for its internal functionality, as in the example above. See the following document for more information about the Components object: ● http://www.mozilla.org/scriptable/components_object.html http://www.mozilla.org/docs/dom/domref/dom_window_ref11.html (1 de 2) [09/06/2003 10:17:43] window.ComponentsSpecification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref11.html (2 de 2) [09/06/2003 10:17:43] window.confirm()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.confirm() Displays a dialog with a message that the user needs to respond to. Syntax result = window.confirm(text)Parameters text is a string. result is a boolean value indicating whether OK or Cancel was selected.Example if ( window.confirm("Want to see my mood ring?")) { window.open("mood.html", "mood ring", "");}Notes http://www.mozilla.org/docs/dom/domref/dom_window_ref12.html (1 de 2) [09/06/2003 10:17:45] window.confirm()Unlike the alert dialog, a confirm dialog has OK and Cancel buttons, and returns true only when the user confirms the choice being presented by clicking OK. The return value of window.confirm() is often tested as part of a conditional block, as in the example above. See also window.alert(), window.prompt() Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref12.html (2 de 2) [09/06/2003 10:17:45] window.controllersHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.controllers Returns the XUL controllers of the chrome window. Syntax controllers = window.controllersParameters controllers is an array of objects of the type XUL Controllers.Example <script> function con() { alert(window.controllers);}</script>// displays: [object XULControllers]Notes None. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref13.html (1 de 2) [09/06/2003 10:17:46] window.controllersNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref13.html (2 de 2) [09/06/2003 10:17:46] window.cryptoHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.crypto Returns the browser crypto object, which can then be used to manipulate various browser security features. Syntax syntax codeParameters blah is a blah.Example // example code hereNotes Addtional notes. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref14.html (1 de 2) [09/06/2003 10:17:48] window.cryptoCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref14.html (2 de 2) [09/06/2003 10:17:48] window.defaultStatusHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.defaultStatus Gets/sets the status bar text for the given window. Syntax sMsg = window.defaultStatus window.defaultStatus = sMsgParameters sMsg is a string containing the text to be displayed by default in the statusbar.Example <html><body onload="window.defaultStatus='hello!';"/><button onclick="window.confirm('Are you sure you want to quit?');">confirm</button></body></htm>Notes To set the status once the window has been opened, use window.status. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref15.html (1 de 2) [09/06/2003 10:17:51] window.defaultStatusNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref15.html (2 de 2) [09/06/2003 10:17:51] window.directoriesHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.directories Returns the window directories toolbar object. Syntax dirBar = window.directoriesParameters dirBar is an object of the type barProp.Example <script> function dirs() { alert(window.directories);}</script>Notes None. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref16.html (1 de 2) [09/06/2003 10:17:53] window.directoriesNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref16.html (2 de 2) [09/06/2003 10:17:53] window.documentHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.document Returns a reference to the document that the window contains. Syntax doc = window.documentParameters doc is an object reference.Example doc= window.document; window.dump(doc.title);// prints the current document's title to the console.Notes None. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref17.html (1 de 2) [09/06/2003 10:17:55] window.documentCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref17.html (2 de 2) [09/06/2003 10:17:55] window.dump()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.dump() Prints messages to the console. Syntax window.dump(text)Parameters text is a string.Example doc= window.document; window.dump(doc.title);// prints the current document's title to the console.Notes If you have no console available, this method prints nothing but doesn't raise an error. window.dump is commonly used to print statements to the console can be used to debug JavaScript used to access the DOM. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref18.html (1 de 2) [09/06/2003 10:17:57] window.dump()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref18.html (2 de 2) [09/06/2003 10:17:57] window.escape()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.escape() Encodes a string. Syntax sEscaped = window.escape(sRegular)Parameters sEscaped is the endoded string. sRegular is a regular stringExample alert(escape("http://www.cnn.com"));// displays: http%3Awww.cnn.comNotes The escape() method converts special characters (any characters that are not regular text or numbers) into hexadecimal characters, which is especially necessary for setting the values of cookies. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref19.html (1 de 2) [09/06/2003 10:17:58] window.escape()Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref19.html (2 de 2) [09/06/2003 10:17:58] window.focus()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.focus() Sets focus on the window. Syntax window.focus()Parameters None.Example if (clicked) { window.focus(); }Notes None. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref20.html (1 de 2) [09/06/2003 10:18:00] window.focus()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref20.html (2 de 2) [09/06/2003 10:18:00] window.forward()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.forward() Moves the window one document forward in the history. Syntax window.forward()Parameters None.Example function goForward() { if ( canGoForward) window.forward();}Notes None. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref21.html (1 de 2) [09/06/2003 10:18:02] window.forward()Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref21.html (2 de 2) [09/06/2003 10:18:02] window.framesHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.frames Returns an array of the subframes in the current window. Syntax frameList = window.framesParameters frameList is an array of frame objects.Example frames = window.frames; for (var i = 0; i < frames.length; i++) {// do something with each subframe as frames[i]}Notes None. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref22.html (1 de 2) [09/06/2003 10:18:04] window.framesNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref22.html (2 de 2) [09/06/2003 10:18:04] Syntax Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.GetAttention() Flashes the application icon to get the user's attention. Syntax window.GetAttention()Parameters None.Example // from Chatzilla function notifyAttention (source){ if (typeof source != "object") source = client.viewsArray[source].source; if (client.currentObject != source){ var tb = getTabForObject (source, true); var vk = Number(tb.getAttribute("viewKey")); tb.setAttribute ("state", "attention"); client.activityList[vk] = "!"; updateTitle();} http://www.mozilla.org/docs/dom/domref/dom_window_ref23.html (1 de 2) [09/06/2003 10:18:07] Syntax if (client.FLASH_WINDOW) window.GetAttention();}Notes On windows and linux, the icon flashes in the system tray. On macintosh, the icon in the upper right corner of the desktop flashes. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref23.html (2 de 2) [09/06/2003 10:18:07] Syntax Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.getSelection() Returns a selection object representing the selected item(s). Syntax selection = window.getSelection()Parameters selection is a selection object.Example function cutThis() { selObj = window.getSelection(); selText = selObj.toSting(); if len(selText) ...Notes The selection object returned by this method is automatically converted to a string as needed. If you asked for the len of selObj in the listing above, for example, the method would return the length of the object converted into a string (using the selection object's own toString() method. But you can also get the ranges in the selection and you can navigate through the selected nodes using these range objects. See the nsISelection interface in mozilla for more information about selection objects and the services they provide for manipulating selections: http://lxr.mozilla.org/seamonkey/source/content/base/public/nsISelection.idl http://www.mozilla.org/docs/dom/domref/dom_window_ref24.html (1 de 2) [09/06/2003 10:18:09] Syntax Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref24.html (2 de 2) [09/06/2003 10:18:09] window.historyHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.history Returns a reference to the history object, which provides an interface for manipulating the browser history. Syntax historyObj = window.historyParameters historyObject is an object reference.Example h = window.history; if ( h.length ) { // if there is a history h.back(); // equivalent to clicking back button}Notes The history object provides the following interface: current back() length forward() http://www.mozilla.org/docs/dom/domref/dom_window_ref25.html (1 de 2) [09/06/2003 10:18:12] window.history next go() previousYou can call access this interface from the window object by calling, for example, window.history.back(). Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref25.html (2 de 2) [09/06/2003 10:18:12] window.home()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.home() Returns the window to the home page. Syntax window.home()Parameters None.Example function goHome() { window.home();}Notes None. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref26.html (1 de 2) [09/06/2003 10:18:15] window.home()Copyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref26.html (2 de 2) [09/06/2003 10:18:15] window.innerHeightHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.innerHeight Gets/sets the height of the content area of the browser window. Syntax var winHeight = window.innerHeightParameters winHeight is the number of pixels as an integer.Example var winHeight = window.innerHeight; window.innerHeight = winHeight;Notes See also window.innerWidth, window.outerHeight. Specification DOM Level 0. Not part of specification.Copyright © 1998-2003 The Mozilla Organization Last modified January 27, 2003 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref27.html [09/06/2003 10:18:17] window.innerWidthHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.innerWidth Gets the height of the content area of the browser window. Syntax var winWidth = window.innerWidthParameters winWidth is the number of pixels as an integer.Example var winWidth = window.innerWidth;Notes See also window.innerHeight, window.outerHeight. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref28.html (1 de 2) [09/06/2003 10:18:19] window.innerWidthCopyright © 1998-2003 The Mozilla Organization Last modified January 24, 2003 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref28.html (2 de 2) [09/06/2003 10:18:19] window.lengthHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.length Returns the number of frames in the window. Syntax ifrms = window.lengthParameters ifrms is the number of frames as an integer.Example if ( window.length )// this is a document with subframesNotes None. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref29.html (1 de 2) [09/06/2003 10:18:20] window.lengthCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref29.html (2 de 2) [09/06/2003 10:18:20] window.locationHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.location Gets/sets the location, or current URL, of the window object. Syntax url = window.location window.location = urlParameters url is a string containing the URL for the specified location.Example function getNews() { window.location= "http://www.cnn.com";}// in html: <button onclick="getNews();">News</button>Notes None. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref30.html (1 de 2) [09/06/2003 10:18:22] window.locationNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref30.html (2 de 2) [09/06/2003 10:18:22] window.locationbarHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.locationbar Returns the locationbar object, whose visibility can be toggled in the window. Syntax lBarObj = window.locationbarParameters lBarObj is an object reference.Example The following complete HTML example shows way that the visible property of the various "bar" objects is used, and also the change to the privileges necessary to write to the visible property of any of the bars on an existing window. <html><head><title>Various DOM Tests</title><script>// changing bar states on the existing window netscape.security.PrivilegeManager. enablePrivilege("UniversalBrowserWrite"); window.locationbar.visible=!window.locationbar.visible;</script></head><body>Various DOM Tests http://www.mozilla.org/docs/dom/domref/dom_window_ref31.html (1 de 2) [09/06/2003 10:18:24] window.locationbar</body></html>Notes When you load the example page above, the browser displays the following dialog: To toggle the visibility of these bars, you must either sign your scripts or enable the appropriate privileges, as in the example above. Also be aware that dynamically updating the visibilty of the various toolbars can change the size of the window rather dramatically, and may affect the layout of your page. See also: window.locationbar, window.menubar, window.personalbar, window.scrollbars, window.statusbar, window.toolbar Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref31.html (2 de 2) [09/06/2003 10:18:24] window.menubarHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.menubar Returns the menubar object, whose visibility can be toggled in the window. Syntax mBarObj = window.menubarParameters mBarObj is an object reference.Example The following complete HTML example shows way that the visible property of the various "bar" objects is used, and also the change to the privileges necessary to write to the visible property of any of the bars on an existing window. <html><head><title>Various DOM Tests</title><script>// changing bar states on the existing window netscape.security.PrivilegeManager. enablePrivilege("UniversalBrowserWrite"); window.menubar.visible=!window.menubar.visible;</script></head><body>Various DOM Tests</body> http://www.mozilla.org/docs/dom/domref/dom_window_ref32.html (1 de 2) [09/06/2003 10:18:26] window.menubar</html>Notes When you load the example page above, the browser displays the following dialog: To toggle the visibility of these bars, you must either sign your scripts or enable the appropriate privileges, as in the example above. Also be aware that dynamically updating the visibilty of the various toolbars can change the size of the window rather dramatically, and may affect the layout of your page. See also: window.locationbar, window.menubar, window.personalbar, window.scrollbars, window.statusbar, window.toolbar Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref32.html (2 de 2) [09/06/2003 10:18:26] window.moveBy()Home | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.moveBy() Moves the current window by a specified amount. Syntax window.moveBy(deltaX, deltaY)Parameters deltaX is the amount of pixels to move the window horizontally. deltaY is the amount of pixels to move the window vertically.Example function budge() { moveBy(10, -10);}Notes You can use negative numbers as parameters for this function. This function makes a relative move while window.moveTo() makes an absolute move. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref33.html (1 de 2) [09/06/2003 10:18:37] window.moveBy()Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref33.html (2 de 2) [09/06/2003 10:18:37] http://www.mozilla.org/docs/dom/domref/dom_window_ref34.htmlHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.moveTo() Moves the window to the specified coordinates. Syntax window.moveTo(x, y)Parameters x is the horizontal coordinate to be moved to. y is the vertical coordinate to be moved to.Example function origin() {// moves to top left corner of screen window.moveTo(0, 0) }Notes This function moves the window absolutely while window.moveBy() moves the window relative to its current location. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_window_ref34.html (1 de 2) [09/06/2003 10:18:40] http://www.mozilla.org/docs/dom/domref/dom_window_ref34.htmlNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref34.html (2 de 2) [09/06/2003 10:18:40] window.nameHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search window.name Gets/sets the name of the window. Syntax sName = window.name window.name = sNameParameters name is a string.Example window.name = "lab_view";Notes The name of the window is used primarily for setting targets for hyperlinks and forms. Windows do not need to have names. See also window.name. Specification DOM Level 0. Not part of specification.Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_window_ref35.html (1 de 2) [09/06/2003 10:18:42] window.nameCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_window_ref35.html (2 de 2) [09/06/2003 10:18:42] http://www.mozilla.org/docs/dom/domref/dom_el_ref.htmlHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search DOM Element ReferenceThis chapter provides a brief reference for all of the methods, properties, and events available to all HTML and XML elements in the Netscape 6 DOM. These DOM interfaces cross the various specification levels, but tend to concentrate on the published DOM Level 2 HTML recommendation. Each member includes a link to the appropriate place in the W3C DOM specifications. DOM Elements Interface In this case, Elements refers to the interface that all HTML and XML elements have available to them from the DOM. There are more specialized interfaces for particular objects-the BODY element, for example, has extra functions and properties you can use, as do tables. This chapter refers to the interface that all elements share. Properties attributes Returns an array of the attributes on the element. childNodes Returns an array of the child nodes on the element. className Gets/sets the class of the element. dir Gets/sets the directionality of the element. firstChild Returns the first direct child of the current node. id Gets/sets the id of the current element. innerHTML innerHTML returns all of the markup and content within a given element. lang Specifies the base language of an element's attribute values and text content. lastChild Returns the last child of the current node. http://www.mozilla.org/docs/dom/domref/dom_el_ref.html (1 de 4) [09/06/2003 10:19:12] http://www.mozilla.org/docs/dom/domref/dom_el_ref.html length Returns the number of items in a list (e.g. childNodes). localName localName returns the local part of the qualified name of this node. namespaceURI The namespace URI of this node, or NULL if it is unspecified. nextSibling Returns the node immediately following the current one in the tree. nodeName Returns the name of the current node. nodeType Returns the type of the current node. nodeValue Returns the value of the current node. offsetHeight offsetHeight gets the number of pixels that the current element is offset within the offsetParent node offsetLeft gets/sets the number of pixels that the current element is offset to the left within the offsetLeft offsetParent node. offsetParent returns a reference to the object in which the current element is offset (i.e., the parent offsetParent element). offsetTop offsetTop returns the position of the current element relative to the top of the offsetParent node. offsetWidth offsetWidth gets the number of pixels that the current element is offset within the offsetParent node. ownerDocument Returns the document in which this node appears. parentNode Returns the parent node of the current node. prefix prefix returns the namespace prefix of the current node, or NULL if it is unspecified. previousSibling Returns the node immediately previous to the current one in the tree. style style returns the block of style rules on the current element. tabIndex Gets/sets the position of the element in the tabbing order. tagName tagName returns the name of the element. title title returns the title of the document.Methods addEventListener addEventListener allows the registration of event listeners on the event target.The appendChild method inserts the specified node into the list of nodes on the current appendChild document. blur The blur method removes keyboard focus from the current element. click The click method excecutes a click on the current element. cloneNode The cloneNode method returns a duplicate of the current node.The dispatchEvent method allows the dispatch of events into the implementation's event dispatchEvent model. focus focus sets focus on the current element. http://www.mozilla.org/docs/dom/domref/dom_el_ref.html (2 de 4) [09/06/2003 10:19:12] http://www.mozilla.org/docs/dom/domref/dom_el_ref.html getAttribute getAttribute returns the value of the named attribute on the current node. getAttributeNS getAttributeNS returns the value of the attribute with the given name and namespace. getAttributeNode Returns the attribute of the current element as a separate node. getElementsByTagName Returns the elements of a particular name that are children of the current element. hasAttribute returns a boolean value indicating whether the current element has the hasAttribute specified attribute or not. hasAttribute is a boolean value indicating whether the current element has an attribute with hasAttributeNS the specified name and namespace. hasChildNodes is a boolean value indicating whether the current element has children or hasChildNodes not. insertBefore The insertBefore method allows you to insert a node before the current element in the DOM. item The item method retrieves a node from the tree by index.The normalize method puts the current node and all of its subtree into a "normalized" form normalize (see below). removeAttribute The removeAttribute() method removes an attribute from the current element. removeAttributeNode removeAttributeNode removes the specified attribute from the current element. removeChild The removeChild() method removes a child node from the current element. removeEventListener removeEventListener() allows the removal of event listeners from the event target. replaceChild The replaceChild() method replaces one child node on the current element with another. setAttribute adds a new attribute or changes the value of an existing attribute on the current setAttribute element. setAttributeNS adds a new attribute or changes the value of an attribute with the given setAttributeNS namespace and name. setAttributeNode setAttributeNode adds a new attribute node to the current element. supports The supports method tests if this DOM implementation supports a particular feature.Event Handlers These element properties cannot be assigned to in the way that the event handlers on the document and window objects can. All of the folllowing event handler properties are read- only, and are made to return the event handling code, if any, that has already been added to the element in the HTML or XML itself. onblur Returns the event handling code for the blur event. onclick Returns the event handling code for the click event. ondblclick Returns the event handling code for the dblclick event. onfocus Returns the event handling code for the focus event. http://www.mozilla.org/docs/dom/domref/dom_el_ref.html (3 de 4) [09/06/2003 10:19:12] http://www.mozilla.org/docs/dom/domref/dom_el_ref.html onkeydown Returns the event handling code for the keydown event. onkeypress Returns the event handling code for the keypress event. onkeyup Returns the event handling code for the keyup event. onmousedown Returns the event handling code for the mousedown event. onmousemove Returns the event handling code for the mousemove event. onmouseout Returns the event handling code for the mouseout event. onmouseover Returns the event handling code for the mouseover event. onmouseup Returns the event handling code for the mouseup event. onresize Returns the event handling code for the resize event.Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref.html (4 de 4) [09/06/2003 10:19:12] attributesHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search attributes Returns an array of attributes on the given element Syntax attributes = elementNode.attributesParameters The attributes parameter returned by this property is a NamedNodeMap of attribute nodes.Example // get the first element in the document para = document.getElementsByTag("p")[0]; atts = para.attributes;Notes The array returned by this property is a NamedNodeMap, a list of objects rather than strings. The name and value of the attribute objects are accessible as separate properties, as in the following complete example, which retrieves the name/value pair of the first attribute of the "p1" paragraph in the document: http://www.mozilla.org/docs/dom/domref/dom_el_ref2.html (1 de 2) [09/06/2003 10:19:20] attributes<html><head><script> function showA() { p = document.getElementById("p1"); t = document.getElementById("t"); t.setAttribute("value", p.attributes[0].name + "->" + p.attributes[0].value);}</script></head>Sample Paragraph<form><input type="button" value="show" onclick="showA()" /><input id="t" type="text" value="" /></form></html>Specification attributesNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref2.html (2 de 2) [09/06/2003 10:19:20] childNodesHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search childNodes Returns an array of child nodes on the given element node. Syntax nodeList = elementNode.childNodesParameters nodeList is a list of elements that are children of the current element.Example // table is an object reference to a table element kids = table.childNodes; for (var i = 0; i < kids.length; i++) {// do something with each kid as kids[i]}Notes The document object itself has only a single child, and that is the HTML element. Note again that the items in the array are objects and not strings. To get data from those objects you must use their properties (e.g. childNode[2].nodeName to get the name, etc.) Specification childNodes http://www.mozilla.org/docs/dom/domref/dom_el_ref3.html (1 de 2) [09/06/2003 10:19:22] childNodesNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref3.html (2 de 2) [09/06/2003 10:19:22] classNameHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search className This property gets/sets the class of the current element Syntax name = element.className element.className = nameParameters name is a string representing the class of the current element.Example el = document.getElementById("div1"); if (el.className == "fixed") {// skip a particular class of element goNextElement(); }Notes The name className is used for this property instead of "class" because of conflicts with the "class" keyword in many languages which use the DOM. Specification className http://www.mozilla.org/docs/dom/domref/dom_el_ref4.html (1 de 2) [09/06/2003 10:19:24] classNameNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref4.html (2 de 2) [09/06/2003 10:19:24] dirHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search dir The dir property specifies the directionality of the text of the current element. Syntax directionality = element.dir element.dir = directionalityParameters directionality is a string representing the direction of the current element text. See Notes below for a list of the valid directions.Example p = document.getElementById("para1"); p.dir = "rtl"; // change text direction on this Notes The directionality of element text is which direction that text goes (for support of different language systems). Possible values for dir are ltr, for Left-to-right, and rtl, for Right-toleft. Specification dir http://www.mozilla.org/docs/dom/domref/dom_el_ref5.html (1 de 2) [09/06/2003 10:19:26] dirNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref5.html (2 de 2) [09/06/2003 10:19:26] firstChildHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search firstChild firstChild returns the first child element of the current element Syntax element = element.firstChildParameters The element parameter returned is a node of type element.Example trow = document.getElementById("row1"); left_cell = trow.firstChild;Notes Returns NULL if the current node is childless. Specification firstChildNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref6.html (1 de 2) [09/06/2003 10:19:28] firstChildCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref6.html (2 de 2) [09/06/2003 10:19:28] idHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search id The id property uniquely identifies the current element. Syntax id_str = element.id element.id = id_strParameters id_str is a string representing the id of the current element.Example if element.id != "main_loop" goBack();Notes There is no more central property to the domain of web development than id. The ID of an element is what is most often used to retrieve it (i.e., with getElementById), and it allows the various nodes in a document to be manipulated independently of one another. In HTML and in XUL, the id is defined as an attribute on the element like so: <td id="table-cell2" />If you plan to use the DOM with your web pages, it's a good idea to give as many of your elements id attributes as is necessary. Note that the id element is also frequently used to associated style rules with individual markup elements. http://www.mozilla.org/docs/dom/domref/dom_el_ref7.html (1 de 2) [09/06/2003 10:19:29] idSpecification idNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref7.html (2 de 2) [09/06/2003 10:19:29] innerHTMLHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search innerHTML innerHTML returns all of the markup and content within a given element. Syntax HTML = element.innerHTMLParameters HTML is a string that contains the current element and its content (including child elements) as raw HTMLExample // HTML:// <div id="d">Content// Further Elaborated// </div> d = document.getElementById("d"); dump(d.innerHTML);// the string "ContentFurther Elaborated"// is dumped to the console windowNotes Though not actually a part of the DOM spec, this property gives the web developer enormous flexibility over the contents of a web page. Consider the following example, where a script sets the blah blah.. http://www.mozilla.org/docs/dom/domref/dom_el_ref8.html (1 de 2) [09/06/2003 10:19:31] innerHTML// nuther example You can get the HTML and text contained within any element-including BODY or HTML- and parse it yourself or blah blah. You can also set this property, which means that you can control the contents of the document by adding to or subtracting from the innerHTML. This third example gives you an idea about how evil this can be when it falls into the wrong hands. // third example Note that when you append to the innerHTML of a document, you have essentially created a new document. The session history for the browser is incremented, and when you go Back, the document is there in its original, unappended state. Specification DOM Level 0. Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref8.html (2 de 2) [09/06/2003 10:19:31] langHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search lang This property specifies the base language of an element's attribute values and text content. Syntax language = element.lang element.lang = languageParameters language is a string that represents the language in which the text of the current element is written.Example // this snippet checks that the base language blah blah if ( document.lang != "en" ) { document.location = "other_lang_top.html";}Notes The language code returned by this property is defined in RFC 1766. Common examples include "en" for English, "ja" for Japanese, "sp" for Spanish, and so on. The default value of this attribute is unknown. Note that this property, though valid at the individual element level described here, is most often used for the BODY or for the document itself. Specification http://www.mozilla.org/docs/dom/domref/dom_el_ref9.html (1 de 2) [09/06/2003 10:19:33] lang langNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref9.html (2 de 2) [09/06/2003 10:19:33] lastChildHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search lastChild lastChild returns the last child of the current element. Syntax last_child = element.lastChildParameters last_child is the final element node in the nodeList of children on the current element.Example tr = document.getElementById("row1"); corner_td = tr.lastChild;Notes Returns NULL if there are no child elements. Specification lastChildNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref10.html (1 de 2) [09/06/2003 10:19:35] lastChildCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref10.html (2 de 2) [09/06/2003 10:19:35] lengthHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search length length returns the number of items in a list. Syntax no_of_items = nodeList.lengthParameters no_of_items is an integer value representing the number of items in a list.Example // all the paragraphs in the document items = document.getElementsByTagName("p");// are there any at all? if ( items.length ) {// for each item in the list,// append the entire element as a string of HTML for (var i = 0; i < items.length; i++) { gross += items[0].innerHTML;// gross is now all the HTML for the paragraphs}}Notes length is a very common property in DOM programming. It's very common to test the length http://www.mozilla.org/docs/dom/domref/dom_el_ref11.html (1 de 2) [09/06/2003 10:19:36] length of a list (to see if it exists at all) and to use it as the iterator in a for loop, as in the example above. Specification lengthNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref11.html (2 de 2) [09/06/2003 10:19:36] localNameHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search localName localName returns the local part of the qualified name of this node. Syntax name = element.localNameParameters name is the local name as a string.Example // qualifiedName = "XXXYYY" d = document.getElementById("div1"); text_field = document.getElementById("t"); text_field.setAttribute("value", d.localName);// text_field reads "YYY"Notes For nodes of any type other than ELEMENT_NODE and ATTRIBUTE_NODE and nodes created with a DOM Level 1 method, such as createElement on the document object, this is always NULL. The localname of a node is that part of the node's qualified name that comes after the colon. Qualified names are typically used in XML as part of the namespace(s) of the particular XML documents. For example, in the qualified name "ecomm:partners," "partners" is the localname and ecomm is the prefix: http://www.mozilla.org/docs/dom/domref/dom_el_ref12.html (1 de 2) [09/06/2003 10:19:38] localName<ecomm:business id="soda_shop" type="brick_n_mortar"><ecomm:partners><ecomm:partner id="1001">Tony's Syrup Warehouse</ecomm:partner></ecomm:partner></ecomm:business>The prefix-in this case, "ecomm"-defines the namespace in which the localname can be used. See Also namespaceURI Specification localNameNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref12.html (2 de 2) [09/06/2003 10:19:38] namespaceURIHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search namespaceURI The namespace URI of this node, or NULL if it is unspecified. Syntax namespace = element.namespaceURIParameters namespace is a string that represents the namespace URI of the current node.Example In this snippet, a node is being examined for its localName and its namespaceURI. If the namespaceURI matches a variable in which the namespace for the XUL namespace is defined, then the node is understood to be a <browser /> widget from XUL. if (node.localName == "browser" && node.namespaceURI == kXULNSURI) {// <a href="/tags/XUL/" rel="tag">xul</a> browser this.viewee = node.webNavigation.document;...}Notes This is not a computed value that is the result of a namespace lookup based on an examination of the namespace declarations in scope. It is merely the namespace URI given at creation time. http://www.mozilla.org/docs/dom/domref/dom_el_ref13.html (1 de 2) [09/06/2003 10:19:40] namespaceURI For nodes of any type other than ELEMENT_NODE and ATTRIBUTE_NODE and nodes created with a DOM Level 1 method, such as createElement from the Document interface, this is always NULL. Per the Namespaces in XML Specification, an attribute does not inherit its namespace from the element it is attached to. If an attribute is not explicitly given a namespace, it simply has no namespace. Specification nameSpaceURINetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref13.html (2 de 2) [09/06/2003 10:19:40] nextSiblingHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search nextSibling Returns the node immediately following the current one in the tree. Syntax next_element = element.nextSiblingParameters next_element is the element node directly after the current element in the list of siblings (i.e., the list of children for the parentNode).Example // in a table, the cells are siblings cell1 = document.getElementById("td1"); cell2 = cell1.nextSibling;Notes Returns NULL if there are no more nodes. Specification nextSiblingNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref14.html (1 de 2) [09/06/2003 10:19:42] nextSiblingCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref14.html (2 de 2) [09/06/2003 10:19:42] nodeNameHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search nodeName Returns the name of the current node as a string. Syntax name = element.nodeNameParameters name is a string representing the name of the currrent element.Example div1 = document.getElementById("d1"); text_field = document.getElementById("t"); text_field.setAttribute("value", div1.nodeName);// textfield reads "div" nowNotes None. Specification nodeNameNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref15.html (1 de 2) [09/06/2003 10:19:44] nodeNameCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref15.html (2 de 2) [09/06/2003 10:19:44] nodeTypeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search nodeType Returns a code representing the type of the underlying node Syntax code = document.nodeTypeParameters code is an unsigned short with one of the following values:ELEMENT_NODE = 1;ATTRIBUTE_NODE = 2;TEXT_NODE = 3;CDATA_SECTION_NODE = 4;ENTITY_REFERENCE_NODE = 5;ENTITY_NODE = 6;PROCESSING_INSTRUCTION_NODE = 7;COMMENT_NODE = 8;DOCUMENT_NODE = 9;DOCUMENT_TYPE_NODE = 10;DOCUMENT_FRAGMENT_NODE = 11;NOTATION_NODE = 12;Example http://www.mozilla.org/docs/dom/domref/dom_el_ref16.html (1 de 2) [09/06/2003 10:19:46] nodeType if document.nodeType != 9 document.close() else document.write("I'm a doc!");Notes None. Specification nodeTypeNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref16.html (2 de 2) [09/06/2003 10:19:46] nodeValueHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search nodeValue Returns the value of the current node. Syntax value = document.nodeValueParameters value is a string containing the value of the current node, if any.Example None.Notes For the document itself, nodeValue returns NULL. For text, comment, and CDATA nodes, nodeValue returns the content of the node. For attribute nodes, the value of the attribute is returned. The following table shows the return values for different elements: Attr value of attributeCDATASection content of the CDATA SectionComment content of the commentDocument nullDocumentFragment nullDocumentType nullElement null http://www.mozilla.org/docs/dom/domref/dom_el_ref17.html (1 de 2) [09/06/2003 10:19:48] nodeValueNamedNodeMap nullEntityReference null Notation null ProcessingInstruction entire content excluding the targetText content of the text nodeWhen nodeValue is defined to be NULL, setting it has no effect. Specification nodeValueNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref17.html (2 de 2) [09/06/2003 10:19:48] offsetHeightHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search offsetHeight offsetHeight gets the number of pixels that the current element is offset within the offsetParent node. Syntax height = element.offsetHeightParameters height is an integer representing the offset in pixels.Example color_table = document.getElementById("t1"); tOffset = color_table.offsetHeight; if ( tOffset > 5 ) {// large offset: do something here}Notes None. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_el_ref18.html (1 de 2) [09/06/2003 10:19:50] offsetHeightNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref18.html (2 de 2) [09/06/2003 10:19:50] offsetLeftHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search offsetLeft Gets/sets the number of pixels that the current element is offset to the left within the offsetParent node. Syntax left = element.offsetLeftParameters left is an integer representing the offset to the left in pixels.Example color_table = document.getElementById("t1"); tOLeft = color_table.offsetLeft; if ( tOLeft > 5 ) {// large left offset: do something here}Notes None. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_el_ref19.html (1 de 2) [09/06/2003 10:19:52] offsetLeftNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref19.html (2 de 2) [09/06/2003 10:19:52] offsetParentHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search offsetParent offsetParent returns a reference to the object which is the closest (nearest in the containment hierarchy) positioned containing element. If the element is non-positioned, the root element (html in standards compliant mode; body in quirks rendering mode) is the offsetParent. Syntax parentObj = element.offsetParentParameters parentObj is an object reference to the element in which the current element is offset.Example example hereNotes extra information Specification DOM Level 0. Not part of specification. Netscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref20.html [09/06/2003 10:20:00] offsetTopHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search offsetTop offsetTop returns the position of the current element relative to the top of the offsetParent node. Syntax topPos = element.offsetTopParameters topPos is the number of pixels from the top of the parent element.Example d = document.getElementById("div1"); topPos = d.offsetTop; if (topPos > 10 ) {// object it offset less// than 10 pixels in its parent}Notes None. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_el_ref21.html (1 de 2) [09/06/2003 10:20:11] offsetTopNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref21.html (2 de 2) [09/06/2003 10:20:11] offsetWidthHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search offsetWidth offsetWidth gets the number of pixels that the current element is offset within the offsetParent node. Syntax width = element.offsetWidthParameters width is an integer representing the offset in pixels.Example color_table = document.getElementById("t1"); tOffset = color_table.offsetWidth; if ( tOffset > 5 ) {// large offset: do something here}Notes None. Specification DOM Level 0. Not part of specification. http://www.mozilla.org/docs/dom/domref/dom_el_ref22.html (1 de 2) [09/06/2003 10:20:17] offsetWidthNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref22.html (2 de 2) [09/06/2003 10:20:17] ownerDocumentHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search ownerDocument The ownerDocument property returns the top-level document object for this node. Syntax document = element.ownerDocumentParameters document is the document object parent of the current element.Example // given a node "p", get the top-level HTML child// of the document object d = p.ownerDocument; htm = p.documentElement;Notes The document object returned by this property is the main object with which all the child nodes in the actual HTML document are created. If this property is used on a node that is itself a document, the result is NULL. Specification ownerDocument http://www.mozilla.org/docs/dom/domref/dom_el_ref23.html (1 de 2) [09/06/2003 10:20:19] ownerDocumentNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref23.html (2 de 2) [09/06/2003 10:20:19] parentNodeHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search parentNode The parentNode property returns the parent of the current element. Syntax pElement = element.parentNodeParameters pElement is the element parent of the current node.Example text_field = document.getElementById("t"); if ( div1.parentNode == document ){ text_field.setAttribute("value", "top-level");// textfield displays text "top-level"}Notes extra information Specification parentNode Netscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref24.html (1 de 2) [09/06/2003 10:20:21] parentNodeCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref24.html (2 de 2) [09/06/2003 10:20:21] prefixHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search prefix prefix returns the namespace prefix of the current node, or NULL if it is unspecified. Syntax pre = element.prefix element.prefix = preParameters pre is the namespace prefix as a string.Example example hereNotes extra information Specification prefixNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref25.html (1 de 2) [09/06/2003 10:20:23] prefix http://www.mozilla.org/docs/dom/domref/dom_el_ref25.html (2 de 2) [09/06/2003 10:20:23] previousSiblingHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search previousSibling Returns the node immediately previous to the current one in the tree. Syntax pNode = elementNode.previousSiblingParameters pNode is the node prior to this one in the ordered list.Example n1 = n2.previousSibling;Notes Returns NULL if there are no more nodes. Specification previousSiblingNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref26.html (1 de 2) [09/06/2003 10:20:25] previousSiblingCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref26.html (2 de 2) [09/06/2003 10:20:25] styleHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search style style returns the block of style rules on the current element. Syntax styleBlock = element.style ( element.style.styleAttr = value )Parameters styleBlock is a string containing theExample div = document.getElementById("div1); div.style.marginTop = ".25in";Notes style is a very commonly used property in DOM programming. You can use it to get the style rules associated with a particular element, and though you cannot set style on an element by assigning to the style property directly, you can use the style property to get to the writable style attributes on the node, as in the short example above. See the DOM CSS Properties List for a list of the CSS properties that are accessible from the Gecko DOM. There are some additional notes there about the use of the style property to style elements in the DOM. Specification http://www.mozilla.org/docs/dom/domref/dom_el_ref27.html (1 de 2) [09/06/2003 10:20:27] style styleNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref27.html (2 de 2) [09/06/2003 10:20:27] tabIndexHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search tabIndex Gets/sets the tab order of the current element. Syntax element.tabIndex = iIndexParameters iIndex is a numberExample b1 = document.getElementById("button1"); b1.tabIndex = 1;Notes None. Specification tabIndexNetscape Communications http://developer.netscape.com http://www.mozilla.org/docs/dom/domref/dom_el_ref28.html (1 de 2) [09/06/2003 10:20:29] tabIndexCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref28.html (2 de 2) [09/06/2003 10:20:29] tagNameHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search tagName tagName returns the name of the element. Syntax elementName = element.tagNameParameters elementName is a string containing the name of the current element.Example <paragraph id="p001">When I was born...</paragraph> p = document.getElementById("p001");// p.tagName returns "paragraph"Notes In XML, tagName preserves case. In HTML, tagName returns the element name in the canonical uppercase form. The value of tagName is the same as that of nodeName. Specification tagName http://www.mozilla.org/docs/dom/domref/dom_el_ref29.html (1 de 2) [09/06/2003 10:20:32] tagNameNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref29.html (2 de 2) [09/06/2003 10:20:32] titleHome | Projects | Docs | Jargon Bugzilla | LXR | Tree Status | Checkins Feedback | FAQ | Search title title returns the title of the document. Syntax sTitle = document.titleParameters sTitle is a string that contains the title of the current document.Example <html><title>Hello World!</title><body>...// document.title returns "Hello World!"Notes None. Specification title http://www.mozilla.org/docs/dom/domref/dom_el_ref30.html (1 de 2) [09/06/2003 10:20:37] titleNetscape Communications http://developer.netscape.comCopyright © 1998-2003 The Mozilla Organization Last modified December 11, 2002 Document History Edit this Page (or via CVS) http://www.mozilla.org/docs/dom/domref/dom_el_ref30.html (2 de 2) [09/06/2003 10:20:37] </div> </article> </div> </div> </div> <script type="text/javascript" async crossorigin="anonymous" src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8519364510543070"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.1/jquery.min.js" crossorigin="anonymous" referrerpolicy="no-referrer"></script> <script> var docId = '007783e0ff29e99afd5a248ab3856b50'; var endPage = 1; var totalPage = 858; var pfLoading = false; window.addEventListener('scroll', function () { if (pfLoading) return; var $now = $('.article-imgview .pf').eq(endPage - 1); if (document.documentElement.scrollTop + $(window).height() > $now.offset().top) { pfLoading = true; endPage++; if (endPage > totalPage) return; var imgEle = new Image(); var imgsrc = "//data.docslib.org/img/007783e0ff29e99afd5a248ab3856b50-" + endPage + (endPage > 3 ? ".jpg" : ".webp"); imgEle.src = imgsrc; var $imgLoad = $('<div class="pf" id="pf' + endPage + '"><img src="/loading.gif"></div>'); $('.article-imgview').append($imgLoad); imgEle.addEventListener('load', function () { $imgLoad.find('img').attr('src', imgsrc); pfLoading = false }); if (endPage < 7) { adcall('pf' + endPage); } } }, { passive: true }); </script> <script> var sc_project = 11552861; var sc_invisible = 1; var sc_security = "b956b151"; </script> <script src="https://www.statcounter.com/counter/counter.js" async></script> </html>