001    package org.apache.myfaces.tobago.taglib.component;
002    
003    /*
004     * Licensed to the Apache Software Foundation (ASF) under one or more
005     * contributor license agreements.  See the NOTICE file distributed with
006     * this work for additional information regarding copyright ownership.
007     * The ASF licenses this file to You under the Apache License, Version 2.0
008     * (the "License"); you may not use this file except in compliance with
009     * the License.  You may obtain a copy of the License at
010     *
011     *      http://www.apache.org/licenses/LICENSE-2.0
012     *
013     * Unless required by applicable law or agreed to in writing, software
014     * distributed under the License is distributed on an "AS IS" BASIS,
015     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
016     * See the License for the specific language governing permissions and
017     * limitations under the License.
018     */
019    
020    import org.apache.myfaces.tobago.apt.annotation.BodyContentDescription;
021    import org.apache.myfaces.tobago.apt.annotation.Tag;
022    import org.apache.myfaces.tobago.apt.annotation.TagAttribute;
023    import org.apache.myfaces.tobago.apt.annotation.UIComponentTag;
024    import org.apache.myfaces.tobago.apt.annotation.UIComponentTagAttribute;
025    import org.apache.myfaces.tobago.apt.annotation.Facet;
026    import org.apache.myfaces.tobago.taglib.decl.HasBinding;
027    import org.apache.myfaces.tobago.taglib.decl.HasDeprecatedHeight;
028    import org.apache.myfaces.tobago.taglib.decl.HasId;
029    import org.apache.myfaces.tobago.taglib.decl.HasLabelAndAccessKey;
030    import org.apache.myfaces.tobago.taglib.decl.HasTip;
031    import org.apache.myfaces.tobago.taglib.decl.IsDisabled;
032    import org.apache.myfaces.tobago.taglib.decl.IsReadonly;
033    import org.apache.myfaces.tobago.taglib.decl.IsRendered;
034    
035    /*
036     * Created: Aug 5, 2005 6:08:24 PM
037     * User: bommel
038     * $Id: SelectOneListboxTagDeclaration.java 578592 2007-09-23 18:51:32Z bommel $
039     */
040    /**
041     * Render a single selection option listbox.
042     */
043    @Tag(name = "selectOneListbox")
044    @BodyContentDescription(anyTagOf = "(<f:selectItems>|<f:selectItem>|<tc:selectItem>)+ <f:facet>* ")
045    @UIComponentTag(
046        uiComponent = "org.apache.myfaces.tobago.component.UISelectOne",
047        rendererType = "SelectOneListbox",
048        facets = {
049        @Facet(name = "click",
050            description =
051                "This facet can contain a UICommand that is invoked in case of a click event from the component"),
052        @Facet(name = "change",
053            description =
054                "This facet can contain a UICommand that is invoked in case of a change event from the component")
055            })
056    public interface SelectOneListboxTagDeclaration extends SelectOneTagDeclaration, HasId, IsDisabled,
057        IsReadonly, HasLabelAndAccessKey, IsRendered, HasBinding, HasDeprecatedHeight, HasTip {
058    
059      /**
060       * Flag indicating that selecting an Item representing a Value is Required.
061       * If an SelectItem was choosen which underling value is an empty string an
062       * ValidationError occurs and a Error Message is rendered.
063       */
064      @TagAttribute(type = String.class)
065      @UIComponentTagAttribute(type = "java.lang.Boolean")
066      void setRequired(String required);
067    }