Option


1   // Copyright 2004, 2005 The Apache Software Foundation
2   //
3   // Licensed under the Apache License, Version 2.0 (the "License");
4   // you may not use this file except in compliance with the License.
5   // You may obtain a copy of the License at
6   //
7   //     http://www.apache.org/licenses/LICENSE-2.0
8   //
9   // Unless required by applicable law or agreed to in writing, software
10  // distributed under the License is distributed on an "AS IS" BASIS,
11  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  // See the License for the specific language governing permissions and
13  // limitations under the License.
14  
15  package org.apache.tapestry.wml;
16  
17  import org.apache.hivemind.HiveMind;
18  import org.apache.tapestry.AbstractComponent;
19  import org.apache.tapestry.IMarkupWriter;
20  import org.apache.tapestry.IRequestCycle;
21  
22  /**
23   * This component serves as a container for one item that is listed as a choice in a {@link Select}.
24   * A {@link Select}offers a selection of choices from which usersu may choose one or more items.
25   * The select list is created using a select element which contains a collection of option elements.
26   * A string or text describing the item appears between the opening and closing option tags. In
27   * order to have a dynamic onpick attribute it is better to use a concrete class of
28   * {@link org.apache.tapestry.link.ILinkRenderer}with the {@link OptionRenderer}.
29   * 
30   * @author David Solis
31   * @since 3.0
32   */
33  
34  public abstract class Option extends AbstractComponent
35  {
36  
37      /**
38       * @see org.apache.tapestry.AbstractComponent#renderComponent(IMarkupWriter, IRequestCycle)
39       */
40  
41      protected void renderComponent(IMarkupWriter writer, IRequestCycle cycle)
42      {
43          boolean render = !cycle.isRewinding();
44  
45          if (render)
46          {
47              writer.begin("option");
48  
49              String   value = getValue();
50              if (HiveMind.isNonBlank(value))
51                  writer.attribute("value", value);
52  
53              renderInformalParameters(writer, cycle);
54  
55              renderBody(writer, cycle);
56  
57              writer.end();
58          }
59      }
60  
61      public abstract String   getValue();
62  }
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags