src/cm/media/js/lib/yui/yui_3.0.0b1/examples/node-menunav/node-menunav-5.html
changeset 0 40c8f766c9b8
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cm/media/js/lib/yui/yui_3.0.0b1/examples/node-menunav/node-menunav-5.html	Mon Nov 23 15:14:29 2009 +0100
@@ -0,0 +1,276 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+	<title>YUI Library Examples: MenuNav Node Plugin: Left Nav With Submenus With Shadows</title>
+    <meta http-equiv="content-type" content="text/html; charset=utf-8">
+    	<link rel="stylesheet" type="text/css" href="../../assets/yui.css" >
+
+<style>
+    /*Supplemental CSS for the YUI distribution*/
+    #custom-doc { width: 95%; min-width: 950px; }
+    #pagetitle {background-image: url(../../assets/bg_hd.gif);}
+/*    #pagetitle h1 {background-image: url(../../assets/title_h_bg.gif);}*/
+</style>
+
+<link rel="stylesheet" type="text/css" href="../../assets/dpSyntaxHighlighter.css">
+
+<!--there is no custom header content for this example-->
+
+<link type="text/css" rel="stylesheet" href="../../build/cssfonts/fonts-min.css" />
+<script type="text/javascript" src="../../build/yui/yui-min.js"></script>
+
+</head>
+<body id="yahoo-com" class=" yui-skin-sam">
+<div id="custom-doc" class="yui-t2">
+<div id="hd">
+	<div id="ygunav">
+		<p>
+            <em>
+                <a href="http://developer.yahoo.com/yui/3/">YUI 3.x Home</a> <i> - </i>	
+            </em>
+		</p>
+		<form action="http://search.yahoo.com/search" id="sitesearchform">
+            <input name="vs" type="hidden" value="developer.yahoo.com">
+            <input name="vs" type="hidden" value="yuiblog.com">
+		    <div id="sitesearch">
+		    	<label for="searchinput">Site Search (YDN &amp; YUIBlog): </label>
+			    <input type="text" id="searchinput" name="p">
+			    <input type="submit" value="Search" id="searchsubmit" class="ygbt">
+		    </div>
+		</form>
+    </div>
+	<div id="ygma"><a href="../../"><img src="../../assets/logo.gif"  border="0" width="200" height="93"></a></div>
+	<div id="pagetitle"><h1>YUI Library Examples: MenuNav Node Plugin: Left Nav With Submenus With Shadows</h1></div>
+</div>
+<div id="bd">
+
+	<div id="bar-note"><p><strong>Note:</strong> This is YUI 3.x. Looking for <a href="http://developer.yahoo.com/yui/">YUI 2.x</a>?</p></div>
+
+	<div id="yui-main">
+		<div class="yui-b">
+		  <div class="yui-ge">
+			  <div class="yui-u first example" id="main">
+
+	<h2>MenuNav Node Plugin: Left Nav With Submenus With Shadows</h2>
+
+	<div id="example" class="promo">
+	<p>
+	<p>
+This example demonstrates how to add shadows to submenus of a menu built using the MenuNav Node
+Plugin.
+</p>
+	</p>	
+
+	<div class="module example-container  newWindow">
+			<div id="example-canvas" class="bd">
+
+		<p class="newWindowButton yui-skin-sam">
+        <span id="newWindowLink">
+            <span class="first-child">
+                <a href="node-menunav-5_source.html" target="_blank">View example in new window.</a>
+            </span>
+        </span>	
+    </p>
+	
+		
+		</div>
+	</div>			
+	</div>
+		
+	<h3>Creating the Shadow HTML</h3>
+<p>
+One way to add shadows to submenus is to append decorator elements to the node representing a 
+submenu's bounding box.  As the name implies, decorator elements add no semantic value to the 
+markup, but enable additional styles to be applied.  When adding any decorator elements to create 
+effects like shadows or rounded corners, always add those elements via JavaScript, since it is only 
+when JavaScript is enabled that a menu's markup is transformed in a drop-down menu system via the 
+MenuNav Node Plugin.
+</p>
+
+<p>
+Each shadow will be represented in HTML as a single <code>&#60;div&#62;</code> element with a class
+of <code>yui-menu-shadow</code> applied, and can easily be created by passing a string of HTML
+to Node's <a href="../../api/Node.html#method_create"><code>create</code></a> method.  Use the 
+<a href="../../api/Node.html#method_queryAll"><code>queryAll</code></a> method to 
+retrieve Node instances for each submenu, and the 
+<a href="../../api/Node.html#method_appendChild"><code>appendChild</code></a> method to add the 
+shadow to each submenu.
+</p>
+
+<textarea name="code" class="JScript" cols="60" rows="1">
+//	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({base:"../../build/", timeout: 10000}).use("node-menunav", function(Y) {
+
+	//	Retrieve the Node instance representing the root menu
+	//	(<div id="productsandservices">)
+
+	var menu = Y.Node.get("#productsandservices");
+
+
+	//	Use the "queryAll" method to retrieve the 
+	//	Node instances representing each submenu.
+
+	menu.queryAll(".yui-menu").each(function (node) {
+	
+		// Append a shadow element to the bounding box of each submenu
+
+		node.appendChild(Y.Node.create('<div class="yui-menu-shadow"></div>'));
+	
+	});
+
+
+	//	Call the "plug" method of the Node instance, passing in a reference to the
+	//	MenuNav Node Plugin.
+
+	menu.plug(Y.Plugin.NodeMenuNav);
+
+});
+</textarea>
+<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>&#60;div id="productsandservices"&#62;</code>) is ready to be scripted.
+</p>
+
+<h3>Styling the Shadow HTML</h3>
+<p>
+With the shadow element appended to each submenu, the next step is to define the style for the 
+shadow.  The shadows in this example will be 12% alpha transparent black, and offset from the left, 
+bottom, and right edges of each submenu's content box by 3px.  To create this effect, start by 
+setting the <code>position</code> property to <code>absolute</code> and the <code>z-index</code> 
+property to <code>-1</code>.  This will position each submenu's shadow behind its content box.  For 
+the 12% alpha transparent black color, set the <code>background-color</code> to <code>#000</code> 
+and <code>opacity</code> property to <code>.12</code>. 
+</p>
+
+<p>
+Next, set the both the <code>width</code> and <code>height</code> properties to <code>100%</code> 
+so that the dimensions of the <code>shadow</code> match that of each submenu's bounding box.  
+(<em>Note:</em>  Setting the <code>height</code> property to <code>100%</code> won't work in IE 6 
+Strict Mode unless the element's parent element has a height defined.  For this reason the the 
+MenuNav Node Plugin automatically sets the <code>width</code> and <code>height</code> properties of 
+each submenu's bounding box to the values of its <code>offsetWidth</code> and 
+<code>offsetHeight</code> properties before it is made visible.)
+</p>
+
+<p>
+To create the three-sided effect for the shadow, set the <code>padding</code> property to 
+<code>1px 3px 0 3px</code>.  As the CSS Box Model specifies that the value for padding is used to 
+calculate the total width of of an element, the addition of the padding to the shadow makes the 
+rendered width of the shadow 6px wider (100% + 6px) and 1px taller (100% + 1px) than that of each 
+submenu's bounding box.  Finally, setting the <code>top</code> property to <code>2px</code> and
+the <code>left</code> property to <code>-3px</code> will position the shadow so that its offset 
+from the left, bottom, and right edge of each submenu's content box by 3px.
+</p>
+
+<textarea name="code" class="CSS" cols="60" rows="1">
+.yui-menu-shadow {
+
+	position: absolute;
+	z-index: -1;		
+	top: 2px;
+	left: -3px;
+	
+	background-color: #000;
+	opacity: .12;
+	filter: alpha(opacity=12);	/*	For IE since it doesn't implement the CSS3 
+									"opacity" property. */
+
+	padding: 1px 3px 0 3px;
+	width: 100%;
+	height: 100%;
+
+}
+</textarea>
+
+<p>
+Lastly, it is necessary to modify the position and dimensions of the <code>&#60;iframe&#62;</code> 
+shim, otherwise <code>&#60;select&#62;</code> elements will poke through each submenu's shadow in 
+IE 6.  Start by setting the <code>z-index</code> property to <code>-2</code> so that the 
+<code>&#60;iframe&#62;</code> shim is behind the shadow element.  Next, set the <code>padding</code>
+property to <code>3px 3px 0 3px</code>.  The core CSS file for MenuNav already sets the 
+<code>height</code> and <code>width</code> properties to <code>100%</code>, so the addition of the 
+padding will result in the calculated width and height of the <code>&#60;iframe&#62;</code> shim 
+being 100% + 6px and 100% + 3px respectively &#151; enough to shim the shadow.  Lastly, setting the 
+<code>left</code> property to <code>-1</code> syncs the left edge of the 
+<code>&#60;iframe&#62;</code> with that of the shadow.
+</p>
+
+<textarea name="code" class="CSS" cols="60" rows="1">
+#productsandservices .yui-menu .yui-shim {
+
+	z-index: -2;	/* Place the iframe shim behind the shadow element */
+
+	/*
+		Adjust the dimensions of the <iframe> shim to match the shadow, 
+		otherwise <select> elements will poke through the shadow.
+	*/
+
+	left: -3px;
+	padding: 3px 3px 0 3px;
+
+}
+</textarea>				</div>
+				<div class="yui-u sidebar">
+					
+				
+					<div id="examples" class="mod box4">
+                        <div class="hd">
+						<h4>
+    MenuNav Node Plugin Examples:</h4>
+                        </div>
+						<div class="bd">
+							<ul>
+								<li><a href='../node-menunav/node-menunav-1.html'>Basic Left Nav</a></li><li><a href='../node-menunav/node-menunav-2.html'>Basic Top Nav</a></li><li><a href='../node-menunav/node-menunav-3.html'>Menu Button Top Nav</a></li><li><a href='../node-menunav/node-menunav-4.html'>Split Button Top Nav</a></li><li class='selected'><a href='../node-menunav/node-menunav-5.html'>Left Nav With Submenus With Shadows</a></li><li><a href='../node-menunav/node-menunav-6.html'>Left Nav With Submenus With Rounded Corners</a></li><li><a href='../node-menunav/node-menunav-7.html'>Skinning Menus Created Using the MenuNav Node Plugin</a></li><li><a href='../node-menunav/node-menunav-8.html'>Adding Submenus On The Fly</a></li>							</ul>
+						</div>
+					</div>
+					
+					<div class="mod box4">
+                        <div class="hd">
+						<h4>More MenuNav Node Plugin Resources:</h4>
+                        </div>
+                        <div class="bd">
+						<ul>
+							<!-- <li><a href="http://developer.yahoo.com/yui/node-menunav/">User's Guide</a> (external)</li> -->
+						<li><a href="../../api/module_node-menunav.html">API Documentation</a></li>
+</ul>
+                        </div>
+					</div>
+			  </div>
+		</div>
+		
+		</div>
+	</div>
+
+
+<div class="yui-b toc3" id="tocWrapper">
+<!-- TABLE OF CONTENTS -->
+<div id="toc">
+	
+<ul>
+<li class="sect first">YUI 3.x Project</li><li class="item"><a title="The Yahoo! User Interface (YUI) Library, 3.x Branch, " href="http://developer.yahoo.com/yui/3/">YUI 3 Web Site (external)</a></li><li class="item"><a title="Examples of every YUI utility and control in action" href="../../examples/">YUI 3 Examples</a></li><li class="item"><a title="Instantly searchable API documentation for the entire YUI library." href="../../api/">YUI 3 API Docs</a></li><li class="item"><a title="The YUI Library can be downloaded from SourceForge" href="http://sourceforge.net/projects/yui/">YUI 3 on Sourceforge (external)</a></li><li class="item"><a title="YUI is free and open, offered under a BSD license." href="http://developer.yahoo.com/yui/3/license.html">YUI License (external)</a></li><li class="sect">YUI 3 Core - Examples</li><li class="item"><a title="YUI (Global Prerequisite) - Functional Examples" href="../../examples/yui/index.html">YUI (Global Prerequisite)</a></li><li class="item"><a title="Event - Functional Examples" href="../../examples/event/index.html">Event</a></li><li class="item"><a title="Node - Functional Examples" href="../../examples/node/index.html">Node</a></li><li class="sect">YUI 3 Component Infrastructure - Examples</li><li class="item"><a title="Attribute - Functional Examples" href="../../examples/attribute/index.html">Attribute</a></li><li class="item"><a title="Plugin - Functional Examples" href="../../examples/plugin/index.html">Plugin</a></li><li class="item"><a title="Widget - Functional Examples" href="../../examples/widget/index.html">Widget</a></li><li class="sect">YUI 3 Utilities - Examples</li><li class="item"><a title="Animation - Functional Examples" href="../../examples/anim/index.html">Animation</a></li><li class="item"><a title="Cache - Functional Examples" href="../../examples/cache/index.html">Cache</a></li><li class="item"><a title="Cookie - Functional Examples" href="../../examples/cookie/index.html">Cookie</a></li><li class="item"><a title="DataSchema - Functional Examples" href="../../examples/dataschema/index.html">DataSchema</a></li><li class="item"><a title="DataSource - Functional Examples" href="../../examples/datasource/index.html">DataSource</a></li><li class="item"><a title="DataType - Functional Examples" href="../../examples/datatype/index.html">DataType</a></li><li class="item"><a title="Drag &amp; Drop - Functional Examples" href="../../examples/dd/index.html">Drag &amp; Drop</a></li><li class="item"><a title="Get - Functional Examples" href="../../examples/get/index.html">Get</a></li><li class="item"><a title="History - Functional Examples" href="../../examples/history/index.html">History</a></li><li class="item"><a title="ImageLoader - Functional Examples" href="../../examples/imageloader/index.html">ImageLoader</a></li><li class="item"><a title="IO - Functional Examples" href="../../examples/io/index.html">IO</a></li><li class="item"><a title="JSON (JavaScript Object Notation) - Functional Examples" href="../../examples/json/index.html">JSON</a></li><li class="item"><a title="Queue - Functional Examples" href="../../examples/queue/index.html">Queue</a></li><li class="item"><a title="Stylesheet - Functional Examples" href="../../examples/stylesheet/index.html">Stylesheet</a></li><li class="sect">YUI 3 Widgets - Examples</li><li class="item"><a title="Overlay - Functional Examples" href="../../examples/overlay/index.html">Overlay</a></li><li class="item"><a title="Slider - Functional Examples" href="../../examples/slider/index.html">Slider</a></li><li class="sect">YUI 3 Node Plugins - Examples</li><li class="item"><a title="FocusManager Node Plugin - Functional Examples" href="../../examples/node-focusmanager/index.html">FocusManager Node Plugin</a></li><li class="item"><a title="MenuNav Node Plugin - Functional Examples" href="../../examples/node-menunav/index.html">MenuNav Node Plugin</a></li><li class="sect">YUI 3 CSS - Examples</li><li class="item"><a title="YUI CSS Reset - Functional Examples" href="../../examples/cssreset/index.html">CSS Reset</a></li><li class="item"><a title="YUI Fonts - Functional Examples" href="../../examples/cssfonts/index.html">CSS Fonts</a></li><li class="item"><a title="YUI Base - Functional Examples" href="../../examples/cssbase/index.html">CSS Base</a></li><li class="sect">YUI 3 Developer Tools - Examples</li><li class="item"><a title="Console - Functional Examples" href="../../examples/console/index.html">Console</a></li><li class="item"><a title="Profiler - Functional Examples" href="../../examples/profiler/index.html">Profiler</a></li><li class="item"><a title="Test - Functional Examples" href="../../examples/test/index.html">Test</a></li><li class="sect">The YUI Community</li><li class="item"><a title="The Yahoo! User Interface Blog" href="http://yuiblog.com">YUI Blog (external)</a></li><li class="item"><a title="The Yahoo! Group YDN-JavaScript hosts the YUI community forum" href="http://tech.groups.yahoo.com/group/ydn-javascript/">YUI Forum (external)</a></li><li class="item"><a title="The Yahoo! Group yui3 is dedicated to the 3.x branch of the Yahoo! User Interface (YUI) Library." href="http://tech.groups.yahoo.com/group/yui3/">YUI 3 Forum (external)</a></li><li class="item"><a title="YUI is used by Yahoo! and by hundreds of other sites, including many you know and love." href="/yui/poweredby/">YUI Sightings (external)</a></li><li class="item"><a title="Videos and podcasts from the YUI Team and from the Yahoo! frontend engineering community." href="http://developer.yahoo.com/yui/theater/">YUI Theater (external)</a></li><li class="sect">YUI Articles on the YUI Website</li><li class="item"><a title="Answers to Frequently Asked Questions about the YUI Library" href="http://developer.yahoo.com/yui/articles/faq/">YUI FAQ (external)</a></li><li class="item"><a title="Yahoo!'s philosophy of Graded Browser Support" href="http://developer.yahoo.com/yui/articles/gbs/">Graded Browser Support (external)</a></li><li class="item"><a title="Reporting Bugs and Making Feature Requests for YUI Components" href="http://developer.yahoo.com/yui/articles/reportingbugs/">Bug Reports/Feature Requests (external)</a></li><li class="item"><a title="Serve YUI source files from Yahoo! -- free, fast, and simple" href="http://developer.yahoo.com/yui/3/articles/hosting/">Serving YUI Files from Yahoo! (external)</a></li></ul>
+</div>
+</div>
+	</div><!--closes bd-->
+
+	<div id="ft">
+        <p class="first">Copyright &copy; 2009 Yahoo! Inc. All rights reserved.</p>
+        <p><a href="http://privacy.yahoo.com/privacy/us/devel/index.html">Privacy Policy</a> - 
+            <a href="http://docs.yahoo.com/info/terms/">Terms of Service</a> - 
+            <a href="http://docs.yahoo.com/info/copyright/copyright.html">Copyright Policy</a> - 
+            <a href="http://careers.yahoo.com/">Job Openings</a></p>
+	</div>
+</div>
+<script src="../../assets/dpSyntaxHighlighter.js"></script>
+<script language="javascript"> 
+dp.SyntaxHighlighter.HighlightAll('code'); 
+</script>
+</body>
+</html>