com.github.fluorumlabs.disconnect.vaadin.ComboBoxLight Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of disconnect-vaadin Show documentation
Vaadin components bindings for Disconnect Zero
The newest version!
package com.github.fluorumlabs.disconnect.vaadin;

import com.github.fluorumlabs.disconnect.core.annotations.WebComponent;
import com.github.fluorumlabs.disconnect.vaadin.elements.ComboBoxLightElement;
import com.github.fluorumlabs.disconnect.vaadin.mixins.HasComboBoxDataProviderMixin;
import com.github.fluorumlabs.disconnect.vaadin.mixins.HasComboBoxMixin;
import com.github.fluorumlabs.disconnect.zero.component.AbstractComponent;
import com.github.fluorumlabs.disconnect.zero.component.Component;
import com.github.fluorumlabs.disconnect.zero.component.HasComponents;
import com.github.fluorumlabs.disconnect.zero.component.HasStyle;
import js.lang.Any;
import js.web.dom.Element;

import javax.annotation.Nullable;

/**
 * <vaadin-combo-box-light> is a customizable version of the <vaadin-combo-box>
 * providing
 * only the dropdown functionality and leaving the input field definition to the user.
 * 
 * The element has the same API as <vaadin-combo-box>.
 * 

 * To create a custom input field, you need to add a child element which has a two-way
 * data-bindable property representing the input value. The property name is expected
 * to be value by default. See the example below for a simplest possible example
 * using a <vaadin-text-field> element.
 *
 * 
<vaadin-combo-box-light>
 *   <vaadin-text-field>
 *   </vaadin-text-field>
 * </vaadin-combo-box-light>
 * 
 * If you are using other custom input fields like <iron-input>, you
 * need to define the name of the bindable property with the attrForValue attribute.
 *
 * <vaadin-combo-box-light attr-for-value="bind-value">
 *   <iron-input>
 *     <input>
 *   </iron-input>
 * </vaadin-combo-box-light>
 * 
 * In the next example you can see how to create a custom input field based
 * on a <paper-input> decorated with a custom <iron-icon> and
 * two <paper-button>s to act as the clear and toggle controls.
 *
 * <vaadin-combo-box-light>
 *   <paper-input label="Elements" class="input">
 *     <iron-icon icon="toll" slot="prefix"></iron-icon>
 *     <paper-button slot="suffix" class="clear-button">Clear</paper-button>
 *     <paper-button slot="suffix" class="toggle-button">Toggle</paper-button>
 *   </paper-input>
 * </vaadin-combo-box-light>
 * 
 */
@WebComponent
public class ComboBoxLight extends AbstractComponent>
		implements HasComboBoxDataProviderMixin, ComboBoxLight>,
		HasComboBoxMixin, ComboBoxLight>,
		HasStyle, ComboBoxLight>, HasComponents, ComboBoxLight, Component> {
	public ComboBoxLight() {
		super(ComboBoxLightElement.TAGNAME());
	}

	/**
	 *
	 */
	public Element focused() {
		return getNode().getFocused();
	}

	/**
	 * Name of the two-way data-bindable property representing the
	 * value of the custom input field.
	 */
	@Nullable
	public String attrForValue() {
		return getNode().getAttrForValue();
	}

	/**
	 * Name of the two-way data-bindable property representing the
	 * value of the custom input field.
	 */
	public ComboBoxLight attrForValue(String attrForValue) {
		getNode().setAttrForValue(attrForValue);
		return this;
	}

	@Nullable
	public Element inputElement() {
		return getNode().getInputElement();
	}
}