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.HasId; 028 import org.apache.myfaces.tobago.taglib.decl.HasLabelAndAccessKey; 029 import org.apache.myfaces.tobago.taglib.decl.HasTip; 030 import org.apache.myfaces.tobago.taglib.decl.IsDisabled; 031 import org.apache.myfaces.tobago.taglib.decl.IsInline; 032 import org.apache.myfaces.tobago.taglib.decl.IsReadonly; 033 import org.apache.myfaces.tobago.taglib.decl.IsRendered; 034 import org.apache.myfaces.tobago.taglib.decl.HasConverter; 035 036 /* 037 * Created: Aug 5, 2005 6:05:28 PM 038 * User: bommel 039 * $Id: SelectOneChoiceTagDeclaration.java 578592 2007-09-23 18:51:32Z bommel $ 040 */ 041 042 /** 043 * Render a single selection dropdown list. 044 */ 045 @Tag(name = "selectOneChoice") 046 @BodyContentDescription(anyTagOf = "(<f:selectItems>|<f:selectItem>|<tc:selectItem>)+ <f:facet>* ") 047 @UIComponentTag( 048 uiComponent = "org.apache.myfaces.tobago.component.UISelectOne", 049 rendererType = "SelectOneChoice", 050 facets = { 051 @Facet(name = "click", 052 description = 053 "This facet can contain a UICommand that is invoked in case of a click event from the component"), 054 @Facet(name = "change", 055 description = 056 "This facet can contain a UICommand that is invoked in case of a change event from the component") 057 }) 058 public interface SelectOneChoiceTagDeclaration 059 extends SelectOneTagDeclaration, HasId, IsDisabled, 060 IsReadonly, IsInline, HasLabelAndAccessKey, 061 IsRendered, HasConverter, HasBinding, HasTip { 062 063 /** 064 * Flag indicating that selecting an Item representing a value is required. 065 * If an SelectItem was choosen which underling value is an empty string an 066 * ValidationError occurs and a Error Message is rendered. 067 */ 068 @TagAttribute(type = String.class) 069 @UIComponentTagAttribute(type = "java.lang.Boolean") 070 void setRequired(String required); 071 }