@progress/sitefinity-widget-designers-sdk
Version:
This package aims to create a parity for widget designer generation similar to the [autogenerated widget designers](https://www.progress.com/documentation/sitefinity-cms/next.js-autogenerated-field-types) in Sitefinity. Due to some limitations in Typescri
400 lines (301 loc) • 169 kB
Markdown
# Sitefinity widget designers SDK
This package aims to create a parity for widget designer generation similar to the [autogenerated widget designers](https://www.progress.com/documentation/sitefinity-cms/next.js-autogenerated-field-types) in Sitefinity. Due to some limitations in Typescript and Javascript, there are several cases where additional data must be provided ([see usage guide](#usage)). Full API documentation could be found in the 'api.md' in the source.
## Intallation
via NPM:
```
npm i @progress/sitefinity-widget-designers-sdk --save
```
via yarn:
```
yarn add @progress/sitefinity-widget-designers-sdk
```
The package relies on the Typescript decorators, which requires adding support for decorators to your tsconfig.json file:
```json
{
"compilerOptions": {
"experimentalDecorators": true
}
}
```
## Concept
The metadata, generated from this package, aims to equal the metadata generated by Sitefinity or the ASP.NET Core external renderer and replace the usage of JSON metadata files in external renderers.
## Usage
### Exctracting the metadata
```ts
import { EntityMetadataGenerator, MetadataModel } from "@progress/sitefinity-widget-designers-sdk";
const designerMetadata: MetadataModel = EntityMetadataGenerator.extractMetadata(widgetEntity);
```
### Extracting default values from the metadata
The the metadata generator will go through the designer JSON definition, extract and parse the default value for each property is such is set. Normally the return type would match the type definition of the widget entity model.
```ts
import { EntityMetadataGenerator } from "@progress/sitefinity-widget-designers-sdk";
const defaultValues: { [key: string]: any } = EntityMetadataGenerator.extractDefaultValues(designerMetadata);
```
### Parsing serialized widget model values
Sitefinity preserves the widget data on the server in stringified JSON form so when it is received, a parsing depending on the property type is necessary to match the entity model properties' types.
```ts
import { EntityMetadataGenerator } from "@progress/sitefinity-widget-designers-sdk";
const deserializedValues: { [key: string]: any } = EntityMetadataGenerator.parseValues(valuesFromServerCall, designerMetadata);
```
### Creating a widget entity and property metadata
The widget model should be decorated using the WidgetEntity decorator.
```ts
import { WidgetEntity } from "@progress/sitefinity-widget-designers-sdk";
@WidgetEntity("SitefinitySection", "Section")
export class SectionEntity {
@Category('QuickEdit')
CssSystemGridSize: number = 12;
}
```
#### DataModel and Model property decorators
Properties that have complex models as types need their data models explicitly specified (while in C# these types and their subproperties would be generated OOB). For more details on complex objects [see here](#complex-objects)
```ts
import { Model, WidgetEntity} from "@progress/sitefinity-widget-designers-sdk";
@WidgetEntity("ComplexWidget", "Complex Widget")
class EntityWithComplexProperties {
@DisplayName("Complex property")
@DataModel(ComplexPropModel)
ComplexProperty?: ComplexPropModel;
}
@Model()
class ComplexPropModel {
@DataType("string")
ChildString: string | null = null;
}
```
is the same as in C#
```cs
public class EntityWithComplexProperties {
[DisplayName("Complex property")]
public ComplexPropModel ComplexProperty { get; set; }
}
public class ComplexPropModel {
public string ChildString { get; set; }
}
```
### Default values
The default value of the properties would be taken either from the DefaultValue decorator or a default value set to the property in the class declaration:
```ts
@DisplayName("Number prop")
@DefaultValue(42)
@DataType("number")
NumberProperty: number;
// DeafultValue="42" Type="number"
```
If a default value is set to basic types, the DataType decorator can be omitted. The following code would produce the same output:
```ts
@DisplayName("Number prop")
NumberProperty: number = 42;
// DeafultValue="42" Type="number"
```
### Property display configuration
Sections can be arraged either manually or via the _SectionsOrder_ class decorator.
Properties can be arranged in sections in the autogenerated designers and ordered by a given index via the _ContentSection_ decorator.
Sections can be separed in categories: _Basic_, _Advanced_, _QuickEdit_. Setting the category to the property will move the property there and create a section for it in that category.
Properties can be given several types of description via the _Description_ and _DescriptionExtended_ decorators.
```ts
@WidgetEntity('CustomEntity', 'Custom entity')
@SectionsOrder('First section', 'Second section')
class Entity {
@ContentSection('Second section', 0)
SecondSectionFirstProperty: any;
@ContentSection('Second section', 1)
SecondSectionSecondProperty: any;
@ContentSection('First section', 0)
@Description('simple description')
FirstSectionFirstProperty: any;
@Category('Advanced')
@DescriptionExtended({
Description: '...',
InlineDescription: '...',
InstructionalNotes: '...'
})
FirstPropertyAdvancedCategoryNewSection: any;
}
```
### Field type
The property editor field is defined via the _DataType_ decorator. Besides the basic types such as _string_, _number_, _bool_/_boolean_, there are some predefined types in the _KnownFieldTypes_ enum as well as the several variations in the _ComplexType_ enum. Types that are a variation of _choices_ should have a _Choice_ decorator defined as well.
```ts
@DataType('string')
StringProperty: string | null = null;
// @DataType('string') for basic types the decorator can be omitted if there is a default value of the same type set
StringProperty: string = 'default value';
@DataType(KnownFieldTypes.Choices)
@Choice([{Title: 'First choice', Value: 'first'}, {Title: 'Second choice', Value: 'second'}])
ChoiceProperty: string | null = null;
// checkbox
@DataType(KnownFieldTypes.CheckBox)
YesNoProperty: boolean = false;
// choices with multiple selection
@DataType(KnownFieldTypes.Choices)
@Choice([{Title: 'First choice', Value: 'first'}, {Title: 'Second choice', Value: 'second'}], true)
MultipleChoiceProperty: string = 'first';
// chip choice
@DataType(KnownFieldTypes.ChipChoice)
@Choice({Choices: [
{Title:'Yes', Name: 'Yes', Value: 'True', Icon: null},
{Title:'No', Name: 'No', Value: false, Icon: null}
]})
ChipChoiceSingle: boolean = true;
```
### Validation
Property values can be validated on the front end based on decorators set in the entity. Most of them can receive and custom validation failed error message.
- _Required_
- _Readonly_
- _Range_
- _MinLength_
- _MaxLength_
- _RegularExpression_:
- _Url_ (predefined regexp)
- _EmailAddress_ (predefined regexp)
- _DecimalPlaces_ (for floating point numbers)
- _StringLength_
### Associated content or media items
A property can refer to a content item of any of the types that are found or created in Sitefinity. The autogenerated designer will display a content selector for that content type. The full type name should be used - e.g. for _pages_: _Telerik.Sitefinity.Pages.Model.PageNode_
#### Related content and media
```ts
@Content({
Type: 'Telerik.Sitefinity.Pages.Model.PageNode',
AllowMultipleItemsSelection: false
})
SelectedPage: MixedContentContext = null;
// Media item is shorthand for Content
@MediaItem('images', true)
SelectedMedia: MixedContentContext = null;
@Content({
Type: 'Telerik.Sitefinity.Libraries.Model.Image',
AllowMultipleItemsSelection: false
})
FullDecoratorSelectedMedia: MixedContentContext = null;
```
#### Taxonomy
```ts
@TaxonomyContent({Type: 'Taxonomy_Tags'})
SelectedTags: MixedContentContext = null
// or
@TaxonomyContent({Type: 'Tags'})
ShorthandSelectedTags: MixedContentContext = null
```
### Conditional visibility
Fields can be shown or hidden based on other property values using the _ConditionalVisibility_ decorator.
```ts
FirstProperty: string = '';
@ConditionalVisibility({
conditions: [{
fieldName: 'FirstProperty',
operator: 'Equals',
value: 'show second property'
}]
})
SecondProperty: string = '';
```
### Complex objects
In the autogenerated designers in Sitefinity there are several ways to define and to represent properties with complex object types.
```ts
@DataModel(PropModel)
// @DataType(ComplexType.Complex)
ComplexObjProp: PropModel = null; // => renders a section with the model
@DataModel(PropModel)
// @DataType(ComplexType.Complex)
@TableView("TableTitle")
ComplextTableProp: PropModel = null; // => renders the model as a table
@DataModel(PropModel)
@DataType(ComplexType.Enumerable)
MultipleComplexObj: PropModel[] = null; // renders editable rows for each instance of the model
@DataModel(PropModel)
// @DataType(ComplexType.Enumerable)
@TableView({ Reorderable: true, Selectable: true, MultipleSelect: true })
MultipleComplexObj: PropModel[] = null; // renders full editable table with a row for each instance of the model
...
@Model()
class PropModel {
stringProp: string = "default-value";
numberProp: number = 13;
...
}
```
### Collections
Having a properties of collection types, it should be explicitly specified:
#### Array
Currently arrays are supported for **objects/classes** and **string** types. Other types would be rendered as a simple string field.
```ts
import { ComplexType, DataModel, DataType } from "@progress/sitefinity-widget-designers-sdk";
// would receive Type="enumerable"
@DataType(ComplexType.Enumerable, "string")
ValidStringCollection: string[] = null;
// would receive Type="enumerable"
@DataModel("string")
@DataType(ComplexType.Enumerable)
AlsoValidStringCollection: string[] = null;
// would receive Type="enumerable"
// with TypeChildProperties of the DataModel
@DataModel(ObjectModel)
@DataType(ComplexType.Enumerable)
ObjectCollection: ObjectModel[] = null
// invalid properties
// would receive Type=null
@DataType(ComplexType.Enumerable)
InvalidCollection: boolean[] | number[] = null;
```
#### Dictionary
Currently a collection of type dictionary is supported only when *LengthDependsOn* property decorator is also present and the value type is an object/class. Otherwise the field would be rendered as a simple string field. For collections of objects that don't depend on another property, we suggest using an array.
```ts
import { ComplexType, DataType, Model } from "@progress/sitefinity-widget-designers-sdk";
@DataModel(DictValue)
@DataType(ComplexType.Dictionary)
@LengthDependsOn("PropName", "PropDisplayName", "PropTitle")
ObjectDictionary: { [key: string]: DictValue } = null;
....
@Model()
class DictValue {
@DataType("number")
Int: number;
@DataType("string")
Str: string;
}
```
### Nested complex objects, collections with multiple properties
#### Nesting single objects
Single objects can be nested inside of each other and will appear as section in the parent object in the desginer. The objects on root will be displayed as an expanding section.
```ts
@Model()
class SimpleObject {
ChildProp1: string = '';
ChildProp2: string = '';
}
@Model()
class ParentComplex {
@ContentSection('', 0)
ParentProp1: string = '';
@ContentSection('', 1)
@DataModel(SimpleObject)
SimpleObject: SimpleObject;
}
@WidgetEntity('NestedSimpleObjects', 'Nested simple objects')
class NestedSimpleObjects {
@DataModel(ParentComplex)
ParentComplexObject: ParentComplex;
}
```
#### Complex objects/collections as tables
The limitations and suggested best practices, stated below, are based on the resulting usibility of the generated UI.
##### Nesting collections of objects
Nesting collections inside of collections (table views) are not allowed and will result in a string field instead of the child collection (it can be used to manually store the JSON representation of the values of the field). The only exception is a list of string as a child of the model for the collection.
```ts
@Model()
class ObjectWithStringList {
@ContentSection('', 0)
Prop1: string = '';
@ContentSection('', 1)
@DataType(ComplexType.Enumerable, 'string')
StringList: string[] = [];
}
@WidgetEntity('ComplexObjectsWithStrings', 'ComplexObjectsWithStrings')
class ComplexTableWithStringList {
@DataType(ComplexType.Enumerable)
@DataModel(ObjectWithStringList)
ComplexObjectsList: ObjectWithStringList[] = [];
}
```
![complex objects with string list](data:image/png;base64,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