There are no dedicated showcase example pages for the Uize.Data module.

SEARCH FOR EXAMPLES

Use the link below to search for example pages on the UIZE Web site that reference the Uize.Data module...

SEARCH

The Uize.Data module defines the Uize.Data package under the Uize namespace.

1.2.1. Features Introduced in This Module

1.2.2. Features Overridden in This Module

1.2.3. Features Inherited From Other Modules

1.2.4. Modules Directly Under This Namespace

1.2.5. Unit Tests

Returns a boolean, indicating whether or not the two specified objects are identical clones of one another.

SYNTAX

areClonesBOOL = Uize.Data.clones (object1OBJ,object2OBJ);

Identical clones have identical structure, possess all the same values for corresponding simple valued properties, but may not share objects (so, object type properties' values may not be shared, either at a corresponding place in their structure, or at different places in their structure).

NOTES

IMPLEMENTATION INFO

Returns a boolean, indicating whether or not the two specified objects share any object references.

SYNTAX

areConjoinedBOOL = Uize.Data.conjoined (object1OBJ,object2OBJ);

NOTES

IMPLEMENTATION INFO

IMPLEMENTATION INFO

Returns an object with only the properties of the source object that are specified by an array of property names.

SYNTAX

filteredOBJ = Uize.Data.filter (sourceObjectOBJ,propertyNamesARRAY);

This method can be useful when receiving an info package of which only a subset needs to be stored or passed on to a subsequent process.

EXAMPLE

var someNodeStyle = {
  color:'#fff',
  left:'10px',
  top:'-50px',
  position:'absolute',
  display:'none',
  width:'200px',
  height:'300px',
  overflow:'hidden'
};
Uize.Node.setStyle (
  'someOtherNode',Uize.Data.filter (someNodeStyle,['left','top','width','height'])
);

In this example, a node style object that is being used for some node is being filtered for just its dimensions and positioning properties, to then be applied to some other node.

Without this method, the setStyle method call would look like...

Uize.Node.setStyle (
  'someOtherNode',
  {
    left:someNodeStyle.left,
    top:someNodeStyle.top,
    width:someNodeStyle.width,
    height:someNodeStyle.height
  }
);

IMPLEMENTATION INFO

Returns an array of records from the specified record set that match the specified criteria.

SYNTAX

matchingRecordsARRAY = Uize.Data.findRecords (recordsARRAY,matchOBJ);

EXAMPLE

var
  employees = [
    {firstName:'John',lastName:'Wilkey',department:'engineering'},
    {firstName:'Marie',lastName:'Stevenson',department:'finance'},
    {firstName:'Craig',lastName:'Pollack',department:'finance'},
    {firstName:'Nick',lastName:'Arendsen',department:'engineering'},
    {firstName:'Mark',lastName:'Strathley',department:'engineering'}
  ],
  financeEmployees = Uize.Data.findRecords (employees,{department:'finance'})
;

In the above example, the variable financeEmployees would be an array with the value...

[
  {firstName:'Marie',lastName:'Stevenson',department:'finance'},
  {firstName:'Craig',lastName:'Pollack',department:'finance'}
]

If the records in your record set are arrays, rather than objects, then you can specify a match object where the keys are numerical indexes representing the array element index / column index, as in...

EXAMPLE

var
  employees = [
    ['John','Wilkey','engineering'],
    ['Marie','Stevenson','finance'],
    ['Craig','Pollack','finance'],
    ['Nick','Arendsen','engineering'],
    ['Mark','Strathley','engineering']
  ],
  financeEmployees = Uize.Data.findRecords (employees,{2:'finance'})
;

In the above example, the financeEmployees variable would have the same value as in the previous example.

NOTES

IMPLEMENTATION INFO

Returns an array of the values for the specified column of the specified record set.

SYNTAX

columnValuesARRAY = Uize.Data.getColumn (rowsARRAY,columnNameSTR);

EXAMPLE

var
  peopleNames = [
    {first:'John',last:'Wilkey'},
    {first:'Marie',last:'Stevenson'},
    {first:'Craig',last:'Pollack'}
  ],
  firstNames = Uize.Data.getColumn (peopleNames,'first'),
  lastNames = Uize.Data.getColumn (peopleNames,'last')
;

In the above example, the variable firstNames would be an array with the value ['John','Marie','Craig'] and the variable lastNames would be an array with the value ['Wilkey','Stevenson','Pollack'].

The records / rows in the record set do not need to be objects - they can also be arrays.

EXAMPLE

var
  peopleNames = [
    ['John','Wilkey'],
    ['Marie','Stevenson'],
    ['Craig','Pollack']
  ],
  firstNames = Uize.Data.getColumn (peopleNames,0),
  lastNames = Uize.Data.getColumn (peopleNames,1)
;

In the above example, the firstNames and lastNames variables would have the same values as in the previous example.

VARIATION

columnValuesARRAY = Uize.Data.getColumn (rowsARRAY,columnNameSTR,onlyUniquesBOOL);

When the value true is specified for the optional onlyUniquesBOOL parameter, then this method will only return the unique values for the specified column.

EXAMPLE

var
  employees = [
    {firstName:'John',lastName:'Wilkey',department:'engineering'},
    {firstName:'Marie',lastName:'Stevenson',department:'finance'},
    {firstName:'Craig',lastName:'Pollack',department:'finance'},
    {firstName:'Nick',lastName:'Arendsen',department:'engineering'},
    {firstName:'Mark',lastName:'Strathley',department:'engineering'}
  ],
  departments = Uize.Data.getColumn (employees,'department',true)
;

In the above example, the variable departments would be an array with the value ['engineering','finance'].

IMPLEMENTATION INFO

IMPLEMENTATION INFO

IMPLEMENTATION INFO

IMPLEMENTATION INFO

IMPLEMENTATION INFO

IMPLEMENTATION INFO

Returns a boolean, indicating whether or not the two specified objects are identical in their contents.

SYNTAX

areIdenticalBOOL = Uize.Data.identical (object1OBJ,object2OBJ);

This method recurses through the two objects specified by the object1OBJ and object2OBJ parameters, testing that they have the same structure and property values. The two parameters can be arbitrarily complex data trees, or simple type values (ie. string, number, boolean). In order to be considered identical, the two objects must have the same structure and the same values at all levels of their structure.

VARIATION

areIdenticalBOOL = Uize.Data.identical (object1OBJ,object2OBJ,optionsOBJ);

When the optional optionsOBJ parameter is specified, comparison options can be specified to determine the criteria this method uses when comparing the two objects.

2.12.1. optionsOBJ

{
  equality : equalitySTR,             // 'type' | 'loose' | 'strict' (default)
  allowConjoined : allowConjoinedBOOL // false | true (default)
}

NOTES

IMPLEMENTATION INFO

Returns an object that represents the key-value intersection / commonality between the two specified objects.

SYNTAX

intersectionOBJ = Uize.Data.intersection (object1OBJ,object2OBJ);

EXAMPLE

var
  employee1 = {
    firstName:'John',
    lastName:'Wilkey',
    startYear:'2008',
    department:'engineering'
  },
  employee2 = {
    firstName:'John',
    lastName:'Henderson',
    startYear:'2008',
    department:'finance'
  },
  employeeInCommon = Uize.Data.intersection (employee1,employee2)
;

In the above example, the variable employeeInCommon would have the value {firstName:'John',startYear:'2008'}.

IMPLEMENTATION INFO

IMPLEMENTATION INFO

IMPLEMENTATION INFO

IMPLEMENTATION INFO

IMPLEMENTATION INFO

The Uize.Data.emptyOut static method has been deprecated in favor of the newly added Uize.emptyOut static method of the Uize base module.

Uize.Data.emptyOut >> BECOMES >> Uize.emptyOut

This method has been promoted to the Uize base module, retaining exactly the same arguments signature and behavior.

The Uize.Data.getKeys static method has been deprecated in favor of the newly added Uize.keys static method of the Uize base module.

Uize.Data.getKeys >> BECOMES >> Uize.keys

This method has been promoted to the Uize base module, retaining exactly the same arguments signature and behavior.

The Uize.Data.getLookup static method has been deprecated in favor of the newly added Uize.lookup static method of the Uize base module.

Uize.Data.getLookup >> BECOMES >> Uize.lookup

This method has been promoted to the Uize base module, retaining exactly the same arguments signature and behavior.

The Uize.Data.getReverseLookup static method has been deprecated in favor of the newly added Uize.reverseLookup static method of the Uize base module.

Uize.Data.getReverseLookup >> BECOMES >> Uize.reverseLookup

This method has been promoted to the Uize base module, retaining exactly the same arguments signature and behavior.

The Uize.Data.getTotalKeys static method has been deprecated in favor of the newly added Uize.totalKeys static method of the Uize base module.

Uize.Data.getTotalKeys >> BECOMES >> Uize.totalKeys

This method has been promoted to the Uize base module, retaining exactly the same arguments signature and behavior.

The Uize.Data.getValues static method has been deprecated in favor of the newly added Uize.values static method of the Uize base module.

Uize.Data.getValues >> BECOMES >> Uize.values

This method has been promoted to the Uize base module, retaining exactly the same arguments signature and behavior.

The Uize.Data.isEmpty static method has been deprecated in favor of the newly added Uize.isEmpty static method of the Uize base module.

Uize.Data.isEmpty >> BECOMES >> Uize.isEmpty

This method has been promoted to the Uize base module, retaining exactly the same arguments signature and behavior.

The Uize.Data.map static method has been deprecated in favor of the newly added Uize.map static method of the Uize base module.

This method has been promoted to the Uize base module, but the arguments signature has been changed. While the deprecated Uize.Data.map method accepts a mapper expression or function as its first argument and an array, object, or number as its second argument, these two arguments are swapped around in the Uize.map method. This is the more conventional signature for map type methods.

INSTEAD OF...

mappedARRAYorOBJ = Uize.Data.map (mapperSTRorFUNC,sourceARRAYorOBJorINT);

USE...

mappedARRAYorOBJ = Uize.map (sourceARRAYorOBJorINT,mapperSTRorFUNC);

Other than the change in its arguments signature, the Uize.map behaves in exactly the same way as the deprecated Uize.Data.map method. Because the Uize.Data.map method has been deprecated, it will live on for about another year, continuing to behave in the same way and using the same signature as before.

The Uize.Data.max static method has been deprecated in favor of the newly added Uize.max static method of the Uize base module.

Uize.Data.max >> BECOMES >> Uize.max

This method has been promoted to the Uize base module, retaining exactly the same arguments signature and behavior.

The Uize.Data.min static method has been deprecated in favor of the newly added Uize.min static method of the Uize base module.

Uize.Data.min >> BECOMES >> Uize.min

This method has been promoted to the Uize base module, retaining exactly the same arguments signature and behavior.

IMPLEMENTATION INFO