public class Input extends AbstractTag
AbstractTag.ExtraCtrl
AbstractComponent.Children
_tagnm
APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE
AFTER_CHILD_ADDED, AFTER_CHILD_REMOVED, AFTER_PAGE_ATTACHED, AFTER_PAGE_DETACHED, CE_BUSY_IGNORE, CE_DUPLICATE_IGNORE, CE_IMPORTANT, CE_NON_DEFERRABLE, CE_REPEAT_IGNORE
Modifier | Constructor and Description |
---|---|
|
Input() |
protected |
Input(java.lang.String tagnm) |
Modifier and Type | Method and Description |
---|---|
java.lang.String |
getAccept()
Returns the accept of this input tag.
|
java.lang.String |
getAlt()
Returns the alt of this input tag.
|
java.lang.String |
getAutocomplete()
Returns the autocomplete of this input tag.
|
java.lang.String |
getDirname()
Returns the dirname of this input tag.
|
java.lang.String |
getHeight()
Returns the height of this input tag.
|
java.lang.String |
getInputmode()
Returns the inputmode of this input tag.
|
java.lang.String |
getList()
Returns the list of this input tag.
|
java.lang.String |
getMax()
Returns the max of this input tag.
|
java.lang.Integer |
getMaxlength()
Returns the maxlength of this input tag.
|
java.lang.String |
getMin()
Returns the min of this input tag.
|
java.lang.String |
getName()
Returns the name of this input tag.
|
java.lang.String |
getPattern()
Returns the pattern of this input tag.
|
java.lang.String |
getPlaceholder()
Returns the placeholder of this input tag.
|
java.lang.String |
getSelectiondirection()
Returns the selectiondirection of this input tag.
|
java.lang.Integer |
getSize()
Returns the size of this input tag.
|
java.lang.String |
getSrc()
Returns the src of this input tag.
|
java.lang.Integer |
getStep()
Returns the step of this input tag.
|
java.lang.String |
getType()
Returns the type of this input tag.
|
java.lang.String |
getValue()
Returns the value of this input.
|
java.lang.String |
getWidgetClass()
Returns the widget class, "zhtml.Input".
|
java.lang.String |
getWidth()
Returns the width of this input tag.
|
boolean |
isAutofocus()
Returns the autofocus of this input tag.
|
boolean |
isChecked()
Returns if the input is checked (type: checkbox or radio).
|
boolean |
isDisabled()
Returns the disabled of this input tag.
|
boolean |
isMultiple()
Returns the multiple of this input tag.
|
boolean |
isReadonly()
Returns the readonly of this input tag.
|
boolean |
isRequired()
Returns the required of this input tag.
|
void |
service(AuRequest request,
boolean everError)
Processes an AU request.
|
void |
setAccept(java.lang.String accept)
Sets the accept of this input tag
|
void |
setAlt(java.lang.String alt)
Sets the alt of this input tag
|
void |
setAutocomplete(java.lang.String autocomplete)
Sets the autocomplete of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setAutofocus(boolean autofocus)
Sets the autofocus of this input tag.
|
void |
setChecked(boolean checked)
Sets if the input is checked (type: checkbox or radio).
|
void |
setDirname(java.lang.String dirname)
Sets the dirname of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setDisabled(boolean disabled)
Sets the disabled of this input tag.
|
void |
setHeight(java.lang.String height)
Sets the height of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setInputmode(java.lang.String inputmode)
Sets the inputmode of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setList(java.lang.String list)
Sets the list of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setMax(java.lang.String max)
Sets the max of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setMaxlength(java.lang.Integer maxlength)
Sets the maxlength of this input tag
|
void |
setMin(java.lang.String min)
Sets the min of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setMultiple(boolean multiple)
Sets the multiple of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setName(java.lang.String name)
Sets the name of this input tag
|
void |
setPattern(java.lang.String pattern)
Sets the pattern of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setPlaceholder(java.lang.String placeholder)
Sets the placeholder of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setReadonly(java.lang.Boolean readonly)
Sets the readonly of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setRequired(boolean required)
Sets the required of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setSelectiondirection(java.lang.String selectiondirection)
Sets the selectiondirection of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setSize(java.lang.Integer size)
Sets the size of this input tag
|
void |
setSrc(java.lang.String src)
Sets the src of this input tag
|
void |
setStep(java.lang.Integer step)
Sets the step of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
void |
setType(java.lang.String type)
Sets the type of this input tag
|
void |
setValue(java.lang.String value)
Sets the vallue of this input.
|
void |
setWidth(java.lang.String width)
Sets the width of this input tag
Notice that this attribute refers to the corresponding attribute of the HTML5 specification.
|
protected void |
smartUpdate(java.lang.String attr,
java.lang.Object value)
Smart-updates a property of the peer widget associated with
the component, running at the client, with the given value.
|
clone, getAccesskey, getDir, getDynamicProperty, getExtraCtrl, getLang, getPropertyAccess, getSclass, getStyle, getTabindex, getTag, getTitle, hasDynamicProperty, isChildable, isContenteditable, isDraggable, isHidden, isOrphanTag, isSpellcheck, redraw, redrawChildrenDirectly, renderProperties, setAccesskey, setContenteditable, setDir, setDraggable, setDynamicProperty, setHidden, setLang, setSclass, setSpellcheck, setStyle, setTabindex, setTitle, setVisible, shallHideId, toString
addAnnotation, addAnnotation, addCallback, addClientEvent, addEventHandler, addEventListener, addEventListener, addForward, addForward, addForward, addForward, addMoved, addRedrawCallback, addScopeListener, addShadowRoot, addShadowRootBefore, addSharedEventHandlerMap, appendChild, applyProperties, beforeChildAdded, beforeChildRemoved, beforeParentChanged, detach, didActivate, didActivate, didDeserialize, didDeserialize, disableBindingAnnotation, disableClientUpdate, enableBindingAnnotation, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttribute, getAttributeOrFellow, getAttributes, getAttributes, getAuService, getAutag, getCallback, getChildren, getClientAttribute, getClientDataAttribute, getClientEvents, getDefaultMold, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getEventListenerMap, getEventListeners, getFellow, getFellow, getFellowIfAny, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getNextSibling, getPage, getParent, getPreviousSibling, getRedrawCallback, getRoot, getShadowFellowIfAny, getShadowRoots, getShadowVariable, getShadowVariable, getShadowVariable0, getSpaceOwner, getSpecialRendererOutput, getStubonly, getSubBindingAnnotationCount, getTemplate, getTemplateNames, getUuid, getWidgetAttribute, getWidgetAttributeNames, getWidgetListener, getWidgetListenerNames, getWidgetOverride, getWidgetOverrideNames, hasAttribute, hasAttribute, hasAttribute, hasAttributeOrFellow, hasBindingAnnotation, hasFellow, hasFellow, hasSubBindingAnnotation, insertBefore, invalidate, invalidatePartial, isInitialized, isInvalidated, isListenerAvailable, isVisible, onChildAdded, onChildRemoved, onPageAttached, onPageDetached, onWrongValue, query, queryAll, redrawChildren, removeAttribute, removeAttribute, removeAttribute, removeCallback, removeChild, removeEventListener, removeForward, removeForward, removeRedrawCallback, removeScopeListener, removeShadowRoot, render, render, render, replace, response, response, response, service, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setAttribute, setAuService, setAutag, setClientAttribute, setClientDataAttribute, setDefinition, setDefinition, setId, setMold, setPage, setPageBefore, setParent, setStubonly, setStubonly, setSubBindingAnnotationCount, setTemplate, setVisibleDirectly, setWidgetAttribute, setWidgetClass, setWidgetListener, setWidgetOverride, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdateWidgetListener, smartUpdateWidgetOverride, updateByClient, updateSubBindingAnnotationCount, willPassivate, willPassivate, willSerialize, willSerialize
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
invalidatePartial
public java.lang.String getValue()
public void setValue(java.lang.String value) throws WrongValueException
WrongValueException
public boolean isChecked()
public void setChecked(boolean checked)
public java.lang.String getAccept()
public void setAccept(java.lang.String accept) throws WrongValueException
WrongValueException
public java.lang.String getAlt()
public void setAlt(java.lang.String alt) throws WrongValueException
WrongValueException
public java.lang.String getAutocomplete()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setAutocomplete(java.lang.String autocomplete) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public boolean isAutofocus()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setAutofocus(boolean autofocus) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.String getDirname()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setDirname(java.lang.String dirname) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public boolean isDisabled()
public void setDisabled(boolean disabled) throws WrongValueException
WrongValueException
public java.lang.String getHeight()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setHeight(java.lang.String height) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.String getInputmode()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setInputmode(java.lang.String inputmode) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.String getList()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setList(java.lang.String list) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.String getMax()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setMax(java.lang.String max) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.Integer getMaxlength()
public void setMaxlength(java.lang.Integer maxlength) throws WrongValueException
WrongValueException
public java.lang.String getMin()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setMin(java.lang.String min) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public boolean isMultiple()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setMultiple(boolean multiple) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.String getName()
public void setName(java.lang.String name) throws WrongValueException
WrongValueException
public java.lang.String getPattern()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setPattern(java.lang.String pattern) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.String getPlaceholder()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setPlaceholder(java.lang.String placeholder) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public boolean isReadonly()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setReadonly(java.lang.Boolean readonly) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public boolean isRequired()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setRequired(boolean required) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.String getSelectiondirection()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setSelectiondirection(java.lang.String selectiondirection) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.Integer getSize()
public void setSize(java.lang.Integer size) throws WrongValueException
WrongValueException
public java.lang.String getSrc()
public void setSrc(java.lang.String src) throws WrongValueException
WrongValueException
public java.lang.Integer getStep()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setStep(java.lang.Integer step) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.String getType()
public void setType(java.lang.String type) throws WrongValueException
WrongValueException
public java.lang.String getWidth()
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
public void setWidth(java.lang.String width) throws WrongValueException
Notice that this attribute refers to the corresponding attribute of the HTML5 specification. Hence, it would still be rendered to client-side as a DOM attribute even if the browser doesn’t support it.
WrongValueException
public java.lang.String getWidgetClass()
getWidgetClass
in interface Component
getWidgetClass
in class AbstractTag
Component.setWidgetClass(java.lang.String)
protected void smartUpdate(java.lang.String attr, java.lang.Object value)
AbstractComponent
The second invocation with the same property will replace the previous
call. In other words, the same property will be set only once in
each execution. If you prefer to send both updates to the client,
use AbstractComponent.smartUpdate(String, Object, boolean)
instead.
This method has no effect if AbstractComponent.invalidate()
is ever invoked
(in the same execution), since AbstractComponent.invalidate()
assumes
the whole content shall be redrawn and all smart updates to
this components can be ignored,
Once AbstractComponent.invalidate()
is called, all invocations to AbstractComponent.smartUpdate(String, Object)
will then be ignored, and AbstractComponent.redraw(java.io.Writer)
will be invoked later.
It can be called only in the request-processing and event-processing phases; excluding the redrawing phase.
There are two ways to draw a component, one is to invoke
Component.invalidate()
, and the other is AbstractComponent.smartUpdate(String, Object)
.
While Component.invalidate()
causes the whole content to redraw,
AbstractComponent.smartUpdate(String, Object)
let component developer control which part
to redraw.
smartUpdate
in class AbstractComponent
value
- the new value.
If it is DeferredValue
, the value
will be retrieved (by calling DeferredValue.getValue()
)
in the rendering phase. It is useful if the value can not be determined now.
For some old application servers (example, Websphere 5.1),
Execution.encodeURL(java.lang.String)
cannot be called in the event processing
thread. So, the developers have to use DeferredValue
or disable the use of the event processing thread
(by use of disable-event-thread
in zk.xml).
If you want to generate the JavaScript code directly (i.e.,
the value is a valid JavaScript snippet), you can use
JavaScriptValue
. Notice that the JavaScript code will be evaluated
before assigning it to the widget.
If the value is a Date object, a special pattern will be generated
(a.k.a., marshaling)
to ensure it can be unmarshalled back correctly at the client.
Notice that it is marshalled to a string based
on TimeZones.getCurrent()
, and then
unmarshalled back at the client. In other words, if the client
is in different time-zone, the value returned by getTime() might
be different. However, the value will remain the same if
the client marshalled the Date object back.
In other words, it assumes the browser's time zone from enduser's
perspective (not really browser's setting) shall be the same
as TimeZones.getCurrent()
.
If the value is a component, a special pattern will be generated to ensure it can be unmarshalled back correctly at the client.
In addition, the value can be any kind of objects that
the client accepts (marshaled by JSON) (see also JSONAware
).
AbstractComponent.updateByClient(java.lang.String, java.lang.Object)
,
AbstractComponent.smartUpdate(String, Object, boolean)
public void service(AuRequest request, boolean everError)
service
in interface ComponentCtrl
service
in class AbstractComponent
everError
- whether any error ever occurred before
processing this request.AbstractComponent.setAuService(org.zkoss.zk.au.AuService)
Copyright © 2005-2021 Potix Corporation. All Rights Reserved.