Standard edit field for entering data

Properties


Description

Background color

The Bootstrap color of the background (bg-primary, bg-success, bg-info, bg-warning, bg-danger, bg-light, bg-dark

DataField

Connected database field (DB variant)

DataSource

Name of the datasource (DB variant)

Datatype

Basic html datatype (email, number etc.). Do not use in combination with input type. This field will use Parsley as validator.

Important: the option 'AlphaNum' implies that you can only enter text characters. However space is not considered to be an alphanum value. So if you set this type and expect users to enter a text string without numbers, it will fail if the field contains spaces. Use the pattern field to overcome this. See documentation on Parsley.org.

Default

Default value of the field

EditState

This property applies to the non-db version only. Usually fields responds to the edit state of the assigned datastource. If the datasource is in read state, all fields are disabled. But if you need to combine controls that are not data-aware then you need to 'unbind' the variable. Values are 'automatic', it behaves like any other field, always on (the field can be edited any time) or always off (the field is always display-only).

Enabled

Future use.

Encode

Use html encoding for security. Since version 2.1 this setting is standard set to false. The property controls if input is being encoded or not. Developers tend to have different opinions about escaping special characters at the source (on input) or on output only. This property set to false will treat the input as raw data. (Btw. PHsPeed is protected against XSS, so actually you decide if you want to store data 'real' in the database, or 'escaped' in the database.

EscapeHTML

See PHP documentation

DeviceClass

See layout

Fieldlength

Max. lenght of the field

FieldColumnWidth

Deprecated

FieldLength

Max. length of the field in characters

Form

Name of the form to be used with the label (specifying will cause the label to be send with any submit utton to your application

Height

The height of the button in the designer. No function within bootstrap.

Hint

Baloon text on field info

InputSize

Default size of the field, by default inherited of the form component

InputType

Type of the field. Do not use in combination of data type.

Label

Descriptive text to be displayed inside the field

LabelBackgroundColor

Bootstrap color of the background

LabelColor

Bootstrap color of the label

LabelPosition

Position of the label. If set 'before' then you MUST apply a device setting to make space for the label.

Left

Location of the component in the designer. No function within bootstrap

MaximumLength

Validation of the field. PHsPeed uses the Parsley library.

MaximumValue

Validation of the field. PHsPeed uses the Parsley library.

MinimumLength

Validation of the field. PHsPeed uses the Parsley library.

MinimumValue

Validation of the field. PHsPeed uses the Parsley library.

Name

The internal name of the component (be careful if you need to change this.)

Owner

Owner of the component

Pattern

Validation of the field. PHsPeed uses the Parsley library.

PlaceHolder

Text to be displayed inside an empty field

PostText

Text to be displayed before the field

PreText

Text to be displayed after the field

ReadOnly

Makes the field display only

Required

Validation of the field. PHsPeed uses the Parsley library.

Sanitize

Sanitize field. This prevents entering malicious code and should be considered on fields that are internally long enough to contain scripts. It is an XSS protection, but not required on simple fields.

TextColor

Bootstrap color of the field

Top

Location of component in the designer. No function within bootstrap

Value

The value of the labelfield.

WhiteList

Whitelist of allowed tags in the field.

Width

The width of the button in the designer. No function within bootstrap.

PHP Events


Description

OnActivate

Triggers when all components are created

OnBlur

Triggers when a user leaves a field (only in conjunction with the JS Event)

OnChange

Triggers when the content of the field is changed (only in conjunction with the JS Event)

OnCreate

Triggers when the component is created

OnDestroy

Triggers when the component is destroyed

OnFocus

Triggers when the component gets focus (only in conjunction with the JS Event)

JavaScript Events        


Description

onBlur

Triggers when the focus leaves the field. (use with the PHP event to intercept)

onChange

Triggers when the field changes (use with the PHP event to intercept)

onFocus

Triggers when the field gets focus (use with the PHP event to intercept)