aem-forms-af-runtime

@aemforms/af-core - v0.22.110

Table of contents

Interfaces

Classes

Type aliases

Variables

Enumerations

Functions

Namespaces

Type aliases

BaseJson

Ƭ BaseJson: TranslationBaseJson & RulesJson & ConstraintsJson & { :type?: string ; altText?: string ; appliedCssClassNames?: string ; buttonType?: string ; constraintMessages?: ConstraintsMessages ; dataRef?: string | null ; enabled?: boolean ; errorMessage?: string ; fieldType?: string ; label?: Label ; lang?: string ; name?: string ; properties?: { [key: string]: any; } ; repeatable?: boolean ; screenReaderText?: string ; tooltip?: string ; viewType?: string ; visible?: boolean }

Type for generic form properties based on adaptive form specification


CaptchaJson

Ƭ CaptchaJson: FieldJson & { captchaDisplayMode?: CaptchaDisplayMode ; captchaProvider?: string ; siteKey?: string }

Type for form captcha field properties based on adaptive form specification


ChangePayload

Ƭ ChangePayload: Object

Payload of change event

Type declaration

Name Type Description
changes { currentValue: any ; prevValue?: any ; propertyName: string }[] List of changes
eventSource? EventSource To identify the source(code/ui) of the event

ConstraintsJson

Ƭ ConstraintsJson: TranslationConstraintsJson & { accept?: string[] ; enforceEnum?: boolean ; exclusiveMaximum?: number ; exclusiveMinimum?: number ; format?: string ; maxFileSize?: number | string ; maxItems?: number ; maxLength?: number ; maxOccur?: number ; maximum?: number ; minItems?: number ; minLength?: number ; minOccur?: number ; minimum?: number ; pattern?: string ; required?: boolean ; step?: number ; type?: string ; uniqueItems?: boolean ; validationExpression?: string }

Type for constraint properties based on adaptive form specification


ConstraintsMessages

Ƭ ConstraintsMessages: Object

Type for constraint messages based on adaptive form specification

Type declaration

Name Type
accept? string
enum? string
exclusiveMaximum? string
exclusiveMinimum? string
format? string
maxFileSize? string
maxItems? string
maxLength? string
maximum? string
minItems? string
minLength? string
minimum? string
pattern? string
required? string
step? string
type? string
uniqueItems? string
validationExpression? string

ContainerJson

Ƭ ContainerJson: BaseJson & { activeChild?: string ; initialItems?: number ; items: (FieldJson | ContainerJson)[] }

Type for form container properties based on adaptive form specification


FieldJson

Ƭ FieldJson: BaseJson & TranslationFieldJson & { checked?: boolean ; default?: any ; displayFormat?: string ; displayValue?: string ; displayValueExpression?: string ; editFormat?: string ; editValue?: string ; emptyValue?: "null" | "undefined" | "" ; readOnly?: boolean ; valid?: boolean ; validationMessage?: string ; validity?: any ; value?: any }

Type for form field properties based on adaptive form specification


FieldsetJson

Ƭ FieldsetJson: ContainerJson & { readOnly?: boolean ; type?: "array" | "object" }

Type for form fieldset based on adaptive form specification


FormCreationMode

Ƭ FormCreationMode: "create" | "restore"


FormJson

Ƭ FormJson: ContainerJson & { action?: string ; adaptiveform?: string ; data?: any ; lang?: string ; metadata?: MetaDataJson ; title?: string }

Type for form model based on adaptive form specification


Items

Ƭ Items<T>: Object

Type for items property based on adaptive form specification

Type parameters

Name
T

Index signature

▪ [key: string]: T


Label

Ƭ Label: Object

Type for label based on adaptive form specification

Type declaration

Name Type
richText? boolean
value string
visible? boolean

MetaDataJson

Ƭ MetaDataJson: Object

Type for form metadata based on adaptive form specification

Type declaration

Name Type
grammar? string
version? string

Primitives

Ƭ Primitives: string | number | boolean | null | undefined

Type alias for primitive types


RulesJson

Ƭ RulesJson: Object

Type for constraint messages based on adaptive form specification

Type declaration

Name Type
events? Items<string[] | string | undefined>
rules? Items<string>

State

Ƭ State<T>: stateProps & T extends ContainerJson ? T & { items: State<FieldJson | ContainerJson>[] } : T

Generic type for a form object state

Type parameters

Name
T

TranslationJson

Ƭ TranslationJson: TranslationBaseJson & TranslationFieldJson & TranslationConstraintsJson

Type for all properties which can be translated based on adaptive form specification


UIChangePayload

Ƭ UIChangePayload: Object

Payload of UI change event. This payload is designed to encapsulate the details of changes initiated through UI interactions. It includes the new value of the element and the checked state that triggered the UI change event.

Type declaration

Name Type Description
checked? boolean The checked state of the element after the UI change.
value? any The new value of the element after the UI change.

Variables

CUSTOM_PROPS_KEY

CUSTOM_PROPS_KEY: "properties"


ConstraintType

ConstraintType: Readonly<{ ACCEPT_MISMATCH: "acceptMismatch" = ‘acceptMismatch’; EXCLUSIVE_MAXIMUM_MISMATCH: "exclusiveMaximumMismatch" = ‘exclusiveMaximumMismatch’; EXCLUSIVE_MINIMUM_MISMATCH: "exclusiveMinimumMismatch" = ‘exclusiveMinimumMismatch’; EXPRESSION_MISMATCH: "expressionMismatch" = ‘expressionMismatch’; FILE_SIZE_MISMATCH: "fileSizeMismatch" = ‘fileSizeMismatch’; FORMAT_MISMATCH: "formatMismatch" = ‘formatMismatch’; MAX_ITEMS_MISMATCH: "maxItemsMismatch" = ‘maxItemsMismatch’; MIN_ITEMS_MISMATCH: "minItemsMismatch" = ‘minItemsMismatch’; PATTERN_MISMATCH: "patternMismatch" = ‘patternMismatch’; RANGE_OVERFLOW: "rangeOverflow" = ‘rangeOverflow’; RANGE_UNDERFLOW: "rangeUnderflow" = ‘rangeUnderflow’; STEP_MISMATCH: "stepMismatch" = ‘stepMismatch’; TOO_LONG: "tooLong" = ‘tooLong’; TOO_SHORT: "tooShort" = ‘tooShort’; TYPE_MISMATCH: "typeMismatch" = ‘typeMismatch’; UNIQUE_ITEMS_MISMATCH: "uniqueItemsMismatch" = ‘uniqueItemsMismatch’; VALUE_MISSING: "valueMissing" = ‘valueMissing’ }>

ConstraintType is an object containing properties that represent the constraint types as per HTML5 specfication. Once can access these properties using dot notation (for example) (ConstraintType.PATTERN_MISMATCH, ConstraintType.TOO_SHORT, etc.).


FunctionRuntime

FunctionRuntime: FunctionRuntimeImpl


TRANSLATION_ID

TRANSLATION_ID: "afs:translationIds"

Name of the object which holds all translation specific properties


TRANSLATION_TOKEN

TRANSLATION_TOKEN: "##"

Token used while creating translation specific properties from adaptive form specification


constraintKeys

constraintKeys: Readonly<{ accept: "acceptMismatch" = ConstraintType.ACCEPT_MISMATCH; exclusiveMaximum: "exclusiveMaximumMismatch" = ConstraintType.EXCLUSIVE_MAXIMUM_MISMATCH; exclusiveMinimum: "exclusiveMinimumMismatch" = ConstraintType.EXCLUSIVE_MINIMUM_MISMATCH; format: "formatMismatch" = ConstraintType.FORMAT_MISMATCH; maxFileSize: "fileSizeMismatch" = ConstraintType.FILE_SIZE_MISMATCH; maxItems: "maxItemsMismatch" = ConstraintType.MAX_ITEMS_MISMATCH; maxLength: "tooLong" = ConstraintType.TOO_LONG; maximum: "rangeOverflow" = ConstraintType.RANGE_OVERFLOW; minItems: "minItemsMismatch" = ConstraintType.MIN_ITEMS_MISMATCH; minLength: "tooShort" = ConstraintType.TOO_SHORT; minimum: "rangeUnderflow" = ConstraintType.RANGE_UNDERFLOW; pattern: "patternMismatch" = ConstraintType.PATTERN_MISMATCH; required: "valueMissing" = ConstraintType.VALUE_MISSING; step: "stepMismatch" = ConstraintType.STEP_MISMATCH; type: "typeMismatch" = ConstraintType.TYPE_MISMATCH; uniqueItems: "uniqueItemsMismatch" = ConstraintType.UNIQUE_ITEMS_MISMATCH; validationExpression: "expressionMismatch" = ConstraintType.EXPRESSION_MISMATCH }>

This map consists of key which are constraints based on `adaptive form specification and value which specifies constraint types as per HTML5 specification


constraintProps

constraintProps: string[]

Constant for all properties which are constraints based on adaptive form specification


createFormInstance

createFormInstance: Object

Call signature

▸ (formModel, callback?, logLevel?, fModel?): FormModel

Creates form instance using form model definition as per adaptive form specification

Parameters
Name Type Default value Description
formModel any undefined form model definition
callback? (f: FormModel) => any undefined a callback that recieves the FormModel instance that gets executed before any event in the Form is executed
logLevel LogLevel 'error' Logging Level for the form. Setting it off will disable the logging
fModel any undefined existing form model, this is additional optimization to prevent creation of form instance
Returns

FormModel

form model

Type declaration

Name Type
currentVersion Version

translationProps

translationProps: string[]

Constant for all properties which can be translated based on adaptive form specification

Functions

checkIfConstraintsArePresent

Const checkIfConstraintsArePresent(item): boolean

Utility to check if the given form field has any data constraints

Parameters

Name Type Description
item FieldJson | FieldsetJson form field to check

Returns

boolean

true if item has data constraints, false otherwise


checkIfKeyAdded

checkIfKeyAdded(currentObj, prevObj, objKey): boolean

Checks if the key got added in current object

Parameters

Name Type
currentObj any
prevObj any
objKey string

Returns

boolean


createTranslationObject

Const createTranslationObject(input, additionalTranslationProps?, bcp47LangTags?): any

Creates translation object with BCP 47 language tags as key and value is a translation object. Key of translation object is generated based on the form hierarchy and it is separated by “##” token to signify that the id is machine generated (ie its not a human generated string)

Parameters

Name Type Default value Description
input any undefined form model definition
additionalTranslationProps string[] [] optional properties which needs to be translated, by default, only OOTB properties of form model definition is translated
bcp47LangTags string[] [] optional additional language tags

Returns

any

translation object for each bcp 47 language tag


defaultFieldTypes

Const defaultFieldTypes(schema): string

Returns the default view type for a given form field object based on adaptive form specification

Parameters

Name Type Description
schema any schema item for which default view type is to found

Returns

string

default view type


exportDataSchema

Const exportDataSchema(form): any

Creates a json schema from form model definition

Parameters

Name Type Description
form FormJson form model definition

Returns

any

json schema of form model definition


extractFileInfo

Const extractFileInfo(file): any

Utility to extract FileObject from string or HTML File data type

Parameters

Name Type
file any

Returns

any

list of FileObject


fetchForm

Const fetchForm(url, headers?): Promise<string>

Helper API to fetch form model definition from an AEM instance

Parameters

Name Type Description
url string URL of the instance
headers any HTTP headers to pass to the aem instance

Returns

Promise<string>

promise which resolves to the form model definition


getConstraintTypeMessages

Const getConstraintTypeMessages(): Object

API to get the constraint type messages

Returns

Object

Name Type
acceptMismatch "The specified file type not supported."
exclusiveMaximumMismatch "Value must be less than ${0}."
exclusiveMinimumMismatch "Value must be greater than ${0}."
expressionMismatch "Please enter a valid value."
fileSizeMismatch "File too large. Reduce size and try again."
formatMismatch "Specify the value in allowed format : ${0}."
maxItemsMismatch "Specify a number of items equal to or less than ${0}."
minItemsMismatch "Specify a number of items equal to or greater than ${0}."
patternMismatch "Please match the format requested."
rangeOverflow "Value must be less than or equal to ${0}."
rangeUnderflow "Value must be greater than or equal to ${0}."
stepMismatch "Please enter a valid value."
tooLong "Please shorten this text to ${0} characters or less."
tooShort "Please lengthen this text to ${0} characters or more."
typeMismatch "Please enter a valid value."
uniqueItemsMismatch "All the items must be unique."
valueMissing "Please fill in this field."

getFileSizeInBytes

Const getFileSizeInBytes(str): number

Converts file size in string to bytes based on IEC specification

Parameters

Name Type Description
str any file size

Returns

number

file size as bytes (in kb) based on IEC specification


getOrElse

Const getOrElse(input, key, defaultValue?): any

Gets the value for the given key from the input, in case of no value, default is returned

Parameters

Name Type Default value Description
input any undefined input object
key string | string[] undefined key to return from input object (key could be comma separated, example, label.value)
defaultValue any null default value

Returns

any


getProperty

Const getProperty<P>(data, key, def): P

Get the property value form the json

Type parameters

Name Description
P type for the default value

Parameters

Name Type Description
data any object as json
key string name of the key
def P default value

Returns

P


isButton

Const isButton(item): boolean

Checks if the input item provided is a button field

Parameters

Name Type Description
item FieldJson | FieldsetJson input item it could be Fieldset or Field

Returns

boolean

true if item is a form button, false otherwise


isCaptcha

Const isCaptcha(item): boolean

Checks if the input item provided is a captcha field

Parameters

Name Type Description
item FieldJson | FieldsetJson input item it could be Fieldset or Field

Returns

boolean

true if item is a form captcha, false otherwise


isCheckbox

Const isCheckbox(item): boolean

Checks if the input item provided is a form check box field

Parameters

Name Type Description
item FieldJson | FieldsetJson input item it could be Fieldset or Field

Returns

boolean

true if item is a form check box, false otherwise


isCheckboxGroup

Const isCheckboxGroup(item): boolean

Checks if the input item provided is a form check box group field

Parameters

Name Type Description
item FieldJson | FieldsetJson input item it could be Fieldset or Field

Returns

boolean

true if item is a form check box group, false otherwise


isDateField

Const isDateField(item): boolean

Checks if the input item provided is a date field

Parameters

Name Type Description
item FieldJson | FieldsetJson input item it could be Fieldset or Field

Returns

boolean

true if item is a form check box group, false otherwise


isEmailInput

Const isEmailInput(item): boolean

Checks if the input item provided is a form check box group field

Parameters

Name Type Description
item FieldJson | FieldsetJson input item it could be Fieldset or Field

Returns

boolean

true if item is a form check box group, false otherwise


isEmpty

Const isEmpty(value): boolean

Utility to check if the value is empty

Parameters

Name Type Description
value any value

Returns

boolean

true if value is empty, false otherwise


isFile

Const isFile(item): boolean

Checks if the input item provided is a form file attachment field

Parameters

Name Type Description
item FieldJson | FieldsetJson input item it could be Fieldset or Field

Returns

boolean

true if item is a form file attachment, false otherwise


isRepeatable

Const isRepeatable(obj): boolean

Parameters

Name Type
obj FieldJson | FieldsetJson

Returns

boolean


jsonString

Const jsonString(obj): string

Prettifies obj as json string

Parameters

Name Type Description
obj any object to prettify

Returns

string

json string


propertyChange

Const propertyChange(propertyName, currentValue, prevValue?): Change

Creates a change event

Parameters

Name Type Description
propertyName string name of the form field property
currentValue any current value
prevValue? any previous value

Returns

Change

Change change event


readAttachments

Const readAttachments(input, excludeUnbound?): Promise<any>

Returns the list of attachments with its data reference.

Parameters

Name Type Default value Description
input ContainerModel undefined The form model containing items.
excludeUnbound boolean false -

Returns

Promise<any>


registerFunctions

Const registerFunctions(functions): void

Parameters

Name Type
functions Object

Returns

void


restoreFormInstance

Const restoreFormInstance(formModel, data?, __namedParameters?): FormModel

Parameters

Name Type Default value
formModel any undefined
data any null
__namedParameters Object defaultOptions
__namedParameters.logLevel LogLevel undefined

Returns

FormModel


setCustomDefaultConstraintTypeMessages

Const setCustomDefaultConstraintTypeMessages(messages): void

API to override the custom default constraint messages

Parameters

Name Type Description
messages Record<string, string> messages to override as per {@link defaultConstraintTypeMessages} As an example, // Example usage: setCustomConstraintMessages({ 'pattern': 'Custom pattern mismatch message.', 'minLength': 'Custom too short message.', });

Returns

void


validateFormData

Const validateFormData(formModel, data): Object

Validates Form model definition with the given data

Parameters

Name Type Description
formModel any form model definition
data any form data

Returns

Object

Name Type
messages any[]
valid boolean

validateFormInstance

Const validateFormInstance(formModel, data): boolean

Validates Form model definition with the given data

deprecated use validateFormData

Parameters

Name Type Description
formModel any form model definition
data any form data

Returns

boolean

true, if form is valid against the given form data, false otherwise