ZK Configuration Reference/zk.xml/The Library Properties/org.zkoss.zul.listbox.checkmarkDeselectOthers

Property:

org.zkoss.zul.listbox.checkmarkDeselectOthers

Applicable:
 globally in zk.xml via <library-property>
 nested in a zul file via <custom-attributes>

Default: false
[Since 5.0.5]

If a Listbox's checkmark (Listbox.isCheckmark()) is enabled, the selection will be toggled when an user clicks an item. In other words, all other items will remain the same.

If you prefer to deselect all other items and select the item being clicked (which the behavior of ZK 5.0.4 and earlier), you can specify true to this library property. For the multiple-selection mode, you can still press *ctrl* with clicking to select multiple items.

Version History

Version	Date	Content
8.5.2	2018	org.zkoss.zul.listbox.checkmarkDeselectOthers and org.zkoss.zul.tree.checkmarkDeselectOthers can now be used as custom attribute to set behaviors on individual tree or listbox components. Previously: only set globally.
5.0.5	September 2010	org.zkoss.zul.listbox.checkmarkDeselectOthers and org.zkoss.zul.tree.checkmarkDeselectOthers are introduced to control how to select items when an item is clicked on a tree or a listbox with checkmark.