PropertiesObservableStore
Class Ext.data.GroupingStore
| Package: | Ext.data |
| Defined In: | GroupingStore.js |
| Class: | GroupingStore |
| Extends: | Store |
| xtype: | groupingstore |
A specialized store implementation that provides for grouping records by one of the available fields. This
+
\ No newline at end of file
+Success of the action is determined in the...
Observable
Class Ext.data.GroupingStore
| Package: | Ext.data |
| Defined In: | GroupingStore.js |
| Class: | GroupingStore |
| Extends: | Store |
A specialized store implementation that provides for grouping records by one of the available fields. This
is usually used in conjunction with an Ext.grid.GroupingView to proved the data model for
a grouped GridPanel.
Config Options
| Config Options | Defined By | |
|---|---|---|
| autoDestroy : Boolean true to destroy the store when the component the store is bound
to is destroyed (defaults to false).
@@ -182,68 +182,70 @@ If the Reader was constructed by passing... The Ext.data.Record.create for additional details).
This property may be used to create new Records of the type held in this Store, for example: | Store | |
Public Methods
| Method | Defined By | |
|---|---|---|
GroupingStore( Object config )
+ // create the Grid
+ var grid = new Ext.grid.EditorGridPanel({
+ store: store,
+ colModel: new Ext.grid.ColumnModel({
+ columns: [
+ {id:'company', header: 'Company', width: 160, dataIndex: 'company'},
+ {header: 'Price', renderer: 'usMoney', dataIndex: 'price'},
+ {header: 'Change', renderer: change, dataIndex: 'change'},
+ {header: '% Change', renderer: pctChange, dataIndex: 'pctChange'},
+ {header: 'Last Updated', width: 85,
+ renderer: Ext.util.Format.dateRenderer('m/d/Y'),
+ dataIndex: 'lastChange'}
+ ],
+ defaults: {
+ sortable: true,
+ width: 75
+ }
+ }),
+ autoExpandColumn: 'company', // match the id specified in the column model
+ height:350,
+ width:600,
+ title:'Array Grid',
+ tbar: [{
+ text: 'Add Record',
+ handler : function(){
+ var defaultData = {
+ change: 0,
+ company: 'New Company',
+ lastChange: (new Date()).clearTime(),
+ pctChange: 0,
+ price: 10
+ };
+ var recId = 3; // provide unique id
+ var p = new store.recordType(defaultData, recId); // create new record
+ grid.stopEditing();
+ store.insert(0, p); // insert a new record into the store (also see add)
+ grid.startEditing(0, 0);
+ }
+ }]
+ }); | Store | |
Public Methods
| Method | Defined By | |||
|---|---|---|---|---|
GroupingStore( Object config )
Creates a new GroupingStore. Creates a new GroupingStore. Parameters:
| GroupingStore | |||
add( Ext.data.Record[] records )
+and read the data into Records.Returns:
| GroupingStore | |||
add( Ext.data.Record[] records )
:
voidAdd Records to the Store and fires the add event. To add Records
to the store from a remote source use load({add:tru... Add Records to the Store and fires the add event. To add Records
to the store from a remote source use load({add:true}).
See also recordType and insert.Parameters:
| Store | |||
addEvents( Object object )
+to add to the cache. See recordType.Returns:
| Store | |||
addEvents( Object|String o, string Optional. )
:
- voidUsed to define events on this Observable Used to define events on this Observable Parameters:
| Observable | |||
addListener( String eventName, Function handler, [Object scope], [Object options] )
+ voidAdds the specified events to the list of events which this Observable may fire. Adds the specified events to the list of events which this Observable may fire. Parameters:
| Observable | |||
addListener( String eventName, Function handler, [Object scope], [Object options] )
:
voidAppends an event handler to this object. Appends an event handler to this object. Parameters:
| Observable | |||
addSorted( Ext.data.Record record )
:
void(Local sort only) Inserts the passed Record into the Store at the index where it
@@ -315,9 +317,42 @@ Ext.data.Record.COMMIT. Parameters:<
void Destroys the store. Destroys the store. Parameters:
| Store | |||
each( Function fn, [Object scope] )
:
voidCalls the specified function for each of the Records in the cache. Calls the specified function for each of the Records in the cache. | Store | |||
enableBubble( Object events )
- :
- voidUsed to enable bubbling of events Used to enable bubbling of events Parameters:
| Observable | |||
filter( String field, String/RegExp value, [Boolean anyMatch], [Boolean caseSensitive] )
+Returning false aborts and exits the iteration.scope : Object(optional) The scope ( this reference) in which the function is executed.
+Defaults to the current Record in the iteration.
| Store | |||
enableBubble( String/Array events )
+ :
+ voidEnables events fired by this Observable to bubble up an owner hierarchy by calling
+this.getBubbleTarget() if present... Enables events fired by this Observable to bubble up an owner hierarchy by calling
+ This is commonly used by Ext.Components to bubble events to owner Containers. See Ext.Component.getBubbleTarget. The default +implementation in Ext.Component returns the Component's immediate owner. But if a known target is required, this can be overridden to +access the required target more quickly. +Example: Parameters:
| Observable | |||
filter( String field, String/RegExp value, [Boolean anyMatch], [Boolean caseSensitive] )
:
voidFilter the records by a specified property. Filter the records by a specified property. Parameters:
| Store | |||
filterBy( Function fn, [Object scope] )
@@ -329,10 +364,10 @@ otherwise it is filtered out.Parameters:record : Ext.data.Record The record to test for filtering. Access field values using Ext.data.Record.get. The ID of the Record passed. scope : Object(optional) The scope of the function (defaults to this)
| Store | |||
find( String property, String/RegExp value, [Number startIndex], [Boolean anyMatch], [Boolean caseSensitive] )
+scope : Object(optional) The scope ( this reference) in which the function is executed. Defaults to this Store.
| Store | |||
find( String fieldName, String/RegExp value, [Number startIndex], [Boolean anyMatch], [Boolean caseSensitive] )
:
- NumberFinds the index of the first matching record in this store by a specific property/value. Finds the index of the first matching record in this store by a specific property/value. Parameters:
| Store | |||
findBy( Function fn, [Object scope], [Number startIndex] )
+ NumberFinds the index of the first matching Record in this store by a specific field value. Finds the index of the first matching Record in this store by a specific field value. Parameters:
| Store | |||
findBy( Function fn, [Object scope], [Number startIndex] )
:
NumberFind the index of the first matching Record in this Store by a function.
If the function returns true it is considere... Find the index of the first matching Record in this Store by a function.
@@ -340,9 +375,9 @@ If the function returns true it is considered a match. The record
to test for filtering. Access field values using Ext.data.Record.get.
The ID of the Record passed. scope : Object(optional) The scope of the function (defaults to this) startIndex : Number(optional) The index to start searching at
| Store | |||
findExact( String property, String/RegExp value, [Number startIndex] )
+scope : Object(optional) The scope ( this reference) in which the function is executed. Defaults to this Store.startIndex : Number(optional) The index to start searching at
| Store | |||
findExact( String fieldName, Mixed value, [Number startIndex] )
:
- NumberFinds the index of the first matching record in this store by a specific property/value. Finds the index of the first matching record in this store by a specific property/value. Parameters:
| Store | |||
fireEvent( String eventName, Object... args )
+ NumberFinds the index of the first matching Record in this store by a specific field value. Finds the index of the first matching Record in this store by a specific field value. Parameters:
| Store | |||
fireEvent( String eventName, Object... args )
:
BooleanFires the specified event with the passed parameters (minus the event name).
An event may be set to bubble up an Obse... Fires the specified event with the passed parameters (minus the event name). @@ -418,14 +453,14 @@ will be automatically included with the posted parameters according to the speci parameters to a remote data source. Note:params will override any
baseParams of the same name.
Parameters are encoded as standard HTTP parameters using Ext.urlEncode. A function to be called after the Records -have been loaded. The callback is called after the load event and is passed the following arguments:
Scope with which to call the callback (defaults + A function to be called after the Records +have been loaded. The callback is called after the load event is fired, and is passed the following arguments:
Scope with which to call the callback (defaults to the Store object) Indicator to append loaded records rather than + Indicator to append loaded records rather than replace the current cache. Note: see note for loadData
| Store | |||
loadData( Object data, [Boolean append] )
@@ -455,22 +490,30 @@ included in the results.Parameters:
The record to test for filtering. Access field values using Ext.data.Record.get. The ID of the Record passed. scope : Object(optional) The scope of the function (defaults to this)
| Store | |||
rejectChanges()
+scope : Object(optional) The scope ( this reference) in which the function is executed. Defaults to this Store.
| Store | |||
| rejectChanges()
:
void Reject outstanding changes on all modified records. | Store | |||
relayEvents( Object o, Array events )
:
- voidRelays selected events from the specified Observable as if the events were fired by this. Relays selected events from the specified Observable as if the events were fired by this. Parameters:
| Observable | |||
reload( [Object options] )
- :
- voidReloads the Record cache from the configured Proxy using the configured Reader and
-the options from the last load ope... Reloads the Record cache from the configured Proxy using the configured Reader and -the options from the last load operation performed. -Note: see the Important note in load. Parameters:
| Store | |||
remove( Ext.data.Record record )
+ voidRelays selected events from the specified Observable as if the events were fired by this. Relays selected events from the specified Observable as if the events were fired by this. Parameters:
| Observable | |||
reload( Object options )
+ :
+ voidReloads the Record cache from the configured Proxy using the configured
+Reader and the options from the last load ope... Reloads the Record cache from the configured Proxy using the configured +Reader and the options from the last load operation +performed. +Note: see the Important note in load. Parameters:
| Store | |||
remove( Ext.data.Record/Ext.data.Record[] record )
:
- voidRemove a Record from the Store and fires the remove event. Remove a Record from the Store and fires the remove event. Parameters:
| Store | |||
| removeAll()
+ void Remove Records from the Store and fires the remove event. Remove Records from the Store and fires the remove event. Parameters:
| Store | |||
removeAll( Boolean silent )
:
- voidRemove all Records from the Store and fires the clear event. Remove all Records from the Store and fires the clear event. Parameters:
| Store | |||
removeAt( Number index )
+ voidRemove all Records from the Store and fires the clear event. Remove all Records from the Store and fires the clear event. Parameters:
| Store | |||
removeAt( Number index )
:
voidRemove a Record from the Store at the specified index. Fires the remove event. Remove a Record from the Store at the specified index. Fires the remove event. Parameters:
| Store | |||
removeListener( String eventName, Function handler, [Object scope] )
:
@@ -482,7 +525,7 @@ event...Resume firing events. (see Parameters:
| Observable | |||
| save()
:
- void Saves all pending changes to the store. If the commensurate Ext.data.Api.actions action is not configured, then
+ Number Saves all pending changes to the store. If the commensurate Ext.data.Api.actions action is not configured, then
the ... Saves all pending changes to the store. If the commensurate Ext.data.Api.actions action is not configured, then
the configured url will be used.
@@ -491,7 +534,8 @@ change url removed records Ext.data.Api.actions.destroy phantom records Ext.data.Api.actions.create modified records Ext.data.Api.actions.update - Parameters:
| Store | |||
setBaseParam( String name, Mixed value )
+Parameters:
| Store | |||
setBaseParam( String name, Mixed value )
:
voidSet the value for a property name in this store's baseParams. Usage:myStore.setBaseParam('foo', {bar:3}); Set the value for a property name in this store's baseParams. Usage: Parameters:
| Store | |||
setDefaultSort( String fieldName, [String dir] )
:
@@ -515,11 +559,14 @@ after the Fires before a request is made for a new data object. If the beforeload handler returns
false the load action will b... | Store | |||
beforewrite :
- ( DataProxy this, String action, Record/Array[Record] rs, Object options, Object arg )
- Listeners will be called with the following arguments:
| Store | |||
clear :
- ( Store this )
- Fires when the data cache has been cleared. Fires when the data cache has been cleared. Listeners will be called with the following arguments:
| Store | |||
| datachanged :
+false the load action will be canceled. Listeners will be called with the following arguments:
| Store | |||
beforesave :
+ ( Ext.data.Store store, Object data )
+ Fires before a save action is called. A save encompasses destroying records, updating records and creating records. Fires before a save action is called. A save encompasses destroying records, updating records and creating records. Listeners will be called with the following arguments:
| Store | |||
beforewrite :
+ ( Ext.data.Store store, String action, Record/Array[Record] rs, Object options, Object arg )
+ Listeners will be called with the following arguments:
| Store | |||
clear :
+ ( Store this, Record[] The )
+ Fires when the data cache has been cleared. Fires when the data cache has been cleared. Listeners will be called with the following arguments:
| Store | |||
datachanged :
( Store this )
Fires when the data cache has changed in a bulk manner (e.g., it has been sorted, filtered, etc.) and a
widget that i... Fires when the data cache has changed in a bulk manner (e.g., it has been sorted, filtered, etc.) and a
@@ -545,15 +592,17 @@ for description. | Store this, Object meta )
Fires when this store's reader provides new metadata (fields). This is currently only supported for JsonReaders. Fires when this store's reader provides new metadata (fields). This is currently only supported for JsonReaders. Listeners will be called with the following arguments:
| Store | ||
remove :
( Store this, Ext.data.Record record, Number index )
- Fires when a Record has been removed from the Store Fires when a Record has been removed from the Store Listeners will be called with the following arguments:
| Store | |||
| update :
+ Fires when a Record has been removed from the Store Fires when a Record has been removed from the Store Listeners will be called with the following arguments:
| Store | |||
save :
+ ( Ext.data.Store store, Number batch, Object data )
+ Fires after a save is completed. A save encompasses destroying records, updating records and creating records. Fires after a save is completed. A save encompasses destroying records, updating records and creating records. Listeners will be called with the following arguments:
| Store | |||
update :
( Store this, Ext.data.Record record, String operation )
Fires when a Record has been updated Fires when a Record has been updated Listeners will be called with the following arguments:
| Store | |||
| write : + Ext.data.Record.REJECT + Ext.data.Record.COMMIT | Store | |||
write :
( Ext.data.Store store, String action, Object result, Ext.Direct.Transaction res, Record/Record[] rs )
Fires if the server returns 200 after an Ext.data.Api.actions CRUD action.
-Success or failure of the action is availa... Fires if the server returns 200 after an Ext.data.Api.actions CRUD action.
-Success or failure of the action is available in the result['successProperty'] property.
-The server-code might set the successProperty to false if a database validation
-failed, for example.Listeners will be called with the following arguments:
| Store | |||
Fires if the server returns 200 after an Ext.data.Api.actions CRUD action.
+Success of the action is determined in the
result['successProperty']property (NOTE for RESTful stores,
+a simple 20x response is sufficient for the actions "destroy" and "update". The "create" action should should return 200 along with a database pk).Listeners will be called with the following arguments:
store: Ext.data.Storeaction: String[Ext.data.Api.actions.create|update|destroy]result: ObjectThe 'data' picked-out out of the response for convenience.res: Ext.Direct.Transactionrs: Record/Record[]Store's records, the subject(s) of the write-action