Share via


SP.NavigationNode object

Represents the URL to a specific navigation node and provides access to properties and methods for manipulating the ordering of the navigation node in a navigation node collection.

Applies to: apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

var object = new SP.NavigationNode()

Members

The NavigationNode object has the following members.

Constructor

The NavigationNode object has the following constructor.

Constructor

Description

NavigationNode

Initializes a new instance of the SP.NavigationNode object.

Methods

The NavigationNode object has the following methods.

Method

Description

deleteObject

Deletes the navigation node.

initPropertiesFromJson

update

Updates property changes that have been made to the navigation node.

Properties

The NavigationNode object has the following properties.

Property

Description

children

Gets the collection of child nodes of the navigation node.

id

Gets a value that specifies the identifier for the navigation node.

isDocLib

isExternal

isVisible

title

Gets or sets value that specifies the anchor text for the navigation node link.

url

Gets or sets a value that specifies the URL stored with the navigation node.

Example

The following example creates an input button on an application page that adds a node to the Quick Launch area of the current Web site and displays the current Quick Launch nodes.

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<script type="text/ecmascript" language="ecmascript">

    var quickLaunchNodeCollection = null;
    var nnci = null;
    function runCode() {

        var clientContext = new SP.ClientContext.get_current();

        if (clientContext != undefined && clientContext != null) {
            var web = clientContext.get_web();

            // Get the Quick Launch navigation node collection.
            this.quickLaunchNodeCollection = web.get_navigation().get_quickLaunch();

            // Set properties for a new navigation node.
            this.nnci = new SP.NavigationNodeCreationInformation();
            nnci.set_title('MyNode');
            nnci.set_url('https://localhost');
            // Create node as the last node in the collection.
            nnci.set_asLastNode(true);
            this.quickLaunchNodeCollection.add(nnci);

            clientContext.load(this.quickLaunchNodeCollection);
            clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));
        }
    }

    function onQuerySucceeded() {
        var nodeInfo = '';
        var nodeEnumerator = this.quickLaunchNodeCollection.getEnumerator();
        while (nodeEnumerator.moveNext()) {
            var node = nodeEnumerator.get_current();
            nodeInfo += node.get_title() + '\n';
        }
        alert("Current nodes: \n\n" + nodeInfo);
    }

    function onQueryFailed(sender, args) {
        alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
    }

</script>

    <input id="Button1" type="button" value="Run Code" onclick="runCode()" />

</asp:Content>