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.Tag;
021    import org.apache.myfaces.tobago.apt.annotation.TagAttribute;
022    import org.apache.myfaces.tobago.apt.annotation.UIComponentTag;
023    import org.apache.myfaces.tobago.apt.annotation.UIComponentTagAttribute;
024    import org.apache.myfaces.tobago.apt.annotation.Facet;
025    import org.apache.myfaces.tobago.taglib.decl.HasBinding;
026    import org.apache.myfaces.tobago.taglib.decl.HasDimension;
027    import org.apache.myfaces.tobago.taglib.decl.HasId;
028    import org.apache.myfaces.tobago.taglib.decl.HasLabel;
029    import org.apache.myfaces.tobago.taglib.decl.HasState;
030    
031    /*
032     * Date: 30.03.2006
033     * Time: 21:57:22
034     */
035    /**
036     * TODO description of page tag
037     */
038    @Tag(name = "page")
039    @UIComponentTag(
040        uiComponent = "org.apache.myfaces.tobago.component.UIPage",
041        rendererType = "Page",
042        facets =
043            {@Facet(name = "action", description = "Contains an instance of UICommand (tc:command) for an auto-action"),
044            @Facet(name = "menuBar", description = "Menubar"),
045            @Facet(name = "layout", description = "Contains an instance of UILayout")})
046    
047    public interface PageTagDeclaration extends TobagoBodyTagDeclaration, HasLabel, HasId, HasDimension, HasBinding,
048        HasState {
049      /**
050       * Possible values for doctype are:
051       * <dl>
052       * <dt>strict</dt><dd>HTML 4.01 Strict DTD</dd>
053       * <dt>loose</dt><dd>HTML 4.01 Transitional DTD</dd>
054       * <dt>frameset</dt><dd>HTML 4.01 Frameset DTD</dd>
055       * </dl>
056       * All other values are ignored and no DOCTYPE is set.
057       * The default value is 'loose'.
058       */
059      @TagAttribute
060      @UIComponentTagAttribute(defaultValue = "loose")
061      void setDoctype(String doctype);
062    
063      /**
064       * Contains the id of the component wich should have the focus after
065       * loading the page.
066       * Set to emtpy string for disabling setting of focus.
067       * Default (null) enables the "auto focus" feature.
068       */
069      @TagAttribute
070      @UIComponentTagAttribute()
071      void setFocusId(String focusId);
072    
073      /**
074       * Absolute URL to an image or image name to lookup in tobago resource path
075       * representing the application. In HTML it is used as a favicon.
076       */
077      @TagAttribute
078      @UIComponentTagAttribute()
079      void setApplicationIcon(String icon);
080    
081    }