ButtonGroup.java

/*
 *  Copyright 2012 GWT-Bootstrap
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */
package com.github.gwtbootstrap.client.ui;

import com.github.gwtbootstrap.client.ui.base.AbstractDropdownBase;
import com.github.gwtbootstrap.client.ui.base.AbstractMarkupWidget;
import com.github.gwtbootstrap.client.ui.base.DivWidget;
import com.github.gwtbootstrap.client.ui.constants.Constants;
import com.github.gwtbootstrap.client.ui.constants.ToggleType;
import com.google.gwt.user.client.ui.IsWidget;
import com.google.gwt.user.client.ui.Widget;

//@formatter:off
/**
 * ButtonGroups take buttons and combine them to one optically integrated
 * widget.
 * 
 * <p>
 * <h3>UiBinder Usage:</h3>
 * 
 * <pre>
 * {@code 
 * <b:ButtonGroup>
 *     <b:Button>First Button</b:Button>
 *     <b:Button>Second Button</b:Button>
 *     <b:Button>Third Button</b:Button>
 * </b:ButtonGroup>}
 * </pre>
 * 
 * You can also use the buttons as checkboxes or radio buttons:
 * 
 * <pre>
 * {@code
 * <b:ButtonGroup toggle="radio">
 * 	<b:Button text="1" />
 * 		<b:Button text="2" />
 * 	<b:Button text="3" />
 * 	<b:Button text="4" />
 * </b:ButtonGroup>
 * }
 * </pre>
 * 
 * @since 2.0.4.0
 * 
 * @author Carlos Alexandro Becker
 * @author ohashi keisuke
 * 
 * @see <a
 *      href="http://getbootstrap.com/2.3.2/components.html#buttonGroups">Bootstrap
 *      documentation</a>
 * @see Button
 * @see ButtonToolbar
 */
// @formatter:on
public class ButtonGroup extends DivWidget {

    /**
     * Creates an empty ButtonGroup.
     */
    public ButtonGroup() {
        setStyleName(Constants.BTN_GROUP);
    }

    /**
     * Creates a ButtonGroup containing the provided Buttons.
     * 
     * @param buttons
     *            the widgets to be added to the ButtonGroup
     */
    public ButtonGroup(Button... buttons) {
        this();
        for (Button btn : buttons) {
            add(btn);
        }
    }
    
    @Override
    public void add(IsWidget child) {
        
        Widget widget = asWidgetOrNull(child);
        if(child instanceof AbstractMarkupWidget && widget instanceof DropdownButton) {
            AbstractMarkupWidget markup = (AbstractMarkupWidget) child;
            DropdownButton dropdownBase = (DropdownButton) widget;
            
            markup.setWidget(dropdownBase.getTriggerWidget());
            markup.asWidget();
        }
        
        
        this.add(widget);
    }

    /**
     * Adds a new {@link Button} to the group.
     * 
     * @param widget
     *            the Button to be added.
     */
    @Override
    public void add(Widget widget) {

        if(widget instanceof Button) {
            super.add(widget);
            return;
        }
        
        if(widget instanceof DropdownButton) {
            this.add((DropdownButton)widget);
            return;
        }
        
        throw new IllegalArgumentException(
                "A ButtonGroup can only contain Buttons or DropdownButton. You added " + widget);
        
        
    }
    
    /**
     * Add dropdown widget
     * @param dropdown dropdown widget
     */
    private void add(AbstractDropdownBase dropdown) {
        
        super.add(dropdown.getTriggerWidget());
        super.add(dropdown.getMenuWiget());
        
        this.setStyleName(Constants.DROPUP, dropdown.isDropup());
        
    }
    
    @Override
    public boolean remove(Widget w) {
        
        if(!(w instanceof AbstractDropdownBase)) {
            return super.remove(w);
        }
        
        AbstractDropdownBase dropdown = (AbstractDropdownBase) w;
        
        super.remove(dropdown.getTriggerWidget());
        return super.remove(dropdown.getMenuWiget());
    }

    /**
     * Set/unset the data-toggle behavior.
     * 
     * @param type
     */
    public void setToggle(ToggleType type) {
        if (type == null || type == ToggleType.NONE) {
            getElement().removeAttribute(Constants.DATA_TOGGLE);
            return;
        }
        getElement().setAttribute(Constants.DATA_TOGGLE, type.get());

    }

    /**
     * Set/unset the data-toggle behavior.
     * 
     * @param toggle
     */
    public void setToggle(String toggle) {
        try {
            setToggle(ToggleType.valueOf(toggle.toUpperCase()));
        } catch (Exception e) {
            throw new IllegalArgumentException("Invalid toggle option.");
        }
    }
    
    /**
     * Set vertical style
     * @param vertical true:Set , false:Unset
     */
    public void setVertical(boolean vertical) {
        setStyleName(Constants.BTN_GROUP_VERTICAL, vertical);
    }
}