Page History
...
Such array types are able to send granular updates between server and client. For example if you change from Rhino one element's value (or for more complex element property types - such as 'component' type - if something changes in only one of the array elements) then only the change is sent over to the browser/client instead of the whole array (and the other way around - a change on client doesn't send the full array to server). In the future array types might support granular updates for add/remove element operations as well but for now those operations will result in the full value being sent.
Array types are simply defined in .spec files using '[]' suffix.
...
| Code Block | ||
|---|---|---|
| ||
"model": {
(...)
"myIntArray": "int[]",
"myStringArray": "string[]",
"myCustomTypeArray": "person[]",
(...)
},
(...)
"types": {
"person": {
"firstName": "string",
"lastName": "string",
"photo": "dataprovider"
}
} |
Array types also allow configuration options to be specified for the element type (defaults/values/tags/... + some types support type specific configuration options in .spec file).
For example when you would have only one 'component' typed property in the component model, you could link it to a foundset like this (more info in 'component' property type):
| Code Block | ||
|---|---|---|
| ||
"model":
{
(...)
"myFoundset" : "foundset",
"childElement" : { "type" : "component", "forFoundset": "myFoundset" },
(...)
} |
But if you want to have an array of 'component' values that are all linked to a foundset you can use array specific configuration option 'elementConfig' like this
| Code Block | ||
|---|---|---|
| ||
"model":
{
(...)
"myFoundset" : "foundset",
"childElements" : { "type" : "component[]", "elementConfig" : { "forFoundset": "myFoundset" } },
(...)
} |
| Info |
|---|
"pushToServer" .spec setting of an array property is currently automatically inherited by the elements of that property (so any "pushToServer" setting defined on elements of the array, so in "elementConfig" will be ingnored). That means that for example if you define the array prop. to be "shallow" watched, all it's elements will be shallow watched. If you don't define pushToServer or define "reject" then the elements of that array will not be watched inside the browser and any changes to them will not be sent to the server. You should not use pushToServer: "deep" on array property types, as that will actually add a deep watch on the array and any change within an element of that array will be interpreted as an array prop. change and will send the full array value to the server. If you use "shallow" then the changes in array elements are watched anyway (so in the end it is similar to a deep watch), so you normally do not need "deep" anyway; "deep" is meant more for properties of types like 'object' where you can have random JSON content that you want to be deep watched (so it sends it's whole value to the server for any change - so without granular updates). |
Browser/client side value
...
Overview
Content Tools
Activity