Ajax fields in DG3
The fields in DG3 are independent input fields as we now them from traditional web design, but in DG3 we do not depend on the web forms and post mechanism used by traditional web pages. All forms are Ajax driven and updated in place form a data engine on the server. The form engine in DG3 are plugin based, so any type of element can be made into a field by our field api. That is why easily can support 3 different richtext editor and all traditional types of web fields.
In this document I will walk trough the different elements supported out of the box in all DG3 fields, what they mean and how you use them.
Main setting are divided in two parts, the all fields part and the one with individual settings for the field type. This is all the common settings:
Name | The tag id and the input name if field is input tag set in the tag Ex.:<input id="Name" name="Name" type="text">. This is also the name you must use for livelive values when using out livelive tag [[ Name ]] in redirect urls and other places supporting livelive tags. |
Field type |
The input type supported by DG3. What you see in this list depends on activated field types. Default is text, hidden, date, dropdown, list, checkbox, radiobutton, textedit, richtext, tinymce, ckedit and the html5 tags email and url. |
Style | is the class name set in the tag <input class="Style"... You can use this field to let the field pick up a class from your css. |
Extra style |
This can be used to define an individual style for this field. Anything you write inside this field is put into the style="Extra style content" |
Tag tail |
Used to add your extra settings inside the tag. Can be used to add other attributes supported by the tag. Ex.: placeholder="enter name" to use the new placeholder attribute with a text field or to set values from the url parameters by using value=[{ xdg3.url.search }] that sets value attribute to the search parameter found in a url like "/blogsearch/?search=frase to search" |
Default value |
This can be used to set a default value to a field if no value is set by the record. Use with care since a blank is no value when it comes to default value. The default value has to be in the form of a string surrounded by "" or as a live value in the form of any supported by the page. Ex. fixed value: "this is set if no other value is set" or live text: user.email or maindata.name or xdg3.url.paramname |
All field do also have some individual setting, in this section I will document the field in all common file types.
A standard text field that is shown.
Field size |
set the size attribute that calculates the width of the fields in characters, can be used to make the field larger or smaller |
Field length |
set the maxlength attribute that limit the number of characters that can be input using the field |
Hide input |
Used to make a password field that shows * instead of characters |
This is a field that can hold values you need for livelive or to set in the record when saving, but not want to show to the user.
Data map relates to how the field is connected to the server side data.
Source |
The datasource used by the field. Usually blank when you use the defined main table on the page. Can be internal, prism8 and external. Internal is only used to connect to fields in the User table used for authentication. |
Table |
Usually blank when you use the defined main table on the page. Can be User for internal and any datease table for prism8. |
Map to |
A dropdown with fields in the table selected or the page main table if that is used. Will set a new value to the Live field. |
Live | The name of the field we connect to if you can not select it using Map to. The two should be the same value if the field is selectable for a table definition. |
Extra relates to int code for javascript.