001package org.gwtbootstrap3.client.ui;
002
003/*
004 * #%L
005 * GwtBootstrap3
006 * %%
007 * Copyright (C) 2013 GwtBootstrap3
008 * %%
009 * Licensed under the Apache License, Version 2.0 (the "License");
010 * you may not use this file except in compliance with the License.
011 * You may obtain a copy of the License at
012 * 
013 *      http://www.apache.org/licenses/LICENSE-2.0
014 * 
015 * Unless required by applicable law or agreed to in writing, software
016 * distributed under the License is distributed on an "AS IS" BASIS,
017 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
018 * See the License for the specific language governing permissions and
019 * limitations under the License.
020 * #L%
021 */
022
023import org.gwtbootstrap3.client.ui.base.AbstractListItem;
024import org.gwtbootstrap3.client.ui.base.button.AbstractToggleButton;
025import org.gwtbootstrap3.client.ui.constants.Styles;
026
027import com.google.gwt.dom.client.Element;
028import com.google.gwt.user.client.ui.Widget;
029
030/**
031 * Drop down item within a list, e.g. {@link NavTabs}, {@link NavPills} or
032 * {@link Navbar}.
033 * <p/>
034 * <h3>UiBinder example</h3>
035 * <p/>
036 * <pre>
037 * {@code
038 *     <b:NavTabs>
039 *         <b:AnchorListItem active="true">Item 1</b:AnchorListItem>
040 *         <b:AnchorListItem>Item 2</b:AnchorListItem>
041 *         <b:ListDropDown>
042 *             <b:AnchorButton toggle="DROPDOWN">Dropdown</b:AnchorButton>
043 *             <b:DropDownMenu>
044 *                 <b:AnchorListItem>Dropdown 1</b:AnchorListItem>
045 *                 <b:AnchorListItem>Dropdown 2</b:AnchorListItem>
046 *                 <b:AnchorListItem>Dropdown 3</b:AnchorListItem>
047 *             </b:DropDownMenu>
048 *         </b:ListDropDown>
049 *         <b:AnchorListItem>Item 3</b:AnchorListItem>
050 *     </b:NavTabs>
051 * }
052 * </pre>
053 *
054 * @author Sven Jacobs
055 * @see NavTabs
056 * @see NavPills
057 * @see Navbar
058 */
059public class ListDropDown extends AbstractListItem {
060
061    public ListDropDown() {
062        setStyleName(Styles.DROPDOWN);
063    }
064
065    @Override
066    public void add(final Widget child) {
067        if (child instanceof AbstractToggleButton) {
068            if (!(child instanceof AnchorButton)) {
069                throw new IllegalArgumentException("Only buttons of type AnchorButton can be added to ListDropDown");
070            }
071
072            child.setStyleName(Styles.DROPDOWN_TOGGLE);
073        }
074
075        add(child, (Element) getElement());
076    }
077}