Textbox

From UG

Revision as of 00:20, 24 January 2010 (edit) Alex (Talk | contribs) (→stop on max) ← Older edit		Revision as of 18:41, 26 January 2010 (edit) (undo) Alex (Talk | contribs) (→Major Functional Attributes) Newer edit →
Line 10:		Line 10:
-	=== type/format ===	+	=== datatype/format ===
-	Type as in "data type".	+	See [[Datatypes]].
-	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]]
-		+
-	==== hit the wall ====	+
-		+
-	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.	+
-		+
-	==== status line  ====	+
-		+
-	There is a status line somewhere on the panel that real time displays the problem.	+
	=== readonly ===		=== readonly ===

---

Revision as of 18:41, 26 January 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 for spec 5 See also 6 Figures 6.1 Fig 1

Intro

Easily most used UI control.

Used to enter text on forms.

Major Functional Attributes

datatype/format

See Datatypes.

validation

see Validation

readonly

Values: Y, N.

default

Values:

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

Look and Feel attributes

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.

Template for spec

Attribute:	Value:
widget type:	Textbox
adjusent label:	tbd
default:	blank / tbd
type/format:	integer / decimal / alphanumeric / ascii
required?:
validation type:	stop on max / zk standard / on submit
read-only?:	Y / N

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

Figures

Fig 1