Versions Compared

Key

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


Panel
nameidblue0

Textbox

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

Attributes

NameDescriptionValue
id

Unique Identifier.

Any
nameThe textbox name.Any
visiblemodesThe modes the 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 textbox.'[[pagefunction, datatype, datapath ]]' operator(==,!=) 'value'
readonlyIf true then the textbox value cannot be changed.true or false
readonlyconditions

The conditions that should be met in order to display the 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 that should be refreshed when 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

sizeThe size of the textbox.

smaller(5 characters), small(8 characters), normal(16 characters), large(32 characters)

urlIf the URL is specified then the text in read mode is a link.Any
onchangeDefines the function call(s) triggered 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>