org.apache.tapestry5.corelib.components
Class Select

java.lang.Object
  org.apache.tapestry5.corelib.base.AbstractField
      org.apache.tapestry5.corelib.components.Select

All Implemented Interfaces:

ClientElement, Field

public class Select
extends AbstractField

Select an item from a list of values, using an [X]HTML <select> element on the client side. An validation decorations will go around the entire <select> element.

A core part of this component is the ValueEncoder (the encoder parameter) that is used to convert between server-side values and client-side strings. In many cases, a ValueEncoder can be generated automatically from the type of the value parameter. The ValueEncoderSource service provides an encoder in these situations; it can be overriden by binding the encoder parameter, or extended by contributing a ValueEncoderFactory into the service's configuration.

Constructor Summary

Select()

Method Summary

boolean	isRequired() Returns false; most components do not support declarative validation.
protected void	processSubmission(String elementName) Method implemented by subclasses to actually do the work of processing the submission of the form.

Methods inherited from class org.apache.tapestry5.corelib.base.AbstractField

createDefaultParameterBinding, decorateInsideField, getClientId, getControlName, getLabel, isDisabled, setDecorator, setFormSupport

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Select

public Select()

Method Detail

processSubmission

protected void processSubmission(String elementName)

Description copied from class: AbstractField

Method implemented by subclasses to actually do the work of processing the submission of the form. The element's elementName property will already have been set. This method is only invoked if the field is not disabled.

Specified by:

processSubmission in class AbstractField

Parameters:

elementName - the name of the element (used to find the correct parameter in the request)

isRequired

public boolean isRequired()

Description copied from class: AbstractField

Returns false; most components do not support declarative validation.

Specified by:

isRequired in interface Field

Overrides:

isRequired in class AbstractField

Returns:

true if a non-blank value is required for the field