Selection managers manage selection among a series of objects. They enable standard control and shift click modifiers to aid range selection. Selection managers provide methods to manipulate, add to and clear the selection. For example:
<canvas>
<dataset name="fruits">
<fruit>Oranges</fruit>
<fruit>Apples</fruit>
<fruit>Bananas</fruit>
<fruit>Grapes</fruit>
<fruit>Kiwis</fruit>
<fruit>Papayas</fruit>
<fruit>Watermelon</fruit>
<fruit>Strawberries</fruit>
<fruit>Cherries</fruit>
</dataset>
<simplelayout/>
<text>Select a series of items below. The control and shift-click modifiers
help select ranges.</text>
<view name="fruitlist">
<selectionmanager name="selector" toggle="true"/>
<simplelayout/>
<view name="listitem" datapath="fruits:/fruit" onclick="parent.selector.select(this);">
<text name="txt" datapath="text()"/>
<method name="setSelected" args="amselected">
if (amselected) {
var txtColor = 0xFFFFFF;
var bgcolor = 0x999999;
} else {
var txtColor = 0x000000;
var bgcolor = 0xFFFFFF;
}
this.setAttribute('bgcolor', bgcolor);
this.txt.setAttribute('fgcolor', txtColor);
</method>
</view>
<method name="deleteSelected"><![CDATA[
var csel = this.selector.getSelection();
this.selector.clearSelection();
for (var i = csel.length - 1; i >= 0; i = i - 1) {
csel[i].destroy();
}
]]></method>
</view>
<button onclick="fruitlist.deleteSelected();">Delete selection</button>
</canvas>
| Name (CSS property) | Type (tag) | Type (js) | Default | Category |
|---|---|---|---|---|
sel
|
string | String | setSelected | read/write |
The name of the method to call on an object when an object's
selectedness changes. The method is called with a single Boolean
argument. The default value for this field is setSelected.
(This feature is not available for <dataselectionmanager>.)
|
||||
toggle
|
boolean | Boolean | read/write | |
Attributes inherited from <node>
classroot, cloneManager, data, datapath, defaultplacement, id, ignoreplacement, immediateparent, inited, initstage, name, nodeLevel, options, parent, placement, styleclass, subnodes, transition
Methods
-
clearSelection() -
-
getSelection() -
-
isMultiSelect() -
Determines whether the additional selection should be multi-selected or should replace the existing selection
-
isRangeSelect() -
Determines whether the additional selection should be range-selected or should replace the existing selection
-
isSelected() -
-
select() -
-
unselect() -
Methods inherited from <node>
animate, applyConstraintMethod, applyData, childOf, completeInstantiation, construct, createChildren, dataBindAttribute, destroy, determinePlacement, getOption, getUID, init, lookupSourceLocator, releaseConstraint, releaseConstraintMethod, searchImmediateSubnodes, searchSubnodes, setOption, setSelected, updateData
Events