学习Ajax框架之dojo：第十一节——Dojo 的General Widget（上）（附源代码）

General Widget 是Dojo提供的一组通用的widget，每一种General Widget 实现的功能都相对独立。下面我们来看看都是什么样的widget吧。

1. Tree：树形菜单

在讲解Dojo的Layout Widget的AccordionContainer时，已经介绍并使用过Tree了，有兴趣的朋友可以参看学习Ajax框架之dojo：第八节——Dojo的Layout Widget的第四部分AccordionContainer的示例，在这里不再赘述！

 

2. Button：按钮

之前，也已经用到该widget。简单的说一下用法：<div dojoType="Button" id="button">This is a button</div>

 

3. Menu：下拉菜单

我们使用示例来说明Menu的使用方法以及Menu属性的用法。

示例1：首先，我们需要引入Menu包： dojo.require("dojo.widget.Menu2")。当点击鼠标右键时，弹出该菜单项。效果图如下：

1）主菜单为：

<div dojoType="PopupMenu2" contextMenuForWindow="true" toggle="explode">
      <div dojoType="MenuItem2" caption="Select All" disabled="true" onClick="alert('Shouldn\'t see this!');"></div>
      <div dojoType="MenuItem2" iconSrc="http://www.cnblogs.com/src/widget/templates/buttons/cut.gif" caption="Cut" accelKey="Ctrl+C"

            onClick="alert('not actually cutting anything, just a test!')"></div>
      <div dojoType="MenuItem2" iconSrc="http://www.cnblogs.com/src/widget/templates/buttons/copy.gif" caption="Copy" accelKey="Ctrl+X"
            onClick="alert('not actually copying anything, just a test!')"></div>
      <div dojoType="MenuItem2" iconSrc="http://www.cnblogs.com/src/widget/templates/buttons/paste.gif" caption="Paste" accelKey="Ctrl+V"
            onClick="alert('not actually pasting anything, just a test!')"></div>
      <div dojoType="MenuSeparator2"></div>
      <div dojoType="MenuItem2" caption="Do more stuff" submenuId="submenu1"></div>
</div>

2）caption为Do more stuff的子菜单：

<div dojoType="PopupMenu2" widgetId="submenu1" toggle="explode">
     <div dojoType="MenuItem2" caption="One" submenuId="submenu2" disabled="true"></div>
     <div dojoType="MenuItem2" caption="Two" submenuId="submenu2"></div>
</div>

<div dojoType="PopupMenu2" widgetId="submenu2" toggle="explode">
 <div dojoType="MenuItem2" caption="Three" onClick="alert('Three!')"></div>
 <div dojoType="MenuItem2" caption="Four" onClick="alert('Four!')"></div>
</div>

 

示例2：需要引入的Menu包：dojo.require("dojo.widget.Menu2")和dojo.hostenv.writeIncludes()。页面加载后，在页面的最上方，显示菜单导航条，效果图如下图所示：

<div dojoType="MenuBar2">
     <div dojoType="MenuBarItem2" caption="File" submenuId="submenu1"></div>
     <div dojoType="MenuBarItem2" caption="Edit" submenuId="submenu2"></div>
     <div dojoType="MenuBarItem2" caption="View" disabled="true"></div>
     <div dojoType="MenuBarItem2" caption="Help" submenuId="submenu2"></div>
</div>

<div dojoType="PopupMenu2" widgetId="submenu1" contextMenuForWindow="true">
     <div dojoType="MenuItem2" caption="Enabled Item" onClick="alert('Hello world');"></div>
     <div dojoType="MenuItem2" caption="Disabled Item" disabled="true"></div>
     <div dojoType="MenuSeparator2"></div>
     <div dojoType="MenuItem2" caption="Enabled Submenu" submenuId="submenu2"></div>
     <div dojoType="MenuItem2" caption="Disabled Submenu" submenuId="submenu2" disabled="true"></div>
</div>

<div dojoType="PopupMenu2" widgetId="submenu2">
     <div dojoType="MenuItem2" caption="Submenu Item One" onClick="alert('Submenu 1!')"></div>
     <div dojoType="MenuItem2" caption="Submenu Item Two" onClick="alert('Submenu 2!')"></div>
</div>

在页面上点击鼠标右键时，会出现隐藏的菜单项，效果与示例1的效果相同，仅仅菜单项的内容不同而已。

 

示例3：示例1和示例2让我们学会了如何编写菜单项和子菜单项，让菜单项右击显示。那么，如何让菜单在指定的位置右击显示呢？需要什么属性来设定呢？该属性在任何情况下都可以使用吗？下面的示例会一一帮你解答的！

需要引入的Menu包：dojo.require("dojo.widget.Menu2") 和 dojo.hostenv.writeIncludes()。

情况一：在标题为“Right click here!”上面右击，显示菜单项。

<h3 id="test1" style="background-color: gray; display: block; width: 200px;text-align: center;">Right click here!</h3>

菜单项：

<div dojoType="PopupMenu2" targetNodeIds="test1">
     <div dojoType="MenuItem2" caption="MENU1 Right click here!"></div> 
     <div dojoType="MenuItem2" caption="MENU1-Item 1"></div>
     <div dojoType="MenuItem2" caption="MENU1-Item 2"></div>
</div>

情况二：在div里面的标题为“Testing from within a DIV”上面右击，显示菜单项。

<div style="display: inline; width; 250px; background-color: navy; text-align: center; padding: 1em;">
    <h3 style="background-color: #B2B2B2; display: inline;" id="testwithindiv">Testing from within a DIV</h3>
</div>

情况二的菜单项，同与情况一的菜单项。

情况三：使用code完成菜单项的加载，功能同情况一和情况二。

function init(){
      var menu = dojo.widget.createWidget("PopupMenu2", {targetNodeIds: ["test1", "test2", "testwithindiv"]});
      menu.addChild(dojo.widget.createWidget("MenuItem2", {caption: "MENU 1"}));
      menu.addChild(dojo.widget.createWidget("MenuItem2", {caption: "MENU1-Item 1"}));
      menu.addChild(dojo.widget.createWidget("MenuItem2", {caption: "MENU1-Item 2"}));
}
dojo.addOnLoad(init);

<h3 id="test1" style="background-color: gray; display: inline;">Right click here!</h3>

<h3 id="test2" style="background-color: #C1C1C1;display: inline;">Or here!</h3><br /><br />

<div style="display: tablecell; width; 70%; background-color: navy; text-align: center; padding: 1em;">
 <h3 style="background-color: #B2B2B2; display: inline;" id="testwithindiv">Testing from within a DIV</h3>
</div>

情况四：在id="test1"的div里面右击，显示菜单项。

 <div style="background-color: yellow; display: block; width: 200px;" id="test1">

       Statically positioned block

       <div dojoType="PopupMenu2" targetNodeIds="test1">
             <div dojoType="MenuItem2" caption="MENU1-Item 1"></div>
             <div dojoType="MenuItem2" caption="MENU1-Item 2"></div> 
      </div>
 </div>

情况五：在SplitContainer中的ContentPane里面右击，显示菜单项。

 

 <div dojoType="SplitContainer"
  orientation="horizontal"
  sizerWidth="5"
  activeSizing="1"
  style="border: 2px solid black; width: 400px; height: 150px;"
 >
       <div dojoType="ContentPane" sizeMin="20" sizeShare="20" id="pane1">
             ContentPane 1
       </div>
       <div dojoType="ContentPane" sizeMin="50" sizeShare="50" id="pane2">
             ContentPane 2

             <div dojoType="PopupMenu2" targetNodeIds="pane1;pane2">
                   <div dojoType="MenuItem2" caption="MENU2-Item 1"></div>
                   <div dojoType="MenuItem2" caption="MENU2-Item 2"></div> 
             </div>
       </div>
 </div>

menu小结：总结上面的各种情况，实现的功能是一样的，关键的属性是targetNodeIds。