gwt.material.design.client.ui.MaterialListBox Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of gwt-material

A Material Design look and feel for GWT Applications

There is a newer version: 2.8.3

/*
 * #%L
 * GwtMaterial
 * %%
 * Copyright (C) 2015 - 2017 GwtMaterialDesign
 * %%
 * 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.
 * #L%
 */
package gwt.material.design.client.ui;

import com.google.gwt.dom.client.OptionElement;
import gwt.material.design.client.base.AllowBlankKeyFactory;
import gwt.material.design.client.ui.html.Option;

//@formatter:off

/**
 * Material ListBox is another dropdown component that will set / get the value depends on the selected index
 * 
UiBinder Usage:
 * 
 * 
 * {@code
 *    
 * }
 * 
 * Java Usage:
 * 
 * 
 * {@code
 *     // functions
 *    lstBox.setSelectedIndex(2);
 *    lstBox.getSelectedIndex();
 *    lstBox.addValueChangeHandler(handler);
 * }
 * 
 * 
 *
 * @author kevzlou7979
 * @author Ben Dol
 * @see Material ListBox
 * @see Material Design Specification
 */
//@formatter:on
public class MaterialListBox extends MaterialListValueBox {

    public void add(Option option) {
        getSelectElement().add(OptionElement.as(option.getElement()), null);
        values.add(option.getValue());
    }

    @Override
    public String getValue() {
        String value = super.getValue();
        if (value == null) {
            return AllowBlankKeyFactory.BLANK_VALUE_TEXT;
        } else {
            return value;
        }
    }

    @Override
    public void setValue(String value) {
        if (AllowBlankKeyFactory.BLANK_VALUE_TEXT.equals(value)) {
            super.setValue(null);
        } else {
            super.setValue(value);
        }
    }

}