YUI Library Examples: TreeView Control: TreeView with Tooltips

Adding Tooltips to the TreeView Control

This examples builds on our simple example. Tooltips are added to the nodes by utilizing the technique described in the Container Family example, One Tooltip, Many Context Elements.

The only additions beyond the stock tree required to get tooltips to work is:

Add a 'title' attribute to each TextNode. This attribute will be used for the node's tooltip.
Save the label element id of each node in an array that can be provided to the Tooltip constructor.

// Global variable to allow console inspection of tree:
var tree;

// Anonymous function wraps the remainder of the logic:
(function() {

var tt, contextElements = [];

// Function to initialize the tree:
    function treeInit() {
        buildRandomTextNodeTree();

// Instantiate the single tooltip passing in the list of all of
        // the node label element ids
        tt = new YAHOO.widget.Tooltip("tt", { 
                    context: contextElements 
                });
    }
    
	//Function  creates the tree and 
	//builds between 3 and 7 children of the root node:
    function buildRandomTextNodeTree() {
	
		// Instantiate the tree:
        tree = new YAHOO.widget.TreeView("treeDiv1");

for (var i = 0; i < Math.floor((Math.random()*4) + 3); i++) {
            var o = {
                label: "label-" + i,
                // Tooltip will use the title attribute
                title: "This is " + "label-" + i
            };

var tmpNode = new YAHOO.widget.TextNode(o, tree.getRoot(), false);

// Generate the markup for this node when the tree is first
            // rendered.  This is necessary in order to make sure tooltips
            // can be attached to hidden nodes.
            tmpNode.renderHidden = true;

// Save the element id for Tooltip
            contextElements.push(tmpNode.labelElId);

buildLargeBranch(tmpNode);
        }

// Expand and collapse happen prior to the actual expand/collapse,
       // and can be used to cancel the operation
       tree.subscribe("expand", function(node) {
              YAHOO.log(node.index + " was expanded", "info", "example");
              // return false; // return false to cancel the expand
           });

tree.subscribe("collapse", function(node) {
              YAHOO.log(node.index + " was collapsed", "info", "example");
           });

// Trees with TextNodes will fire an event for when the label is clicked:
       tree.subscribe("labelClick", function(node) {
              YAHOO.log(node.index + " label was clicked", "info", "example");
           });

// The tree is not created in the DOM until this method is called:
        tree.render();
    }

// Function builds 10 children for the node you pass in:
    function buildLargeBranch(node) {
        if (node.depth < 10) {
            YAHOO.log("buildRandomTextBranch: " + node.index, "info", "example");
            for ( var i = 0; i < 10; i++ ) {

var o = {
                    label: node.label + "-" + i,

// Tooltip will use the title attribute
                    title: "This is " + node.label + "-" + i
                };

var tmpNode = new YAHOO.widget.TextNode(o, node, false);

// Save the element id for Tooltip
                contextElements.push(tmpNode.labelElId);
            }
        }
    }

// Add an onDOMReady handler to build the tree when the document is ready
    YAHOO.util.Event.onDOMReady(treeInit);

})();

</script>

YUI Logger Output:

Note: Logging and debugging is currently turned off for this example.

Reload with logging
and debugging enabled.

TreeView Control Examples:

More TreeView Control Resources:

All YUI 2.x users should review the YUI 2.8.2 security bulletin, which discusses a vulnerability present in YUI 2.4.0-2.8.1.