ExtJS3 Row Editor Sample

The RowEditor plugin was recently added to the ExtJS examples page. It works a lot like a normal Grid Editor, except you can edit several fields on a given row at once before saving.

This neatly solves the problem of adding a new row to an editor grid, entering data into the first field and finding it save itself straight away, which is rarely desired. In this fashion we can provide full CRUD for simple models in a single page.

Installation

You’ll need to get a copy of the javascript, css and images from the server. This is a bit of a pain. If you still have theExtJS SDK around you can find these in the examples folder, if not you can get each file as follows:

Grab the plugin JS file below and put it where you usually put your .js files:
http://www.extjs.com/deploy/dev/examples/ux/RowEditor.js

This needs to go with your other stylesheets, usually in a directory called ‘css’:
http://www.extjs.com/deploy/dev/examples/ux/css/RowEditor.css

Download these two images and put them into your existing ‘images’ folder (the same place the other ExtJS images live):
http://www.extjs.com/deploy/dev/examples/ux/images/row-editor-bg.gif
http://www.extjs.com/deploy/dev/examples/ux/images/row-editor-btns.gif

Include the .js and .css files on your page and you should be ready to go.

Usage

RowEditor is a normal grid plugin, so you’ll need to instantiate it and add to your grid’s ‘plugins’ property. You also need to define what type of Editor is available (if any) on each column:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

var editor = new Ext.ux.grid.RowEditor(); var grid = new Ext.grid.GridPanel({   plugins: [editor],   columns: [     {       header   : 'User Name',       dataIndex: 'name',       editor   : new Ext.form.TextField()     },     {       header   : 'Email',       dataIndex: 'email',       editor   : new Ext.form.TextField()     }   ]   ... the rest of your grid config here });

RowEditor defines a few events, the most useful one being ‘afteredit’. Its signature looks like this:

1 2 3 4 5 6 7 8 9 10

/**  * @event afteredit  * Fired after a row is edited and passes validation.  This event is fired  * after the store's update event is fired with this edit.  * @param {Ext.ux.grid.RowEditor} roweditor This object  * @param {Object} changes Object with changes made to the record.  * @param {Ext.data.Record} r The Record that was edited.  * @param {Number} rowIndex The rowIndex of the row just edited  */ 'afteredit'

All you need to do is listen to that event on your RowEditor and save your model object appropriately. First though, we’ll define the Ext.data.Record that we’re using in this grid’s store:

1 2 3 4 5

var User = Ext.data.Record.create([   {name: 'user_id', type: 'int'},   {name: 'name',    type: 'string'},   {name: 'email',   type: 'string'} ]);

And now the afteredit listener itself

1 2 3 4 5 6 7 8 9 10 11 12 13 14

editor.on({   scope: this,   afteredit: function(roweditor, changes, record, rowIndex) {     //your save logic here - might look something like this:     Ext.Ajax.request({       url   : record.phantom ? '/users' : '/users/' + record.get('user_id'),       method: record.phantom ? 'POST'   : 'PUT',       params: changes,       success: function() {         //post-processing here - this might include reloading the grid if there are calculated fields       }     });   } });

The code above simply takes the changes object (which is just key: value object with all the changed fields) and issues a request to your server backend. ‘record.phantom’ returns true if this record does not yet exist on the server – we use this information above to specify whether we’re POSTing to /users or PUTing to /users/123, in line with normal RESTful practices.

Adding a new record

The example above allows for editing an existing record, but how do we add a new one? Like this:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

var grid = new Ext.grid.GridPanel({   //... the same config from above goes here,   tbar: [     {       text   : "Add User",       handler: function() {         //make a new empty User and stop any current editing         var newUser = new User({});         rowEditor.stopEditing();                   //add our new record as the first row, select it         grid.store.insert(0, newUser);         grid.getView().refresh();         grid.getSelectionModel().selectRow(0);                   //start editing our new User         rowEditor.startEditing(0);       }     }   ] });

Pretty simple stuff – we’ve just added a toolbar with a button which, when clicked, creates a new User record, inserts it at the top of the grid and focusses the RowEditor on it.

Configuration Options

Although not documented, the plugin has a few configuration options:

1 2 3 4 5 6

var editor = new Ext.ux.grid.RowEditor({   saveText  : "My Save Button Text",   cancelText: "My Cancel Button Text",   clicksToEdit: 1, //this changes from the default double-click activation to single click activation   errorSummary: false //disables display of validation messages if the row is invalid });

If you want to customise other elements of the RowEditor you probably can do it.