nav element | nav object (Windows)

This topic has not yet been rated - Rate this topic

Represents a section of a document that contains navigation links to other documents or to locations within the document.

HTML information

Closing Tag	required
CSS Display	block

DOM Information

Inheritance Hierarchy

Node

Element

nav

Members

The nav object has these types of members:

Methods
Properties

Methods

The nav object has these methods.

Method	Description
appendChild	Appends an element as a child to the object.
applyElement	Makes the element either a child or parent of another element.
blur	Causes the element to lose focus and fires the onblur event.
clearAttributes	Removes all attributes and values from the object.
click	Simulates a click by causing the onclick event to fire.
cloneNode	Copies a reference to the object from the document hierarchy.
componentFromPoint	Returns the component located at the specified coordinates via certain events.
contains	Checks whether the given element is contained within the object.
getAttributeNodeNS	Gets an attribute object that matches the specified namespace and name.
getAttributeNS	Gets the value of the specified attribute within the specified namespace.
getElementsByClassName	Gets a collection of objects that are based on the value of the class attribute.
getElementsByTagNameNS	Gets a collection of objects that are based on the specified element names within a specified namespace.
hasAttribute	Determines whether an attribute with the specified name exists.
hasAttributeNS	Determines whether an attribute that has the specified namespace and name exists.
hasAttributes	Determines whether one or more attributes exist for the object.
insertAdjacentHTML	Inserts the given HTML text into the element at the location.
insertAdjacentText	Inserts the given text into the element at the specified location.
msMatchesSelector	Determines whether an object matches the specified selector.
normalize	Merges adjacent DOM objects to produce a normalized document object model.
removeAttributeNS	Removes the specified attribute from the object.
removeNode	Removes the object from the document hierarchy.
replaceAdjacentText	Replaces the text adjacent to the element.
replaceNode	Replaces the object with another element.
setActive	Sets the object as active without setting focus to the object.
setAttributeNodeNS	Sets an attribute object as part of the object.
setAttributeNS	Sets the value of the specified attribute within the specified namespace.
setCapture	Sets the mouse capture to the object that belongs to the current document.
swapNode	Exchanges the location of two objects in the document hierarchy.

Properties

The nav object has these properties.

Property	Description
accessKey	Sets or retrieves the access key for the object.
attributes	Retrieves a collection of attributes of the object.
canHaveChildren	Gets a value indicating whether the object can contain child objects.
className	Sets or retrieves the class of the object.
constructor	Returns a reference to the constructor of an object.
innerHTML	Sets or retrieves the HTML between the start and end tags of the object.
innerText	Sets or retrieves the text between the start and end tags of the object.
isContentEditable	Gets the value that indicates whether the user can edit the contents of the object.
isDisabled	Gets the value that indicates whether the user can interact with the object.
isTextEdit	Retrieves whether a TextRange object can be created using the object.
lang	Sets or retrieves the language to use.
offsetHeight	Retrieves the height of the object relative to the layout or coordinate parent, as specified by the offsetParent property.
offsetParent	Retrieves a reference to the container object that defines the offsetTop and offsetLeft properties of the object.
offsetWidth	Retrieves the width of the object relative to the layout or coordinate parent, as specified by the offsetParent property.
outerHTML	Sets or retrieves the object and its content in HTML.
outerText	Sets or retrieves the text of the object.
parentElement	Retrieves the parent object in the object hierarchy.
parentTextEdit	Retrieves the container object in the document hierarchy that can be used to create a TextRange containing the original object.
role	Sets or retrieves the role for this element.
sourceIndex	Retrieves the ordinal position of the object, in source order, as the object appears in the document's all collection.
tagName	Retrieves the tag name of the object.
title	Sets or retrieves advisory information (a ToolTip) for the object.
uniqueNumber	Retrieves the element's unique number.

Standards information

There are no standards that apply here.

Remarks

The nav element is only supported for webpages displayed in a Windows Store app using JavaScript. For more information, see Defining Document Compatibility.

Not all groups of links on a document need to be in a nav element, only sections that consist of major navigation blocks. In particular, it is common for footer elements to have a short list of links to various documents of a site, such as the terms of service, home, and copyright. The footer element alone is sufficient for such cases, and does not require a nav element.

Note Some devices and applications (such as screen readers) might use the nav element as a way to determine what content on the document to initially skip or provide on request.

Examples

The following example uses the nav element to indicate that a list contains site navigation links.


  <nav>
   <h1>Site Navigation</h1>
   <ul>
    <li><a href="index.html">Home</a></li>
    <li><a href="gallery.html">Photos</a></li>
    <li><a href="news.html">Updates</a></li>
   </ul>
  </nav>

nav element | nav object