git.roojs.org Git - roojs1/blob - Roo/grid/EditorGrid.js

   1 /*
   2  * Based on:
   3  * Ext JS Library 1.1.1
   4  * Copyright(c) 2006-2007, Ext JS, LLC.
   5  *
   6  * Originally Released Under LGPL - original licence link has changed is not relivant.
   7  *
   8  * Fork - LGPL
   9  * <script type="text/javascript">
  10  */
  11
  12 /**
  13  * @class Roo.grid.EditorGrid
  14  * @extends Roo.grid.Grid
  15  * Class for creating and editable grid.
  16  * @param {String/HTMLElement/Roo.Element} container The element into which this grid will be rendered -
  17  * The container MUST have some type of size defined for the grid to fill. The container will be
  18  * automatically set to position relative if it isn't already.
  19  * @param {Object} dataSource The data model to bind to
  20  * @param {Object} colModel The column model with info about this grid's columns
  21  */
  22 Roo.grid.EditorGrid = function(container, config){
  23     Roo.grid.EditorGrid.superclass.constructor.call(this, container, config);
  24     this.getGridEl().addClass("xedit-grid");
  25
  26     if(!this.selModel){
  27         this.selModel = new Roo.grid.CellSelectionModel();
  28     }
  29
  30     this.activeEditor = null;
  31
  32         this.addEvents({
  33             /**
  34              * @event beforeedit
  35              * Fires before cell editing is triggered. The edit event object has the following properties <br />
  36              * <ul style="padding:5px;padding-left:16px;">
  37              * <li>grid - This grid</li>
  38              * <li>record - The record being edited</li>
  39              * <li>field - The field name being edited</li>
  40              * <li>value - The value for the field being edited.</li>
  41              * <li>row - The grid row index</li>
  42              * <li>column - The grid column index</li>
  43              * <li>cancel - Set this to true to cancel the edit or return false from your handler.</li>
  44              * </ul>
  45              * @param {Object} e An edit event (see above for description)
  46              */
  47             "beforeedit" : true,
  48             /**
  49              * @event afteredit
  50              * Fires after a cell is edited. <br />
  51              * <ul style="padding:5px;padding-left:16px;">
  52              * <li>grid - This grid</li>
  53              * <li>record - The record being edited</li>
  54              * <li>field - The field name being edited</li>
  55              * <li>value - The value being set</li>
  56              * <li>originalValue - The original value for the field, before the edit.</li>
  57              * <li>row - The grid row index</li>
  58              * <li>column - The grid column index</li>
  59              * </ul>
  60              * @param {Object} e An edit event (see above for description)
  61              */
  62             "afteredit" : true,
  63             /**
  64              * @event validateedit
  65              * Fires after a cell is edited, but before the value is set in the record.
  66          * You can use this to modify the value being set in the field, Return false
  67              * to cancel the change. The edit event object has the following properties <br />
  68              * <ul style="padding:5px;padding-left:16px;">
  69          * <li>editor - This editor</li>
  70              * <li>grid - This grid</li>
  71              * <li>record - The record being edited</li>
  72              * <li>field - The field name being edited</li>
  73              * <li>value - The value being set</li>
  74              * <li>originalValue - The original value for the field, before the edit.</li>
  75              * <li>row - The grid row index</li>
  76              * <li>column - The grid column index</li>
  77              * <li>cancel - Set this to true to cancel the edit or return false from your handler.</li>
  78              * </ul>
  79              * @param {Object} e An edit event (see above for description)
  80              */
  81             "validateedit" : true
  82         });
  83     this.on("bodyscroll", this.stopEditing,  this);
  84     this.on(this.clicksToEdit == 1 ? "cellclick" : "celldblclick", this.onCellDblClick,  this);
  85 };
  86
  87 Roo.extend(Roo.grid.EditorGrid, Roo.grid.Grid, {
  88     /**
  89      * @cfg {Number} clicksToEdit
  90      * The number of clicks on a cell required to display the cell's editor (defaults to 2)
  91      */
  92     clicksToEdit: 2,
  93
  94     // private
  95     isEditor : true,
  96     // private
  97     trackMouseOver: false, // causes very odd FF errors
  98
  99     onCellDblClick : function(g, row, col){
 100         this.startEditing(row, col);
 101     },
 102
 103     onEditComplete : function(ed, value, startValue){
 104         this.editing = false;
 105         this.activeEditor = null;
 106         ed.un("specialkey", this.selModel.onEditorKey, this.selModel);
 107         var r = ed.record;
 108         var field = this.colModel.getDataIndex(ed.col);
 109         var e = {
 110             grid: this,
 111             record: r,
 112             field: field,
 113             originalValue: startValue,
 114             value: value,
 115             row: ed.row,
 116             column: ed.col,
 117             cancel:false,
 118             editor: ed
 119         };
 120         if(String(value) !== String(startValue)){
 121
 122             if(this.fireEvent("validateedit", e) !== false && !e.cancel){
 123                 r.set(field, e.value);
 124                 delete e.cancel; //?? why!!!
 125                 this.fireEvent("afteredit", e);
 126             }
 127         } else {
 128             this.fireEvent("afteredit", e); // always fir it!
 129         }
 130         this.view.focusCell(ed.row, ed.col);
 131     },
 132
 133     /**
 134      * Starts editing the specified for the specified row/column
 135      * @param {Number} rowIndex
 136      * @param {Number} colIndex
 137      */
 138     startEditing : function(row, col){
 139         this.stopEditing();
 140         if(this.colModel.isCellEditable(col, row)){
 141             this.view.ensureVisible(row, col, true);
 142             var r = this.dataSource.getAt(row);
 143             var field = this.colModel.getDataIndex(col);
 144             var e = {
 145                 grid: this,
 146                 record: r,
 147                 field: field,
 148                 value: r.data[field],
 149                 row: row,
 150                 column: col,
 151                 cancel:false
 152             };
 153             if(this.fireEvent("beforeedit", e) !== false && !e.cancel){
 154                 this.editing = true;
 155                 var ed = this.colModel.getCellEditor(col, row);
 156                 if (!ed) {
 157                     return;
 158                 }
 159                 if(!ed.rendered){
 160                     ed.render(ed.parentEl || document.body);
 161                 }
 162                 (function(){ // complex but required for focus issues in safari, ie and opera
 163                     ed.row = row;
 164                     ed.col = col;
 165                     ed.record = r;
 166                     ed.on("complete", this.onEditComplete, this, {single: true});
 167                     ed.on("specialkey", this.selModel.onEditorKey, this.selModel);
 168                     this.activeEditor = ed;
 169                     var v = r.data[field];
 170                     ed.startEdit(this.view.getCell(row, col), v);
 171                 }).defer(50, this);
 172             }
 173         }
 174     },
 175
 176     /**
 177      * Stops any active editing
 178      */
 179     stopEditing : function(){
 180         if(this.activeEditor){
 181             this.activeEditor.completeEdit();
 182         }
 183         this.activeEditor = null;
 184     }
 185 });