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);
// ...
OptionalborderWhether to show a border around the section.
OptionalcolumnsThe content of the 12 columns of a ROW section. Each element of the array may contain:
PDFTemplateSimpleField or PDFTemplateSimpleField;-, to indicate that the field in the previous column span over the represented column;OptionalcontextThe context to consider for the data of a INNER_SECTION or REPEATED_INNER_SECTION (inception).
OptionaldescriptionA description to help identify the section in the template.
OptionalinnerThe inner template for a INNER_SECTION or REPEATED_INNER_SECTION (inception).
OptionaltitleThe title of a HEADER section or INNER_SECTION (or REPATED_INNER_SECTION).
It's a Label (markdown) supporting variables substitution (e.g. Here's **@myVar**).
Note: the var substitution is made on runtime data, based on the section's context.
The type of section.
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
Whether the column identified by the index contains or not a field. It returns false in case the section isn't of type ROW.
Given the index of a column containing a field, return on how many columns the field spans.
Shortcut to Utils.isEmpty to check the emptiness of a field.
Optionaltype: isEmptyFieldTypesWhether the column identified by the index is empty or not.
Check whether the section is among one of the types selected.
Load the attributes from an already existing resource.
Optionallanguages: LanguagesRemove a field from the columns that it occupied before.
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.
Optionalvariables: (LabelVariable | StringVariable)[]errors if empty, the checkings are successfully passed.
Typical implementation:
const e = super.validate();
if(this.iE(this.attr)) e.push(`attr`);
// ...
return e;
The section of a multi-sections template for PDF printing of entities.