<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Example: Menu Button Top Nav</title>
<link rel="stylesheet" href="http://fonts.googleapis.com/css?family=PT+Sans:400,700,400italic,700italic">
<link rel="stylesheet" href="../../build/cssgrids/cssgrids-min.css">
<link rel="stylesheet" href="../assets/css/main.css">
<link rel="stylesheet" href="../assets/vendor/prettify/prettify-min.css">
<link rel="shortcut icon" type="image/png" href="../assets/favicon.png">
<script src="../../build/yui/yui-min.js"></script>
</head>
<body>
<!--
<a href="https://github.com/yui/yui3"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub"></a>
-->
<div id="doc">
<div id="hd">
<h1><img src="http://yuilibrary.com/img/yui-logo.png"></h1>
</div>
<h1>Example: Menu Button Top Nav</h1>
<div class="yui3-g">
<div class="yui3-u-3-4">
<div id="main">
<div class="content"><div class="intro">
<p>
This example demonstrates how to create a traditional, two-column page layout (<a href="../cssgrids/index.html">using Grids</a>) with top navigation rendered like menu buttons.
</p>
</div>
<div class="example newwindow">
<a href="node-menunav-3-example.html" target="_blank" class="button">
View Example in New Window
</a>
</div>
<h2>Setting Up the HTML</h2>
<p>
Begin by including the <a href="../cssgrids/index.html#dependencies">CSS Grids dependencies</a> and grid
markup (this example uses a 2 column version of the
<a href="../cssgrids/cssgrids-fluid.html">Fluid Page Template</a> with a 160px left column).
Add the markup for the menu to the left column of the grid.
</p>
<p>
<strong>Note:</strong> be sure to add the <code>yui3-skin-sam</code> classname to the
page's <code><body></code> element or to a parent element of the widget in order to apply
the default CSS skin. See <a href="http://yuilibrary.com/yui/docs/tutorials/skins/">Understanding Skinning</a>.
</p>
<pre class="code prettyprint"><body class="yui3-skin-sam"> <!-- You need this skin class --></pre>
<p>
The root menu of menus built using the MenuNav Node Plugin can have a verical or horizontal
orientation. The default orientation for menus is vertical, but can be easily switched to
horizontal by applying a class of <code>yui3-menu-horizontal</code> to the node representing the
root menu's bounding box, as illustrated below:
</p>
<pre class="code prettyprint"><div id="productsandservices" class="yui3-menu yui3-menu-horizontal"><!-- Bounding box -->
<div class="yui3-menu-content"><!-- Content box -->
<ul>
<!-- Menu items -->
</ul>
</div>
</div></pre>
<p>
To render each menu label in the horizontal menu as a menu button, add the class
<code>yui3-menubuttonnav</code> to the node representing the root menu's bounding box, as
illustrated below:
</p>
<pre class="code prettyprint"><div id="menu-1" class="yui3-menu yui3-menu-horizontal yui3-menubuttonnav"><!-- Bounding box -->
<div class="yui3-menu-content"><!-- Content box -->
<ul>
<!-- Menu items -->
</ul>
</div>
</div></pre>
<p>
Next, wrap the text node of each menu label of the root menu in an
<code><em></code> element:
</p>
<pre class="code prettyprint"><div id="menu-1" class="yui3-menu yui3-menu-horizontal yui3-menubuttonnav"><!-- Bounding box -->
<div class="yui3-menu-content"><!-- Content box -->
<ul>
<li>
<a class="yui3-menu-label" href="#submenu-1"><em>Submenu Label</em></a>
<div id="submenu-1" class="yui3-menu">
<div class="yui3-menu-content">
<!-- submenu content -->
</div>
</div>
</li>
</ul>
</div>
</div></pre>
<h2>Initializing the Menu</h2>
<p>
With the menu markup in place, retrieve the Node instance representing the root
menu (<code><div id="productsandservices"></code>) and call the
<a href="http://yuilibrary.com/yui/docs/api/classes/Node.html#method_plug"><code>plug</code></a>
passing in a reference to the MenuNav Node Plugin.
</p>
<pre class="code prettyprint">// Call the "use" method, passing in "node-menunav". This will load the
// script and CSS for the MenuNav Node Plugin and all of the required
// dependencies.
YUI().use('node-menunav', function(Y) {
// Retrieve the Node instance representing the root menu
// (<div id="productsandservices">) and call the "plug" method
// passing in a reference to the MenuNav Node Plugin.
var menu = Y.one("#productsandservices");
menu.plug(Y.Plugin.NodeMenuNav);
});</pre>
<p>
<em>Note:</em> In keeping with the
<a href="http://developer.yahoo.com/performance/">Exceptional Performance</a>
team's recommendation, the script block used to instantiate the menu will be
<a href="http://developer.yahoo.com/performance/rules.html#js_bottom">placed at the bottom of the page</a>.
This not only improves performance, it helps ensure that the DOM subtree of the
element representing the root menu
(<code><div id="productsandservices"></code>) is ready to be scripted.
</p>
</div>
</div>
</div>
<div class="yui3-u-1-4">
<div class="sidebar">
<div class="sidebox">
<div class="hd">
<h2 class="no-toc">Examples</h2>
</div>
<div class="bd">
<ul class="examples">
<li data-description="Creating left navigation using the MenuNav Node Plugin.">
<a href="menunav-leftnav.html">Basic Left Nav</a>
</li>
<li data-description="Creating top navigation using the MenuNav Node Plugin">
<a href="node-menunav-2.html">Basic Top Nav</a>
</li>
<li data-description="Creating menu button navigation using the MenuNav Node Plugin">
<a href="node-menunav-3.html">Menu Button Top Nav</a>
</li>
<li data-description="Creating split button navigation using the MenuNav Node Plugin">
<a href="node-menunav-4.html">Split Button Top Nav</a>
</li>
<li data-description="Adding shadows to submenus of a left nav using the MenuNav Node Plugin">
<a href="node-menunav-5.html">Left Nav with Submenus with Shadows</a>
</li>
<li data-description="Adding rounded corners to submenus of a left nav using the MenuNav Node Plugin">
<a href="node-menunav-6.html">Left Nav With Submenus With Rounded Corners</a>
</li>
<li data-description="Skining a menu built using the MenuNav Node Plugin to look like the menus on Flickr">
<a href="node-menunav-7.html">Skinning Menus Created Using the MenuNav Node Plugin</a>
</li>
</ul>
</div>
</div>
</div>
</div>
</div>
</div>
<script src="../assets/vendor/prettify/prettify-min.js"></script>
<script>prettyPrint();</script>
<script>
YUI.Env.Tests = {
examples: [],
project: '../assets',
assets: '../assets/node-menunav',
name: 'node-menunav-3',
title: 'Menu Button Top Nav',
newWindow: 'true',
auto: false
};
YUI.Env.Tests.examples.push('menunav-leftnav');
YUI.Env.Tests.examples.push('node-menunav-2');
YUI.Env.Tests.examples.push('node-menunav-3');
YUI.Env.Tests.examples.push('node-menunav-4');
YUI.Env.Tests.examples.push('node-menunav-5');
YUI.Env.Tests.examples.push('node-menunav-6');
YUI.Env.Tests.examples.push('node-menunav-7');
</script>
<script src="../assets/yui/test-runner.js"></script>
</body>
</html>