View Javadoc

1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *   http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing,
13   * software distributed under the License is distributed on an
14   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15   * KIND, either express or implied.  See the License for the
16   * specific language governing permissions and limitations
17   * under the License.
18   */
19  package org.apache.myfaces.view.facelets.tag.jsf.core;
20  
21  import javax.faces.view.facelets.ComponentConfig;
22  import javax.faces.view.facelets.ComponentHandler;
23  
24  import org.apache.myfaces.buildtools.maven2.plugin.builder.annotation.JSFFaceletAttribute;
25  import org.apache.myfaces.buildtools.maven2.plugin.builder.annotation.JSFFaceletTag;
26  
27  @JSFFaceletTag(
28          name = "f:selectItems",
29          bodyContent = "empty",
30          componentClass="javax.faces.component.UISelectItems")
31  public class SelectItemsHandler extends ComponentHandler
32  {
33  
34      public SelectItemsHandler(ComponentConfig config)
35      {
36          super(config);
37      }
38      
39      
40      /**
41       * Is either an EL expression pointing to the element in the value collection
42       * whose value should be marked as a "no selection" item, or a literal string
43       * that exactly matches the value of the item in the collection that must be 
44       * marked as the "no selection" item. If the user selects such an item and 
45       * the field is marked as required, then it will not pass validation.
46       * 
47       * @since 2.0
48       * @return
49       */
50      @JSFFaceletAttribute(name = "noSelectionValue",
51              className = "javax.el.ValueExpression",
52              deferredValueType = "java.lang.Boolean")
53      private boolean getNoSelectionValue()
54      {
55          return false;
56      }
57  }