dojox.grid.DataGrid 编程篇(2)
dojox.grid.DataGrid 编程篇(2) -- 方法与事件
dojox.grid.DataGrid 组件还提供了一些方法，使用者利用这些方法可以进一步丰富表格的表现体验。
1. 获取、修改任一单元格的数据：
取得第3行，字段"f3"的值
[javascript] view plaincopy
var grid = dijit.byId("grid1");
var row = grid.getItem(3);
// 获取值
var value = grid.store.getValue(row, "f3");
// 修改值
grid.store.setValue(row, "f3", "abc");
或者直接写为
[javascript] view plaincopy
var grid = dijit.byId("grid1");
var row = grid.getItem(3);
var value = row["f3"];
注意：默认情况下，每次修改值都会导致Grid该行刷新
2. 获取(取消)选中行
[javascript] view plaincopy
var grid = dijit.byId("grid1");
var selectedRows = grid.selection.getSelected();
var value = selectedRows[0]["f3"];
因为支持多选，所以 grid.selection.getSelected 返回的是选中的行数组。
[javascript] view plaincopy
// 获得选择的第一行
grid.selection.getFirstSelected();
// 清除所有选中行
grid.selection.deselectAll();
// 选中第n行
grid.selection.select(4);
3. 设置单元格焦点
[javascript] view plaincopy
// 设置第一行，第二列的单元格的焦点
grid.focus.setFocusIndex(0, 1);
4. 将某一行显示在视图中
[javascript] view plaincopy
// 滚动显示出第4行
grid.scrollToRow(3);
5. 隐藏某一列
[javascript] view plaincopy
// 隐藏第五列
grid.layout.setColumnVisibility(4, false);
6. 改变行的显示 onStyleRow (参数：row对象)
[javascript] view plaincopy
dojo.connect(grid, "onStyleRow", function(row) {
// 第二行背景设为红色
if (row.index == 1) {
row.customClasses += " redRow ";
}
});
grid.resize();
<style type="text/css">
.redRow tr { background-color: red !important; }
</style>
7. 行点击事件 onRowClick (参数: Event 对象)
[javascript] view plaincopy
dojo.connect(grid, "onRowClick", function(e) {
alert(e.rowIndex);
});
另外：Enter键也能触发 onRowClick 事件。
不过这里有个Bug，上下键移动时，选择行不会跟随，这时候按下Enter时 e.rowIndex === undefined。后面会介绍如何解决这个Bug。
（改进的 EnhancedGrid 上下键移动时，选择行会跟随）
8. 行选择事件 onSelected (参数: row index)
[javascript] view plaincopy
dojo.connect(grid, "onSelected", function(index) {
alert(index);
});
如果选择行发生变化时会被触发。
9. 单元格点击事件 onCellClick (参数: Event 对象)
[javascript] view plaincopy
dojo.connect(grid, "onCellClick", function(e) {
console.log("[" + e.rowIndex + "," + e.cellIndex + "]");
//rowIndex=-1 为表头
if (e.rowIndex < 0) return;
e.cellNode.style.backgroundColor = "red";
});
10. 全选择的代码示例：
[html] view plaincopy
<table dojoType='dojox.grid.DataGrid' id='grid1' jsid='js_grid1'
style='border:1px #a8a8a8 solid;width:450px;height:200px;' store="getDataStore(10)"
canSort='false' editable="true" selectionMode='extended' selectable="false" >
<colgroup span="1" noscroll="true"></colgroup>
<colgroup span="6"></colgroup>
<thead>
<tr>
<th field="f0" cellStyles="text-align:center;" width="50px" editable="true" cellType="dojox.grid.cells.Bool" alwaysEditing="true">
<div style="text-align:center;">
<label for="chk">选择</label><br/><input type="checkbox" id="chk" onclick="changeAll(this)">
</div>
</th>
<th field="f1" cellStyles="text-align:center;" width="100px" >列1</th>
<th field="f2" cellStyles="text-align:center;" width="100px" >列2</th>
<th field="f3" cellStyles="text-align:center;" width="100px" >列3</th>
<th field="f4" cellStyles="text-align:center;" width="100px" >列4</th>
<th field="f5" cellStyles="text-align:center;" width="100px" >列5</th>
<th field="f6" cellStyles="text-align:center;" width="100px" formatter="addLink">列6</th>
</tr>
</thead>
</table>
JavaScript：表头的Checkbox点击时触发下面的方法。
[javascript] view plaincopy
function changeAll(checkbox) {
var grid = dijit.byId("grid1");
for(var i=0, row; (row=grid.getItem(i)); i++) {
grid.store.setValue(row, "f0", checkbox.checked);
}
}
注意：在表格列宽变化时(即拖拽调整列宽)会导致Grid重绘，因此上面用 cacheCheck 来保持表头的Checkbox的checked状态。
在 onResizeColumn 实际中设置回去。
[javascript] view plaincopy
dojo.connect(grid, "onResizeColumn", function(cellIdx) {
dojo.byId("chk").checked = cacheCheck;
});
11. 变化通知
当使用编辑列的时候，可以利用数据源的变更通知：
[javascript] view plaincopy
grid._isChanged = false;
dojo.connect(grid.store, "onSet", function(item, attr, oldVal, newVal) {
if (oldVal == null)
oldVal = "";
if (oldVal != newVal) {
dojo.byId("divMsg").innerHTML = attr + ":" + oldVal + "->" + newVal;
grid._isChanged = true;
}
});
-- 本章结束 --
