resources/src/mediawiki.rcfilters/ui/mw.rcfilters.ui.FilterTagMultiselectWidget.js

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