Version 0.2.6

CHANGELOG.md

@@ -1,3 +1,24 @@
+### 0.2.6
+Bug Fixes and Improvements
+
+- TextCell should trigger and error and highlight the text area if the formatter
+  returns undefined. [Issue #149](https://github.com/wyuenho/backgrid/issues/149)
+- SelectCell and Select2Cell can now handle multiple
+  selections. [Issue #152](https://github.com/wyuenho/backgrid/issues/159)
+- ServerSideFilter's query parameter will now persist across server mode
+  pagination with
+  PageableCollection. [Issue #159](https://github.com/wyuenho/backgrid/issues/159)
+- Paginator no longer requires the column definition list in its constructor.
+- Paginator will no long page into the negative under server mode and when
+  there's no `totalRecords`
+  set. [Issue #33](https://github.com/wyuenho/backgrid/issues/33)
+- DatetimeFormatter now accepts UNIX offset values and MomentFormatter now
+  accepts both UNIX offset and UNIX timestamp
+  values. [Issue #145](https://github.com/wyuenho/backgrid/issues/145)
+- The `error` class can now be applied to cells without going into edit mode.
+- SelectCellEditor will now save the value if there's only one
+  option. [Issue #153](https://github.com/wyuenho/backgrid/issues/153)
+
 ### 0.2.5
 New Features
 

README.md

@@ -27,6 +27,7 @@ functionalities easy.
 - Chrome 4+
 - Safari 4+
 - Firefox 4+
+- Opera 9+
 
 ### Notes:
 
@@ -55,7 +56,7 @@ var columns = [{
   // Defines a cell type, and ID is displayed as an integer without the ',' separating 1000s.
   cell: Backgrid.IntegerCell.extend({
     orderSeparator: ''
-  })
+  }1)
 }, {
   name: "name",
   label: "Name",
@@ -83,11 +84,10 @@ var columns = [{
 var grid = new Backgrid.Grid({
   columns: columns,
   collection: territories,
-  footer: Backgrid.Paginator
 });
 
-// Render the grid and attach the root to your HTML document
-$("#example-1-result").append(grid.render().$el);
+// Render the grid and attach the Grid's root to your HTML document
+$("#example-1-result").append(grid.render().el);
 ```
 
 # Result:

api/data-03f6d0eff7392a61971ad69a7c3faeb8.js → api/data-2955af782e470c702685db56403591a1.js

@@ -217,6 +217,12 @@ Docs = {
         "private": null,
         "icon": "icon-class"
       },
+      {
+        "name": "Backgrid.SelectFormatter",
+        "extends": "Backgrid.CellFormatter",
+        "private": null,
+        "icon": "icon-class"
+      },
       {
         "name": "Backgrid.Grid",
         "extends": "Backbone.View",
@@ -1011,6 +1017,24 @@ Docs = {
         },
         "sort": 3
       },
+      {
+        "name": "multiple",
+        "fullName": "Backgrid.SelectCell.multiple",
+        "icon": "icon-property",
+        "url": "#!/api/Backgrid.SelectCell-property-multiple",
+        "meta": {
+        },
+        "sort": 3
+      },
+      {
+        "name": "formatter",
+        "fullName": "Backgrid.SelectCell.formatter",
+        "icon": "icon-property",
+        "url": "#!/api/Backgrid.SelectCell-property-formatter",
+        "meta": {
+        },
+        "sort": 3
+      },
       {
         "name": "optionValues",
         "fullName": "Backgrid.SelectCell.optionValues",
@@ -1020,6 +1044,15 @@ Docs = {
         },
         "sort": 3
       },
+      {
+        "name": "delimiter",
+        "fullName": "Backgrid.SelectCell.delimiter",
+        "icon": "icon-property",
+        "url": "#!/api/Backgrid.SelectCell-property-delimiter",
+        "meta": {
+        },
+        "sort": 3
+      },
       {
         "name": "initialize",
         "fullName": "Backgrid.SelectCell.initialize",
@@ -1819,19 +1852,19 @@ Docs = {
         "sort": 3
       },
       {
-        "name": "save",
-        "fullName": "Backgrid.Extension.TextareaEditor.save",
+        "name": "saveOrCancel",
+        "fullName": "Backgrid.Extension.TextareaEditor.saveOrCancel",
         "icon": "icon-method",
-        "url": "#!/api/Backgrid.Extension.TextareaEditor-method-save",
+        "url": "#!/api/Backgrid.Extension.TextareaEditor-method-saveOrCancel",
         "meta": {
         },
         "sort": 3
       },
       {
-        "name": "cancel",
-        "fullName": "Backgrid.Extension.TextareaEditor.cancel",
-        "icon": "icon-method",
-        "url": "#!/api/Backgrid.Extension.TextareaEditor-method-cancel",
+        "name": "clearError",
+        "fullName": "Backgrid.Extension.TextareaEditor.clearError",
+        "icon": "icon-property",
+        "url": "#!/api/Backgrid.Extension.TextareaEditor-property-clearError",
         "meta": {
         },
         "sort": 3
@@ -2090,6 +2123,33 @@ Docs = {
         },
         "sort": 3
       },
+      {
+        "name": "SelectFormatter",
+        "fullName": "Backgrid.SelectFormatter",
+        "icon": "icon-class",
+        "url": "#!/api/Backgrid.SelectFormatter",
+        "meta": {
+        },
+        "sort": 1
+      },
+      {
+        "name": "constructor",
+        "fullName": "Backgrid.SelectFormatter.constructor",
+        "icon": "icon-method",
+        "url": "#!/api/Backgrid.SelectFormatter-method-constructor",
+        "meta": {
+        },
+        "sort": 3
+      },
+      {
+        "name": "fromRaw",
+        "fullName": "Backgrid.SelectFormatter.fromRaw",
+        "icon": "icon-method",
+        "url": "#!/api/Backgrid.SelectFormatter-method-fromRaw",
+        "meta": {
+        },
+        "sort": 3
+      },
       {
         "name": "Grid",
         "fullName": "Backgrid.Grid",

api/index.html

@@ -12,7 +12,7 @@
   <link rel="stylesheet" href="resources/css/app-d837b293d081641aaa2111b87080b6d6.css" type="text/css" />
 
   <script type="text/javascript" src="extjs/ext-all.js"></script>
-  <script type="text/javascript" src="data-03f6d0eff7392a61971ad69a7c3faeb8.js"></script>
+  <script type="text/javascript" src="data-2955af782e470c702685db56403591a1.js"></script>
 
   <script type="text/javascript" src="app-9096a86b4ef476d85905927d55b2fdef.js"></script>
 
@@ -59,6 +59,7 @@ <h3>Formatters</h3>
 <li><a href="#!/api/Backgrid.EmailFormatter" rel="Backgrid.EmailFormatter" class="docClass">Backgrid.EmailFormatter</a></li>
 <li><a href="#!/api/Backgrid.NumberFormatter" rel="Backgrid.NumberFormatter" class="docClass">Backgrid.NumberFormatter</a></li>
 <li><a href="#!/api/Backgrid.DatetimeFormatter" rel="Backgrid.DatetimeFormatter" class="docClass">Backgrid.DatetimeFormatter</a></li>
+<li><a href="#!/api/Backgrid.SelectFormatter" rel="Backgrid.SelectFormatter" class="docClass">Backgrid.SelectFormatter</a></li>
 </ul>
 </div>
 <div class='right-column'>
@@ -128,7 +129,7 @@ <h3>Filter</h3>
         </div>
 
 
-  <div id='footer-content' style='display: none'>Generated on Sat 27 Apr 2013 19:31:16 by <a href='https://github.com/senchalabs/jsduck'>JSDuck</a> 4.8.0.</div>
+  <div id='footer-content' style='display: none'>Generated on Tue 07 May 2013 23:21:44 by <a href='https://github.com/senchalabs/jsduck'>JSDuck</a> 4.8.0.</div>
 
   <script type='text/javascript'>  var _gaq = _gaq || [];  _gaq.push(['_setAccount', 'UA-36403214-1']);  _gaq.push(['_setDomainName', 'backgridjs.com']);  _gaq.push(['_setAllowLinker', true]);  _gaq.push(['_trackPageview']); (function() {   var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;   ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';   var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })();</script>
 

api/output/Backgrid.BooleanCell.js

@@ -133,7 +133,7 @@ Ext.data.JsonP.Backgrid_BooleanCell({
 
     ]
   },
-  "linenr": 644,
+  "linenr": 643,
   "files": [
     {
       "filename": "cell.js",

api/output/Backgrid.BooleanCellEditor.js

@@ -109,7 +109,7 @@ Ext.data.JsonP.Backgrid_BooleanCellEditor({
 
     ]
   },
-  "linenr": 558,
+  "linenr": 557,
   "files": [
     {
       "filename": "cell.js",

api/output/Backgrid.CellFormatter.js

@@ -108,6 +108,7 @@ Ext.data.JsonP.Backgrid_CellFormatter({
     "Backgrid.EmailFormatter",
     "Backgrid.Extension.MomentFormatter",
     "Backgrid.NumberFormatter",
+    "Backgrid.SelectFormatter",
     "Backgrid.StringFormatter"
   ],
   "mixedInto": [
@@ -116,5 +117,5 @@ Ext.data.JsonP.Backgrid_CellFormatter({
   "parentMixins": [
 
   ],
-  "html": "<div><pre class=\"hierarchy\"><h4>Subclasses</h4><div class='dependency'><a href='#!/api/Backgrid.DatetimeFormatter' rel='Backgrid.DatetimeFormatter' class='docClass'>Backgrid.DatetimeFormatter</a></div><div class='dependency'><a href='#!/api/Backgrid.EmailFormatter' rel='Backgrid.EmailFormatter' class='docClass'>Backgrid.EmailFormatter</a></div><div class='dependency'><a href='#!/api/Backgrid.Extension.MomentFormatter' rel='Backgrid.Extension.MomentFormatter' class='docClass'>Backgrid.Extension.MomentFormatter</a></div><div class='dependency'><a href='#!/api/Backgrid.NumberFormatter' rel='Backgrid.NumberFormatter' class='docClass'>Backgrid.NumberFormatter</a></div><div class='dependency'><a href='#!/api/Backgrid.StringFormatter' rel='Backgrid.StringFormatter' class='docClass'>Backgrid.StringFormatter</a></div></pre><div class='doc-contents'><p>Just a convenient class for interested parties to subclass.</p>\n\n<p>The default Cell classes don't require the formatter to be a subclass of\nFormatter as long as the fromRaw(rawData) and toRaw(formattedData) methods\nare defined.</p>\n</div><div class='members'><div class='members-section'><div class='definedBy'>Defined By</div><h3 class='members-title icon-method'>Methods</h3><div class='subsection'><div id='method-constructor' class='member first-child not-inherited'><a href='#' class='side expandable'><span>&nbsp;</span></a><div class='title'><div class='meta'><span class='defined-in' rel='Backgrid.CellFormatter'>Backgrid.CellFormatter</span><br/></div><strong class='new-keyword'>new</strong><a href='#!/api/Backgrid.CellFormatter-method-constructor' class='name expandable'>Backgrid.CellFormatter</a>( <span class='pre'></span> ) : <a href=\"#!/api/Backgrid.CellFormatter\" rel=\"Backgrid.CellFormatter\" class=\"docClass\">Backgrid.CellFormatter</a></div><div class='description'><div class='short'> ...</div><div class='long'>\n<h3 class='pa'>Returns</h3><ul><li><span class='pre'><a href=\"#!/api/Backgrid.CellFormatter\" rel=\"Backgrid.CellFormatter\" class=\"docClass\">Backgrid.CellFormatter</a></span><div class='sub-desc'>\n</div></li></ul></div></div></div><div id='method-fromRaw' class='member  not-inherited'><a href='#' class='side expandable'><span>&nbsp;</span></a><div class='title'><div class='meta'><span class='defined-in' rel='Backgrid.CellFormatter'>Backgrid.CellFormatter</span><br/></div><a href='#!/api/Backgrid.CellFormatter-method-fromRaw' class='name expandable'>fromRaw</a>( <span class='pre'>rawData</span> ) : *</div><div class='description'><div class='short'>Takes a raw value from a model and returns an optionally formatted string\nfor display. ...</div><div class='long'><p>Takes a raw value from a model and returns an optionally formatted string\nfor display. The default implementation simply returns the supplied value\nas is without any type conversion.</p>\n<h3 class=\"pa\">Parameters</h3><ul><li><span class='pre'>rawData</span> : *<div class='sub-desc'>\n</div></li></ul><h3 class='pa'>Returns</h3><ul><li><span class='pre'>*</span><div class='sub-desc'>\n</div></li></ul></div></div></div><div id='method-toRaw' class='member  not-inherited'><a href='#' class='side expandable'><span>&nbsp;</span></a><div class='title'><div class='meta'><span class='defined-in' rel='Backgrid.CellFormatter'>Backgrid.CellFormatter</span><br/></div><a href='#!/api/Backgrid.CellFormatter-method-toRaw' class='name expandable'>toRaw</a>( <span class='pre'>formattedData</span> ) : *|undefined</div><div class='description'><div class='short'>Takes a formatted string, usually from user input, and returns a\nappropriately typed value for persistence in the model. ...</div><div class='long'><p>Takes a formatted string, usually from user input, and returns a\nappropriately typed value for persistence in the model.</p>\n\n<p>If the user input is invalid or unable to be converted to a raw value\nsuitable for persistence in the model, toRaw must return <code>undefined</code>.</p>\n<h3 class=\"pa\">Parameters</h3><ul><li><span class='pre'>formattedData</span> : string<div class='sub-desc'>\n</div></li></ul><h3 class='pa'>Returns</h3><ul><li><span class='pre'>*|undefined</span><div class='sub-desc'>\n</div></li></ul></div></div></div></div></div></div></div>"
+  "html": "<div><pre class=\"hierarchy\"><h4>Subclasses</h4><div class='dependency'><a href='#!/api/Backgrid.DatetimeFormatter' rel='Backgrid.DatetimeFormatter' class='docClass'>Backgrid.DatetimeFormatter</a></div><div class='dependency'><a href='#!/api/Backgrid.EmailFormatter' rel='Backgrid.EmailFormatter' class='docClass'>Backgrid.EmailFormatter</a></div><div class='dependency'><a href='#!/api/Backgrid.Extension.MomentFormatter' rel='Backgrid.Extension.MomentFormatter' class='docClass'>Backgrid.Extension.MomentFormatter</a></div><div class='dependency'><a href='#!/api/Backgrid.NumberFormatter' rel='Backgrid.NumberFormatter' class='docClass'>Backgrid.NumberFormatter</a></div><div class='dependency'><a href='#!/api/Backgrid.SelectFormatter' rel='Backgrid.SelectFormatter' class='docClass'>Backgrid.SelectFormatter</a></div><div class='dependency'><a href='#!/api/Backgrid.StringFormatter' rel='Backgrid.StringFormatter' class='docClass'>Backgrid.StringFormatter</a></div></pre><div class='doc-contents'><p>Just a convenient class for interested parties to subclass.</p>\n\n<p>The default Cell classes don't require the formatter to be a subclass of\nFormatter as long as the fromRaw(rawData) and toRaw(formattedData) methods\nare defined.</p>\n</div><div class='members'><div class='members-section'><div class='definedBy'>Defined By</div><h3 class='members-title icon-method'>Methods</h3><div class='subsection'><div id='method-constructor' class='member first-child not-inherited'><a href='#' class='side expandable'><span>&nbsp;</span></a><div class='title'><div class='meta'><span class='defined-in' rel='Backgrid.CellFormatter'>Backgrid.CellFormatter</span><br/></div><strong class='new-keyword'>new</strong><a href='#!/api/Backgrid.CellFormatter-method-constructor' class='name expandable'>Backgrid.CellFormatter</a>( <span class='pre'></span> ) : <a href=\"#!/api/Backgrid.CellFormatter\" rel=\"Backgrid.CellFormatter\" class=\"docClass\">Backgrid.CellFormatter</a></div><div class='description'><div class='short'> ...</div><div class='long'>\n<h3 class='pa'>Returns</h3><ul><li><span class='pre'><a href=\"#!/api/Backgrid.CellFormatter\" rel=\"Backgrid.CellFormatter\" class=\"docClass\">Backgrid.CellFormatter</a></span><div class='sub-desc'>\n</div></li></ul></div></div></div><div id='method-fromRaw' class='member  not-inherited'><a href='#' class='side expandable'><span>&nbsp;</span></a><div class='title'><div class='meta'><span class='defined-in' rel='Backgrid.CellFormatter'>Backgrid.CellFormatter</span><br/></div><a href='#!/api/Backgrid.CellFormatter-method-fromRaw' class='name expandable'>fromRaw</a>( <span class='pre'>rawData</span> ) : *</div><div class='description'><div class='short'>Takes a raw value from a model and returns an optionally formatted string\nfor display. ...</div><div class='long'><p>Takes a raw value from a model and returns an optionally formatted string\nfor display. The default implementation simply returns the supplied value\nas is without any type conversion.</p>\n<h3 class=\"pa\">Parameters</h3><ul><li><span class='pre'>rawData</span> : *<div class='sub-desc'>\n</div></li></ul><h3 class='pa'>Returns</h3><ul><li><span class='pre'>*</span><div class='sub-desc'>\n</div></li></ul></div></div></div><div id='method-toRaw' class='member  not-inherited'><a href='#' class='side expandable'><span>&nbsp;</span></a><div class='title'><div class='meta'><span class='defined-in' rel='Backgrid.CellFormatter'>Backgrid.CellFormatter</span><br/></div><a href='#!/api/Backgrid.CellFormatter-method-toRaw' class='name expandable'>toRaw</a>( <span class='pre'>formattedData</span> ) : *|undefined</div><div class='description'><div class='short'>Takes a formatted string, usually from user input, and returns a\nappropriately typed value for persistence in the model. ...</div><div class='long'><p>Takes a formatted string, usually from user input, and returns a\nappropriately typed value for persistence in the model.</p>\n\n<p>If the user input is invalid or unable to be converted to a raw value\nsuitable for persistence in the model, toRaw must return <code>undefined</code>.</p>\n<h3 class=\"pa\">Parameters</h3><ul><li><span class='pre'>formattedData</span> : string<div class='sub-desc'>\n</div></li></ul><h3 class='pa'>Returns</h3><ul><li><span class='pre'>*|undefined</span><div class='sub-desc'>\n</div></li></ul></div></div></div></div></div></div></div>"
 });

api/output/Backgrid.DateCell.js

@@ -157,7 +157,7 @@ Ext.data.JsonP.Backgrid_DateCell({
 
     ]
   },
-  "linenr": 526,
+  "linenr": 525,
   "files": [
     {
       "filename": "cell.js",

api/output/Backgrid.DatetimeCell.js

@@ -157,7 +157,7 @@ Ext.data.JsonP.Backgrid_DatetimeCell({
 
     ]
   },
-  "linenr": 460,
+  "linenr": 459,
   "files": [
     {
       "filename": "cell.js",