Textbox

From UG

(Difference between revisions)
Jump to: navigation, search
(→Template)
 
(20 intermediate revisions not shown)
Line 1: Line 1:
-
[[Category:UI]]
+
[[Category:Widgets]]
== Intro ==
== Intro ==
-
Easily most used UI control.
+
Frequently used UI control.
Used to enter text on forms.
Used to enter text on forms.
-
== Major Attributes ==
+
== Major Functional Attributes ==
 +
=== datatype/format ===
-
=== type/format ===
+
See [[Datatypes]].
-
 
+
-
Type as in "data type".
+
-
 
+
-
This encompasses "constraints". Normally system validates these.
+
-
 
+
-
Possible values - see [[Datatypes]].
+
-
 
+
-
In ZK there are seperate widgets for some datatypes: "intbox", "decimalbox", etc.
+
-
 
+
-
This could/should be defined often "before" the UI - this is a property of class of corresponding object.
+
=== validation ===
=== validation ===
-
This relates to how / when we validate type/format.
+
see [[Validation]]
-
 
+
-
Possible values:
+
-
 
+
-
* stopOnMax - system will not let user enter more than X chars, it will simply silently stop as if we hit the wall
+
-
* zk validation - typical "real-time" ZK validation - on focus Off bar will appear with "x"
+
-
* on Submit - validate only after user clicked "Submit button". Standard Error pop-up will appear.
+
-
 
+
-
 
+
-
=== width ===
+
-
 
+
-
Defines how wide is a textbox on the screen.
+
-
 
+
-
Most of the times it is defined in number of chars (ZK '''cols''' attribute). But it could be also defined in pixels (ZK '''width''' attribute).
+
-
 
+
-
This is actually almost only style / layout issue.
+
-
 
+
=== readonly ===
=== readonly ===
Line 53: Line 28:
* value that comes from DB or memory
* value that comes from DB or memory
-
=== Template for spec ===
+
== Look and Feel attributes ==
-
{| {{table}} border="1"
+
=== width ===
-
| '''Value:'''
+
-
|-
+
-
| type/format:  || text
+
-
|-
+
-
| validation:  || tbd
+
-
|-
+
-
| width:        || tbd
+
-
|-
+
-
| read-only:    || tbd
+
-
|-
+
-
| default:      || blank
+
-
|-
+
-
|}
+
 +
Defines how wide is a textbox on the screen.
-
== Other Attributes ==
+
Most of the times it is defined in number of chars (ZK '''cols''' attribute). But it could be also defined in pixels (ZK '''width''' attribute).
-
=== value ===
+
This is actually almost only style / layout issue, could be defined in Style section. So in this case link should be provided instead of repeating definition.
-
Sets the text value.  
+
-
=== rows ===
 
-
Sets the rows. We consider row=1 for textbox. If not we call it [[Texarea]].
 
-
=== type ===
 
-
Values : text | password
 
-
=== constraint ===
 
-
Any.
 
-
=== width ===
+
== Template ==
-
Example:  width="50px"
+
-
=== readonly ===
+
:: ''default:''  blank, from DB, etc
-
Values : true|false
+
:: ''datatype/format/Biz Obj:'' [[Datatypes#TBD]] or link to ''Business Object'' wiki
-
== Template for spec ==
+
:: ''required:''        N, Y
 +
:: ''validation type:'' [[Validation#zk_standard]], [[Validation#on submit]], [[Validation#ststus line]]
 +
:: ''readonly:''        N, Y
-
{| {{table}} border="1"
+
== See also ==
-
| align="center" style="background:#f0f0f0;"|'''UI Control attribute:'''
+
-
| align="center" style="background:#f0f0f0;"|'''Value:'''
+
-
|-
+
-
| rows:      || 1
+
-
|-
+
-
| data type:  || text
+
-
|-
+
-
| width:      || tbd
+
-
|-
+
-
| maxlength  || tbd
+
-
|-
+
-
| constraint: || tbd
+
-
|-
+
-
| default:    || blank
+
-
|-
+
-
|}
+
-
== Links ==
+
* http://en.wikipedia.org/wiki/Text_box
* [http://docs.zkoss.org/wiki/Developer_reference_The_XUL_Components_Components_Textbox  In zk ref]
* [http://docs.zkoss.org/wiki/Developer_reference_The_XUL_Components_Components_Textbox  In zk ref]

Current revision as of 20:41, 22 February 2010


Contents

[edit] Intro

Frequently used UI control.

Used to enter text on forms.

[edit] Major Functional Attributes

[edit] datatype/format

See Datatypes.

[edit] validation

see Validation

[edit] readonly

Values: Y, N.

[edit] default

Values:

  • blank
  • constant
  • value that comes from DB or memory

[edit] Look and Feel attributes

[edit] width

Defines how wide is a textbox on the screen.

Most of the times it is defined in number of chars (ZK cols attribute). But it could be also defined in pixels (ZK width attribute).

This is actually almost only style / layout issue, could be defined in Style section. So in this case link should be provided instead of repeating definition.



[edit] Template

default: blank, from DB, etc
datatype/format/Biz Obj: Datatypes#TBD or link to Business Object wiki
required: N, Y
validation type: Validation#zk_standard, Validation#on submit, Validation#ststus line
readonly: N, Y

[edit] See also

[edit] Figures

[edit] Fig 1

File:Textbox.png

Retrieved from "https://wiki.jaguarfreight.com/Textbox"
Personal tools