org.apache.wicket.markup.html.form
Class AutoLabelResolver

java.lang.Object
  org.apache.wicket.markup.html.form.AutoLabelResolver

All Implemented Interfaces:

java.io.Serializable, IClusterable, IComponentResolver

public class AutoLabelResolver
extends java.lang.Object
implements IComponentResolver

Resolver that implements the wicket:for attribute functionality. The attribute makes it easy to set up <label> tags for form components by providing the following features without having to add any additional components in code:

• Outputs the for attribute with the value equivalent to the markup id of the referenced form component
• Appends required css class to the <label> tag if the referenced form component is required
• Appends error css class to the <label> tag if the referenced form component has failed validation
• Appends disabled css class to the <label> tag if the referenced form component has is not enabled in hierarchy

The value of the wicket:for attribute can either contain an id of the form component or a path to it using the standard : path separator. Note that .. can be used as part of the path to construct a reference to the parent container, eg ..:..:foo:bar. First the value of the attribute will be treated as a path and the <label> tag's closest parent container will be queried for the form component. If the form component cannot be resolved the value of the wicket:for attribute will be treated as an id and all containers will be searched from the closest parent to the page.

Author:

igor, Carl-Eric Menzel

See Also:

Serialized Form

Nested Class Summary

protected static class

AutoLabelResolver.AutoLabel Component that is attached to the <label> tag and takes care of writing out the label text as well as setting classes on the <label> tag

Constructor Summary

AutoLabelResolver()

Method Summary

Component

resolve(MarkupContainer container, MarkupStream markupStream, ComponentTag tag) Try to resolve a component.

Methods inherited from class java.lang.Object

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

Constructor Detail

AutoLabelResolver

public AutoLabelResolver()

Method Detail

resolve

public Component resolve(MarkupContainer container,
                         MarkupStream markupStream,
                         ComponentTag tag)

Description copied from interface: IComponentResolver

Try to resolve a component.

Specified by:

resolve in interface IComponentResolver

Parameters:

container - The container parsing its markup

markupStream - The current markupStream

tag - The current component tag while parsing the markup

Returns:

component or null if not found