Setting Menu Configuration Properties At Runtime : Menu MenuItem « YUI Library « JavaScript DHTML






Setting Menu Configuration Properties At Runtime

 

<!--
Software License Agreement (BSD License)
Copyright (c) 2009, Yahoo! Inc.
All rights reserved.

Redistribution and use of this software in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

    * Redistributions of source code must retain the above copyright notice, this list of conditions and the
      following disclaimer.
    * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
    * Neither the name of Yahoo! Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission of Yahoo! Inc.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Sources of Intellectual Property Included in the YUI Library

YUI is issued by Yahoo! under the BSD license above. Below is a list of certain publicly available software that is the source of intellectual property in YUI, along with the licensing terms that pertain to thosesources of IP. This list is for informational purposes only and is not intended to represent an exhaustive list of third party contributions to the YUI.

    * Douglas Crockford's JSON parsing and stringifying methods: In the JSON Utility, Douglas Crockford's JSON parsing and stringifying methods are adapted from work published at JSON.org. The adapted work is in the public domain.
    * Robert Penner's animation-easing algorithms: In the Animation Utility, YUI makes use of Robert Penner's algorithms for easing.
    * Geoff Stearns's SWFObject: In the Charts Control and the Uploader versions through 2.7.0, YUI makes use of Geoff Stearns's SWFObject v1.5 for Flash Player detection and embedding. More information on SWFObject can be found here (http://blog.deconcept.com/swfobject/). SWFObject is (c) 2007 Geoff Stearns and is released under the MIT License (http://www.opensource.org/licenses/mit-license.php).
    * Diego Perini's IEContentLoaded technique: The Event Utility employs a technique developed by Diego Perini and licensed under GPL. YUI's use of this technique is included under our BSD license with the author's permission.

-->

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>


    <meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Setting Menu Configuration Properties At Runtime</title>

<style type="text/css">
/*margin and padding on body element
  can introduce errors in determining
  element position and are not recommended;
  we turn them off as a foundation for YUI
  CSS treatments. */
body {
  margin:0;
  padding:0;
}
</style>

<link rel="stylesheet" type="text/css" href="yui_2.7.0b-lib/fonts/fonts-min.css" />
<link rel="stylesheet" type="text/css" href="yui_2.7.0b-lib/menu/assets/skins/sam/menu.css" />
<script type="text/javascript" src="yui_2.7.0b-lib/yahoo-dom-event/yahoo-dom-event.js"></script>
<script type="text/javascript" src="yui_2.7.0b-lib/container/container_core-min.js"></script>
<script type="text/javascript" src="yui_2.7.0b-lib/menu/menu-min.js"></script>


<!--begin custom header content for this example-->
<style type="text/css">

    /*
        Set the "zoom" property to "normal" since it is set to "1" by the 
        ".example-container .bd" rule in yui.css and this causes a Menu
        instance's width to expand to 100% of the browser viewport.
    */
    
    div.yuimenu .bd {
    
        zoom: normal;
    
    }
    

    /*
        Overrides for the ".example-container a:visited" in the 
        the yui.css file.
    */

    div.yuimenu a.yuimenuitemlabel-disabled:visited {
    
            color: #A6A6A6;
    
    }

</style>
<!--end custom header content for this example-->

</head>

<body class=" yui-skin-sam">


<h1>Setting Menu Configuration Properties At Runtime</h1>

<div class="exampleIntro">
  <p>
This example demonstrates how to set MenuItem configuration properties at 
runtime and listen for the changes through the "configChanged" event.
</p>
<p id="clicknote">
<em>Note:</em> By default clicking outside of a menu will hide it.  
Additionally, menu items without a submenu or a URL to navigate to will hide their 
parent menu when clicked.  Click the "Show Menu" button below to make the menu 
visible if it is hidden.
</p>      
</div>

<!--BEGIN SOURCE CODE FOR EXAMPLE  -->

<script type="text/javascript">

    /*
         Initialize and render the Menu when the element it is to be 
         rendered into is ready to be scripted.
    */

    YAHOO.util.Event.onAvailable("rendertarget", function () {

        /*
             "configChange" event handler for each MenuItem instance - used 
             to log info about the configuration property that was changed.
        */

        function onMenuItemConfigChange(p_sType, p_aArgs) {

            var sPropertyName = p_aArgs[0][0],
                sPropertyValue = p_aArgs[0][1];

            YAHOO.log(("Index: " + this.index + ", " +
                       "Group Index: " + this.groupIndex + ", " +
                       "Custom Event Type: " + p_sType + ", " +                  
                       "\"" + sPropertyName + "\" Property Set To: \"" 
                       + sPropertyValue + "\""), "info", "example12");
        
        }


        /*
      Instantiate a Menu:  The first argument passed to the constructor
      is the id for the Menu element to be created, the second is an 
      object literal of configuration properties.
        */

        var oMenu = new YAHOO.widget.Menu("basicmenu", { fixedcenter: true });


        /*
             Subscribe to the Menu instance's "itemAdded" event in order to 
             subscribe to the "configChange" event handler of each MenuItem 
             instance's configuration object.
        */

        oMenu.subscribe("itemAdded", function (p_sType, p_aArgs) {

            var oMenuItem = p_aArgs[0];
           
            /*
                 Subscribe to the "configChange" event handler of each MenuItem 
                 instance's configuration object.
            */

            oMenuItem.cfg.subscribe("configChanged", onMenuItemConfigChange);

        });


        /*
            Add items to the Menu instance by passing an array of strings 
            (each of which represents the "text" configuration property of a 
            YAHOO.widget.MenuItem instance) to the "addItems" method.
        */

        oMenu.addItems([
            
                "Selected MenuItem",
                "Disabled MenuItem",
                "MenuItem With A URL",
                "Checked MenuItem"

            ]);


        /*
            Since this Menu instance is built completely from script, call the 
            "render" method passing in the DOM element that it should be 
            appended to.
        */

        oMenu.render("rendertarget");


        /*
             Set a configuration property of each MenuItem to trigger the firing
             of its configuration object's "configChanged" event.
        */

        oMenu.getItem(0).cfg.setProperty("selected", true);
        oMenu.getItem(1).cfg.setProperty("disabled", true);
        oMenu.getItem(2).cfg.setProperty("url", "http://www.yahoo.com");
        oMenu.getItem(3).cfg.setProperty("checked", true);
        

        YAHOO.util.Event.addListener("menutoggle", "click", oMenu.show, null, oMenu);

    });
    
</script>

<button id="menutoggle" type="button">Show Menu</button>
<div id="rendertarget"></div>
<!--END SOURCE CODE FOR EXAMPLE  -->

</body>
</html>
<!-- presentbright.corp.yahoo.com uncompressed/chunked Thu Feb 19 10:53:17 PST 2009 -->

   
  








yui_2.7.0b.zip( 4,431 k)

Related examples in the same category

1.Icon on a Menu bar
2.Disabled menuitem
3.Add shortcut key to menuitem
4.Add submenu to menuitem
5.Add menuitem separator to menu
6.Create a Menu instance using existing markup on the page.
7.Create a Menu instance using nothing but JavaScript.
8.Grouped Menu Items Using Markup
9.Grouped Menu Items Using JavaScript
10.Grouped Menu Items With Titles From Markup
11.Grouped Menu Items With Titles From JavaScript
12.Multi-tiered Menu(sub menu) From Markup
13.Multi-tiered Menu (sun menu) From JavaScript
14.Handling Menu Click Events
15.Listening For Menu Events
16.Set MenuItem configuration properties when adding items to a Menu instance.
17.OS-Style Programs Menu