Input Controls Types and Parameters

From ActionApps Documentation
Jump to: navigation, search

Text Area

Text Area - input for end users
Text Area - wizard

Text area with 60 columns

Parameters:

name type description example
row count (integer number) 20


Textarea with Presets

Textarea with presets - input for end users
Textarea with presets - wizard

Text area with values names list. When you choose a name from the list, the appropriate value is printed in the text area Parameters:

name type description example
rows (integer number) Textarea rows 4
cols (integer number) Text area columns 60


Rich Edit Text Area

Rich Edit Text Area - input for end users
Rich Edit Text Area - wizard

Rich edit text area. This operates the same way as Text Area in browsers which don't support the Microsoft TriEdit library. In IE 5.0 and higher and in Netscape 4.76 and higher (after installing the necessary features) it uses the TriEdit to provide an incredibly powerful HTML editor. Another possibility is to use the iframe version which should work in IE on Windows and Mac (set the 3rd parameter to "iframe"). The code for this editor is taken from the Wysiwyg open project (http://www.unica.edu/uicfreesoft/) and changed to fullfill our needs. See http://www.unica.edu/uicfreesoft/wysiwyg_web_edit/Readme_english.txt on details how to prepare Netscape. The javascript code needed to provide the editor is saved in two HTML files, so that the user doesn't have to load it every time she reloads the Itemedit web page. Parameters:

name type description example
row count (integer number) 10
column count (integer number) 70
type type: class (default) / iframe class

Text Field

Text field - input for end users.
Text field - wizard

A text field. Parameters:

name type description example
max characters (integer number) max count of characters entered (maxlength parameter) 254
width (integer number) width of the field in characters (size parameter) 30

Multiple text field

Multiple text field - input for end users
Multiple text field - wizard

Text field input type which allows you to enter more than one (multiple) values into one field (just like if you select multiple values from Multiple Selectbox). The new values are filled by popup box. Parameters:

name type description example
Show Actions (any text) Which action buttons to show: M - Move (up and down) D - Delete value, A - Add new value C - Change the value Use 'MDAC' (default), 'DAC', just 'M' or any other combination. The order of letters M,D,A,C is not important. MDAC
Row count (integer number) Number of rows (values) displayed at once 6

Text field with presets

Text field with presets - input for end users
Text field with presets - wizard

Text field with values names list. When you choose a name from the list, the appropriate value is printed in the text field Parameters:

name type description example
max characters (integer number) max count of characteres entered in the text field (maxlength parameter) 254
width (integer number) width of the text field in characters (size parameter) 20
slice field (field id) field (or format string) that will be displayed in select box (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) category........
use name (boolean: 0=false,1=true) if set (=1), then the name of selected constant is used, insted of the value. Default is 0
adding (boolean: 0=false,1=true) adding the selected items to input field comma separated
secondfield (field id) field_id of another text field, where value of this selectbox will be propagated too (in main text are will be text and there will be value) source_href.....
add2constant (boolean: 0=false,1=true) if set to 1, user typped value in inputform is stored into constants (only if the value is not already there)
Show items from bins (integer number) (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 3
Filtering conditions (any text) (for slices only) Conditions for filtering items in selection. Use conds[] array. conds[0][category.......1]=Enviro&conds[1][switch.........2]=1
Sort by (any text) (for slices only) Sort the items in specified order. Use sort[] array sort[0][headline........]=a&sort[1][publish_date....]=d

Select Box

Select Box - input for end users
Select Box - wizard

A selectbox field with a values list. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice, usually with the f_v alias function) Parameters:

name type description example
slice field (field id) field (or format string) that will be displayed in select box (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) category........
use name (boolean: 0=false,1=true) if set (=1), then the name of selected constant is used, insted of the value. Default is 0
Show items from bins (integer number) (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 3
Filtering conditions (any text) (for slices only) Conditions for filtering items in selection. Use conds[] array. conds[0][category.......1]=Enviro&conds[1][switch.........2]=1
Sort by (any text) (for slices only) Sort the items in specified order. Use sort[] array sort[0][headline........]=a&sort[1][publish_date....]=d


Radio button

Radio button - input for end users
Radio button - wizard

Radio button group - the user may choose one value of the list. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice - it is obviously used with f_v alias function then) Parameters:

name type description example
Columns (integer number) Number of columns. If unfilled, the checkboxes are all on one line. If filled, they are formatted in a table. 3
Move right (boolean: 0=false,1=true) Should the function move right or down to the next value? 1
Slice field (field id) Field (or format string) that will be displayed as radiobuton's option (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) category........
Show items from bins (integer number) (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 3
Filtering conditions (any text) (for slices only) Conditions for filtering items in selection. Use conds[] array. conds[0][category.......1]=Enviro&conds[1][switch.........2]=1
Sort by (any text) (for slices only) Sort the items in specified order. Use sort[] array sort[0][headline........]=a&sort[1][publish_date....]=d


Date

Date - input for end users
Date - wizard

you can choose an interval from which the year will be offered Parameters:

name type description example
Starting Year (integer number) The (relative) start of the year interval 1
Ending Year (integer number) The (relative) end of the year interval 10
Relative (boolean: 0=false,1=true) If this is 1, the starting and ending year will be taken as relative - the interval will start at (this year - starting year) and end at (this year + ending year). If this is 0, the starting and ending years will be taken as absolute. 1
Show time (boolean: 0=false,1=true) show the time box? (1 means Yes, undefined means No) 1


Check box

Check box - input for end users

Multiple Checkboxes

Multiple checkboxes - input for end users
Multiple checkboxes - wizard

Multiple choice checkbox group. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice - it is obviously used with f_v alias function then) Parameters:

name type description example
Columns (integer number) Number of columns. If unfilled, the checkboxes are all on one line. If filled, they are formatted in a table. 3
Move right (boolean: 0=false,1=true) Should the function move right or down to the next value? 1
Slice field (field id) Field (or format string) that will be displayed as checbox options (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) category........
Show items from bins (integer number) (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 3
Filtering conditions (any text) (for slices only) Conditions for filtering items in selection. Use conds[] array. conds[0][category.......1]=Enviro&conds[1][switch.........2]=1
Sort by (any text) (for slices only) Sort the items in specified order. Use sort[] array sort[0][headline........]=a&sort[1][publish_date....]=d


Multiple Selectbox

Multiple selectbox - input for end users
Multiple selectbox - wizard

Multiple choice select box. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice - it is obviously used with f_v alias function then) Parameters:

name type description example
Row count (integer number) 5
Slice field (field id) field (or format string) that will be displayed in select box (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) category........
Show items from bins (integer number) (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 3
Filtering conditions (any text) (for slices only) Conditions for filtering items in selection. Use conds[] array. conds[0][category.......1]=Enviro&conds[1][switch.........2]=1
Sort by (any text) (for slices only) Sort the items in specified order. Use sort[] array sort[0][headline........]=a&sort[1][publish_date....]=d

Two boxes

Two boxes - input for end users
Two boxes - wizard

Two Boxes. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice - it is obviously used with f_v alias function then) Parameters:

name type description example
Row count (integer number) 5
Title of "Offer" selectbox (any text) Our offer
Title of "Selected" selectbox (any text) Selected
Slice field (field id) field (or format string) that will be displayed in the boxes (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) category........
Show items from bins (integer number) (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 3
Filtering conditions (any text) (for slices only) Conditions for filtering items in selection. Use conds[] array. conds[0][category.......1]=Enviro&conds[1][switch.........2]=1
Sort by (any text) (for slices only) Sort the items in specified order. Use sort[] array sort[0][headline........]=a&sort[1][publish_date....]=d


File upload

File upload - input for end users
File upload - wizard

File upload - a text field with the file find button Parameters:

name type description example
Allowed file types (any text) image/*
Label (any text) To be printed before the file upload field File:
Hint (any text) appears beneath the file upload field You can select a file ...

Related Item Window

Related Item Window - input for end users
Related Item Window - pop-up window shown after click on "Add"
Related Item Window - wizard

List of items connected with the active one - by using the buttons Add and Delete you show a window, where you can search in the items list Parameters:

name type description example
Row count (integer number) Row count in the list 15
Buttons to show (any text) Defines, which buttons to show in item selection: A - Add M - add Mutual B - Backward Use 'AMB' (default), 'MA', just 'A' or any other combination. The order of letters A,M,B is important. AMB
Admin design (boolean: 0=false,1=true) If set (=1), the items in related selection window will be listed in the same design as in the Item manager - 'Design - Item Manager' settings will be used. Only the checkbox will be replaced by the buttons (see above). It is important that the checkbox must be defined as: <input type=checkbox name="chb[x_#ITEM_ID#]" value="1"> (which is default). If unset (=0), just headline is shown (default).
Tag Prefix (any text) Selects tag set ('AMB' / 'GYR'). Ask Mitra for more details. AMB
Show Actions (any text) Which action buttons to show: M - Move (up and down) D - Delete relation, R - add Relation to existing item N - insert new item in related slice and make it related E - Edit related item Use 'DR' (default), 'MDRNE', just 'N' or any other combination. The order of letters M,D,R,N,E is not important. MDR
Show headlines from selected bins (integer number) To show headlines in related window from selected bins. Use this values for bins: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 3
Filtering conditions - unchangeable (any text) Conditions for filtering items in related items window. This conds user can't change.
Filtering conditions - changeable (any text) Conditions for filtering items in related items window. This conds user can change.
Slice field (field id) field (or format string) that will be displayed in the boxes (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - {publish_date....}). publish_date....


Do not show

This option hides the input field.

Hierarchical constants

A view with level boxes allows to choose constants. Parameters:

name type description example
Level count (integer number) Count of level boxes 3
Box width (integer number) Width in characters 60
Size of target (integer number) Lines in the target select box 5
Horizontal (boolean: 0=false,1=true) Show levels horizontally 1
First selectable (integer number) First level which will have a Select button
Level names Names of level boxes, separated by tilde (~). Replace the default Level 0, Level 1, ... Top level~Second level~Keyword

Password and Change password

Password and change password - input for end users
Password and change password - wizard

Password input boxes allowing to send password (for password-protected items) and to change password (including the "Retype password" box). When a user fills new password, it is checked against the retyped password, MD5-encrypted so that nobody may learn it and stored in the database. If the field is not Required, shows a 'Delete Password' checkbox. Parameters:

name type description example
Field size (integer number) Size of the three fields 60
Label for Change Password (any text) Replaces the default 'Change Password' Change your password
Label for Retype New Password (any text) Replaces the default "Retype New Password" Retype the new password
Label for Delete Password (any text) Replaces the default "Delete Password" Delete password (set to empty)
Help for Change Password (any text) Help text under the Change Password box (default: no text) To change password, enter the new password here and below
Help for Retype New Password (any text) Help text under the Retype New Password box (default: no text) Retype the new password exactly the same as you entered into "Change Password".

Hidden field

Hidden field - wizard

The field value will be shown as <input type='hidden'. You will probably set this filed by javascript trigger used on any other field.

Local URL picker

Local URL picker - input for end users
Local URL picker - wizard

You can use this window to browse your local web site and pick the URL that you want to use. Parameters:

name type description example
URL (any text) The URL of your local web server from where you want to start browsing for a particular URL. http#://www.ecn.cz/articles/solar.shtml