org.apache.tapestry.dojo.form
Class AbstractFormWidget

java.lang.Object
  org.apache.hivemind.impl.BaseLocatable
      org.apache.tapestry.AbstractComponent
          org.apache.tapestry.form.AbstractFormComponent
              org.apache.tapestry.dojo.form.AbstractFormWidget

All Implemented Interfaces:

org.apache.hivemind.Locatable, org.apache.hivemind.LocationHolder, IFormWidget, IWidget, IFormComponent, IComponent, IDirectEvent, IRender

Direct Known Subclasses:

Autocompleter

public abstract class AbstractFormWidget
extends AbstractFormComponent
implements IFormWidget

Represents a dojo widget that manages an html form input field.

Since:

4.1

Author:

jkuhnert

Constructor Summary

AbstractFormWidget()

Method Summary

protected void	renderFormComponent(IMarkupWriter writer, IRequestCycle cycle)
protected abstract void	renderFormWidget(IMarkupWriter writer, IRequestCycle cycle) Called when rendering a form widget.
void	renderWidget(IMarkupWriter writer, IRequestCycle cycle) Similar to the semantics involved with normal AbstractComponent.renderComponent method writing component state to the output stream.
protected void	rewindFormComponent(IMarkupWriter writer, IRequestCycle cycle)
protected abstract void	rewindFormWidget(IMarkupWriter writer, IRequestCycle cycle) Called during form submission to retrieve submitted input values.

Methods inherited from class org.apache.tapestry.form.AbstractFormComponent

getCanTakeFocus, getForm, getIdParameter, getName, getRenderBodyOnRewind, isRequired, renderComponent, renderDelegateAttributes, renderDelegatePrefix, renderDelegateSuffix, renderIdAttribute, setClientId, setForm, setName, setName

Methods inherited from class org.apache.tapestry.AbstractComponent

addAsset, addBody, addComponent, checkActiveLock, cleanupAfterRender, enterActiveState, finishLoad, finishLoad, format, format, format, format, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getBody, getBodyCount, getClientId, getComponent, getComponents, getContainedComponent, getContainer, getEventInvoker, getExtendedId, getId, getIdPath, getListeners, getMessage, getMessages, getNamespace, getPage, getProperty, getSpecification, isInActiveState, isParameterBound, isRendering, isStateful, pageEndRender, prepareForRender, render, renderBody, renderInformalParameters, setBinding, setContainedComponent, setContainer, setId, setNamespace, setPage, setProperty, toString, triggerEvent

Methods inherited from class org.apache.hivemind.impl.BaseLocatable

getLocation, setLocation

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.tapestry.IDirectEvent

isStateful, triggerEvent

Methods inherited from interface org.apache.tapestry.IComponent

addAsset, addBody, addComponent, enterActiveState, finishLoad, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getClientId, getComponent, getComponents, getContainedComponent, getContainer, getEventInvoker, getExtendedId, getId, getIdPath, getListeners, getMessage, getMessages, getNamespace, getPage, getProperty, getSpecification, isRendering, renderBody, setBinding, setContainedComponent, setContainer, setId, setNamespace, setPage, setProperty

Methods inherited from interface org.apache.tapestry.IRender

render

Methods inherited from interface org.apache.hivemind.LocationHolder

setLocation

Methods inherited from interface org.apache.hivemind.Locatable

getLocation

Methods inherited from interface org.apache.tapestry.form.IFormComponent

getClientId, getDisplayName, isDisabled

Constructor Detail

AbstractFormWidget

public AbstractFormWidget()

Method Detail

renderWidget

public void renderWidget(IMarkupWriter writer,
                         IRequestCycle cycle)

Similar to the semantics involved with normal AbstractComponent.renderComponent method writing component state to the output stream.

Specified by:

renderWidget in interface IWidget

Parameters:

writer - The markup writer used to write any output.

cycle - The corresponding request.

renderFormComponent

protected void renderFormComponent(IMarkupWriter writer,
                                   IRequestCycle cycle)

Specified by:

renderFormComponent in class AbstractFormComponent

rewindFormComponent

protected void rewindFormComponent(IMarkupWriter writer,
                                   IRequestCycle cycle)

Specified by:

rewindFormComponent in class AbstractFormComponent

renderFormWidget

protected abstract void renderFormWidget(IMarkupWriter writer,
                                         IRequestCycle cycle)

Called when rendering a form widget.

Parameters:

writer - The markup writer to render with.

cycle - The cycle associated with request.

rewindFormWidget

protected abstract void rewindFormWidget(IMarkupWriter writer,
                                         IRequestCycle cycle)

Called during form submission to retrieve submitted input values. Components should do any validation/retrieval of values in this method.

Parameters:

writer - The passed in IMarkupWriter will be a NullMarkupWriter, making any content written ignored.

cycle - Typically used to retrieve submitted value via cycle.getParameter(getName()).