You're reading the documentation for Wicket Stuff 11.x, the current feature line. The 10.x long-term support documentation is the default.
Components
Wicket 1.5 Tree
A copy of the tree components that were part of wicket-extensions before Wicket 6.0.0, kept for applications that still use them. The classes keep their original package, org.apache.wicket.extensions.markup.html.tree, so existing imports keep working.
For new code, use the tree components in Wicket itself: NestedTree and TableTree in wicket-extensions (org.apache.wicket.extensions.markup.html.repeater.tree).
Components
All trees take a Swing javax.swing.tree.TreeModel, either directly or as an IModel<? extends TreeModel>.
Tree: a complete tree in which each item consists of a junction link, an icon and a label.LabelTree: a simple tree that renders each node with a label.LinkTree: aLabelTreewith a link on each node, so users can select individual nodes. OverrideonNodeLinkClicked(Object node, BaseTree tree, AjaxRequestTarget target)to react to a click.BaseTree: the base for custom trees; implementnewNodeComponent(String id, IModel<Object> model).TreeTable(in thetablesubpackage): a grid with a tree, divided into columns. One of the columns has to be aPropertyTreeColumn; other columns can be, for example,PropertyRenderableColumns.TreeTableis marked deprecated in favour ofTableTree.
The trees can use three kinds of links, set with setLinkType(LinkType): LinkType.REGULAR (always refreshes the whole page, works without JavaScript), LinkType.AJAX (partial updates, needs JavaScript) and LinkType.AJAX_FALLBACK (partial updates, acts like a regular link without JavaScript).
Maven
<dependency>
<groupId>org.wicketstuff</groupId>
<artifactId>wicket15-tree</artifactId>
</dependency>
Import org.wicketstuff:wicketstuff-bom in your dependencyManagement section to manage the version.
This module used to live in its own repository, wicketstuff/wicket1.5-tree, which was last released as org.wicketstuff:wicket15-tree:9.0.0. It is now part of Wicket Stuff core, and its version follows the Wicket Stuff core version.
Example
A TreeTable showing a family tree, from the module’s tests:
FamilyTreeNode family = new FamilyTreeNode(opa);
FamilyTreeNode jannekeNode = family.addChild(janneke);
jannekeNode.addChild(pino);
TreeModel treeModel = new DefaultTreeModel(family);
IColumn[] columns = new IColumn[] {
new PropertyTreeColumn<>(new ColumnLocation(Alignment.LEFT, 100, Unit.PERCENT), "Titel", "self.name"),
new PropertyRenderableColumn<>(new ColumnLocation(Alignment.LEFT, 100, Unit.PERCENT), "Titel",
"self.name") };
add(new TreeTable("tree", treeModel, columns));
<div wicket:id="tree"></div>
Tests and example application
The tests render Tree, LabelTree, LinkTree and TreeTable, and expand, collapse and select nodes using Ajax. Run Start from src/test/java to try the TreeTable example on http://localhost:8080/.
Source: wicket15-tree