Include files (*.inc) are evaluated within the referencing template and can be useful for repeated blocks of code. They can have parameters, such as :nc (do not evaluate comments) or :parameterName=pValue (named parameter), and are included with the /(!example) marker
Control Templates (*.ctrl) contain scripts to mimic default Plex behavior. Default templates can be overridden the control name property template= followed by the control template name without the extension, e.g. template=DojoDateEdit
Page Templates (*-page.wcli) must be below the root template function in the Plex inheritance path. It does not contain a complete HTML page, but it can contain any components that you want to manually add to any function in the inheritance path other than the root. It is always processed before the Control Template and applied by inheriting from the function with the same implementation name. Multiple Page templates can be applied and adds contents to defined attach points in the root template, e.g.:
/(!MainArea)
Anything here will be generated in the MainArea
/(!MainArea)
Root Templates (*-root) contain a complete HTML page, but nothing corresponds to a Plex panel control. It’s analogous to a root function (function shell) in Plex. It does not have to be the action diagram root, but it can be any function in the inheritance path. It’s the first template to be expanded during template generation. Each panel can only have one root, which contains ‘attach points’ to include later templates, e.g./(!AttachPoint:name=MainArea)
WebClient Control Name Parameters
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
label: String
The label of this field.
Control Name Parameter: label
Alternative way to set a label of the field.
For example: Plex edit field control name is set to myField.
You can set the control name of the Plex label field to myFieldLbl:myField.Label
labelWidth: String
The width of the field label. The value defaults to 40% unless specified in the controlName. The param name to specify the width is called width.
For example: width=50%
Control Name Parameter: width
yearFrom: Number
The start year for the calendar picker. If yearFrom is greated than yearTo then the order of years will be reversed.
Control Name Parameter: yearFrom
yearTo: Number
The last year for the calendar picker.
Control Name Parameter: yearTo
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
value: Object/Date
The calendar field value. Accepts an object of ‘year’, ’month’, and ’day’ values, all of which should be numbers, or a Date.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
change (Plex event: Updated)
Fires when a date is selected.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
label: String
The label of this field.
Control Name Parameter: label
Alternative way to set a label of the field.
For example: Plex edit field control name is set to myField.
You can set the control name of the Plex label field to myFieldLbl:myField.Label
Examples
value: Object/Date
The calendar field value. Accepts an object of ‘year’, ’month’, and ’day’ values, all of which should be numbers, or a Date.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
change (Plex event: Updated)
Fires when a date is selected.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
url: String
The location of the audio to play.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
iconCls: String
Optional CSS class to add to the icon element. This is useful if you want to use a CSS background image to create your Button icon.
Control Name Parameter: iconCls
The list of iconCls that can be used are below.
|
|
ui: String
Optional style to apply to your button.
Control Name Parameter: ui
The list of ui that can be used are below:
'normal'
- a basic gray button (default).'back'
- a back button.'forward'
- a forward button.'round'
- a round button.'plain'
'action'
- shaded using the $active-color .'decline'
- shaded using the $alert-color .'confirm'
- shaded using the $confirm-color .Examples
disabled: Boolean
Whether or not the component is disabled.
getPicture
Triggered after a photo is taken and accepted.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: cls
labelWidth: String
The width of the field label. The value defaults to 40% unless specified in the controlName. The param name to specify the width is called width.
For example: width=50%
Control Name Parameter: width
Examples
uncheckedValue: String
The unchecked value of the field.
checkedValue: String
The checked value of the field.
value: String
The value to submit if the item is in a checked state.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: cls
label: String
The label of this field.
Control Name Parameter: label
Alternative way to set a label of the field.
For example: Plex edit field control name is set to myField.
You can set the control name of the Plex label field to myFieldLbl:myField.Label
Example
options: Array
An array of select options.
value: String
A value to initialize this field with.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: cls
label: String
The label of this field.
Control Name Parameter: label
Alternative way to set a label of the field.
For example: Plex edit field control name is set to myField.
You can set the control name of the Plex label field to myFieldLbl:myField.Label
labelWidth: String
The width of the field label. The value defaults to 40% unless specified in the controlName. The param name to specify the width is called width.
For example: width=50%
Control Name Parameter: width
extraControl: Component
For attaching another edit field on the same row.
For example: The control name of the first edit field is myFirstField:MainArea
The control name of the second edit field is mySecondField:myFirstField.ExtraControl
placeHolder: String
A string value displayed in the input when the control is empty if specified in the control name.
Control Name Parameter: hint
Examples
value: Mixed
A value to initialize this field with.
maxLength: Number
The maximum number of permitted input characters.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
keyup (Plex event: Modified)
Fires when a key is released on the input element.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
baseCls: String
The base CSS class to apply to this component’s element.
Control Name Parameter: gridClass
The Grid Header Columns will be create with CSS class of "*gridClass*h". For example, if gridClass = myGrid, then the CSS class will be "myGridh".
CSS entries are need to in order to lay out the Editable Grid properly. Entries should look something like this (note: # needs to be the actual column number. The first column number is 0.):
.myGridh .head0 .col#,
.myGrid .col#{
width: 25%;
}
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
onItemDisclosure: Boolean
True to display a disclosure item on each list item.
Control Name Parameter: disclose
grouped: Boolean
Whether or not to group items in the provided Store with a header for each item.
Control Name Parameter: grouped
indexBar: Boolean
True to render an alphabet index bar docked on the right.
Control Name Parameter: indexBar
itemTpl: String
The template to use for each of the items displayed in the DataView.
Control Name Parameter: tplGenerator
Please note that for this control template, the tplGenerator should be set to " wcli.util.gridColTpl".
itemCls: String
An additional CSS class to apply to items within the DataView.
Control Name Parameter: itemClass
renderTplGenerator:String
The template to use for each of the columns displayed in the DataView.
Control Name Parameter: renderTplGenerator
Please note that for this control template, the renderTplGenerator should be set to "wcli.util.gridColHdr".
store: Object
Can either be a Store instance or a configuration object that will be turned into a Store.
disabled: Boolean
Whether or not the component is disabled.
itemtap (Plex event: Select)
Fires whenever an item is tapped
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
iconCls: String
Optional CSS class to add to the icon element. This is useful if you want to use a CSS background image to create your Button icon.
Control Name Parameter: iconCls
The list of iconCls that can be used are below.
|
|
ui: String
Optional style to apply to your button.
Control Name Parameter: ui
The list of ui that can be used are below:
'normal'
- a basic gray button (default).'back'
- a back button.'forward'
- a forward button.'round'
- a round button.'plain'
'action'
- shaded using the $active-color .'decline'
- shaded using the $alert-color .'confirm'
- shaded using the $confirm-color .
label: String
The label of this field.
Control Name Parameter: label
Alternative way to set a label of the field.
For example: Plex edit field control name is set to myField.
You can set the control name of the Plex label field to myFieldLbl:myField.Label
contactName: String
The name of the contact person.
Control Name Parameter: contact
Alternative way to set the contactName attribute.
For example: Plex edit field control name is set to myEmail.
You can set the control name of the Plex label field to myEmailLbl:myEmail.Label
confirmContact: Boolean
Display confirmation button if set to true. The default value is false.
Control Name Parameter: confirm
Examples
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
text: String
Display the text set in Plex panel properties.
contactUrl: String
The email address of the contact.
baseCls: String
The base CSS class to apply to this component’s element.
Control Name Parameter: gridClass
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
onItemDisclosure: Boolean
True to display a disclosure item on each list item.
Control Name Parameter: disclose
grouped: Boolean
Whether or not to group items in the provided Store with a header for each item.
Control Name Parameter: grouped
indexBar: Boolean
True to render an alphabet index bar docked on the right.
Control Name Parameter: indexBar
itemTpl: String
The template to use for each of the items displayed in the DataView.
Control Name Parameter: tplGenerator
itemCls: String
An additional CSS class to apply to items within the DataView.
Control Name Parameter: itemClass
Example
store: Object
Can either be a Store instance or a configuration object that will be turned into a Store.
disabled: Boolean
Whether or not the component is disabled.
itemtap (Plex event: Select)
Fires whenever an item is tapped.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
html: String
HTML content to render inside this Component or a reference to an existing element on the page.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
keyup (Plex event: Modified)
Fires when a key is released on the input element.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
controlName: String
This field contains a copy of control name property from the Plex panel.
html: String
HTML content to render inside this Component or a reference to an existing element on the page.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
mapType
Set using a separate control with the name "MapType". Defaults to "roadmap" if none if found.
zoomLevel
Set using a separate control with the name "Zoom". Defaults to "12" if none if found.
markerText
Set using a separate control with the name "MarkerText". Defaults to blank if none if found.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
label: String
The label of this field.
Control Name Parameter: label
Alternative way to set a label of the field.
For example: Plex edit field control name is set to myField.
You can set the control name of the Plex label field to myFieldLbl:myField.Label
maxRows: Number
The maximum number of lines made visible by the input. The default value is 5.
Control Name Parameter: maxRows
placeHolder: String
A string value displayed in the input when the control is empty if specified in the control name.
Control Name Parameter: hint
Examples
value: String
A value to initialize this field with.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
painted
Fires when the panel is first show on the device screen.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
keyup (Plex event: Modified)
Fires when a key is released on the input element.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
label: String
The label of this field.
Control Name Parameter: label
Alternative way to set a label of the field.
For example: Plex edit field control name is set to myField.
You can set the control name of the Plex label field to myFieldLbl:myField.Label
placeHolder: String
A string value displayed in the input when the control is empty if specified in the control name.
Control Name Parameter: hint
Examples
value: String
A value to initialize this field with.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
keyup (Plex event: Modified)
Fires when a key is released on the input element.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
iconCls: String
Optional CSS class to add to the icon element. This is useful if you want to use a CSS background image to create your Button icon.
Control Name Parameter: iconCls
The list of iconCls that can be used are below.
|
|
ui: String
Optional style to apply to your button.
Control Name Parameter: ui
The list of ui that can be used are below:
'normal'
- a basic gray button (default).'back'
- a back button.'forward'
- a forward button.'round'
- a round button.'plain'
'action'
- shaded using the $active-color .'decline'
- shaded using the $alert-color .'confirm'
- shaded using the $confirm-color .
label: String
The label of this field.
Control Name Parameter: label
Alternative way to set a label of the field.
For example: Plex edit field control name is set to myField.
You can set the control name of the Plex label field to myFieldLbl:myField.Label
Examples
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
text: String
Display the text set in Plex panel properties.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: cls
label: String
The label of this field.
Control Name Parameter: label
Alternative way to set a label of the field.
For example: Plex edit field control name is set to myField.
You can set the control name of the Plex label field to myFieldLbl:myField.Label
labelWidth: String
The width of the field label. The value defaults to 40% unless specified in the controlName. The param name to specify the width is called width.
For example: width=50%
Control Name Parameter: width
extraControl: Component
For attaching another edit field on the same row.
For example: The control name of the first edit field is myFirstField:MainArea
The control name of the second edit field is mySecondField:myFirstField.ExtraControl
placeHolder: String
A string value displayed in the input when the control is empty if specified in the control name.
Control Name Parameter: hint
value: Mixed
A value to initialize this field with.
maxLength: Number
The maximum number of permitted input characters.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
keyup (Plex event: Modified)
Fires when a key is released on the input element.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: cls
iconCls: String
Optional CSS class to add to the icon element. This is useful if you want to use a CSS background image to create your Button icon.
Control Name Parameter: iconCls
The list of iconCls that can be used are below.
|
|
ui: String
Optional style to apply to your button.
Control Name Parameter: ui
The list of ui that can be used are below:
'normal'
- a basic gray button (default).'back'
- a back button.'forward'
- a forward button.'round'
- a round button.'plain'
'action'
- shaded using the $active-color .'decline'
- shaded using the $alert-color .'confirm'
- shaded using the $confirm-color .Examples
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
text: String
Display the text set in Plex panel properties.
pressed (Plex event: Pressed)
Fires when a button is pressed.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
label: String
The label of this field.
Control Name Parameter: label
Examples
disabled: Boolean
Whether or not the component is disabled.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
keyup (Plex event: Modified)
Fires when a key is released on the input element.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
This is the root template for the mobile web application. The following attachpoints are defined.
HeadArea
Contains HTML elements that appear in the HTML <head> tag.
JSInit
Contains Javascript statements that will be executed upon initialization before the first panel is loaded.
HeaderArea
Contains WebMobile controls that appear at the top of the web panel.
MainArea
Contains WebMobile controls that appear at the content pane of the web panel.
HiddenArea
Contains WebMobile control that do not appear on the web panel.
FullscreenArea
Contains a Web Mobile control that expands to the size of the panel. Typically used for a list.
ToolbarArea
Contains Web Mobile controls that appear as elements in the toolbar.
TabbarArea
Contains Web Mobile controls that appear as elements in the tabbar.
FooterArea
Contains WebMobile controls that appear at the bottom of the web panel.
JSOnLoad
Contains Javascript statements that will be executed after the panel is loaded.
CSSArea
Contains CSS codes for the current panel.
JSOnReady
Contains Javascript statemens that will be executed after the application has been loaded.
LinkArea
Contains HTML link elements.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
value: Mixed
A value to initialize this field with.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
wclicls: String
A CSS class to override the base class CSS.
Control Name Parameter: class
label: String
The label of this field.
Control Name Parameter: label
Examples
value: String
A value to initialize this field with.
disabled: Boolean
Whether or not the component is disabled.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
keyup (Plex event: Modified)
Fires when a key is released on the input element.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
html: String
HTML content to render inside this Component or a reference to an existing element on the page.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
labelWidth: String
The width of the field label. The value defaults to 40% unless specified in the controlName. The param name to specify the width is called width.
For example: width=50%
Control Name Parameter: width
Examples
uncheckedValue: String
The unchecked value of the field.
checkedValue: String
The checked value of the field.
value: String
The value to submit if the item is in a checked state.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
focus (Plex event: Gained Focus)
Attempts to set the field as the active input focus.
blur (Plex event: Lost Focus)
Fires when the field loses input focus.
change (Plex event: Updated)
Fires just before the field blurs if the field value has changed.
controlName: String
This field contains a copy of control name property from the Plex panel.
cls: String
The CSS class to add to this control element.
Control Name Parameter: class
iconCls: String
Optional CSS class to add to the icon element. This is useful if you want to use a CSS background image to create your Button icon.
Control Name Parameter: iconCls
The list of iconCls that can be used are below.
|
|
ui: String
Optional style to apply to your button.
Control Name Parameter: ui
The list of ui that can be used are below:
'normal'
- a basic gray button (default).'back'
- a back button.'forward'
- a forward button.'round'
- a round button.'plain'
'action'
- shaded using the $active-color .'decline'
- shaded using the $alert-color .'confirm'
- shaded using the $confirm-color .Examples
text: String
Display the text set in Plex panel properties.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.
controlName: String
This field contains a copy of control name property from the Plex panel.
imageCls: String
The CSS class to use when mode is not set to ‘background.’ The default value is ‘x-image-component.’
Control Name Parameter: imageCls
imageAlign: String
Set the horizontal alignment of the control. The default value is ‘left.’
Control Name Parameter: imageAlign
mode: String
If set to ‘background’, uses a background-image CSS property instead of an <img> tag to display image. The default value is ‘background’.
src: String
The source of the image.
tap (Plex event: Pressed)
Fires when the image in tapped.
id: String
The unique id of this control.
name: String
The field’s HTML name attribute. This property comes from the first element in the control name.
controlName: String
This field contains a copy of control name property from the Plex panel.
url: String
Location of the video to play.
disabled: Boolean
Whether or not the component is disabled.
hidden: Boolean
Whether or not the component is hidden.