EasyUI 的元件有兩種宣告方式:一種是直接寫 class(純 CSS 驅動),另一種是用 JS 呼叫。以下對照 1.0.5 版本整理常用屬性、事件與方法。
常用屬性:title(標題)、iconCls(16x16 圖示 class)、width/height(預設 auto)、left/top、cls/headerCls/bodyCls(各區塊自訂 class)、style、fit(是否適應父容器,預設 false)、border(預設 true)、doSize、collapsible、minimizable、maximizable、closable(各功能按鈕,預設 false)、tools(自訂工具列,每項含 iconCls 與 handler)、collapsed/minimized/maximized/closed(初始狀態)、href(遠端載入網址)、loadingMessage(預設 Loading…)。
事件:onLoad、onBeforeOpen/onOpen、onBeforeClose/onClose、onBeforeDestroy/onDestroy、onBeforeCollapse/onCollapse、onBeforeExpand/onExpand、onResize(回傳 width、height)、onMove(回傳 left、top)、onMaximize、onRestore、onMinimize。
方法:options、panel、header、body、setTitle、open、close、destroy、refresh、resize、move。其中 open/close/destroy 都支援 force 參數,可繞過對應的 onBefore 回呼。
modal(是否為模態視窗)、shadow(是否顯示陰影),其餘繼承自 panel。
disabled(預設 false)、plain(是否為普通樣式,預設 false)。
required(預設 false)、validType(可為 length[a,b] 指定長度區間、email、url)、missingMessage(空值提示)、invalidMessage(格式錯誤提示)。後兩者系統有英文預設值,可自訂覆蓋。
屬性:url、animate(展開收合動畫,預設 false)。
節點屬性:text、id(遠端載入時很重要)、state(open/closed,預設 open)、attributes(自訂屬性)、children(子節點陣列)。
事件:onClick(參數含 id、text、attributes、target)、onLoadSuccess、onLoadError。
方法:reload、getSelected、collapse、expand、append(param 含 parent 與 data)、remove。
常用屬性:title、iconCls、border、width/height、columns、frozenColumns(左側凍結欄)、striped(斑馬線)、method(預設 post)、nowrap、idField、url、loadMsg、pagination、rownumbers、singleSelect、fit、pageNumber(預設 1)、pageSize(預設 10)、pageList(預設 [10,20,30,40,50])、queryParams、sortName、sortOrder(asc/desc)。
欄位屬性:title、field、width、rowspan、colspan、align、sortable、checkbox。
事件:onLoadSuccess、onLoadError、onClickRow、onDblClickRow、onSortColumn、onSelect、onUnselect(多數回傳 rowIndex 與 rowData)。
方法:options、resize、reload、fixColumnSize、loadData、getSelected、getSelections、clearSelections、selectRow、selectRecord、unselectRow。
屬性:width/height、idSeed(衍生面板 DOM id,預設 0)、plain、fit、border、scrollIncrement、scrollDuration。
事件:onLoad、onSelect、onClose。
方法:resize、add、close、select、exists。
面板屬性:id、text、content、href、cache(預設 true)、icon、closable、selected、width、height。
屬性:width、listWidth、listHeight、valueField、textField、editable(預設 true)、url。
事件:onLoadSuccess、onLoadError、onSelect、onChange。
方法:select、setValue(可傳字串或含 valueField/textField 的物件)、getValue、reload。
屬性:width、treeWidth、treeHeight、url。
事件:onSelect、onChange。
方法:setValue(可傳節點 id 或含 id/text 的物件)、getValue、reload。
屬性:title、region(north/south/east/west/center)、border(預設 true)、split(是否顯示可拖曳分隔線,預設 false)、icon、href。
屬性:zIndex、left(預設 0)、top(預設 0)、href。
事件:onShow、onHide。
方法:show(傳 left 與 top)、hide。
disabled、plain、menu(對應的選單選擇器)、duration(懸停顯示持續時間,毫秒,預設 100)。
min(允許最小值)、max(允許最大值)、precision(小數位數)。
div.easyui-accordion(手風琴,繼承 panel)、a.easyui-splitbutton(分割按鈕)、div.menu-sep(選單分隔線)。
.dialog(繼承 window):title(預設 New Dialog)、collapsible、minimizable、maximizable、resizable、toolbar、buttons。
.draggable:handle、disabled、edge、axis(v/h);事件 onStartDrag、onDrag(回傳 false 可取消拖動)、onStopDrag。
.messager:show(showType 可為 null/slide/fade/show,預設 slide;showSpeed 預設 600ms;width 預設 250、height 預設 100;timeout 為 0 則不自動關閉)、alert(含 title、msg、icon、fn)、confirm(fn 回傳 true 才處理)、prompt(fn 接收使用者輸入值)。
.pagination:total(預設 1)、pageSize(預設 10)、pageNumber(預設 1)、pageList(預設 [10,20,30,50])、loading、buttons、beforePageText、afterPageText、displayMsg;事件 onSelectPage(回傳 pageNumber 與 pageSize)。
這份清單對照的是 1.0.5,屬性名稱與預設值在後續版本有過調整(例如 messager 的方法名、progressbar 的引進等)。實際開發時,建議以所用版本的官方文件為準,並把常用的幾個元件(panel、datagrid、tabs、messager)的屬性記熟——它們幾乎出現在每一個後台專案裡。