Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel
id0

Textbox

This element is used to display a text box on the page.

Attributes

NameDescriptionValue
id

Unique Identifier.

any
Any
name
A name that describes the Text box
The textbox name.Any
visiblemodesThe modes the
text box
textbox should be visible.A comma-separated list of the modes (read
/
, new
/
, edit)
visibilityconditionsThe conditions that should be met in order to display the
Text box
textbox.'[[pagefunction, datatype, datapath ]]' operator(==,!=) 'value'
readonlyIf
is
true then
text box cannot change value
the textbox value cannot be changed.true
,
or false
readonlyconditions

The conditions that should be met in order to display

the

text box

textbox in read only mode.

'[[pagefunction, datatype, datapath ]]' operator(==,!=) 'value'
datapathThe data path field name.Needs to correspond to the CRMDO object field
.
datatypeThe type of datapath field.alias, java.lang.Integer, java.lang.String, ...
refreshThe parts of the page
parts
that should be refreshed when
the text box change
the textbox value is changed.

page

mainmenu

main

details

tab,tabID

component,is_on_tab:is_on_menu:tabID:componentID

element,is_on_tab:is_on_menu:tabid:componentID:elementID

section,sectionID

area,areaID

dataformatting
Specific
Defines the formatting
of data
settings of the text to be displayed in a semicolon separated list.

DIGITS:3: number of decimal digits displayed for float fields

DATEONLY: show date only of a date-time field

TIMEONLY: show time only of a date-time field

PERSIAN: convert Persian (Jalali) date format

DURATIONDAYS: show duration in days of a special time duration float field

DURATIONHOURS: show duration in hours of a special time duration float field

DURATIONMINUTES: show duration in minutes of a special time duration float

size
the
The size of
text box
the textbox.

smaller(5 characters), small(8 characters),

normal(16 characters), large(32 characters)

url
if url is specify
If the URL is specified then the text in read mode is a link.Any
onchangeDefines the function call(s) triggered
when text box
when the textbox value is changed.<functions>…</functions>

...

clearonchangeIf set to true then the textbox will be cleared on change (when the Enter or Tab keys are pressed)true,false
focusonchangeIf set to true then the focus will go on this textbox again on change (when the Enter or Tab keys are pressed)true,false
leftsidelabelLabel on the left side of the valueany string for static labels, [[getValue,java.lang.String,datapath]] for dynamic labels
rightsidelabelLabel on the right side of the value
isautocompleteIf set to true then the textbox then previous values will be shown. By default is set to truetrue,false

Examples

Expand
titleTextbox

Image RemovedImage Added

Code Block
languagexml
themeEclipselanguagexml
titleTextbox
<textbox>
    <id>txtPayAmtValue</id>
    <datapath>totalAmount</datapath>
    <size>smaller</size>
    <dataformatting>DIGITS:2</dataformatting>
    <datatype>java.math.BigDecimal</datatype>
    <refresh>page</refresh>
    <onchange>
        <functions>
            <function>
                <type>ejb</type>
                <classname>ejb/CRMUIPayment</classname>
                <functionname>calculdateRoundedTotalAmount</functionname>
                <resultaction>replace</resultaction>
                <datatype>root</datatype>                        
                <parameters>
                    <parameter>
                        <value>[[getDTO]]</value>
                        <datatype>java.lang.Object</datatype>
                    </parameter>    
                </parameters>
            </function>
        </functions>
    </onchange>
</textbox> 
Expand
titleTextbox With Alias

Image Removed

Code Block
themeEclipse
languagexml
titleTextbox With Alias
<textbox>
        <id>txtIssuedOnAlias</id>
        <name>Issued On</id>    
        <value>[[notNull,java.lang.String,date1,java.lang.String,date2]]</value>
        <datapath>issuedOn</datapath>
        <datatype>alias</datatype>
</textbox>

Expand
titleTextbox With URL

Image Removed

Code Block
themeEclipse
languagexml
titleTextbox With URL
<textbox>
    <id>txtCode</id>
    <datapath>code</datapath>
    <url>page.do?xml=products/products&amp;act=summary</url>
</textbox>