gwt.material.design.client.ui.MaterialListValueBox Maven / Gradle / Ivy
/*
* #%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.core.client.GWT;
import com.google.gwt.dom.client.Document;
import com.google.gwt.dom.client.OptionElement;
import com.google.gwt.dom.client.SelectElement;
import com.google.gwt.event.dom.client.DomEvent;
import com.google.gwt.event.logical.shared.ValueChangeEvent;
import com.google.gwt.i18n.client.HasDirection.Direction;
import com.google.gwt.user.client.ui.FormPanel;
import com.google.gwt.user.client.ui.HasConstrainedValue;
import com.google.gwt.user.client.ui.ListBox;
import gwt.material.design.client.async.AsyncWidgetCallback;
import gwt.material.design.client.async.HasAsyncRenderer;
import gwt.material.design.client.async.IsAsyncWidget;
import gwt.material.design.client.async.loader.AsyncDisplayLoader;
import gwt.material.design.client.async.loader.DefaultListValueBoxLoader;
import gwt.material.design.client.async.mixin.AsyncWidgetMixin;
import gwt.material.design.client.async.renderer.AsyncRenderer;
import gwt.material.design.client.base.*;
import gwt.material.design.client.base.mixin.FieldTypeMixin;
import gwt.material.design.client.base.mixin.NativeBrowserStyleMixin;
import gwt.material.design.client.base.mixin.ReadOnlyMixin;
import gwt.material.design.client.base.mixin.StatusTextMixin;
import gwt.material.design.client.constants.CssName;
import gwt.material.design.client.constants.FieldType;
import gwt.material.design.client.js.JsMaterialElement;
import gwt.material.design.client.ui.html.Label;
import gwt.material.design.jquery.client.api.JQueryElement;
import java.util.*;
import static gwt.material.design.client.js.JsMaterialElement.$;
//@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 MaterialListValueBox extends AbstractValueWidget implements JsLoader, HasPlaceholder,
HasConstrainedValue, HasReadOnly, HasFieldTypes, IsAsyncWidget, List>,
HasAsyncRenderer, HasNativeBrowserStyle, HasLabel {
private final ListBox listBox = new ListBox();
private final Label label = new Label();
protected final List values = new ArrayList<>();
private KeyFactory keyFactory = new AllowBlankKeyFactory();
private MaterialLabel errorLabel = new MaterialLabel();
private AsyncRenderer asyncRenderer;
private ReadOnlyMixin, ListBox> readOnlyMixin;
private StatusTextMixin statusTextMixin;
private FieldTypeMixin fieldTypeMixin;
private AsyncWidgetMixin, List> asyncWidgetMixin;
private NativeBrowserStyleMixin nativeBrowserStyleMixin;
private String emptyPlaceHolder = null;
public MaterialListValueBox() {
super(Document.get().createDivElement(), CssName.INPUT_FIELD, CssName.LISTBOX_WRAPPER);
setAllowBlank(false);
setAsyncDisplayLoader(new DefaultListValueBoxLoader(this));
}
@Override
protected void onLoad() {
super.onLoad();
add(listBox);
add(label);
add(errorLabel);
registerHandler(addValueChangeHandler(valueChangeEvent -> {
if (isToggleReadOnly()) {
setReadOnly(true);
}
}));
load();
}
@Override
public void load() {
JQueryElement listBoxElement = $(listBox.getElement());
JsMaterialElement.$(listBox.getElement()).material_select(() -> $("input.select-dropdown").trigger("close", true));
listBoxElement.change((e, param) -> {
try {
ValueChangeEvent.fire(this, getValue());
} catch (IndexOutOfBoundsException ex) {
GWT.log("ListBox value change handler threw an exception.", ex);
}
return true;
});
JQueryElement selectDropdown = listBoxElement.siblings("input.select-dropdown");
selectDropdown.mousedown((event, o) -> {
$("input[data-activates!='" + listBoxElement.attr("data-activates") + "'].select-dropdown").trigger("close", true);
return true;
});
selectDropdown.blur((e, param1) -> {
DomEvent.fireNativeEvent(Document.get().createBlurEvent(), this);
return true;
});
selectDropdown.focus((e, param1) -> {
DomEvent.fireNativeEvent(Document.get().createFocusEvent(), this);
if (isAsynchronous() && !isLoaded()) {
load(getAsyncCallback());
}
return true;
});
if (isAllowBlank()) {
addBlankItemIfNeeded();
}
}
@Override
protected void onUnload() {
super.onUnload();
unload();
}
@Override
public void unload() {
if (listBox != null && listBox.isAttached()) {
$(listBox.getElement()).siblings("input.select-dropdown").off("mousedown");
$(listBox.getElement()).off("change");
$(listBox.getElement()).material_select("destroy");
}
}
@Override
public void reload() {
if (isAttached()) {
unload();
load();
}
}
public void add(T value) {
addItem(value);
}
/**
* Adds an item to the list box, specifying its direction. This method has
* the same effect as
* addItem(value, dir, item)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}; cannot be null
* @param dir the item's direction
*/
public void addItem(T value, Direction dir) {
addItem(value, dir, true);
}
/**
* Adds an item to the list box, specifying its direction. This method has
* the same effect as
* addItem(value, dir, item)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}; cannot be null
* @param dir the item's direction
* @param reload perform a 'material select' reload to update the DOM.
*/
public void addItem(T value, Direction dir, boolean reload) {
values.add(value);
listBox.addItem(keyFactory.generateKey(value), dir);
if (reload) {
reload();
}
}
/**
* Adds an item to the list box. This method has the same effect as
* addItem(value, item)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}; cannot be null
*/
public void addItem(T value) {
addItem(value, true);
}
/**
* Adds an item to the list box. This method has the same effect as
* addItem(value, item)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}; cannot be null
* @param reload perform a 'material select' reload to update the DOM.
*/
public void addItem(T value, boolean reload) {
values.add(value);
listBox.addItem(keyFactory.generateKey(value));
if (reload) {
reload();
}
}
/**
* Adds an item to the list box, specifying an initial value for the item.
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}; cannot be null
* @param text the text of the item to be added
*/
public void addItem(T value, String text) {
addItem(value, text, true);
}
/**
* Adds an item to the list box, specifying an initial value for the item.
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}; cannot be null
* @param text the text of the item to be added
* @param reload perform a 'material select' reload to update the DOM.
*/
public void addItem(T value, String text, boolean reload) {
values.add(value);
listBox.addItem(text, keyFactory.generateKey(value));
if (reload) {
reload();
}
}
/**
* Adds an item to the list box, specifying its direction and an initial
* value for the item.
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}; cannot be null
* @param dir the item's direction
* @param text the text of the item to be added
*/
public void addItem(T value, Direction dir, String text) {
addItem(value, dir, text, true);
}
/**
* Adds an item to the list box, specifying its direction and an initial
* value for the item.
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}; cannot be null
* @param dir the item's direction
* @param text the text of the item to be added
* @param reload perform a 'material select' reload to update the DOM.
*/
public void addItem(T value, Direction dir, String text, boolean reload) {
values.add(value);
listBox.addItem(text, dir, keyFactory.generateKey(value));
if (reload) {
reload();
}
}
/**
* Inserts an item into the list box. Has the same effect as
* insertItem(value, item, index)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}.
* @param index the index at which to insert it
*/
public void insertItem(T value, int index) {
insertItemInternal(value, index, true);
}
/**
* Inserts an item into the list box. Has the same effect as
* insertItem(value, item, index)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}.
* @param index the index at which to insert it
* @param reload perform a 'material select' reload to update the DOM.
*/
public void insertItem(T value, int index, boolean reload) {
index += getIndexOffset();
insertItemInternal(value, index, reload);
}
protected void insertItemInternal(T value, int index, boolean reload) {
values.add(index, value);
listBox.insertItem(keyFactory.generateKey(value), index);
if (reload) {
reload();
}
}
/**
* Inserts an item into the list box, specifying its direction. Has the same
* effect as
* insertItem(value, dir, item, index)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}.
* @param dir the item's direction
* @param index the index at which to insert it
*/
public void insertItem(T value, Direction dir, int index) {
insertItemInternal(value, dir, index, true);
}
/**
* Inserts an item into the list box, specifying its direction. Has the same
* effect as
* insertItem(value, dir, item, index)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}.
* @param dir the item's direction
* @param index the index at which to insert it
* @param reload perform a 'material select' reload to update the DOM.
*/
public void insertItem(T value, Direction dir, int index, boolean reload) {
index += getIndexOffset();
insertItemInternal(value, dir, index, reload);
}
protected void insertItemInternal(T value, Direction dir, int index, boolean reload) {
values.add(index, value);
listBox.insertItem(keyFactory.generateKey(value), dir, index);
if (reload) {
reload();
}
}
/**
* Inserts an item into the list box, specifying an initial value for the
* item. Has the same effect as
* insertItem(value, null, item, index)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}.
* @param text the text of the item to be inserted
* @param index the index at which to insert it
*/
public void insertItem(T value, String text, int index) {
insertItemInternal(value, text, index, true);
}
/**
* Inserts an item into the list box, specifying an initial value for the
* item. Has the same effect as
* insertItem(value, null, item, index)
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}.
* @param text the text of the item to be inserted
* @param index the index at which to insert it
* @param reload perform a 'material select' reload to update the DOM.
*/
public void insertItem(T value, String text, int index, boolean reload) {
index += getIndexOffset();
insertItemInternal(value, text, index, reload);
}
protected void insertItemInternal(T value, String text, int index, boolean reload) {
values.add(index, value);
listBox.insertItem(text, keyFactory.generateKey(value), index);
if (reload) {
reload();
}
}
/**
* Inserts an item into the list box, specifying its direction and an
* initial value for the item. If the index is less than zero, or greater
* than or equal to the length of the list, then the item will be appended
* to the end of the list.
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}.
* @param dir the item's direction. If {@code null}, the item is displayed
* in the widget's overall direction, or, if a direction
* estimator has been set, in the item's estimated direction.
* @param text the text of the item to be inserted
* @param index the index at which to insert it
*/
public void insertItem(T value, Direction dir, String text, int index) {
insertItemInternal(value, dir, text, index, true);
}
/**
* Inserts an item into the list box, specifying its direction and an
* initial value for the item. If the index is less than zero, or greater
* than or equal to the length of the list, then the item will be appended
* to the end of the list.
*
* @param value the item's value, to be submitted if it is part of a
* {@link FormPanel}.
* @param dir the item's direction. If {@code null}, the item is displayed
* in the widget's overall direction, or, if a direction
* estimator has been set, in the item's estimated direction.
* @param text the text of the item to be inserted
* @param index the index at which to insert it
* @param reload perform a 'material select' reload to update the DOM.
*/
public void insertItem(T value, Direction dir, String text, int index, boolean reload) {
index += getIndexOffset();
insertItemInternal(value, dir, text, index, reload);
}
protected void insertItemInternal(T value, Direction dir, String text, int index, boolean reload) {
values.add(index, value);
listBox.insertItem(keyFactory.generateKey(value), dir, text, index);
if (reload) {
reload();
}
}
/**
* Removes the item at the specified index.
*
* @param index the index of the item to be removed
* @throws IndexOutOfBoundsException if the index is out of range
*/
public void removeItem(int index) {
removeItemInternal(index, true);
}
/**
* Removes the item at the specified index.
*
* @param index the index of the item to be removed
* @param reload perform a 'material select' reload to update the DOM.
* @throws IndexOutOfBoundsException if the index is out of range
*/
public void removeItem(int index, boolean reload) {
index += getIndexOffset();
removeItemInternal(index, reload);
}
protected void removeItemInternal(int index, boolean reload) {
values.remove(index);
listBox.removeItem(index);
if (reload) {
reload();
}
}
/**
* Removes a value from the list box. Nothing is done if the value isn't on
* the list box.
*
* @param value the value to be removed from the list
*/
public void removeValue(T value) {
removeValue(value, true);
}
/**
* Removes a value from the list box. Nothing is done if the value isn't on
* the list box.
*
* @param value the value to be removed from the list
* @param reload perform a 'material select' reload to update the DOM.
*/
public void removeValue(T value, boolean reload) {
int idx = getIndex(value);
if (idx >= 0) {
removeItemInternal(idx, reload);
}
}
/**
* This will reset the listbox from original selected index.
*/
@Override
public void reset() {
super.reset();
setSelectedIndex(0);
}
/**
* Removes all items from the list box.
*/
@Override
public void clear() {
values.clear();
listBox.clear();
clearStatusText();
if (emptyPlaceHolder != null) {
insertEmptyPlaceHolder(emptyPlaceHolder);
}
reload();
if (isAllowBlank()) {
addBlankItemIfNeeded();
}
}
/**
* Starting GMD 2.3.1 we standardized the labelling system
* of all value widget fields. Please check {@link HasLabel#setLabel(String)}
* for the new getter and setter.
*/
@Deprecated
@Override
public void setPlaceholder(String placeholder) {
setLabel(placeholder);
}
/**
* Starting GMD 2.3.1 we standardized the labelling system
* of all value widget fields. Please check {@link HasLabel#getLabel()}
* for the new getter and setter.
*/
@Deprecated
@Override
public String getPlaceholder() {
return getLabel();
}
@Override
public void setLabel(String label) {
this.label.setText(label);
}
@Override
public String getLabel() {
return label.getText();
}
public OptionElement getOptionElement(int index) {
return getSelectElement().getOptions().getItem(index);
}
protected SelectElement getSelectElement() {
return listBox.getElement().cast();
}
/**
* Sets whether this list allows multiple selections.
*
* @param multipleSelect true to allow multiple selections
*/
public void setMultipleSelect(boolean multipleSelect) {
listBox.setMultipleSelect(multipleSelect);
}
/**
* Gets whether this list allows multiple selection.
*
* @return true if multiple selection is allowed
*/
public boolean isMultipleSelect() {
return listBox.isMultipleSelect();
}
public void setEmptyPlaceHolder(String value) {
if (value == null) {
// about to un-set emptyPlaceHolder
if (emptyPlaceHolder != null) {
// emptyPlaceHolder is about to change from null to non-null
if (isEmptyPlaceHolderListed()) {
// indeed first item is actually emptyPlaceHolder
removeEmptyPlaceHolder();
} else {
GWT.log("WARNING: emptyPlaceHolder is set but not listed.", new IllegalStateException());
}
} // else no change
} else {
if (!value.equals(emptyPlaceHolder)) {
// adding emptyPlaceHolder
insertEmptyPlaceHolder(value);
} // else no change
}
emptyPlaceHolder = value;
}
public String getEmptyPlaceHolder() {
return emptyPlaceHolder;
}
@Override
public void setAcceptableValues(Collection values) {
clear();
if (isAllowBlank()) {
addBlankItemIfNeeded();
}
values.forEach(this::addItem);
}
@Override
public T getValue() {
int selectedIndex = listBox.getSelectedIndex();
if (selectedIndex >= 0) {
return values.get(selectedIndex);
}
return null;
}
@Override
public void setValue(T value) {
setValue(value, false);
}
@Override
public void setValue(T value, boolean fireEvents) {
if (value == null) {
reset();
if (fireEvents) {
ValueChangeEvent.fire(this, null);
}
} else {
int index = values.indexOf(value);
if (index < 0 && value instanceof String) {
index = getIndexByString((String) value);
}
if (index > -1) {
T before = getValue();
setSelectedIndexInternal(index);
if (fireEvents) {
ValueChangeEvent.fireIfNotEqual(this, before, value);
}
}
}
}
// TODO: Optimize performance (maybe use a map)
public T getValueByString(String key) {
for (T value : values) {
if (keyFactory.generateKey(value).equals(key)) {
return value;
}
}
return null;
}
// TODO: Optimize performance (maybe use a map)
public int getIndexByString(String key) {
int index = -1;
for (T value : values) {
if (keyFactory.generateKey(value).equals(key)) {
index = values.indexOf(value);
}
}
return index;
}
/**
* As of GMD 2.2 this was replaced by {@link #setNativeBrowserStyle(boolean)}
*/
@Deprecated
public boolean isOld() {
return isNativeBrowserStyle();
}
/**
* As of GMD 2.2 this was replaced by {@link #setNativeBrowserStyle(boolean)}
*/
@Deprecated
public void setOld(boolean value) {
setNativeBrowserStyle(value);
}
@Override
public void setNativeBrowserStyle(boolean value) {
getNativeBrowserStyleMixin().setNativeBrowserStyle(value);
}
@Override
public boolean isNativeBrowserStyle() {
return getNativeBrowserStyleMixin().isNativeBrowserStyle();
}
/**
* Sets the value associated with the item at a given index. This value can
* be used for any purpose, but is also what is passed to the server when
* the list box is submitted as part of a {@link FormPanel}.
*
* @param index the index of the item to be set
* @param value the item's new value; cannot be null
* @throws IndexOutOfBoundsException if the index is out of range
*/
public void setValue(int index, String value) {
index += getIndexOffset();
listBox.setValue(index, value);
reload();
}
@Override
public void setTitle(String title) {
listBox.setTitle(title);
}
/**
* Sets whether an individual list item is selected.
*
* @param index the index of the item to be selected or unselected
* @param selected true to select the item
* @throws IndexOutOfBoundsException if the index is out of range
*/
public void setItemSelected(int index, boolean selected) {
index += getIndexOffset();
setItemSelectedInternal(index, selected);
}
private void setItemSelectedInternal(int index, boolean selected) {
listBox.setItemSelected(index, selected);
reload();
}
/**
* Sets the text associated with the item at a given index.
*
* @param index the index of the item to be set
* @param text the item's new text
* @throws IndexOutOfBoundsException if the index is out of range
*/
public void setItemText(int index, String text) {
index += getIndexOffset();
listBox.setItemText(index, text);
reload();
}
/**
* Sets the text associated with the item at a given index.
*
* @param index the index of the item to be set
* @param text the item's new text
* @param dir the item's direction.
* @throws IndexOutOfBoundsException if the index is out of range
*/
public void setItemText(int index, String text, Direction dir) {
index += getIndexOffset();
listBox.setItemText(index, text, dir);
reload();
}
public void setName(String name) {
listBox.setName(name);
}
/**
* Sets the currently selected index.
*
* After calling this method, only the specified item in the list will
* remain selected. For a ListBox with multiple selection enabled, see
* {@link #setItemSelected(int, boolean)} to select multiple items at a
* time.
*
* @param index the index of the item to be selected
*/
public void setSelectedIndex(int index) {
if (index >= 0) {
index += getIndexOffset();
}
setSelectedIndexInternal(index);
}
protected void setSelectedIndexInternal(int index) {
listBox.setSelectedIndex(index);
reload();
}
/**
* Sets the number of items that are visible. If only one item is visible,
* then the box will be displayed as a drop-down list.
*
* @param visibleItems the visible item count
*/
public void setVisibleItemCount(int visibleItems) {
listBox.setVisibleItemCount(visibleItems);
}
/**
* Gets the number of items present in the list box.
*
* @return the number of items
*/
public int getItemCount() {
return listBox.getItemCount();
}
/**
* Gets the text associated with the item at the specified index.
*
* @param index the index of the item whose text is to be retrieved
* @return the text associated with the item
* @throws IndexOutOfBoundsException if the index is out of range
*/
public String getItemText(int index) {
index += getIndexOffset();
return listBox.getItemText(index);
}
/**
* Gets the text for currently selected item. If multiple items are
* selected, this method will return the text of the first selected item.
*
* @return the text for selected item, or {@code null} if none is selected
*/
public String getSelectedItemText() {
return listBox.getSelectedItemText();
}
public String getName() {
return listBox.getName();
}
/**
* Gets the currently-selected item. If multiple items are selected, this
* method will return the first selected item ({@link #isItemSelected(int)}
* can be used to query individual items).
*
* @return the selected index, or -1 if none is selected
*/
public int getSelectedIndex() {
int selectedIndex = getSelectedIndexInternal();
if (selectedIndex >= 0) {
selectedIndex -= getIndexOffset();
}
return selectedIndex;
}
protected int getSelectedIndexInternal() {
return listBox.getSelectedIndex();
}
/**
* Gets the value associated with the item at a given index.
*
* @param index the index of the item to be retrieved
* @return the item's associated value
* @throws IndexOutOfBoundsException if the index is out of range
*/
public T getValue(int index) {
return getValueInternal(index + getIndexOffset());
}
protected T getValueInternal(int index) {
return values.get(index);
}
/**
* Gets the value for currently selected item. If multiple items are
* selected, this method will return the value of the first selected item.
*
* @return the value for selected item, or {@code null} if none is selected
*/
public T getSelectedValue() {
try {
return values.get(getSelectedIndexInternal());
} catch (IndexOutOfBoundsException ex) {
return null;
}
}
/**
* Gets the number of items that are visible. If only one item is visible,
* then the box will be displayed as a drop-down list.
*
* @return the visible item count
*/
public int getVisibleItemCount() {
return listBox.getVisibleItemCount();
}
/**
* Determines whether an individual list item is selected.
*
* @param index the index of the item to be tested
* @return true if the item is selected
* @throws IndexOutOfBoundsException if the index is out of range
*/
public boolean isItemSelected(int index) {
return listBox.isItemSelected(index + getIndexOffset());
}
@Override
public void setEnabled(boolean enabled) {
listBox.setEnabled(enabled);
label.setEnabled(enabled);
reload();
}
@Override
public boolean isEnabled() {
return listBox.isEnabled();
}
/**
* Use your own key factory for value keys.
*/
public void setKeyFactory(KeyFactory keyFactory) {
this.keyFactory = keyFactory;
}
@Override
public void setReadOnly(boolean value) {
getReadOnlyMixin().setReadOnly(value);
if (!value && isAttached()) {
$(listBox.getElement()).material_select("destroy");
$(listBox.getElement()).material_select();
}
}
@Override
public boolean isReadOnly() {
return getReadOnlyMixin().isReadOnly();
}
@Override
public void setToggleReadOnly(boolean toggle) {
getReadOnlyMixin().setToggleReadOnly(toggle);
}
@Override
public boolean isToggleReadOnly() {
return getReadOnlyMixin().isToggleReadOnly();
}
@Override
public void setAllowBlank(boolean allowBlank) {
super.setAllowBlank(allowBlank);
if (allowBlank) {
addBlankItemIfNeeded();
} else {
removeBlankItemIfNeeded();
}
}
protected void addBlankItemIfNeeded() {
int idx = getIndex(null);
if (idx < 0) {
ArrayList previous = new ArrayList<>(values);
values.clear();
values.add(null);
values.addAll(previous);
listBox.insertItem(AllowBlankKeyFactory.BLANK_VALUE_TEXT, 0);
setSelectedIndexInternal(-1);
}
}
protected void removeBlankItemIfNeeded() {
int idx = getIndex(null);
if (idx >= 0 && idx < values.size()) {
removeItem(idx, true);
}
}
public ListBox getListBox() {
return listBox;
}
@Override
public StatusTextMixin getStatusTextMixin() {
if (statusTextMixin == null) {
statusTextMixin = new StatusTextMixin<>(this, errorLabel, this, label);
}
return statusTextMixin;
}
public Label getLabelWidget() {
return label;
}
public MaterialLabel getErrorLabel() {
return errorLabel;
}
/**
* Returns all selected values of the list box, or empty array if none.
*
* @return the selected values of the list box
*/
public String[] getItemsSelected() {
List selected = new LinkedList<>();
for (int i = getIndexOffset(); i < listBox.getItemCount(); i++) {
if (listBox.isItemSelected(i)) {
selected.add(listBox.getValue(i));
}
}
return selected.toArray(new String[selected.size()]);
}
/**
* Sets the currently selected value.
*
* After calling this method, only the specified item in the list will
* remain selected. For a ListBox with multiple selection enabled, see
* {@link #setValueSelected(T, boolean)} to select multiple items at a
* time.
*
* @param value the value of the item to be selected
*/
public void setSelectedValue(T value) {
int idx = getIndex(value);
if (idx >= 0) {
setSelectedIndexInternal(idx);
}
}
/**
* Sets whether an individual list value is selected.
*
* @param value the value of the item to be selected or unselected
* @param selected true to select the item
*/
public void setValueSelected(T value, boolean selected) {
int idx = getIndex(value);
if (idx >= 0) {
setItemSelectedInternal(idx, selected);
}
}
/**
* Gets the index of the specified value.
*
* @param value the value of the item to be found
* @return the index of the value
*/
public int getIndex(T value) {
int count = getItemCount() - getIndexOffset();
for (int i = 0; i < count; i++) {
if (Objects.equals(getValue(i), value)) {
return i;
}
}
return -1;
}
/**
* Checks whether {@link #emptyPlaceHolder} is added/present in both {@link #listBox} and {@link #values} at 0 index.
*
* @return is {@link #emptyPlaceHolder} added/present in both {@link #listBox} and {@link #values}?
*/
protected boolean isEmptyPlaceHolderListed() {
return emptyPlaceHolder.equals(listBox.getValue(0)) &&
values.get(0) == null;
}
protected void insertEmptyPlaceHolder(String emptyPlaceHolder) {
listBox.insertItem(emptyPlaceHolder, 0);
values.add(0, null);
getOptionElement(0).setDisabled(true);
}
protected void removeEmptyPlaceHolder() {
// indeed the first item/value is emptyPlaceHolder
listBox.removeItem(0);
values.remove(0);
OptionElement currentPlaceholder = getOptionElement(0);
if (currentPlaceholder != null) {
currentPlaceholder.setDisabled(false);
}
}
/**
* @return index increased by number of special items/values at the start (e.g. {@link #emptyPlaceHolder})
*/
protected int getIndexOffset() {
return emptyPlaceHolder != null && isEmptyPlaceHolderListed() ? 1 : 0;
}
@Override
public void setFieldType(FieldType type) {
getFieldTypeMixin().setFieldType(type);
}
@Override
public FieldType getFieldType() {
return getFieldTypeMixin().getFieldType();
}
@Override
public void setLabelWidth(double percentWidth) {
getFieldTypeMixin().setLabelWidth(percentWidth);
}
@Override
public void setFieldWidth(double percentWidth) {
getFieldTypeMixin().setFieldWidth(percentWidth);
}
@Override
public void setAsynchronous(boolean asynchronous) {
getAsyncWidgetMixin().setAsynchronous(asynchronous);
}
@Override
public boolean isAsynchronous() {
return getAsyncWidgetMixin().isAsynchronous();
}
@Override
public void load(AsyncWidgetCallback, List> asyncCallback) {
getAsyncWidgetMixin().load(asyncCallback);
}
@Override
public void setLoaded(boolean loaded) {
getAsyncWidgetMixin().setLoaded(loaded);
}
@Override
public boolean isLoaded() {
return getAsyncWidgetMixin().isLoaded();
}
@Override
public void setAsyncCallback(AsyncWidgetCallback, List> asyncCallback) {
getAsyncWidgetMixin().setAsyncCallback(asyncCallback);
}
@Override
public AsyncWidgetCallback, List> getAsyncCallback() {
return getAsyncWidgetMixin().getAsyncCallback();
}
@Override
public void setAsyncDisplayLoader(AsyncDisplayLoader displayLoader) {
getAsyncWidgetMixin().setAsyncDisplayLoader(displayLoader);
}
@Override
public void setAsyncRenderer(AsyncRenderer asyncRenderer) {
this.asyncRenderer = asyncRenderer;
}
@Override
public AsyncRenderer getAsyncRenderer() {
return asyncRenderer;
}
@Override
public AsyncDisplayLoader getAsyncDisplayLoader() {
return getAsyncWidgetMixin().getAsyncDisplayLoader();
}
public ReadOnlyMixin, ListBox> getReadOnlyMixin() {
if (readOnlyMixin == null) {
readOnlyMixin = new ReadOnlyMixin<>(this, listBox);
}
return readOnlyMixin;
}
protected FieldTypeMixin getFieldTypeMixin() {
if (fieldTypeMixin == null) {
fieldTypeMixin = new FieldTypeMixin<>(this);
}
return fieldTypeMixin;
}
protected AsyncWidgetMixin, List> getAsyncWidgetMixin() {
if (asyncWidgetMixin == null) {
asyncWidgetMixin = new AsyncWidgetMixin<>(this);
}
return asyncWidgetMixin;
}
protected NativeBrowserStyleMixin getNativeBrowserStyleMixin() {
if (nativeBrowserStyleMixin == null) {
nativeBrowserStyleMixin = new NativeBrowserStyleMixin<>(this, listBox);
}
return nativeBrowserStyleMixin;
}
}