Package com.vaadin.flow.data.renderer

Class NativeButtonRenderer<SOURCE>

java.lang.Object

com.vaadin.flow.data.renderer.Renderer<SOURCE>

com.vaadin.flow.data.renderer.LitRenderer<SOURCE>

com.vaadin.flow.data.renderer.ComponentRenderer<Component,SOURCE>

com.vaadin.flow.data.renderer.BasicRenderer<SOURCE,String>

com.vaadin.flow.data.renderer.NativeButtonRenderer<SOURCE>

Type Parameters:

SOURCE - the type of the item to be received in the click listeners

All Implemented Interfaces:

ClickableRenderer<SOURCE>, Serializable

public class NativeButtonRenderer<SOURCE>
extends BasicRenderer<SOURCE,String>
implements ClickableRenderer<SOURCE>

A renderer to create a clickable button.

ClickableRenderer.ItemClickListeners are notified when the rendered buttons are either clicked or tapped (in touch devices).

Author:

Vaadin Ltd

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.vaadin.flow.data.renderer.ClickableRenderer

ClickableRenderer.ItemClickListener<SOURCE>

Constructor Summary

Constructors

Constructor	Description
NativeButtonRenderer(ValueProvider<SOURCE,String> labelProvider)	Creates a new button renderer with a dynamic label.
NativeButtonRenderer(ValueProvider<SOURCE,String> labelProvider, ClickableRenderer.ItemClickListener<SOURCE> clickListener)	Creates a new button renderer with a dynamic label and registers a ClickableRenderer.ItemClickListener to receive events.
NativeButtonRenderer(String label)	Creates a new button renderer with the specified label.
NativeButtonRenderer(String label, ClickableRenderer.ItemClickListener<SOURCE> clickListener)	Creates a new button renderer with the specified label and registers a ClickableRenderer.ItemClickListener to receive events.

Method Summary

Modifier and Type	Method	Description
Registration	addItemClickListener(ClickableRenderer.ItemClickListener<SOURCE> listener)	Adds a click listener to the renderer.
Component	createComponent(SOURCE item)	Creates a component for a given object model item.
List<ClickableRenderer.ItemClickListener<SOURCE>>	getItemClickListeners()	Gets all registered listeners.
protected String	getTemplateExpression()	Returns the Lit template expression used to render items.

Methods inherited from class com.vaadin.flow.data.renderer.BasicRenderer

getFormattedValue, getValueProvider

Methods inherited from class com.vaadin.flow.data.renderer.ComponentRenderer

render, updateComponent

Methods inherited from class com.vaadin.flow.data.renderer.LitRenderer

getValueProviders, of, withFunction, withFunction, withProperty

Methods inherited from class com.vaadin.flow.data.renderer.Renderer

render

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.vaadin.flow.data.renderer.ClickableRenderer

onClick

Constructor Details

NativeButtonRenderer

public NativeButtonRenderer(String label)

Creates a new button renderer with the specified label. The label is the same for all the items.

Item click listeners can be added via addItemClickListener(ItemClickListener).

Parameters:

label - the label of the rendered button, not null

NativeButtonRenderer

public NativeButtonRenderer(String label,
 ClickableRenderer.ItemClickListener<SOURCE> clickListener)

Creates a new button renderer with the specified label and registers a ClickableRenderer.ItemClickListener to receive events. The label is the same for all the items.

More click listeners can be added via addItemClickListener(ItemClickListener).

Parameters:

label - the label for the rendered button, not null

clickListener - a listener to receive click events

NativeButtonRenderer

public NativeButtonRenderer(ValueProvider<SOURCE,String> labelProvider)

Creates a new button renderer with a dynamic label.

Item click listeners can be added via addItemClickListener(ItemClickListener).

Parameters:

labelProvider - the provider for the labels of the rendered buttons, not null

NativeButtonRenderer

public NativeButtonRenderer(ValueProvider<SOURCE,String> labelProvider,
 ClickableRenderer.ItemClickListener<SOURCE> clickListener)

Creates a new button renderer with a dynamic label and registers a ClickableRenderer.ItemClickListener to receive events.

More click listeners can be added via addItemClickListener(ItemClickListener).

Parameters:

labelProvider - the provider for the labels of the rendered buttons, not null

clickListener - a listener to receive click events

Method Details

addItemClickListener

public Registration addItemClickListener(ClickableRenderer.ItemClickListener<SOURCE> listener)

Description copied from interface: ClickableRenderer

Adds a click listener to the renderer. Events are fired when items are clicked or tapped (for touch devices).

Specified by:

addItemClickListener in interface ClickableRenderer<SOURCE>

Parameters:

listener - the listener to receive click events, not null

Returns:

a registration that can be used to remove the listener from this renderer

getItemClickListeners

public List<ClickableRenderer.ItemClickListener<SOURCE>> getItemClickListeners()

Description copied from interface: ClickableRenderer

Gets all registered listeners.

Specified by:

getItemClickListeners in interface ClickableRenderer<SOURCE>

Returns:

an unmodifiable list of registered listeners, not null

createComponent

public Component createComponent(SOURCE item)

Description copied from class: ComponentRenderer

Creates a component for a given object model item. Subclasses can override this method to provide specific behavior.

Overrides:

createComponent in class BasicRenderer<SOURCE,String>

Parameters:

item - the model item, possibly null

Returns:

a component instance representing the provided item

getTemplateExpression

protected String getTemplateExpression()

Description copied from class: LitRenderer

Returns the Lit template expression used to render items.

Overrides:

getTemplateExpression in class BasicRenderer<SOURCE,String>

Returns:

the template expression