Package org.zkoss.stateless.sul

Interface IListheader<I extends IAnyGroup>

All Superinterfaces:

IChildable<IListheader<I>,I>, IChildrenOfInputgroup<IListheader<I>>, IComponent<IListheader<I>>, IHeaderElement<IListheader<I>>, IHtmlBasedComponent<IListheader<I>>, ILabelElement<IListheader<I>>, ILabelImageElement<IListheader<I>>, IXulElement<IListheader<I>>

public interface IListheader<I extends IAnyGroup>
extends IHeaderElement<IListheader<I>>, IChildable<IListheader<I>,I>

Immutable Listheader component

The list header which defines the attributes and header of a column of a list box.

Support @Action

Name	Action Type
onSort	ActionData: SortData Denotes user has sorted the row of this column.
onGroup	ActionData: SortData Denotes user has grouped all the cells under a column. [ZK PE]
onUngroup	ActionData: SortData Denotes user has ungrouped all the cells under a column. [ZK EE]

Author:

katherine

See Also:

• Listheader

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	IListheader.Builder<I extends IAnyGroup>	Builds instances of type IListheader.
static enum	IListheader.SortDirection	Sets the sort direction.
static class	IListheader.Updater	Builds an updater of type IListheader for UiAgent.smartUpdate(Locator, SmartUpdater).

Field Summary

Fields

Modifier and Type	Field	Description
static final IListheader<IAnyGroup>	DEFAULT	Constant for default attributes of this immutable component.

Method Summary

Modifier and Type	Method	Description
Comparator<?>	getSortAscending()	Returns the ascending sorter, or null if not available.
Comparator<?>	getSortDescending()	Returns the descending sorter, or null if not available.
default String	getSortDirection()	Returns the sort direction.
default String	getWidgetClass()	Returns the client widget class.
default boolean	isResponsiveVisible()	Returns whether this column is visible when the listbox is in responsive (stacking) mode.
static <I extends IAnyGroup> IListheader<I>	of(I... children)	Returns the instance with the given any group children.
static <I extends IAnyGroup> IListheader<I>	of(Iterable<? extends I> children)	Returns the instance with the given any group children.
static <I extends IAnyGroup> IListheader<I>	of(String label)	Returns the instance with the given label.
static <I extends IAnyGroup> IListheader<I>	of(String label, String image)	Returns the instance with the given label and image.
static <I extends IAnyGroup> IListheader<I>	ofId(String id)	Returns the instance with the given id.
static <I extends IAnyGroup> IListheader<I>	ofImage(String image)	Returns the instance with the given image.
IListheader<I>	withResponsiveVisible(boolean responsiveVisible)	Returns a copy of this immutable component with the specified responsiveVisible.
default IListheader<I>	withSortAscending(String sortAscending)	Returns a copy of this immutable component with the specified sortAscending class name.
IListheader<I>	withSortAscending(Comparator<?> sortAscending)	Returns a copy of this immutable component with the specified sortAscending.
default IListheader<I>	withSortDescending(String sortDescending)	Returns a copy of this immutable component with the specified sortDescending class name.
IListheader<I>	withSortDescending(Comparator<?> sortDescending)	Returns a copy of this immutable component with the specified sortDescending.
IListheader<I>	withSortDirection(String sortDirection)	Returns a copy of this immutable component with the specified sortDirection.
default IListheader<I>	withSortDirection(IListheader.SortDirection sortDirection)	Returns a copy of this immutable component with the specified sortDirection.

Methods inherited from interface org.zkoss.stateless.sul.IChildable

getChildren, withChildren, withChildren

Methods inherited from interface org.zkoss.stateless.sul.IComponent

getAction, getActions, getClientAttributes, getId, getMold, getWidgetListeners, getWidgetOverrides, isVisible, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withAction, withActions, withActions, withClientAttribute, withClientAttributes, withId, withMold, withVisible, withWidgetClass, withWidgetListener, withWidgetListeners, withWidgetOverride, withWidgetOverrides

Methods inherited from interface org.zkoss.stateless.sul.IHeaderElement

getAlign, getValign, withAlign, withValign

Methods inherited from interface org.zkoss.stateless.sul.IHtmlBasedComponent

getClientAction, getDraggable, getDroppable, getHeight, getHflex, getLeft, getRenderdefer, getSclass, getSkeleton, getStyle, getTabindex, getTooltiptext, getTop, getVflex, getWidth, getZclass, getZIndex, isFocus, withClientAction, withDraggable, withDroppable, withFocus, withHeight, withHflex, withLeft, withRenderdefer, withSclass, withSkeleton, withStyle, withTabindex, withTabindex, withTooltiptext, withTop, withVflex, withWidth, withZclass, withZIndex

Methods inherited from interface org.zkoss.stateless.sul.ILabelElement

getLabel, withLabel

Methods inherited from interface org.zkoss.stateless.sul.ILabelImageElement

getHoverImage, getIconSclass, getIconSclasses, getIconTooltip, getIconTooltips, getImage, isPreloadImage, withHoverImage, withIconSclass, withIconSclasses, withIconTooltip, withIconTooltips, withImage, withPreloadImage

Methods inherited from interface org.zkoss.stateless.sul.IXulElement

getContext, getCtrlKeys, getPopup, getTooltip, withContext, withCtrlKeys, withPopup, withTooltip

Field Details

DEFAULT

static final IListheader<IAnyGroup> DEFAULT

Constant for default attributes of this immutable component.

Method Details

getWidgetClass

default String getWidgetClass()

Returns the client widget class.

Default: "zul.sel.Listheader"

Specified by:

getWidgetClass in interface IComponent<I extends IAnyGroup>

Returns:

getSortDirection

default String getSortDirection()

Returns the sort direction.

Default: "natural".

withSortDirection

IListheader<I> withSortDirection(String sortDirection)

Returns a copy of this immutable component with the specified sortDirection.

Sets the sort direction. This does not sort the data, it only serves as an indicator as to how the listbox is sorted. (unless the listbox has IListbox.isAutosort() attribute for model case)

Parameters:

sortDirection - One of "ascending", "descending" and "natural"

Default: "natural".

Returns:

A modified copy of the this object

withSortDirection

default IListheader<I> withSortDirection(IListheader.SortDirection sortDirection)

Returns a copy of this immutable component with the specified sortDirection.

Sets the sort direction. This does not sort the data, it only serves as an indicator as to how the listbox is sorted. (unless the listbox has IListbox.isAutosort() attribute for model case)

Parameters:

sortDirection - One of IListheader.SortDirection

Default: IListheader.SortDirection.NATURAL.

Returns:

A modified copy of the this object

getSortAscending

@Nullable
Comparator<?> getSortAscending()

Returns the ascending sorter, or null if not available.

Default: null

withSortAscending

IListheader<I> withSortAscending(@Nullable
 Comparator<?> sortAscending)

Returns a copy of this immutable component with the specified sortAscending.

Sets the ascending sorter, or null for no sorter for the ascending order.

Parameters:

sortAscending - The comparator used to sort the ascending order.

Default: null.

Returns:

A modified copy of the this object

withSortAscending

default IListheader<I> withSortAscending(String sortAscending)
                                  throws ClassNotFoundException,
InstantiationException,
IllegalAccessException

Returns a copy of this immutable component with the specified sortAscending class name.

Sets the ascending sorter with the class name, or null for no sorter for the ascending order.

Parameters:

sortAscending - The comparator used to sort the ascending order.

Default: null.

Returns:

A modified copy of the this object

Throws:

ClassNotFoundException

InstantiationException

IllegalAccessException

getSortDescending

@Nullable
Comparator<?> getSortDescending()

Returns the descending sorter, or null if not available.

Default: null

withSortDescending

IListheader<I> withSortDescending(@Nullable
 Comparator<?> sortDescending)

Returns a copy of this immutable component with the specified sortDescending.

Sets the descending sorter, or null for no sorter for the descending order.

Parameters:

sortDescending - The comparator used to sort the descending order.

Default: null.

Returns:

A modified copy of the this object

withSortDescending

default IListheader<I> withSortDescending(String sortDescending)
                                   throws ClassNotFoundException,
InstantiationException,
IllegalAccessException

Returns a copy of this immutable component with the specified sortDescending class name.

Sets the descending sorter with the class name, or null for no sorter for the descending order.

Parameters:

sortDescending - The comparator used to sort the descending order.

Default: null.

Returns:

A modified copy of the this object

Throws:

ClassNotFoundException

InstantiationException

IllegalAccessException

isResponsiveVisible

default boolean isResponsiveVisible()

Returns whether this column is visible when the listbox is in responsive (stacking) mode.

Default: true.

Since:

11.0.0

withResponsiveVisible

IListheader<I> withResponsiveVisible(boolean responsiveVisible)

Returns a copy of this immutable component with the specified responsiveVisible.

Sets whether this column is visible when the listbox is in responsive (stacking) mode. false hides the column only in stacking mode; it stays visible in table mode.

Parameters:

responsiveVisible - false to hide this column in stacking mode.

Default: true.

Returns:

A modified copy of the this object

Since:

11.0.0

of

static <I extends IAnyGroup> IListheader<I> of(String label)

Returns the instance with the given label.

Parameters:

label - The label belongs to this column.

of

static <I extends IAnyGroup> IListheader<I> of(String label,
 String image)

Returns the instance with the given label and image.

Parameters:

label - The label that the column holds.

image - The image that the column holds.

of

static <I extends IAnyGroup> IListheader<I> of(Iterable<? extends I> children)

Returns the instance with the given any group children.

Parameters:

children - The children belong to any group

See Also:

• IAnyGroup

of

static <I extends IAnyGroup> IListheader<I> of(I... children)

Returns the instance with the given any group children.

Parameters:

children - The children belong to any group

See Also:

• IAnyGroup

ofImage

static <I extends IAnyGroup> IListheader<I> ofImage(String image)

Returns the instance with the given image.

Parameters:

image - The image that the column holds.

ofId

static <I extends IAnyGroup> IListheader<I> ofId(String id)

Returns the instance with the given id.

Parameters:

id - The id to identify this component