( function ( mw, $ ) {
/**
* Notification group item widget for echo popup.
*
* @class
* @extends mw.echo.ui.NotificationItemWidget
* @mixins OO.ui.mixin.PendingElement
* @mixins OO.ui.mixin.GroupElement
* @mixins OO.ui.mixin.GroupWidget
*
* @constructor
* @param {mw.echo.dm.NotificationGroupItem} model Item model
* @param {Object} [config] Configuration object
*/
mw.echo.ui.NotificationGroupItemWidget = function MwEchoUiNotificationGroupItemWidget( model, config ) {
config = config || {};
// Parent constructor
mw.echo.ui.NotificationGroupItemWidget.parent.call( this, model, config );
// Mixin constructor
OO.ui.mixin.GroupWidget.call( this, config );
OO.ui.mixin.PendingElement.call( this, config );
this.setPendingElement( this.$group );
this.$group
.addClass( 'mw-echo-ui-notificationGroupItemWidget-group' )
// We have to manually set the display to 'none' here because
// otherwise the 'slideUp' and 'slideDown' jQuery effects don't
// work
.css( 'display', 'none' );
this.showTitles = false;
this.expanded = false;
// Add "expand" button
this.toggleExpandButton = new OO.ui.ButtonOptionWidget( {
icon: 'expand',
framed: false,
classes: [ 'mw-echo-ui-notificationItemWidget-content-actions-button' ]
} );
this.updateExpandButton();
this.actionsButtonSelectWidget.addItems( [ this.toggleExpandButton ] );
// Events
this.toggleExpandButton.connect( this, { click: 'expand' } );
this.$content.on( 'click', this.expand.bind( this ) );
this.model.connect( this, {
add: 'onModelAddGroup',
remove: 'onModelRemoveGroup',
clear: 'onModelClearGroups'
} );
// TODO: Handle cases where the group became empty or a case where the group only has 1 item left.
// Note: Right now this code works primarily for cross-wiki notifications. These act differently
// than local bundles. Cross-wiki notifications, when they "lose" their items for being read, they
// vanish from the list. Unlike them, the plan for local bundles is that read sub-items go outside
// the bundle and become their own items in the general notificationsWidget, and when the local bundle
// has 1 notification left, the group will actually transform into that last notification item.
// We don't listen to the empty event right now, because the entire item is deleted in cross-wiki
// notifications. When we work on local bundles, we will have to add that event listener per item.
// Initialization
this.populateFromModel();
this.toggleExpanded( false );
this.$element
.addClass( 'mw-echo-ui-notificationGroupItemWidget' )
.append(
$( '
' )
.addClass( 'mw-echo-ui-notificationGroupItemWidget-separator' ),
this.$group
);
};
/* Initialization */
OO.inheritClass( mw.echo.ui.NotificationGroupItemWidget, mw.echo.ui.NotificationItemWidget );
OO.mixinClass( mw.echo.ui.NotificationGroupItemWidget, OO.ui.mixin.PendingElement );
// Need to mixin base class as well
OO.mixinClass( mw.echo.ui.NotificationGroupItemWidget, OO.ui.mixin.GroupElement );
OO.mixinClass( mw.echo.ui.NotificationGroupItemWidget, OO.ui.mixin.GroupWidget );
/* Methods */
/**
* Respond to model clearing the group
*/
mw.echo.ui.NotificationGroupItemWidget.prototype.onModelClearGroups = function () {
this.clearItems();
this.handleEmptyGroups();
};
/**
* Respond to model adding group
*
* @param {mw.echo.dm.NotificationsModel} notificationsModel Added group
* @param {number} index Position the group was added
*/
mw.echo.ui.NotificationGroupItemWidget.prototype.onModelAddGroup = function ( notificationsModel, index ) {
this.addItems(
[
new mw.echo.ui.BundledNotificationGroupWidget( notificationsModel, {
showTitle: this.showTitles,
$overlay: this.$overlay
} )
],
index
);
this.checkShowTitles();
};
/**
* Expand the notification group
*/
mw.echo.ui.NotificationGroupItemWidget.prototype.expand = function () {
var widget = this;
this.toggleExpanded( !this.expanded );
this.updateExpandButton();
if ( this.expanded ) {
// Expand
this.pushPending();
// Query all sources
this.model.fetchAllNotificationsInGroups()
.always( function () {
widget.popPending();
} );
// Log the expand action
mw.echo.logger.logInteraction(
mw.echo.Logger.static.actions.notificationBundleExpand,
mw.echo.Logger.static.context.popup,
widget.getModel().getId(),
widget.getModel().getCategory()
);
}
};
/**
* Update the expand button label
*/
mw.echo.ui.NotificationGroupItemWidget.prototype.updateExpandButton = function () {
var type = this.model.getType();
if ( $.isArray( type ) ) {
type = 'all';
}
this.toggleExpandButton.setLabel(
this.expanded ?
mw.msg( 'notification-link-text-collapse-all' ) :
// Messages that appear here are:
// notification-link-text-expand-alert-count
// notification-link-text-expand-message-count
mw.msg( 'notification-link-text-expand-' + this.model.getType() + '-count', this.model.getCount() )
);
this.toggleExpandButton.setIcon(
this.expanded ?
'collapse' :
'expand'
);
};
/**
* Populate the items from the model
*/
mw.echo.ui.NotificationGroupItemWidget.prototype.populateFromModel = function () {
var i,
items = this.model.getItems(),
widgets = [];
for ( i = 0; i < items.length; i++ ) {
widgets.push(
new mw.echo.ui.BundledNotificationGroupWidget( items[ i ], {
showTitle: this.showTitles,
$overlay: this.$overlay
} )
);
}
this.addItems( widgets );
this.checkShowTitles();
};
/**
* Respond to model removing a group
*
* @param {mw.echo.dm.NotificationsModel} notificationsModel Removed group
*/
mw.echo.ui.NotificationGroupItemWidget.prototype.onModelRemoveGroup = function ( notificationsModel ) {
var widget = this.getItemFromData( notificationsModel.getId() );
if ( widget ) {
this.removeItems( [ widget ] );
}
};
/**
* Toggle the expand/collapsed state of this group widget
*
* @param {boolean} show Show the widget expanded
*/
mw.echo.ui.NotificationGroupItemWidget.prototype.toggleExpanded = function ( show ) {
this.expanded = show !== undefined ? !!show : !this.expanded;
if ( show ) {
this.$group.slideDown();
} else {
this.$group.slideUp();
}
};
/**
* Check whether the titles should be shown and toggle them in the items.
*/
mw.echo.ui.NotificationGroupItemWidget.prototype.checkShowTitles = function () {
var i,
items = this.getItems(),
numItems = items.length,
showTitles = numItems > 1;
if ( this.showTitles !== showTitles ) {
this.showTitles = showTitles;
for ( i = 0; i < numItems; i++ ) {
items[ i ].toggleTitle( showTitles );
}
}
};
} )( mediaWiki, jQuery );