Merge "Move around "ا" to after "آ" and not before"
[lhc/web/wiklou.git] / resources / src / mediawiki.rcfilters / ui / mw.rcfilters.ui.FilterTagMultiselectWidget.js
1 ( function ( mw ) {
2 /**
3 * List displaying all filter groups
4 *
5 * @class
6 * @extends OO.ui.MenuTagMultiselectWidget
7 * @mixins OO.ui.mixin.PendingElement
8 *
9 * @constructor
10 * @param {mw.rcfilters.Controller} controller Controller
11 * @param {mw.rcfilters.dm.FiltersViewModel} model View model
12 * @param {mw.rcfilters.dm.SavedQueriesModel} savedQueriesModel Saved queries model
13 * @param {Object} config Configuration object
14 * @cfg {jQuery} [$overlay] A jQuery object serving as overlay for popups
15 */
16 mw.rcfilters.ui.FilterTagMultiselectWidget = function MwRcfiltersUiFilterTagMultiselectWidget( controller, model, savedQueriesModel, config ) {
17 var rcFiltersRow,
18 title = new OO.ui.LabelWidget( {
19 label: mw.msg( 'rcfilters-activefilters' ),
20 classes: [ 'mw-rcfilters-ui-filterTagMultiselectWidget-wrapper-content-title' ]
21 } ),
22 $contentWrapper = $( '<div>' )
23 .addClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-wrapper' );
24
25 config = config || {};
26
27 this.controller = controller;
28 this.model = model;
29 this.queriesModel = savedQueriesModel;
30 this.$overlay = config.$overlay || this.$element;
31 this.matchingQuery = null;
32 this.currentView = this.model.getCurrentView();
33
34 // Parent
35 mw.rcfilters.ui.FilterTagMultiselectWidget.parent.call( this, $.extend( true, {
36 label: mw.msg( 'rcfilters-filterlist-title' ),
37 placeholder: mw.msg( 'rcfilters-empty-filter' ),
38 inputPosition: 'outline',
39 allowArbitrary: false,
40 allowDisplayInvalidTags: false,
41 allowReordering: false,
42 $overlay: this.$overlay,
43 menu: {
44 hideWhenOutOfView: false,
45 hideOnChoose: false,
46 width: 650,
47 footers: [
48 {
49 name: 'viewSelect',
50 sticky: false,
51 // View select menu, appears on default view only
52 $element: $( '<div>' )
53 .append( new mw.rcfilters.ui.ViewSwitchWidget( this.controller, this.model ).$element ),
54 views: [ 'default' ]
55 },
56 {
57 name: 'feedback',
58 // Feedback footer, appears on all views
59 $element: $( '<div>' )
60 .append(
61 new OO.ui.ButtonWidget( {
62 framed: false,
63 icon: 'feedback',
64 flags: [ 'progressive' ],
65 label: mw.msg( 'rcfilters-filterlist-feedbacklink' ),
66 href: 'https://www.mediawiki.org/wiki/Help_talk:New_filters_for_edit_review'
67 } ).$element
68 )
69 }
70 ]
71 },
72 input: {
73 icon: 'menu',
74 placeholder: mw.msg( 'rcfilters-search-placeholder' )
75 }
76 }, config ) );
77
78 this.savedQueryTitle = new OO.ui.LabelWidget( {
79 label: '',
80 classes: [ 'mw-rcfilters-ui-filterTagMultiselectWidget-wrapper-content-savedQueryTitle' ]
81 } );
82
83 this.resetButton = new OO.ui.ButtonWidget( {
84 framed: false,
85 classes: [ 'mw-rcfilters-ui-filterTagMultiselectWidget-resetButton' ]
86 } );
87
88 if ( !mw.user.isAnon() ) {
89 this.saveQueryButton = new mw.rcfilters.ui.SaveFiltersPopupButtonWidget(
90 this.controller,
91 this.queriesModel
92 );
93
94 this.saveQueryButton.$element.on( 'mousedown', function ( e ) { e.stopPropagation(); } );
95
96 this.saveQueryButton.connect( this, {
97 click: 'onSaveQueryButtonClick',
98 saveCurrent: 'setSavedQueryVisibility'
99 } );
100 this.queriesModel.connect( this, { itemUpdate: 'onSavedQueriesItemUpdate' } );
101 }
102
103 this.emptyFilterMessage = new OO.ui.LabelWidget( {
104 label: mw.msg( 'rcfilters-empty-filter' ),
105 classes: [ 'mw-rcfilters-ui-filterTagMultiselectWidget-emptyFilters' ]
106 } );
107 this.$content.append( this.emptyFilterMessage.$element );
108
109 // Events
110 this.resetButton.connect( this, { click: 'onResetButtonClick' } );
111 // Stop propagation for mousedown, so that the widget doesn't
112 // trigger the focus on the input and scrolls up when we click the reset button
113 this.resetButton.$element.on( 'mousedown', function ( e ) { e.stopPropagation(); } );
114 this.model.connect( this, {
115 initialize: 'onModelInitialize',
116 update: 'onModelUpdate',
117 itemUpdate: 'onModelItemUpdate',
118 highlightChange: 'onModelHighlightChange'
119 } );
120 this.input.connect( this, { change: 'onInputChange' } );
121
122 // The filter list and button should appear side by side regardless of how
123 // wide the button is; the button also changes its width depending
124 // on language and its state, so the safest way to present both side
125 // by side is with a table layout
126 rcFiltersRow = $( '<div>' )
127 .addClass( 'mw-rcfilters-ui-row' )
128 .append(
129 this.$content
130 .addClass( 'mw-rcfilters-ui-cell' )
131 .addClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-cell-filters' )
132 );
133
134 if ( !mw.user.isAnon() ) {
135 rcFiltersRow.append(
136 $( '<div>' )
137 .addClass( 'mw-rcfilters-ui-cell' )
138 .addClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-cell-save' )
139 .append( this.saveQueryButton.$element )
140 );
141 }
142
143 // Add a selector at the right of the input
144 this.viewsSelectWidget = new OO.ui.ButtonSelectWidget( {
145 classes: [ 'mw-rcfilters-ui-filterTagMultiselectWidget-views-select-widget' ],
146 items: [
147 new OO.ui.ButtonOptionWidget( {
148 framed: false,
149 data: '',
150 disabled: true,
151 classes: [ 'mw-rcfilters-ui-filterTagMultiselectWidget-views-select-widget-label' ],
152 label: mw.msg( 'rcfilters-view-advanced-filters-label' )
153 } ),
154 new OO.ui.ButtonOptionWidget( {
155 framed: false,
156 data: 'namespaces',
157 icon: 'article',
158 title: mw.msg( 'rcfilters-view-namespaces-tooltip' )
159 } ),
160 new OO.ui.ButtonOptionWidget( {
161 framed: false,
162 data: 'tags',
163 icon: 'tag',
164 title: mw.msg( 'rcfilters-view-tags-tooltip' )
165 } )
166 ]
167 } );
168
169 // Rearrange the UI so the select widget is at the right of the input
170 this.$element.append(
171 $( '<div>' )
172 .addClass( 'mw-rcfilters-ui-table' )
173 .append(
174 $( '<div>' )
175 .addClass( 'mw-rcfilters-ui-row' )
176 .append(
177 $( '<div>' )
178 .addClass( 'mw-rcfilters-ui-cell' )
179 .addClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-views-input' )
180 .append( this.input.$element ),
181 $( '<div>' )
182 .addClass( 'mw-rcfilters-ui-cell' )
183 .addClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-views-select' )
184 .append( this.viewsSelectWidget.$element )
185 )
186 )
187 );
188
189 // Event
190 this.viewsSelectWidget.connect( this, { choose: 'onViewsSelectWidgetChoose' } );
191
192 rcFiltersRow.append(
193 $( '<div>' )
194 .addClass( 'mw-rcfilters-ui-cell' )
195 .addClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-cell-reset' )
196 .append( this.resetButton.$element )
197 );
198
199 // Build the content
200 $contentWrapper.append(
201 title.$element,
202 this.savedQueryTitle.$element,
203 $( '<div>' )
204 .addClass( 'mw-rcfilters-ui-table' )
205 .append(
206 rcFiltersRow
207 )
208 );
209
210 // Initialize
211 this.$handle.append( $contentWrapper );
212 this.emptyFilterMessage.toggle( this.isEmpty() );
213 this.savedQueryTitle.toggle( false );
214
215 this.$element
216 .addClass( 'mw-rcfilters-ui-filterTagMultiselectWidget' );
217
218 this.reevaluateResetRestoreState();
219 };
220
221 /* Initialization */
222
223 OO.inheritClass( mw.rcfilters.ui.FilterTagMultiselectWidget, OO.ui.MenuTagMultiselectWidget );
224
225 /* Methods */
226
227 /**
228 * Respond to view select widget choose event
229 *
230 * @param {OO.ui.ButtonOptionWidget} buttonOptionWidget Chosen widget
231 */
232 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onViewsSelectWidgetChoose = function ( buttonOptionWidget ) {
233 this.controller.switchView( buttonOptionWidget.getData() );
234 this.viewsSelectWidget.selectItem( null );
235 this.focus();
236 };
237
238 /**
239 * Respond to input change event
240 *
241 * @param {string} value Value of the input
242 */
243 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onInputChange = function ( value ) {
244 var view;
245
246 value = value.trim();
247
248 view = this.model.getViewByTrigger( value.substr( 0, 1 ) );
249
250 this.controller.switchView( view );
251 };
252 /**
253 * Respond to query button click
254 */
255 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onSaveQueryButtonClick = function () {
256 this.getMenu().toggle( false );
257 };
258
259 /**
260 * Respond to save query item change. Mainly this is done to update the label in case
261 * a query item has been edited
262 *
263 * @param {mw.rcfilters.dm.SavedQueryItemModel} item Saved query item
264 */
265 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onSavedQueriesItemUpdate = function ( item ) {
266 if ( this.matchingQuery === item ) {
267 // This means we just edited the item that is currently matched
268 this.savedQueryTitle.setLabel( item.getLabel() );
269 }
270 };
271
272 /**
273 * Respond to menu toggle
274 *
275 * @param {boolean} isVisible Menu is visible
276 */
277 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onMenuToggle = function ( isVisible ) {
278 // Parent
279 mw.rcfilters.ui.FilterTagMultiselectWidget.parent.prototype.onMenuToggle.call( this );
280
281 if ( isVisible ) {
282 mw.hook( 'RcFilters.popup.open' ).fire();
283
284 if ( !this.getMenu().getSelectedItem() ) {
285 // If there are no selected items, scroll menu to top
286 // This has to be in a setTimeout so the menu has time
287 // to be positioned and fixed
288 setTimeout( function () { this.getMenu().scrollToTop(); }.bind( this ), 0 );
289 }
290 } else {
291 // Clear selection
292 this.selectTag( null );
293
294 // Clear input if the only thing in the input is the prefix
295 if (
296 this.input.getValue().trim() === this.model.getViewTrigger( this.model.getCurrentView() )
297 ) {
298 // Clear the input
299 this.input.setValue( '' );
300 }
301
302 // Log filter grouping
303 this.controller.trackFilterGroupings( 'filtermenu' );
304 }
305
306 this.input.setIcon( isVisible ? 'search' : 'menu' );
307 };
308
309 /**
310 * @inheritdoc
311 */
312 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onInputFocus = function () {
313 // Parent
314 mw.rcfilters.ui.FilterTagMultiselectWidget.parent.prototype.onInputFocus.call( this );
315
316 // Scroll to top
317 this.scrollToTop( this.$element );
318 };
319
320 /**
321 * @inheritdoc
322 */
323 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.doInputEscape = function () {
324 // Parent
325 mw.rcfilters.ui.FilterTagMultiselectWidget.parent.prototype.doInputEscape.call( this );
326
327 // Blur the input
328 this.input.$input.blur();
329 };
330
331 /**
332 * @inheritdoc
333 */
334 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onChangeTags = function () {
335 // Parent method
336 mw.rcfilters.ui.FilterTagMultiselectWidget.parent.prototype.onChangeTags.call( this );
337
338 this.emptyFilterMessage.toggle( this.isEmpty() );
339 };
340
341 /**
342 * Respond to model initialize event
343 */
344 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onModelInitialize = function () {
345 this.setSavedQueryVisibility();
346 };
347
348 /**
349 * Respond to model update event
350 */
351 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onModelUpdate = function () {
352 this.updateElementsForView();
353 };
354
355 /**
356 * Update the elements in the widget to the current view
357 */
358 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.updateElementsForView = function () {
359 var view = this.model.getCurrentView(),
360 inputValue = this.input.getValue().trim(),
361 inputView = this.model.getViewByTrigger( inputValue.substr( 0, 1 ) );
362
363 if ( inputView !== 'default' ) {
364 // We have a prefix already, remove it
365 inputValue = inputValue.substr( 1 );
366 }
367
368 if ( inputView !== view ) {
369 // Add the correct prefix
370 inputValue = this.model.getViewTrigger( view ) + inputValue;
371 }
372
373 // Update input
374 this.input.setValue( inputValue );
375
376 if ( this.currentView !== view ) {
377 this.scrollToTop( this.$element );
378 this.currentView = view;
379 }
380 };
381
382 /**
383 * Set the visibility of the saved query button
384 */
385 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.setSavedQueryVisibility = function () {
386 if ( mw.user.isAnon() ) {
387 return;
388 }
389
390 this.matchingQuery = this.controller.findQueryMatchingCurrentState();
391
392 this.savedQueryTitle.setLabel(
393 this.matchingQuery ? this.matchingQuery.getLabel() : ''
394 );
395 this.savedQueryTitle.toggle( !!this.matchingQuery );
396 this.saveQueryButton.toggle(
397 !this.isEmpty() &&
398 !this.matchingQuery
399 );
400
401 if ( this.matchingQuery ) {
402 this.emphasize();
403 }
404 };
405
406 /**
407 * Respond to model itemUpdate event
408 *
409 * @param {mw.rcfilters.dm.FilterItem} item Filter item model
410 */
411 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onModelItemUpdate = function ( item ) {
412 if ( item.getGroupModel().isHidden() ) {
413 return;
414 }
415
416 if (
417 item.isSelected() ||
418 (
419 this.model.isHighlightEnabled() &&
420 item.isHighlightSupported() &&
421 item.getHighlightColor()
422 )
423 ) {
424 this.addTag( item.getName(), item.getLabel() );
425 } else {
426 this.removeTagByData( item.getName() );
427 }
428
429 this.setSavedQueryVisibility();
430
431 // Re-evaluate reset state
432 this.reevaluateResetRestoreState();
433 };
434
435 /**
436 * @inheritdoc
437 */
438 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.isAllowedData = function ( data ) {
439 return (
440 this.model.getItemByName( data ) &&
441 !this.isDuplicateData( data )
442 );
443 };
444
445 /**
446 * @inheritdoc
447 */
448 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onMenuChoose = function ( item ) {
449 this.controller.toggleFilterSelect( item.model.getName() );
450
451 // Select the tag if it exists, or reset selection otherwise
452 this.selectTag( this.getItemFromData( item.model.getName() ) );
453
454 this.focus();
455 };
456
457 /**
458 * Respond to highlightChange event
459 *
460 * @param {boolean} isHighlightEnabled Highlight is enabled
461 */
462 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onModelHighlightChange = function ( isHighlightEnabled ) {
463 var highlightedItems = this.model.getHighlightedItems();
464
465 if ( isHighlightEnabled ) {
466 // Add capsule widgets
467 highlightedItems.forEach( function ( filterItem ) {
468 this.addTag( filterItem.getName(), filterItem.getLabel() );
469 }.bind( this ) );
470 } else {
471 // Remove capsule widgets if they're not selected
472 highlightedItems.forEach( function ( filterItem ) {
473 if ( !filterItem.isSelected() ) {
474 this.removeTagByData( filterItem.getName() );
475 }
476 }.bind( this ) );
477 }
478 };
479
480 /**
481 * @inheritdoc
482 */
483 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onTagSelect = function ( tagItem ) {
484 var widget = this,
485 menuOption = this.menu.getItemFromModel( tagItem.getModel() ),
486 oldInputValue = this.input.getValue().trim();
487
488 this.menu.setUserSelecting( true );
489
490 // Reset input
491 this.input.setValue( '' );
492
493 // Switch view
494 this.controller.switchView( tagItem.getView() );
495
496 // Parent method
497 mw.rcfilters.ui.FilterTagMultiselectWidget.parent.prototype.onTagSelect.call( this, tagItem );
498
499 this.menu.selectItem( menuOption );
500 this.selectTag( tagItem );
501
502 // Scroll to the item
503 if ( this.model.removeViewTriggers( oldInputValue ) ) {
504 // We're binding a 'once' to the itemVisibilityChange event
505 // so this happens when the menu is ready after the items
506 // are visible again, in case this is done right after the
507 // user filtered the results
508 this.getMenu().once(
509 'itemVisibilityChange',
510 function () {
511 widget.scrollToTop( menuOption.$element );
512 widget.menu.setUserSelecting( false );
513 }
514 );
515 } else {
516 this.scrollToTop( menuOption.$element );
517 this.menu.setUserSelecting( false );
518 }
519
520 };
521
522 /**
523 * Select a tag by reference. This is what OO.ui.SelectWidget is doing.
524 * If no items are given, reset selection from all.
525 *
526 * @param {mw.rcfilters.ui.FilterTagItemWidget} [item] Tag to select,
527 * omit to deselect all
528 */
529 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.selectTag = function ( item ) {
530 var i, len, selected;
531
532 for ( i = 0, len = this.items.length; i < len; i++ ) {
533 selected = this.items[ i ] === item;
534 if ( this.items[ i ].isSelected() !== selected ) {
535 this.items[ i ].toggleSelected( selected );
536 }
537 }
538 };
539 /**
540 * @inheritdoc
541 */
542 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onTagRemove = function ( tagItem ) {
543 // Parent method
544 mw.rcfilters.ui.FilterTagMultiselectWidget.parent.prototype.onTagRemove.call( this, tagItem );
545
546 this.controller.clearFilter( tagItem.getName() );
547
548 tagItem.destroy();
549 };
550
551 /**
552 * Respond to click event on the reset button
553 */
554 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.onResetButtonClick = function () {
555 if ( this.model.areCurrentFiltersEmpty() ) {
556 // Reset to default filters
557 this.controller.resetToDefaults();
558 } else {
559 // Reset to have no filters
560 this.controller.emptyFilters();
561 }
562 };
563
564 /**
565 * Reevaluate the restore state for the widget between setting to defaults and clearing all filters
566 */
567 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.reevaluateResetRestoreState = function () {
568 var defaultsAreEmpty = this.model.areDefaultFiltersEmpty(),
569 currFiltersAreEmpty = this.model.areCurrentFiltersEmpty(),
570 hideResetButton = currFiltersAreEmpty && defaultsAreEmpty;
571
572 this.resetButton.setIcon(
573 currFiltersAreEmpty ? 'history' : 'trash'
574 );
575
576 this.resetButton.setLabel(
577 currFiltersAreEmpty ? mw.msg( 'rcfilters-restore-default-filters' ) : ''
578 );
579 this.resetButton.setTitle(
580 currFiltersAreEmpty ? null : mw.msg( 'rcfilters-clear-all-filters' )
581 );
582
583 this.resetButton.toggle( !hideResetButton );
584 this.emptyFilterMessage.toggle( currFiltersAreEmpty );
585 };
586
587 /**
588 * @inheritdoc
589 */
590 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.createMenuWidget = function ( menuConfig ) {
591 return new mw.rcfilters.ui.MenuSelectWidget(
592 this.controller,
593 this.model,
594 $.extend( {
595 filterFromInput: true
596 }, menuConfig )
597 );
598 };
599
600 /**
601 * @inheritdoc
602 */
603 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.createTagItemWidget = function ( data ) {
604 var filterItem = this.model.getItemByName( data );
605
606 if ( filterItem ) {
607 return new mw.rcfilters.ui.FilterTagItemWidget(
608 this.controller,
609 filterItem,
610 {
611 $overlay: this.$overlay
612 }
613 );
614 }
615 };
616
617 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.emphasize = function () {
618 if (
619 !this.$handle.hasClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-animate' )
620 ) {
621 this.$handle
622 .addClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-emphasize' )
623 .addClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-animate' );
624
625 setTimeout( function () {
626 this.$handle
627 .removeClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-emphasize' );
628
629 setTimeout( function () {
630 this.$handle
631 .removeClass( 'mw-rcfilters-ui-filterTagMultiselectWidget-animate' );
632 }.bind( this ), 1000 );
633 }.bind( this ), 500 );
634
635 }
636 };
637 /**
638 * Scroll the element to top within its container
639 *
640 * @private
641 * @param {jQuery} $element Element to position
642 * @param {number} [marginFromTop] When scrolling the entire widget to the top, leave this
643 * much space (in pixels) above the widget.
644 */
645 mw.rcfilters.ui.FilterTagMultiselectWidget.prototype.scrollToTop = function ( $element, marginFromTop ) {
646 var container = OO.ui.Element.static.getClosestScrollableContainer( $element[ 0 ], 'y' ),
647 pos = OO.ui.Element.static.getRelativePosition( $element, $( container ) ),
648 containerScrollTop = $( container ).is( 'body, html' ) ? 0 : $( container ).scrollTop();
649
650 // Scroll to item
651 $( container ).animate( {
652 scrollTop: containerScrollTop + pos.top - ( marginFromTop || 0 )
653 } );
654 };
655 }( mediaWiki ) );