MenuButton 擴充自 $.fn.linkbutton.defaults,並以 $.fn.menubutton.defaults 覆寫其預設值。

相依元件:menu、linkbutton
先準備一個普通連結作為按鈕本體,再準備一個 menu 容器,最後把兩者關聯起來:
<a href="javascript:void(0)" id="mb" iconCls="icon-edit">Edit</a>
<div id="mm" style="width:150px;">
<div iconCls="icon-undo">Undo</div>
<div iconCls="icon-redo">Redo</div>
<div class="menu-sep"></div>
<div>Cut</div>
<div>Copy</div>
<div>Paste</div>
<div class="menu-sep"></div>
<div iconCls="icon-remove">Delete</div>
<div>Select All</div>
</div>
$('#mb').menubutton({ menu: '#mm' });
屬性沿用 linkbutton 的設定,以下為 MenuButton 額外新增的部分:
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| plain | boolean | 為 true 時以簡易樣式呈現按鈕,不帶漸層與邊框效果。 | true |
| menu | string | 用來指定對應 menu 的选择器,例如 '#mm'。 | null |
| duration | number | 滑鼠移入按鈕後,等待多少毫秒才展開選單;設為較小的值可加快反應。 | 100 |
| 名稱 | 參數 | 說明 |
|---|---|---|
| options | none | 回傳目前的設定物件。 |
| disable | none | 停用這個 menu 按鈕。 |
| enable | none | 重新啟用這個 menu 按鈕。 |
由於 MenuButton 本質上是「linkbutton + menu」的組合,選單項目的行為(新增、停用、圖示設定)仍由 menu 元件的方法負責,例如 $('#mm').menu('disableItem', ...)。因此除按鈕本身外,也建議熟悉 menu 的 API,才能完整控制整體互動。