YUI Library Home

YUI Library Examples: Menu Family: Grouped Menu Items With Titles From JavaScript

Menu Family: Grouped Menu Items With Titles From JavaScript

This example demonstrates how to title groups of MenuItem instances.

Note: By default clicking outside of a Menu instance will hide it. Additionally, MenuItem instances without a submenu or a URL to navigate to will hide their parent Menu instance when clicked. Click the "Show Menu" button below to make the Menu instance visible if it is hidden.

View example in new window.

Creating a Menu from JavaScript with items organized into groups with titles

To create a Menu with no pre-existing markup on the page, call the Menu constructor (YAHOO.widget.Menu) passing the id of the Menu element to be created as the first argument.

Add items to a Menu instance via the addItem, insertItem, or addItems methods.

Items can be organized into groups by creating a multi-dimensional array of YAHOO.widget.MenuItem configuration properties and passing it to the addItems method. Add a title to each group via the setItemGroupTitle method.

Finally, it is necessary to call the render method passing the id of, or reference to the element the Menu should be appended to.

1/*
2    Instantiate a Menu:  The first argument passed to the constructor
3    is the id for the Menu element to be created, the second is an 
4    object literal of configuration properties.
5*/ 
6 
7var oMenu = new YAHOO.widget.Menu("menuwithgroups", { fixedcenter: true }); 
8 
9 
10/*
11    Add items to the Menu instance by passing an array of object literals 
12    (each of which represents a set of YAHOO.widget.MenuItem 
13    configuration properties) to the "addItems" method.
14*/ 
15 
16oMenu.addItems([ 
17 
18    [ 
19        { text: "Yahoo! Mail", url: "http://mail.yahoo.com" }, 
20        { text: "Yahoo! Address Book", url: "http://addressbook.yahoo.com" }, 
21        { text: "Yahoo! Calendar", url: "http://calendar.yahoo.com" }, 
22        { text: "Yahoo! Notepad", url: "http://notepad.yahoo.com" } 
23    ], 
24 
25    [ 
26 
27        { text: "Yahoo! Local", url: "http://local.yahoo.com" }, 
28        { text: "Yahoo! Maps", url: "http://maps.yahoo.com" }, 
29        { text: "Yahoo! Travel", url: "http://travel.yahoo.com" }, 
30        { text: "Yahoo! Shopping", url: "http://shopping.yahoo.com" }  
31     
32    ], 
33 
34    [ 
35 
36        { text: "Yahoo! Messenger", url: "http://messenger.yahoo.com" }, 
37        { text: "Yahoo! 360", url: "http://360.yahoo.com" }, 
38        { text: "Yahoo! Groups", url: "http://groups.yahoo.com" }, 
39        { text: "Flickr Photo Sharing", url: "http://www.flickr.com" } 
40     
41    ] 
42 
43]); 
44 
45 
46// Add the title for each group of menu items 
47 
48oMenu.setItemGroupTitle("Yahoo! PIM", 0); 
49oMenu.setItemGroupTitle("Yahoo! Search", 1); 
50oMenu.setItemGroupTitle("Yahoo! Communications", 2); 
51 
52 
53/*
54    Since this Menu instance is built completely from script, call the 
55    "render" method passing in the DOM element that it should be 
56    appended to.
57*/ 
58 
59oMenu.render("rendertarget"); 
view plain | print | ?

Configuration for This Example

You can load the necessary JavaScript and CSS for this example from Yahoo's servers. Click here to load the YUI Dependency Configurator with all of this example's dependencies preconfigured.

Menu Family Examples:

More Menu Family Resources:

Copyright © 2009 Yahoo! Inc. All rights reserved.

Privacy Policy - Terms of Service - Copyright Policy - Job Openings