org.zkoss.zul

Interface ListitemRenderer<T>

public interface ListitemRenderer<T>

Identifies components that can be used as "rubber stamps" to paint the cells in a Listbox.

If you need better control, your renderer can also implement ListitemRendererExt. If you need better control for generting Listgroup and Listgroupfoot, your renderer can also implement ListgroupRendererExt.

In addition, you could also implement RendererCtrl. For example, starts an transaction, and uses it to render all items for the same request.

Author:

tomyeh

See Also:

ListModel, Listbox, ListitemRendererExt, ListgroupRendererExt

Method Summary

Modifier and Type	Method and Description
void	render(Listitem item, T data, int index) Renders the data to the specified list item.

Method Detail

render

void render(Listitem item,
            T data,
            int index)
     throws Exception

Renders the data to the specified list item.

Parameters:

item - the listitem to render the result. Note: when this method is called, the listitem has no child at all, unless you don't return ListitemRendererExt.DETACH_ON_RENDER when ListitemRendererExt.getControls() is called.

You can invoke Listitem.setLabel(java.lang.String) to create Listcell implicitly, or create one or multiple Listcell explicitly.

data - that is returned from ListModel.getElementAt(int)

index - the index of the data that is currently being rendered

Throws:

Exception