jQuery EasyUI Datagrid组件的基础完整DOM结构

jQuery EasyUI Datagrid组件的基础完整DOM结构

标题可能有点长，什么叫“基础完整DOM结构”，这里“基础”的意思是指这个结构不依赖具体数据，不依赖Datagrid的view属性，只要存在 Datagrid实例就会存在这样的基础DOM结构；而“完整”的意思是指在冻结列，冻结行，标题，footer，分页这些功能块都存在时候的DOM结 构。

要搞清楚Datagrid的工作原理，这个DOM结构必须要烂熟于胸的，我们直接来看这个“基础完整DOM结构”是什么样子的：

<!--datagrid的最外层容器，可以使用$(target).datagrid('getPanel')或者$.data(target,'datagrid').panel得到这个DOM对象，这个DOM上其实承载了panel组件-->
<divclass="paneldatagrid">
<!--datagrid的标题区域容器，对应于panel组件的header部分，可以使用$(target).datagrid('getPanel').panel('header')得到这个DOM对象-->
<divclass="panel-header">
<divclass="panel-title"></div>
<divclass="panel-tool"></div>
</div>
<!--datagrid的主体区域容器，对应于panel组件的body部分，可以使用$(target).datagrid('getPanel').panel('body')得到这个DOM对象-->
<divclass="datagrid-wrappanel-body">
<!--datagrid视图部分的容器，这是datagrid组件DOM结构的核心，其基础视图结构跟datagrid的view属性无任何关系。-->
<!--对应dc.view-->
<divclass="datagrid-view">
<!--div.datagrid-view1负责展示冻结列部分(包含行号或者frozenColumns)的数据-->
<!--对应dc.view1-->
<divclass="datagrid-view1">
<!--列标题部分-->
<divclass="datagrid-header">
<!--对应dc.header1-->
<divclass="datagrid-header-inner">
<!--样式里有htable关键字，h代表header的意思-->
<tableclass="datagrid-htable">
<tbody>
<trclass="datagrid-header-row"></tr>
</tbody>
</table>
</div>
</div>
<!--列数据部分-->
<divclass="datagrid-body">
<!--对应dc.body1-->
<divclass="datagrid-body-inner">
<!--frozenRows部分，固定行是1.3.2版本之后才加的功能，注意datagrid-btable-frozen关键样式，btable代码bodytable的意思-->
<tableclass="datagrid-btabledatagrid-btable-frozen"></table>
<!--普通rows部分-->
<tableclass="datagird-btable"></table>
</div>
</div>
<!--footer部分-->
<divclass="datagrid-tooter">
<!--对应dc.footer1-->
<divclass="datagrid-footer-inner">
<!--ftable代表footertable的意思-->
<tableclass="datagrid-ftable"></table>
</div>
</div>
</div>
<!--div.datagrid-view2负责展示非冻结列部分的数据，大家注意到冻结列和普通列视图是分开的，也就是说冻结列和普通列是在不同表格中展示的，这样会产生一个问题，那就是那个表格行高之间的同步问题。-->
<!--对应dc.view2-->
<divclass="datagrid-view2">
<!--列标题部分-->
<divclass="datagrid-header">
<!--对应dc.header2-->
<divclass="datagrid-header-inner">
<tableclass="datagrid-htable">
<tbody>
<trclass="datagrid-header-row"></tr>
</tbody>
</table>
</div>
</div>
<!--列数据部分，注意这里并无datagrid-body-inner这个子元素，而冻结列对应的body却是有的，这个是细微区别-->
<!--对应dc.body2-->
<divclass="datagrid-body">
<!--frozenRows部分，固定行是1.3.2版本之后才加的功能，-->
<tableclass="datagrid-btabledatagrid-btable-frozen"></table>
<tableclass="datagrid-btable"></table>
</div>
<!--footer部分-->
<divclass="datagrid-footer">
<!--对应dc.footer2-->
<divclass="datagrid-footer-inner">
<tableclass="datagrid-ftable"></table>
</div>
</div>
</div>
</div>
<!--分页部分-->
<divclass="datagrid-pagerpagination"></div>
</div>
</div>

对于这个DOM结构，我在html代码里面已经做了简单说明，这里提一下绑定于Datagrid宿主table上的对象的dc属性，这个dc属性存储了对DOM结构里不同部分的引用，获取dc属性的方法：

$.data(target,'datagrid').dc;

而dc属性跟DOM的对应关系，我也在html中做了详细注释，请大家自行查看，这些都是我们深入认识Datagrid组件的基础。