|
原文地址 文章日期:2006/09/25/
新版.32 的YUI-EXT包含了GIRD事件機制的重要升級。許多新事件現在可以用了,監聽事件的機制也改變了(盡管它仍然向后兼容)。
偵聽事件的方法
鑒于 YAHOO.util.CustomEvent只提供簡單的訪問,Grid和相關的對象擴展了新的方法來偵聽事件,這些事件你應該是熟悉的。它們是:
- addListener(eventName, fn, scope, override) - "eventName" should be one of the events defined below. "fn" is the function to call when the event occurs. "scope" is an optional object providing the scope (this) of the function. "override" is whether or not to apply that scope and is only there for backwards compatibility.
- removeListener(eventName, fn, scope) -移除前先提交的事件偵聽
- on(eventName, fn, scope, override) - addListener 快捷方式
這些方法與YAHOO.uitl.Event一樣,有相同的署名(signatures)。
onRowSelect事件的偵聽:
var sm = grid.getSelectionModel(); sm.addListener('rowselect', myHandler);
這是GIRD暴露事件的列表和參數簡介:
- "this" 指的是Grid對象; - "e" 指的是 YAHOO.ext.EventObject (常規化事件對象) ,除了Drag & Drop對象是標準瀏覽器事件對象。- "dd" 指的是Grid的YAHOO.ext.GridDD對象。譯注:下面事件解釋以原文方式提供以便讀者準確理解:
- cellclick - (this, rowIndex, columnIndex, e) - Fires when a cell is clicked
- celldblclick - (this, rowIndex, columnIndex, e) - Fires when a cell is double clicked
- rowclick - (this, rowIndex, e) - Fires when a row is clicked
- rowdblclick - (this, rowIndex, e) - Fires when a row is double clicked
- headerclick - (this, columnIndex, e) - Fires when a header is clicked
- rowcontextmenu - (this, rowIndex, e) - Fires when a row is right clicked
- headercontextmenu - (this, columnIndex, e) - Fires when a header is right clicked
- beforeedit - (this, rowIndex, columnIndex, e) - Fires just before editing is started on a cell
- afteredit - (this, rowIndex, columnIndex, e) - Fires immediately after a cell is edited
- bodyscroll - (scrollLeft, scrollTop) - Fires when the grid's body is scrolled
- columnresize - (columnIndex, newSize) Fires when the user resizes a column.
- startdrag - (this, dd, e) - Fires when row(s) start being dragged
- enddrag - (this, dd, e) - Fires when a drag operation is complete
- dragdrop - (this, dd, targetId, e) - Fires when dragged row(s) are dropped on a valid DD target
- dragover - (this, dd, targetId, e) Fires while row(s) are being dragged. "targetId" is the id of the Yahoo.util.DD object the selected rows are being dragged over.
- dragenter - (this, dd, targetId, e) - Fires when the dragged row(s) first cross another DD target while being dragged
- dragout - (this, dd, targetId, e) - Fires when the dragged row(s) leave another DD target while being dragged
Gird事件的例子
function onCellClick(grid, rowIndex, colIndex, e){ alert('Cell at row ' + rowIndex + ', column ' + colIndex + ' was clicked!'); } var grid = ... // 這里注冊事件 grid.addListener('cellclick', onCellClick);
普通Grid事件Since there is no way to envision everything you may want to do with the grid, I've also exposed direct access to many of the grid's raw events. All of these events pass one parameter to their handler: "e" a YAHOO.ext.EventObject.
- click
- dblclick
- mousedown
- mouseup
- mouseover
- mouseout
- keypress
- keydown
var img = getEl('loading-indicator'); var dm = grid.getDataModel(); dm.addListener('beforeload', img.show, img, true); dm.addListener('load', img.hide, img, true);Hopefully this can get you started with the new event system. If you have any questions, feel free to post in the Help Forum and I will help you out.Jack
JavaScript技術:Gird事件機制初級讀本,轉載需保留來源!
鄭重聲明:本文版權歸原作者所有,轉載文章僅為傳播更多信息之目的,如作者信息標記有誤,請第一時間聯系我們修改或刪除,多謝。