Tabbox Renderer

Here we describe how to implement a custom renderer for a tabbox (org.zkoss.zul.TabboxRenderer). For the concepts about component, model and renderer, please refer to the Model-driven Display section.

When a tabbox (org.zkoss.zul.Tabbox) is assigned with a model, a default renderer is assigned too. The default renderer will assume that each tab has only one tabpanel, and it converts the data into a string directly¹. If you want to display a rich tabpanel or retrieve a particular field of the data, you have to implement org.zkoss.zul.TabboxRenderer to handle the rendering.

For example,

public class MyRenderer implements TabboxRenderer{
    public void renderTab(Tab tab, Object data, int index) {
        tab.setLabel("New -- " + data);
    }
    public void renderTabpanel(Tabpanel tabpanel, Object data, int index) {
        tabpanel.appendChild(new Label("New -- " + data));
    }
}

---

1. If the tabbox is assigned a template called model:tab and model:tabpanel, then the template will be used to render the tabbox. For more information, please refer to the Tabbox Template section. ↩