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.Preliminary;
022    import org.apache.myfaces.tobago.apt.annotation.Tag;
023    import org.apache.myfaces.tobago.apt.annotation.TagAttribute;
024    import org.apache.myfaces.tobago.apt.annotation.UIComponentTag;
025    import org.apache.myfaces.tobago.apt.annotation.UIComponentTagAttribute;
026    import org.apache.myfaces.tobago.taglib.decl.HasIdBindingAndRendered;
027    import org.apache.myfaces.tobago.taglib.decl.HasIdReference;
028    import org.apache.myfaces.tobago.taglib.decl.HasNameReference;
029    import org.apache.myfaces.tobago.taglib.decl.HasState;
030    import org.apache.myfaces.tobago.taglib.decl.HasTreeNodeValue;
031    import org.apache.myfaces.tobago.taglib.decl.IsRequired;
032    
033    /*
034     * Created by IntelliJ IDEA.
035     * User: bommel
036     * Date: 06.04.2006
037     * Time: 22:32:57
038     */
039    /**
040     * Renders a listbox view of a tree.
041     */
042    @Tag(name = "treeListbox")
043    @BodyContentDescription(anyTagOf = "<f:facet>* <f:actionListener>?")
044    @Preliminary(
045        "Implement a var attribute for the tree like in the sheet (http://issues.apache.org/jira/browse/TOBAGO-18)")
046    @UIComponentTag(
047        uiComponent = "org.apache.myfaces.tobago.component.UITreeListbox",
048        rendererType = "TreeListbox")
049    public interface TreeListboxTagDeclaration extends TobagoTagDeclaration, HasIdBindingAndRendered, HasTreeNodeValue,
050        HasState, HasIdReference, HasNameReference, IsRequired {
051      /**
052       * Flag indicating whether or not this component should be render selectable items.
053       * Possible values are:
054       * <ul>
055       * <li><strong>single</strong> : a singleselection tree is rendered</li>
056       * <li><strong>singleLeafOnly</strong> : a singleselection tree is rendered,
057       * only Leaf's are selectable</li>
058       * <li><strong>siblingLeafOnly</strong> : a multiselection tree is rendered,
059       * where only sibling Leaf's are selectable</li>
060       * </ul>
061       */
062      @TagAttribute
063      @UIComponentTagAttribute(defaultValue = "single", allowedValues = {"single", "singleLeafOnly", "siblingLeafOnly"})
064      void setSelectable(String selectable);
065    
066    
067      /**
068       * reference to tip value.
069       */
070      @TagAttribute
071      @UIComponentTagAttribute()
072      void setTipReference(String tipReference);
073    }