Yahoo! Developer Network Home - Help

YDN Site Search

# YUI Library Examples: Menu Family: MenuItem Configuration Properties

# Menu Family: MenuItem Configuration Properties

This example demonstrates how to set configuration properties when instantiating a MenuItem instance.

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

View example in new window.

## Setting MenuItem configuration properties

A MenuItem has a number of configuration properties that affect its behavior and visual rendering. Any of these configuration properties can be set when adding an item to its parent Menu instance by defining them in an object that is passed to the Menu's `addItem`, `insertItem`, or `addItems` methods. This example ulitizes the following configuration properties: text, selected, disabled, helptext, url, emphasis, strongemphasis, and checked.

/* Instantiate the menu. The first argument passed to the constructor is the id of the DOM element to be created for the menu; the second is an object literal representing a set of configuration properties for the menu. */ var oMenu = new YAHOO.widget.Menu("basicmenu", { fixedcenter: true } ); /* Add items to the menu by passing an array of object literals (each of which represents a set of YAHOO.widget.MenuItem configuration properties) to the "addItems" method. */ oMenu.addItems([ { text: "Selected MenuItem", selected: true }, { text: "Disabled MenuItem", disabled: true }, { text: "MenuItem With Help Text", helptext: "Help Me!" }, { text: "MenuItem With A URL", url: "http://www.yahoo.com!" }, { text: "MenuItem With Emphasis", emphasis: true }, { text: "MenuItem With Strong Emphasis", strongemphasis: true }, { text: "Checked MenuItem", checked: true } ]); /* Since this menu is built completely from script, call the "render" method passing in the id of the DOM element that the menu's root element should be appended to. */ oMenu.render("rendertarget");

### Menu Family Examples:

- Basic Menu From Markup
- Basic Menu From JavaScript
- Grouped Menu Items Using Markup
- Grouped Menu Items Using JavaScript
- Grouped Menu Items With Titles From Markup
- Grouped Menu Items With Titles From JavaScript
- Multi-tiered Menu From Markup
- Multi-tiered Menu From JavaScript
- Handling Menu Click Events
- Listening For Menu Events
- MenuItem Configuration Properties
- Setting Menu Configuration Properties At Runtime
- Website Left Nav With Submenus Built From Markup
- Website Left Nav With Submenus From JavaScript
- Website Top Nav With Submenus Built From Markup
- Website Top Nav With Submenus From JavaScript
- Website Left Nav Using Animation With Submenus Built From Markup
- Website Left Nav Using Animation With Submenus From JavaScript
- Website Top Nav Using Animation With Submenus Built From Markup
- Website Top Nav Using Animation With Submenus From JavaScript
- Context Menu
- Adding A Context Menu To A Table
- Adding A Context Menu To A TreeView
- OS-Style Programs Menu
- Application Menubar
- Context Menu Integration (included with examples for DataTable Control (beta))
- Menu Buttons (included with examples for Button Control (beta))
- Split Buttons (included with examples for Button Control (beta))

### More Menu Family Resources:

- User's Guide (external)
- API Documentation
- Cheat Sheet PDF (external)

Copyright © 2007 Yahoo! Inc. All rights reserved.

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