Listendarstellungen mit ListView

ListView I

Ein ListView repliziert seine Inhalte anhand einer Liste von Modell-Objekten. Die Komponenten werden dabei in populateItem angelegt und dem übergebenem item hinzugefügt:

List<String> someList = Arrays.asList("first item", "second item", "third item");
add(new ListView<String>("list", someList) {

    @Override
    protected void populateItem(ListItem<String> item) {
        String text = item.getModelObject();
        // Achtung: item.add(...)!
        item.add(new Label("text", text));
    }

});

ListView II

Markup:

<ul>
    <li wicket:id="list">
        <span wicket:id="text">Text</span>
    </li>
</ul>

Ergebnis:

<ul>
    <li><span>first item</span></li>
    <li><span>second item</span></li>
    <li><span>third item</span></li>
</ul>

wicket:container

Falls der zu wiederholende Teil im Markup aus mehreren Tags besteht (z.B. mehrere Tabellenzeilen pro Listenobjekt), kann <wicket:container> verwendet werden:

<table>
    <wicket:container wicket:id="list">
        <tr>
            <td>Name:</td>
        </tr>
        <tr>
            <td><span wicket:id="name">some name</span></td>
        </tr>
    </wicket:container>
</table>

wicket:remove

Mittels <wicket:remove> kann im Markup HTML zu Testzwecken (Vorschau der statischen HTML-Seite im Browser) eingefügt werden.

Inhalte innerhalb eines <wicket:remove>-Blocks werden von Wicket entfernt, z.B.:

<ul>
    <li wicket:id="list">
        <span wicket:id="text">first</span>
    </li>
    <wicket:remove>
        <li>second item</li>
        <li>third item</li>
    </wicket:remove>
</ul>

Mehrseitige Listen

Mit PageableListView und PagingNavigator können mehrseitige Listen erzeugt werden:

PageableListView<Car> carList = new PageableListView<Car>("carList", carList, 5) {
    @Override
    protected void populateItem(ListItem<Car> item) {
        // populate items here
    }
};

add(carList);
add(new PagingNavigator("carNavigator", carList));

PagingNavigator erzeugt eine seitenweise Navigation:

RepeatingView

RepeatingView ist eine einfachere Listenkomponente, die das Markup für jede Unterkomponente wiederholt:

RepeatingView view = new RepeatingView("repeater");
view.add(new Label("1", "first item"));
view.add(new Label("2", "second item"));
view.add(new Label("3", "third item"));

Markup:

<ul><li wicket:id="repeater"></li></ul>

Ergebnis:

<ul><li>first item</li><li>second item</li><li>third item</li></ul>

Anzeige von Datenbanktabellen

Ein ListView benötigt immer eine vollständig geladene Liste aller Objekte.
Mit DataView und IDataProvider können Datenbankinhalte insb. bei seitenweiser Darstellung per SQL LIMIT bei Bedarf nachgeladen werden.