mixitup.Config

The MixItUp configuration object is extended with properties relating to the MultiFilter extension.

For the full list of configuration options, please refer to the MixItUp core documentation.

mixitup.Config.multifilter

A group of properties defining the behavior of your multifilter UI.

enable
Type Default
boolean false

A boolean dictating whether or not to enable multifilter functionality.

If true, MixItUp will query the DOM for any elements with a data-filter-group attribute present on instantiation.

logicWithinGroup
Type Default
string 'or'

A string dictating the logic to use when concatenating selectors within individual filter groups.

If set to 'or' (default), targets will be shown if they match any active filter in the group.

If set to 'and', targets will be shown only if they match all active filters in the group.

logicBetweenGroups
Type Default
string 'and'

A string dictating the logic to use when concatenating each group’s selectors into one single selector.

If set to 'and' (default), targets will be shown only if they match the combined active selectors of all groups.

If set to 'or', targets will be shown if they match the active selectors of any individual group.

minSearchLength
Type Default
number 3

An integer dictating the minimum number of characters at which the value of a text input will be included as a multifilter. This prevents short or incomplete words with many potential matches from triggering filter operations.

parseOn
Type Default
string 'change'

A string dictating when the parsing of filter groups should occur.

If set to 'change' (default), the mixer will be filtered whenever the filtering UI is interacted with. The mode provides real-time filtering with instant feedback.

If set to 'submit', the mixer will only be filtered when a submit button is clicked (if using a <form> element as a parent). This enables the user to firstly make their selection, and then trigger filtering once they have finished making their selection.

Alternatively, the mixer.parseFilterGroups() method can be called via the API at any time to trigger the parsing of filter groups and filter the mixer.

keyupThrottleDuration
Type Default
number 350

An integer dictating the duration in ms that must elapse between keyup events in order to trigger a change.

Setting a comfortable delay of ~350ms prevents the mixer from being thrashed while typing occurs.