Textbox

From UG

Revision as of 19:33, 23 January 2010 (edit) Alex (Talk | contribs) (→Template for spec) ← Older edit		Current revision as of 20:41, 22 February 2010 (edit) (undo) Alex (Talk | contribs) (→Template)
(11 intermediate revisions not shown)
Line 3:		Line 3:
	== Intro ==		== Intro ==
-	Easily most used UI control.	+	Frequently used UI control.
	Used to enter text on forms.		Used to enter text on forms.
Line 9:		Line 9:
	== Major Functional 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. So in this case link should be provided instead of repeating definition.	+
	=== validation ===		=== validation ===
-	This relates to how / when we validate type/format.	+	see [[Validation]]
-		+
-	Possible values:	+
-		+
-	* [[stop on max]] - system will not let user enter more than X chars, it will simply silently stop as if we hit the wall	+
-	* [[zk standard]] - 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.	+
-	* none	+
	=== readonly ===		=== readonly ===
Line 55:		Line 39:
-	=== Template for spec ===
-	{| {{table}} border="1"	+
-	| '''Attribute:''' || '''Value:'''	+	== Template ==
-	|-	+
-	| default:     || blank / tbd	+	:: ''default:'' blank, from DB, etc
-	|-	+	:: ''datatype/format/Biz Obj:'' [[Datatypes#TBD]] or link to ''Business Object'' wiki
-	| type/format: || integer / decimal  / alphanumeric  / ascii	+
-	|-	+	:: ''required:''        N, Y
-	| required?:	+	:: ''validation type:'' [[Validation#zk_standard]], [[Validation#on submit]], [[Validation#ststus line]]
-	|-	+	:: ''readonly:''        N, Y
-	| validation type:   || stop on max / zk standard / on submit	+
-	|-	+
-	| read-only?:   || Y / N	+
-	|}	+
	== See also ==		== See also ==

---

Current revision as of 20:41, 22 February 2010

Contents 1 Intro 2 Major Functional Attributes 2.1 datatype/format 2.2 validation 2.3 readonly 2.4 default 3 Look and Feel attributes 3.1 width 4 Template 5 See also 6 Figures 6.1 Fig 1

[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

• http://en.wikipedia.org/wiki/Text_box

• In zk ref

• In Demo

• see also http://docs.zkoss.org/wiki/Developer_reference_The_XUL_Components_Overview_InputElement

[edit] Figures

[edit] Fig 1