1 最简单的Grid Panel
Grid Panel是ExtJS的核心部分之一,通过Grid Panel可以对数据显示、排序、分组和编辑。Model和Store是Grid Panel处理数据的核心,每个Grid Panel都必须设置Model和Store。要创建Grid Panel,首先要定义Model,Model包括了Grid Panel所有需要显示的字段,相当于数据库中表字段的集合。Store可以看作是一行数据的集合或者是Model的实例集合,每个Store都包含一个或多个Model实例,Grid Panel显示的数据都存储在Store里面。Grid Panel通过Store获取数据并显示,Store则通过Proxy对数据进行读取和保存。
下面创建一个Grid Panel用来显示用户的基本信息,包括用户名、邮箱、手机号(name、email、phone),首先创建用户模型(User Model)。
Ext.define('User', { extend: 'Ext.data.Model', fields: [ 'name', 'email', 'phone' ] });
接下来创建Store,Store是User的集合,包括多个User实例。
var userStore = Ext.create('Ext.data.Store', { model: 'User', //刚才创建的User Model data: [ { name: 'Lisa', email: 'lisa@simpsons.com', phone: '555-111-1224' }, { name: 'Bart', email: 'bart@simpsons.com', phone: '555-222-1234' }, { name: 'Homer', email: 'home@simpsons.com', phone: '555-222-1244' }, { name: 'Marge', email: 'marge@simpsons.com', phone: '555-222-1254' } ] });
Model和Store都创建好之后,就可以创建Grid Panel了。
Ext.create('Ext.grid.Panel', { renderTo: Ext.getBody(), store: userStore, //绑定上面创建的Store width: 400, height: 200, title: 'Application Users', columns: [ { text: 'Name', width: 100, sortable: false, hideable: false, dataIndex: 'name' //Grid Panel中显示的字段,必须要和User Model中的字段一致 }, { text: 'Email Address', width: 150, dataIndex: 'email', hidden: true }, { text: 'Phone Number', flex: 1, dataIndex: 'phone' } ] });
最后创建的用户Grid Panel如图所示。
2 Grid Panel数据分组(Grouping)
只要在Store中设置groupField属性,就可以对Grid Panel显示的数据进行分组。假设公司有很多员工,需要对公司的员工在Grid Panel中按部门进行分组显示。首先在Store中设置groupField属性为department。
Ext.create('Ext.data.Store', { model: 'Employee', data: ..., groupField: 'department' //设置数据按照department分组 });
然后在Grid Panel中添加grouping Feature,实现分组显示效果。
Ext.create('Ext.grid.Panel', { ... features: [{ ftype: 'grouping' }] });
分组显示效果如下图所示,点击这里查看官方分组显示代码。
3 Grid Panel分页显示
当数据比较多一页显示不完的时候,就需要对数据进行分页显示。Grid Panel可以通过Paging Toolbar和Paging Scroller两种方式实现分页显示显示,Paging Toolbar有上一页/下一页按钮,Paging Scroller是当Grid Panel滚动显示到底部的时候动态加载数据。
要实现分页显示,首先要设置Store支持分页,在Store中设置pageSize,pageSize默认是25。在reader中设置数据总数量totalProperty,分页插件根据pageSize和totalProperty进行分页。下面的代码pageSize设置为4,totalProperty则从返回的json数据中total属性获取。
Ext.create('Ext.data.Store', { model: 'User', autoLoad: true, pageSize: 4, //设置每页显示的数据数量 proxy: { type: 'ajax', url : 'data/users.json', reader: { type: 'json', root: 'users', //指定从json的哪个属性获取数据,如果不指定,则从json的跟属性获取 totalProperty: 'total' //总数据数量 } } });
假设json数据格式如下
{ "success": true, "total": 12, "users": [ { "name": "Lisa", "email": "lisa@simpsons.com", "phone": "555-111-1224" }, { "name": "Bart", "email": "bart@simpsons.com", "phone": "555-222-1234" }, { "name": "Homer", "email": "home@simpsons.com", "phone": "555-222-1244" }, { "name": "Marge", "email": "marge@simpsons.com", "phone": "555-222-1254" } ] }
Store的分页已经设置完毕,下面在Grid Panel中实现Paging Toolbar分页功能。
Ext.create('Ext.grid.Panel', { store: userStore, columns: ..., dockedItems: [{ xtype: 'pagingtoolbar', //在Grid Panel中添加paging toolbar store: userStore, //把paging toolbar的Store设置成和Grid Panel的Store一样 dock: 'bottom', displayInfo: true }] });
Paging Toolbar的分页效果如下图所示,点击这里查看官方Paging Toolbar分页功能代码。
Paging Scroller的分页实现比较简单,只要在Grid Panel中设置如下代码即可,点击这里查看官方Paging Scroller分页功能代码。