inteligr8/alfresco-ng2-components
1
0
Fork 0
mirror of https://github.com/Alfresco/alfresco-ng2-components.git synced 2025-05-12 17:04:57 +00:00
Code Issues Packages Projects Releases Wiki Activity
alfresco-ng2-components/docs/content-services/components/search-check-list.component.md
Vito 3b7f3a5762
[ACA-3506] - Filter are kept when reloaded (#5885) 
* [ADF] - saving in the url the filter values

* Fixed filter status on refresh

* Fixed filter status on refresh

* [ACA-3506] - added url filtering save

* [ACA-3506] - fixed spellcheck

* improve log

* more log

* fix scripts

* Added documentation for allowUpdateOnChange setting

* Added default value in description for docs

Co-authored-by: Vito Albano <vitoalbano@Vitos-MacBook-Pro.local>
Co-authored-by: Eugenio Romano <eugenio.romano@alfresco.com>
2020-07-20 11:39:51 +01:00

3.2 KiB
Raw Blame History

Title, Added, Status, Last reviewed
Title Added Status Last reviewed
Search check list component v2.4.0 Active 2018-06-11

Search check list component

Implements a checklist widget for the Search Filter component.

Check list widget screenshot

Basic usage

{
    "search": {
        "categories": [
            {
                "id": "checkList",
                "name": "Check List",
                "enabled": true,
                "component": {
                    "selector": "check-list",
                    "pageSize": 5,
                    "settings": {
                        "operator": "OR",
                        "allowUpdateOnChange": true,
                        "options": [
                            { "name": "Folder", "value": "TYPE:'cm:folder'" },
                            { "name": "Document", "value": "TYPE:'cm:content'" }
                        ]
                    }
                }
            }
        ]
    }
}

Settings

Name Type Description
operator string Logical operator to combine query fragments. Can be 'AND' or 'OR'.
options array Array of objects with name and value properties. Each object defines a checkbox, labelled with name, that adds the query fragment in value to the query when enabled.
allowUpdateOnChange boolean Enable/Disable the update fire event when text has been changed. By default is true.

Details

This widget displays a list of checkboxes, each of which toggles a particular query fragment in the search. See the Search filter component for full details of how to use the widgets in a search query.

In the settings, the options array, defines the checkboxes that toggle the supplied query fragments and the operator selects logical AND or OR to combine the fragments. In the example above, if the user checks both boxes then the following fragment will be added to the query:

... (TYPE:'cm:folder' OR TYPE:'cm:content') ...

The component can be set to split a long checklist into separate pages of checkboxes using the pageSize value as the number of boxes to show per page (default is 5). When there is more than one page, the widget will display "Show more" and "Show less" buttons as appropriate.

A "Clear all" button is also displayed at the bottom of the widget to clear all checked items in the list.

See also