org.apache.myfaces.trinidad.component.core.input.CoreInputNumberSpinbox Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of trinidad-api Show documentation
Show all versions of trinidad-api Show documentation
Public API for the Apache MyFaces Trinidad project
// WARNING: This file was automatically generated. Do not edit it directly,
// or you will lose your changes.
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.myfaces.trinidad.component.core.input;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Map;
import javax.faces.component.UIComponent;
import javax.faces.component.behavior.ClientBehavior;
import javax.faces.component.behavior.ClientBehaviorHolder;
import org.apache.myfaces.trinidad.bean.FacesBean;
import org.apache.myfaces.trinidad.bean.PropertyKey;
import org.apache.myfaces.trinidad.component.UIXInput;
import org.apache.myfaces.trinidad.util.ComponentUtils;
/**
*
*
* The inputNumberSpinbox component creates a browser input widget and up/down arrows.
* It is used to enter numbers and quickly step through the numbers using the up/down arrows.
* The number needs to be within the minimum and maximum.
* It also supports displaying a label, text, and messages.
*
*
* Events:
*
*
* Type
* Phases
* Description
*
*
* javax.faces.event.ValueChangeEventProcess
Validations
Apply
Request
Values
* The valueChange event is delivered when the value
attribute is changed.
*
*
* org.apache.myfaces.trinidad.event.AttributeChangeEventInvoke
Application
Apply
Request
Values
* Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change event might include the width of a column that supported client-side resizing.
*
*
*/
public class CoreInputNumberSpinbox extends UIXInput
implements ClientBehaviorHolder
{
static public final String AUTO_COMPLETE_ON = "on";
static public final String AUTO_COMPLETE_OFF = "off";
static public final String STYLE_CLASS_AFFIELD_TEXT_MARKER = "AFFieldTextMarker";
static public final String STYLE_CLASS_AFFIELD_TEXT_LTRMARKER = "AFFieldTextLTRMarker";
static public final String STYLE_CLASS_AFFIELD_NUMBER_MARKER = "AFFieldNumberMarker";
static public final FacesBean.Type TYPE = new FacesBean.Type(
UIXInput.TYPE);
static public final PropertyKey CONTENT_STYLE_KEY =
TYPE.registerKey("contentStyle", String.class);
static public final PropertyKey READ_ONLY_KEY =
TYPE.registerKey("readOnly", Boolean.class, Boolean.FALSE);
static public final PropertyKey DISABLED_KEY =
TYPE.registerKey("disabled", Boolean.class, Boolean.FALSE);
static public final PropertyKey AUTO_COMPLETE_KEY =
TYPE.registerKey("autoComplete", String.class, "on");
static public final PropertyKey SHORT_DESC_KEY =
TYPE.registerKey("shortDesc", String.class);
static public final PropertyKey PARTIAL_TRIGGERS_KEY =
TYPE.registerKey("partialTriggers", String[].class);
static public final PropertyKey LABEL_KEY =
TYPE.registerKey("label", String.class);
static public final PropertyKey SIMPLE_KEY =
TYPE.registerKey("simple", Boolean.class, Boolean.FALSE);
static public final PropertyKey ONCHANGE_KEY =
TYPE.registerKey("onchange", String.class);
static public final PropertyKey ONCLICK_KEY =
TYPE.registerKey("onclick", String.class);
static public final PropertyKey ONDBLCLICK_KEY =
TYPE.registerKey("ondblclick", String.class);
static public final PropertyKey ONMOUSEDOWN_KEY =
TYPE.registerKey("onmousedown", String.class);
static public final PropertyKey ONMOUSEUP_KEY =
TYPE.registerKey("onmouseup", String.class);
static public final PropertyKey ONMOUSEOVER_KEY =
TYPE.registerKey("onmouseover", String.class);
static public final PropertyKey ONMOUSEMOVE_KEY =
TYPE.registerKey("onmousemove", String.class);
static public final PropertyKey ONMOUSEOUT_KEY =
TYPE.registerKey("onmouseout", String.class);
static public final PropertyKey ONKEYPRESS_KEY =
TYPE.registerKey("onkeypress", String.class);
static public final PropertyKey ONKEYDOWN_KEY =
TYPE.registerKey("onkeydown", String.class);
static public final PropertyKey ONKEYUP_KEY =
TYPE.registerKey("onkeyup", String.class);
static public final PropertyKey ONBLUR_KEY =
TYPE.registerKey("onblur", String.class);
static public final PropertyKey ONFOCUS_KEY =
TYPE.registerKey("onfocus", String.class);
static public final PropertyKey STYLE_CLASS_KEY =
TYPE.registerKey("styleClass", String.class);
static public final PropertyKey INLINE_STYLE_KEY =
TYPE.registerKey("inlineStyle", String.class);
static public final PropertyKey SHOW_REQUIRED_KEY =
TYPE.registerKey("showRequired", Boolean.class, Boolean.FALSE);
static public final PropertyKey COLUMNS_KEY =
TYPE.registerKey("columns", Integer.class, Integer.valueOf(1));
static public final PropertyKey MAXIMUM_KEY =
TYPE.registerKey("maximum", Integer.class, Integer.valueOf(2147483647));
static public final PropertyKey MINIMUM_KEY =
TYPE.registerKey("minimum", Integer.class, Integer.valueOf(1));
static public final PropertyKey STEP_SIZE_KEY =
TYPE.registerKey("stepSize", Integer.class, Integer.valueOf(1));
static public final PropertyKey ONSELECT_KEY =
TYPE.registerKey("onselect", String.class);
static public final PropertyKey ACCESS_KEY_KEY =
TYPE.registerKey("accessKey", Character.class);
static public final PropertyKey AUTO_SUBMIT_KEY =
TYPE.registerKey("autoSubmit", Boolean.class, Boolean.FALSE);
static public final String HELP_FACET = "help";
static public final String COMPONENT_FAMILY =
"org.apache.myfaces.trinidad.Input";
static public final String COMPONENT_TYPE =
"org.apache.myfaces.trinidad.CoreInputNumberSpinbox";
// Supported client events for client behaviors:
private final static Collection _EVENT_NAMES = Collections.unmodifiableCollection(
Arrays.asList(
"change", "click", "dblclick", "mousedown", "mouseup", "mouseover",
"mousemove", "mouseout", "keypress", "keydown", "keyup", "focus",
"blur", "select", "valueChange"
));
/**
* Construct an instance of the CoreInputNumberSpinbox.
*/
public CoreInputNumberSpinbox()
{
super("org.apache.myfaces.trinidad.NumberSpinbox");
}
/**
* This facet should contain field level help.
*/
final public UIComponent getHelp()
{
return getFacet(HELP_FACET);
}
/**
* This facet should contain field level help.
*/
@SuppressWarnings("unchecked")
final public void setHelp(UIComponent helpFacet)
{
getFacets().put(HELP_FACET, helpFacet);
}
/**
* Gets the CSS styles to attach to the content of the component. For example, you can set the width of that portion to 100 pixels by setting this attribute to "width: 100px".
*
* @return the new contentStyle value
*/
final public String getContentStyle()
{
return ComponentUtils.resolveString(getProperty(CONTENT_STYLE_KEY));
}
/**
* Sets the CSS styles to attach to the content of the component. For example, you can set the width of that portion to 100 pixels by setting this attribute to "width: 100px".
*
* @param contentStyle the new contentStyle value
*/
final public void setContentStyle(String contentStyle)
{
setProperty(CONTENT_STYLE_KEY, (contentStyle));
}
/**
* Gets whether the element is read-only.
*
* @return the new readOnly value
*/
final public boolean isReadOnly()
{
return ComponentUtils.resolveBoolean(getProperty(READ_ONLY_KEY), false);
}
/**
* Sets whether the element is read-only.
*
* @param readOnly the new readOnly value
*/
final public void setReadOnly(boolean readOnly)
{
setProperty(READ_ONLY_KEY, readOnly ? Boolean.TRUE : Boolean.FALSE);
}
/**
* Gets whether the element is disabled.
*
* @return the new disabled value
*/
final public boolean isDisabled()
{
return ComponentUtils.resolveBoolean(getProperty(DISABLED_KEY), false);
}
/**
* Sets whether the element is disabled.
*
* @param disabled the new disabled value
*/
final public void setDisabled(boolean disabled)
{
setProperty(DISABLED_KEY, disabled ? Boolean.TRUE : Boolean.FALSE);
}
/**
* Gets whether previous values of text fields in the form
* should be remembered and offered for auto completion.
*
* @return the new autoComplete value
*/
final public String getAutoComplete()
{
return ComponentUtils.resolveString(getProperty(AUTO_COMPLETE_KEY), "on");
}
/**
* Sets whether previous values of text fields in the form
* should be remembered and offered for auto completion.
*
* @param autoComplete the new autoComplete value
*/
final public void setAutoComplete(String autoComplete)
{
setProperty(AUTO_COMPLETE_KEY, (autoComplete));
}
/**
* Gets the short description of the bean. This text
* is commonly used by user agents to display tooltip help text.
*
* @return the new shortDesc value
*/
final public String getShortDesc()
{
return ComponentUtils.resolveString(getProperty(SHORT_DESC_KEY));
}
/**
* Sets the short description of the bean. This text
* is commonly used by user agents to display tooltip help text.
*
* @param shortDesc the new shortDesc value
*/
final public void setShortDesc(String shortDesc)
{
setProperty(SHORT_DESC_KEY, (shortDesc));
}
/**
* Gets the IDs of the components that should trigger a partial update.
* This component will listen on the trigger components. If one of the
* trigger components receives an event that will cause it to update
* in some way, this component will request to be updated too.
*
* @return the new partialTriggers value
*/
final public String[] getPartialTriggers()
{
return (String[])getProperty(PARTIAL_TRIGGERS_KEY);
}
/**
* Sets the IDs of the components that should trigger a partial update.
* This component will listen on the trigger components. If one of the
* trigger components receives an event that will cause it to update
* in some way, this component will request to be updated too.
*
* @param partialTriggers the new partialTriggers value
*/
final public void setPartialTriggers(String[] partialTriggers)
{
setProperty(PARTIAL_TRIGGERS_KEY, (partialTriggers));
}
/**
* Gets the label of the bean.
*
* @return the new label value
*/
final public String getLabel()
{
return ComponentUtils.resolveString(getProperty(LABEL_KEY));
}
/**
* Sets the label of the bean.
*
* @param label the new label value
*/
final public void setLabel(String label)
{
setProperty(LABEL_KEY, (label));
}
/**
* Gets a boolean value that controls whether the component
* provides label and message support; when set to "true", the component will
* not display messaging support or the label (these attributes may be ignored: label,
* labelAndAccessKey, accessKey, showRequired,
* tip), and may use simpler layout primitives
*
* @return the new simple value
*/
final public boolean isSimple()
{
return ComponentUtils.resolveBoolean(getProperty(SIMPLE_KEY), false);
}
/**
* Sets a boolean value that controls whether the component
* provides label and message support; when set to "true", the component will
* not display messaging support or the label (these attributes may be ignored: label,
* labelAndAccessKey, accessKey, showRequired,
* tip), and may use simpler layout primitives
*
* @param simple the new simple value
*/
final public void setSimple(boolean simple)
{
setProperty(SIMPLE_KEY, simple ? Boolean.TRUE : Boolean.FALSE);
}
/**
* Gets event handler for when the value is changed.
*
* @return the new onchange value
*/
final public String getOnchange()
{
return ComponentUtils.resolveString(getProperty(ONCHANGE_KEY));
}
/**
* Sets event handler for when the value is changed.
*
* @param onchange the new onchange value
*/
final public void setOnchange(String onchange)
{
setProperty(ONCHANGE_KEY, (onchange));
}
/**
* Gets an onclick Javascript handler.
*
* @return the new onclick value
*/
final public String getOnclick()
{
return ComponentUtils.resolveString(getProperty(ONCLICK_KEY));
}
/**
* Sets an onclick Javascript handler.
*
* @param onclick the new onclick value
*/
final public void setOnclick(String onclick)
{
setProperty(ONCLICK_KEY, (onclick));
}
/**
* Gets an ondblclick Javascript handler.
*
* @return the new ondblclick value
*/
final public String getOndblclick()
{
return ComponentUtils.resolveString(getProperty(ONDBLCLICK_KEY));
}
/**
* Sets an ondblclick Javascript handler.
*
* @param ondblclick the new ondblclick value
*/
final public void setOndblclick(String ondblclick)
{
setProperty(ONDBLCLICK_KEY, (ondblclick));
}
/**
* Gets an onmousedown Javascript handler.
*
* @return the new onmousedown value
*/
final public String getOnmousedown()
{
return ComponentUtils.resolveString(getProperty(ONMOUSEDOWN_KEY));
}
/**
* Sets an onmousedown Javascript handler.
*
* @param onmousedown the new onmousedown value
*/
final public void setOnmousedown(String onmousedown)
{
setProperty(ONMOUSEDOWN_KEY, (onmousedown));
}
/**
* Gets an onmouseup Javascript handler.
*
* @return the new onmouseup value
*/
final public String getOnmouseup()
{
return ComponentUtils.resolveString(getProperty(ONMOUSEUP_KEY));
}
/**
* Sets an onmouseup Javascript handler.
*
* @param onmouseup the new onmouseup value
*/
final public void setOnmouseup(String onmouseup)
{
setProperty(ONMOUSEUP_KEY, (onmouseup));
}
/**
* Gets an onmouseover Javascript handler.
*
* @return the new onmouseover value
*/
final public String getOnmouseover()
{
return ComponentUtils.resolveString(getProperty(ONMOUSEOVER_KEY));
}
/**
* Sets an onmouseover Javascript handler.
*
* @param onmouseover the new onmouseover value
*/
final public void setOnmouseover(String onmouseover)
{
setProperty(ONMOUSEOVER_KEY, (onmouseover));
}
/**
* Gets an onmousemove Javascript handler.
*
* @return the new onmousemove value
*/
final public String getOnmousemove()
{
return ComponentUtils.resolveString(getProperty(ONMOUSEMOVE_KEY));
}
/**
* Sets an onmousemove Javascript handler.
*
* @param onmousemove the new onmousemove value
*/
final public void setOnmousemove(String onmousemove)
{
setProperty(ONMOUSEMOVE_KEY, (onmousemove));
}
/**
* Gets an onmouseout Javascript handler.
*
* @return the new onmouseout value
*/
final public String getOnmouseout()
{
return ComponentUtils.resolveString(getProperty(ONMOUSEOUT_KEY));
}
/**
* Sets an onmouseout Javascript handler.
*
* @param onmouseout the new onmouseout value
*/
final public void setOnmouseout(String onmouseout)
{
setProperty(ONMOUSEOUT_KEY, (onmouseout));
}
/**
* Gets an onkeypress Javascript handler.
*
* @return the new onkeypress value
*/
final public String getOnkeypress()
{
return ComponentUtils.resolveString(getProperty(ONKEYPRESS_KEY));
}
/**
* Sets an onkeypress Javascript handler.
*
* @param onkeypress the new onkeypress value
*/
final public void setOnkeypress(String onkeypress)
{
setProperty(ONKEYPRESS_KEY, (onkeypress));
}
/**
* Gets an onkeydown Javascript handler.
*
* @return the new onkeydown value
*/
final public String getOnkeydown()
{
return ComponentUtils.resolveString(getProperty(ONKEYDOWN_KEY));
}
/**
* Sets an onkeydown Javascript handler.
*
* @param onkeydown the new onkeydown value
*/
final public void setOnkeydown(String onkeydown)
{
setProperty(ONKEYDOWN_KEY, (onkeydown));
}
/**
* Gets an onkeyup Javascript handler.
*
* @return the new onkeyup value
*/
final public String getOnkeyup()
{
return ComponentUtils.resolveString(getProperty(ONKEYUP_KEY));
}
/**
* Sets an onkeyup Javascript handler.
*
* @param onkeyup the new onkeyup value
*/
final public void setOnkeyup(String onkeyup)
{
setProperty(ONKEYUP_KEY, (onkeyup));
}
/**
* Gets the event handler for the component losing the focus.
*
* @return the new onblur value
*/
final public String getOnblur()
{
return ComponentUtils.resolveString(getProperty(ONBLUR_KEY));
}
/**
* Sets the event handler for the component losing the focus.
*
* @param onblur the new onblur value
*/
final public void setOnblur(String onblur)
{
setProperty(ONBLUR_KEY, (onblur));
}
/**
* Gets the event handler for the component gaining the focus.
*
* @return the new onfocus value
*/
final public String getOnfocus()
{
return ComponentUtils.resolveString(getProperty(ONFOCUS_KEY));
}
/**
* Sets the event handler for the component gaining the focus.
*
* @param onfocus the new onfocus value
*/
final public void setOnfocus(String onfocus)
{
setProperty(ONFOCUS_KEY, (onfocus));
}
/**
* Gets a CSS style class to use for this component.
* The styleClass attribute value is rendered on the root dom element.
* We provide some public style classes you can use that will affect only the 'content' piece of the component:
* AFFieldTextMarker, AFFieldTextLTRMarker, AFFieldNumberMarker.
*
*
* @return the new styleClass value
*/
final public String getStyleClass()
{
return ComponentUtils.resolveString(getProperty(STYLE_CLASS_KEY));
}
/**
* Sets a CSS style class to use for this component.
* The styleClass attribute value is rendered on the root dom element.
* We provide some public style classes you can use that will affect only the 'content' piece of the component:
* AFFieldTextMarker, AFFieldTextLTRMarker, AFFieldNumberMarker.
*
*
* @param styleClass the new styleClass value
*/
final public void setStyleClass(String styleClass)
{
setProperty(STYLE_CLASS_KEY, (styleClass));
}
/**
* Gets the inline CSS style for this element
*
* @return the new inlineStyle value
*/
final public String getInlineStyle()
{
return ComponentUtils.resolveString(getProperty(INLINE_STYLE_KEY));
}
/**
* Sets the inline CSS style for this element
*
* @param inlineStyle the new inlineStyle value
*/
final public void setInlineStyle(String inlineStyle)
{
setProperty(INLINE_STYLE_KEY, (inlineStyle));
}
/**
* Gets whether the associated control displays a visual indication of required user input. If a "required" attribute is also present, both the "required" attribute and the
* "showRequired" attribute must be false for the visual indication not to be displayed.
*
* @return the new showRequired value
*/
final public boolean isShowRequired()
{
return ComponentUtils.resolveBoolean(getProperty(SHOW_REQUIRED_KEY), false);
}
/**
* Sets whether the associated control displays a visual indication of required user input. If a "required" attribute is also present, both the "required" attribute and the
* "showRequired" attribute must be false for the visual indication not to be displayed.
*
* @param showRequired the new showRequired value
*/
final public void setShowRequired(boolean showRequired)
{
setProperty(SHOW_REQUIRED_KEY, showRequired ? Boolean.TRUE : Boolean.FALSE);
}
/**
* Gets the number of columns to display in the text
* control. If no value is specified, a default
* of 1 columns is used. One column is approximately one character
* in the browser's current display font.
*
* @return the new columns value
*/
final public int getColumns()
{
return ComponentUtils.resolveInteger(getProperty(COLUMNS_KEY), 1);
}
/**
* Sets the number of columns to display in the text
* control. If no value is specified, a default
* of 1 columns is used. One column is approximately one character
* in the browser's current display font.
*
* @param columns the new columns value
*/
final public void setColumns(int columns)
{
setProperty(COLUMNS_KEY, Integer.valueOf(columns));
}
/**
* Gets The maximum number allowed in the input field.
*
* @return the new maximum value
*/
final public int getMaximum()
{
return ComponentUtils.resolveInteger(getProperty(MAXIMUM_KEY), 2147483647);
}
/**
* Sets The maximum number allowed in the input field.
*
* @param maximum the new maximum value
*/
final public void setMaximum(int maximum)
{
setProperty(MAXIMUM_KEY, Integer.valueOf(maximum));
}
/**
* Gets The minimum number allowed in the input field.
*
* @return the new minimum value
*/
final public int getMinimum()
{
return ComponentUtils.resolveInteger(getProperty(MINIMUM_KEY), 1);
}
/**
* Sets The minimum number allowed in the input field.
*
* @param minimum the new minimum value
*/
final public void setMinimum(int minimum)
{
setProperty(MINIMUM_KEY, Integer.valueOf(minimum));
}
/**
* Gets The step size by which the spinbox will increase or decrease the number in the input.
*
* @return the new stepSize value
*/
final public int getStepSize()
{
return ComponentUtils.resolveInteger(getProperty(STEP_SIZE_KEY), 1);
}
/**
* Sets The step size by which the spinbox will increase or decrease the number in the input.
*
* @param stepSize the new stepSize value
*/
final public void setStepSize(int stepSize)
{
setProperty(STEP_SIZE_KEY, Integer.valueOf(stepSize));
}
/**
* Gets event handler for when text becomes selected.
*
* @return the new onselect value
*/
final public String getOnselect()
{
return ComponentUtils.resolveString(getProperty(ONSELECT_KEY));
}
/**
* Sets event handler for when text becomes selected.
*
* @param onselect the new onselect value
*/
final public void setOnselect(String onselect)
{
setProperty(ONSELECT_KEY, (onselect));
}
/**
* Gets
* Character used to gain quick access to
* the form element specified by the
* for, if set (or this component itself,
* if it is a "non-simple" form element).
* For accessibility reasons, this functionality is not supported
* in screen reader mode.
* If the same access key appears in multiple locations in the
* same page of output, the rendering user agent will cycle
* among the elements accessed by the similar keys.
*
* This attribute is sometimes referred to as the "mnemonic".
*
*
* @return the new accessKey value
*/
final public char getAccessKey()
{
return ComponentUtils.resolveCharacter((Character)getProperty(ACCESS_KEY_KEY));
}
/**
* Sets
* Character used to gain quick access to
* the form element specified by the
* for, if set (or this component itself,
* if it is a "non-simple" form element).
* For accessibility reasons, this functionality is not supported
* in screen reader mode.
* If the same access key appears in multiple locations in the
* same page of output, the rendering user agent will cycle
* among the elements accessed by the similar keys.
*
* This attribute is sometimes referred to as the "mnemonic".
*
*
* @param accessKey the new accessKey value
*/
final public void setAccessKey(char accessKey)
{
setProperty(ACCESS_KEY_KEY, Character.valueOf(accessKey));
}
/**
* Gets If set to TRUE on a form element, the component will automatically submit
* the enclosing form when an appropriate action takes place (a click, text
* change, etc.).
*
* @return the new autoSubmit value
*/
final public boolean isAutoSubmit()
{
return ComponentUtils.resolveBoolean(getProperty(AUTO_SUBMIT_KEY), false);
}
/**
* Sets If set to TRUE on a form element, the component will automatically submit
* the enclosing form when an appropriate action takes place (a click, text
* change, etc.).
*
* @param autoSubmit the new autoSubmit value
*/
final public void setAutoSubmit(boolean autoSubmit)
{
setProperty(AUTO_SUBMIT_KEY, autoSubmit ? Boolean.TRUE : Boolean.FALSE);
}
@Override
public String getDefaultEventName()
{
return "change";
}
@Override
public Collection getEventNames()
{
return _EVENT_NAMES;
}
@Override
public Map> getClientBehaviors()
{
return super.getClientBehaviors();
}
@Override
public void addClientBehavior(
String eventName,
ClientBehavior behavior)
{
super.addClientBehavior(eventName, behavior);
}
@Override
public String getFamily()
{
return COMPONENT_FAMILY;
}
@Override
protected FacesBean.Type getBeanType()
{
return TYPE;
}
/**
* Construct an instance of the CoreInputNumberSpinbox.
*/
protected CoreInputNumberSpinbox(
String rendererType
)
{
super(rendererType);
}
static
{
TYPE.lockAndRegister("org.apache.myfaces.trinidad.Input","org.apache.myfaces.trinidad.NumberSpinbox");
}
}