mw.widgets.CategoryMultiselectWidget(configopt)

mw.widgets.CategoryMultiselectWidget

Example

mw.loader.using( 'mediawiki.widgets.CategoryMultiselectWidget', function () {
  var selector = new mw.widgets.CategoryMultiselectWidget( {
    searchTypes: [
      mw.widgets.CategoryMultiselectWidget.SearchType.OpenSearch,
      mw.widgets.CategoryMultiselectWidget.SearchType.InternalSearch
    ]
  } );

  $( document.body ).append( selector.$element );

  selector.setSearchTypes( [ mw.widgets.CategoryMultiselectWidget.SearchType.SubCategories ] );
} );

Constructor

new mw.widgets.CategoryMultiselectWidget(configopt) #

Category selector widget. Displays an OO.ui.MenuTagMultiselectWidget and autocompletes with available categories.

Parameters:

Name Type Attributes Description
config Object <optional>

Configuration options

Properties
Name Type Attributes Default Description
api mw.Api <optional>

Instance of mw.Api (or subclass thereof) to use for queries
limit number <optional>
 10

Maximum number of results to load
searchTypes Array.<mw.widgets.CategoryMultiselectWidget.SearchType> <optional>
 [mw.widgets.CategoryMultiselectWidget.SearchType.OpenSearch]

Default search API to use when searching.
Mixes In:
Source:
Category selector widget.

Extends

Properties

SearchTypestatic #

Properties:

Name Type Description
OpenSearch

Search using action=opensearch
InternalSearch

Search using action=query
Exists

Search for existing categories with the exact title
SubCategories

Search only subcategories
ParentCategories

Search only parent categories
Source:

Methods

clearInput() #

Source:

createTagItemWidget() #

Source:

findItemFromData() #

Source:

isAllowedData() #

Source:

setSearchTypes(searchTypes) #

Sets and validates the value of this.searchType.

Parameters:

Name Type Description
searchTypes Array.<mw.widgets.CategoryMultiselectWidget.SearchType>
Source:
Sets and validates the value of this.searchType.