Object initialization, setting all the default values.
OptionalnewData: anythe data to load, optional
Optionaloptions: anycustom options to apply; they will depend on the child resource
Usually, there is no need to implement the constructor; implicitly, it will call the load of the child resource
and therefore loading all the resources with default values.
If needed, this is the suggested implementation:
super();
this.load(x);
// ...
Additional information, shown below the name.
What qualifies the option among the others, e.g. the customer of a location or the country of a section. When at least two options have a different one, the list shows it as a section heading.
OptionalitemThe object the option was built from; it's kept as-is and never shown.
The label to show; it falls back to the value.
The unique identifier of the option.
Return an attribute in a cleaned standard that force-cast the element.
the origin attribute, to cast
the cast function, e.g. Boolean, Number, String, x => new CustomClass(x), etc.
OptionaldefaultVal: anyif set, the fallback value instead of null
cleaned attribute
Return an array in a cleaned standard that force-cast each element, keeping only the valid ones.
the origin array, to cast and check
the cast function, e.g. x => String(x) or x => new CustomClass(x)
OptionaldefaultVal: anyif set, the fallback value instead of null
cleaned array
Shortcut to Utils.isEmpty to check the emptiness of a field.
Optionaltype: isEmptyFieldTypesLoad the attributes from an already existing resource.
Optionalx: anyWhether the option matches a search query, on any of the text it shows.
Load the attributes from an already existing resource and then force some attributes to assume safeData values. The function is usually used in the back-end to mix together db data with new data, without the risk of changing ids and other attributes which are managed in appositely curated scenario.
the data to load
the attributes to force to specific values
Optionaloptions: anycustom options to apply; they will depend on the child resource
Typical implementation:
super.safeLoad(newData, safeData);
this.keyAttr = safeData.keyAttr;
this.importantAttr = safeData.importantAttr;
this.isDraft = safeData.isDraft;
// ...
Note well: there is no need to call this.load(), since it's implicitly called from super.safeLoad(),
which will anyway use the child version of the method.
Valide the object's attributes, performing all the checkings.
Optionaloptions: anycustom options to apply; they will depend on the implementations
errors if empty, the checkings are successfully passed.
Typical implementation:
const e = super.validate();
if(this.iE(this.attr)) e.push(`attr`);
// ...
return e;
StaticlistBuild a list of options from plain objects, leaving the ones that already are options untouched. Note: it returns a new array every time, so don't call it on a value that is recreated on every change detection (an inline literal in a template): keep the list in a field or a computed.
Optionaloptions: (PickOption<T> | PickOptionLike<T>)[]
An option that can be picked from a list, whether the pick is single or multiple.
It doesn't carry the selection: that belongs to whoever owns the value. Note:
itemis a free slot to keep the object the option was built from, so that the picked value can be resolved back to the domain without looking it up again.