Web SDK documentation
  1. Classes
  2. NavigatorNode

File

core/navigator/navigator-node.ts

Description

Base navigator node. Represents a single entry in the navigator menu. Is considered to be the basic building block of the navigator.

Index

Properties
Methods
Accessors

Properties

Optional breadcrumb
Type : string

The breadcrumb of the node, displaying the "path", but supports multiple levels. e.g. (Groups > Level 1 > Level 2)
children
Type : NavigatorNode[]
Default value : []

Navigator node children (subentries).
confirm
Type : PopoverConfirmComponent
Default value : undefined

Confirmation popover displayed at the end of the process of moving the navigator menu item.
draggable
Type : boolean
Default value : false

Indicates that the navigator node is draggable.
dragged
Default value : false

Indicates that the navigator node is dragged.
draggedHover
Default value : false

Indicates that currently something is dragged over the node.
droppable
Type : boolean
Default value : false

Indicates that the navigator node is droppable.
hidden
Type : boolean
Default value : false

Indicates that the navigator node is visible/hidden.
icon
Type : string

Navigator node icon.
Optional iconComponent
Type : Type<any>

Custom icon component.
iconOpen
Type : string

Navigator node icon when expanded.
Optional iconTemplate
Type : TemplateRef<any>

Custom icon template.
label

Label to be displayed in the navigator node.
Optional loading
Type : boolean

Loading state indicator.
Static NAME
Type : string
Default value : 'NavigatorNode'
open
Type : boolean
Default value : false

Indicates that the navigator node is expanded/collapsed.
parents
Type : NavigatorNode[]
Default value : []

Navigator node parent nodes.
path
Type : string

The path to which the UI will be redirected after clicking the navigator node.
routerLinkExact
Type : boolean
Default value : true

Indicates whether the navigator node should be active based on matching the node path and the URL path. To match the URL exactly, set this option to true.

routerLinkExact set to true: When the URL path is set to /a/b/c and the node path to /a/b then the node will not be set active.

routerLinkExact set to false: When the URL path is set to /a/b/c and the node path to /a/b then the node will be set active.

Methods

add
add(node: NavigatorNode)

Adds a child navigator node to the node.

Parameters :
Name Type Optional Description
node NavigatorNode No

Child node.
Returns : void
Protected countChildren
countChildren()

Counts the amount of children nodes.

Returns : any
dragEnd
dragEnd($event)

This event is fired when a drag operation has ended.

Parameters :
Name Optional Description
$event No

DOM event.
Returns : void
dragEnter
dragEnter($event)

This event is fired when a dragged element enters a valid drop target.

Parameters :
Name Optional Description
$event No

DOM event.
Returns : void
dragLeave
dragLeave($event)

This event is fired when a dragged element leaves a valid drop target.

Parameters :
Name Optional Description
$event No

DOM event.
Returns : void
dragStart
dragStart($event)

This event is fired when the user starts dragging an element.

Parameters :
Name Optional Description
$event No

DOM event.
Returns : void
drop
drop($event)

This event is fired when an element is dropped on a valid drop target.

Parameters :
Name Optional Description
$event No

DOM event.
Returns : void
empty
empty()

Removes children nodes.

Returns : void
expand
expand()

Expands the navigator node if it is collapsed.

Returns : void
find
find(predicate)

Returns a child navigator node based on the predicate.

// The function will compare the labels to the string and return a matching result.
// The capitalization of the characters does not matter (case insensitive).
const predicate = 'group1';
const childNode = parentNode.find(predicate);

// Check: [lodash matches](https://lodash.com/docs/4.17.15#matches)
const predicate = { label: 'group2' };
const childNode = parentNode.find(predicate);
Parameters :
Name Optional Description
predicate No

Filter criteria.
Example : 
<div><pre class="line-numbers"><code class="language-ts">// The function will compare the labels to the string and return a matching result.
// The capitalization of the characters does not matter (case insensitive).
const predicate = &#39;group1&#39;;
const childNode = parentNode.find(predicate);

// Check: [lodash matches](https://lodash.com/docs/4.17.15#matches)
const predicate = { label: &#39;group2&#39; };
const childNode = parentNode.find(predicate);</code></pre></div>
Returns : any
Protected hasChildDevices
hasChildDevices()
Returns : boolean
remove
remove(node: NavigatorNode)

Removes the child navigator node from the node.

Parameters :
Name Type Optional Description
node NavigatorNode No

Child node.
Returns : void
Protected sort
sort()

Sorts the children of the navigator node, by priority and name (ASC). The higher the priority, the higher the position in the hierarchy. For the same priority values, the alphabetical order will take precedence.

Returns : void
Protected toString
toString()

Identifies itself.

Returns : string
traverse
traverse(callback)

Performs a callback function recursively on each of the navigator node's children down the hierarchy.

const expandChild = (childNode) => childNode.expand();
parentNode.traverse(expandChild);
Parameters :
Name Optional Description
callback No

Function to be called.
Example : 
<div><pre class="line-numbers"><code class="language-ts">const expandChild = (childNode) =&gt; childNode.expand();
parentNode.traverse(expandChild);</code></pre></div>
Returns : void
update
update(data?: NavigatorNodeData)

Updates the navigator node.

Parameters :
Name Type Optional Description
data NavigatorNodeData Yes

Data to be updated.
Returns : void
Protected updateChildren
updateChildren()

Updates the navigator node by sorting its children and also checking their visibility.

Returns : void
Protected updateHidden
updateHidden()

Checks if the navigator node should be hidden based on the visibility of its child nodes.

Returns : void

Accessors

hasChildren
gethasChildren()

Returns information whether a navigator node has children.
id
getid()

Returns the ID of the navigator node.
priority
getpriority()

Returns the priority value of the navigator node.
setpriority(priority)

Sets the priority value of the navigator node.

Parameters :
Name Optional Description
priority No

Priority value.
Returns : void
canDrop
getcanDrop()

Returns information whether the navigator node is droppable.
canNavigate
getcanNavigate()

Returns information whether navigation is possible.

results matching ""

    No results matching ""