Class S3HierarchyWidget

Constructor

Parameters:

• lookup - name of the lookup table (must have a hierarchy configured)
• represent - alternative representation method (falls back to the field's represent-method)
• multiple - allow selection of multiple options
• leafonly - True = only leaf nodes can be selected (with multiple=True: selection of a parent node will automatically select all leaf nodes of that branch) False = any nodes can be selected independently
• cascade - automatic selection of children when selecting a parent node (if leafonly=False, otherwise this is the standard behavior!), requires multiple=True
• bulk_select - provide option to select/deselect all nodes
• filter - filter query for the lookup table
• columns - set the columns width class for Foundation forms
• none - label for an option that delivers "None" as value (useful for HierarchyFilters with explicit none-selection)

Widget renderer

Parameters:

• field - the Field
• value - the current value(s)
• attr - additional HTML attributes for the widget

Value parser for the hidden input field of the widget

Parameters:

• value - the value received from the client, JSON string

Returns:

a list (if multiple=True) or the value