com.github.fluorumlabs.disconnect.vaadin.GridColumn 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.GridColumnElement;
import com.github.fluorumlabs.disconnect.vaadin.mixins.HasColumnBaseMixin;
import com.github.fluorumlabs.disconnect.vaadin.renderers.CellRenderer;
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 javax.annotation.Nullable;

/**
 * A <vaadin-grid-column> is used to configure how a column in <vaadin-grid>
 * should look like.
 * 
 * See <vaadin-grid> documentation and demos for instructions and examples on how
 * to configure the <vaadin-grid-column>.
 *
 * 

 */
@WebComponent
public class GridColumn extends AbstractComponent> implements
		HasColumnBaseMixin, GridColumn>,
		HasStyle, GridColumn>, HasComponents, GridColumn, Component> {
	public GridColumn() {
		super(GridColumnElement.TAGNAME());
	}

	/**
	 * Width of the cells for this column.
	 */
	@Nullable
	public String width() {
		return getNode().getWidth();
	}

	/**
	 * Width of the cells for this column.
	 */
	public GridColumn width(String width) {
		getNode().setWidth(width);
		return this;
	}

	/**
	 * Flex grow ratio for the cell widths. When set to 0, cell width is fixed.
	 */
	public double flexGrow() {
		return getNode().getFlexGrow();
	}

	/**
	 * Flex grow ratio for the cell widths. When set to 0, cell width is fixed.
	 */
	public GridColumn flexGrow(double flexGrow) {
		getNode().setFlexGrow(flexGrow);
		return this;
	}

	/**
	 * Custom function for rendering the cell content.
	 * Receives three arguments:
	 *
	 * 
	 * root The cell content DOM element. Append your content to it.
	 * column The <vaadin-grid-column> element.
	 * rowData The object with the properties related with
	 * the rendered item, contains:
	 * 
	 * rowData.index The index of the item.
	 * rowData.item The item.
	 * rowData.expanded Sublevel toggle state.
	 * rowData.level Level of the tree represented with a horizontal offset of the toggle button.
	 * rowData.selected Selected state.
	 * 
	 * 
	 * 
	 */
	@Nullable
	public CellRenderer renderer() {
		return getNode().getRenderer();
	}

	/**
	 * Custom function for rendering the cell content.
	 * Receives three arguments:
	 *
	 * 
	 * root The cell content DOM element. Append your content to it.
	 * column The <vaadin-grid-column> element.
	 * rowData The object with the properties related with
	 * the rendered item, contains:
	 * 
	 * rowData.index The index of the item.
	 * rowData.item The item.
	 * rowData.expanded Sublevel toggle state.
	 * rowData.level Level of the tree represented with a horizontal offset of the toggle button.
	 * rowData.selected Selected state.
	 * 
	 * 
	 * 
	 */
	public GridColumn renderer(CellRenderer renderer) {
		getNode().setRenderer(renderer);
		return this;
	}

	/**
	 * Path to an item sub-property whose value gets displayed in the column body cells.
	 * The property name is also shown in the column header if an explicit header or renderer isn't defined.
	 */
	@Nullable
	public String path() {
		return getNode().getPath();
	}

	/**
	 * Path to an item sub-property whose value gets displayed in the column body cells.
	 * The property name is also shown in the column header if an explicit header or renderer isn't defined.
	 */
	public GridColumn path(String path) {
		getNode().setPath(path);
		return this;
	}

	/**
	 * Automatically sets the width of the column based on the column contents when this is set to true.
	 * 
	 * For performance reasons the column width is calculated automatically only once when the grid items
	 * are rendered for the first time and the calculation only considers the rows which are currently
	 * rendered in DOM (a bit more than what is currently visible). If the grid is scrolled, or the cell
	 * content changes, the column width might not match the contents anymore.
	 * 

	 * Hidden columns are ignored in the calculation and their widths are not automatically updated when
	 * you show a column that was initially hidden.
	 * 

	 * You can manually trigger the auto sizing behavior again by calling grid.recalculateColumnWidths().
	 * 

	 * The column width may still grow larger when flexGrow is not 0.
	 */
	public boolean autoWidth() {
		return getNode().isAutoWidth();
	}

	/**
	 * Automatically sets the width of the column based on the column contents when this is set to true.
	 * 

	 * For performance reasons the column width is calculated automatically only once when the grid items
	 * are rendered for the first time and the calculation only considers the rows which are currently
	 * rendered in DOM (a bit more than what is currently visible). If the grid is scrolled, or the cell
	 * content changes, the column width might not match the contents anymore.
	 * 

	 * Hidden columns are ignored in the calculation and their widths are not automatically updated when
	 * you show a column that was initially hidden.
	 * 

	 * You can manually trigger the auto sizing behavior again by calling grid.recalculateColumnWidths().
	 * 
	 * The column width may still grow larger when flexGrow is not 0.
	 */
	public GridColumn autoWidth(boolean autoWidth) {
		getNode().setAutoWidth(autoWidth);
		return this;
	}
}