Expand all

mw.echo.ui.BundleNotificationItemWidget

Extends

Constructor

new mw.echo.ui.BundleNotificationItemWidget(controller, model, [config]) #

Bundle notification item widget. This widget is expandable and displays inner notifications that constitute the bundle.

Parameters:

Name Type Attributes Description
controller mw.echo.Controller

Echo notifications controller
model mw.echo.dm.BundleNotificationItem

Notification group model
config Object optional

Configuration object
Source:
Bundle notification item widget.

Methods

destroy() #

Disconnect events when widget is destroyed.

Inherited from:
Source:
Disconnect events when widget is destroyed.

expand() #

Expand the group and fetch the list of notifications. Only fetch the first time we expand.

Source:
Expand the group and fetch the list of notifications.

getId() → {number} #

Get the notification Id

Inherited from:
Source:

Returns:

Notification id

Type
number
Get the notification Id

getList() → {mw.echo.ui.SortedListWidget} #

Get the list widget contained in this item

Source:

Returns:

List widget

Type
mw.echo.ui.SortedListWidget
Get the list widget contained in this item

getModel() → {mw.echo.dm.NotificationItem} #

Get the model associated with this widget.

Inherited from:
Source:

Returns:

Item model

Type
mw.echo.dm.NotificationItem
Get the model associated with this widget.

getPrimaryUrl() → {string} #

Get the notification link

Inherited from:
Source:

Returns:

Notification link

Type
string
Get the notification link

getTimestamp() → {number} #

Get the item id

Inherited from:
Source:

Returns:

Notification id

Type
number
Get the item id

isFake() → {boolean} #

Declares whether this widget is a cloned fake.

Inherited from:
Source:

Returns:

false

Type
boolean
Declares whether this widget is a cloned fake.

isForeign() → {boolean} #

Check whether this item is foreign.

Inherited from:
Source:

Returns:

Item is foreign

Type
boolean
Check whether this item is foreign.

isRead() → {boolean} #

Check whether this item is read.

Inherited from:
Source:

Returns:

Item is read

Type
boolean
Check whether this item is read.

isSeen() → {boolean} #

Check whether this item is seen.

Inherited from:
Source:

Returns:

Item is seen

Type
boolean
Check whether this item is seen.

markRead([isRead]) #

Mark this notification as read

Parameters:

Name Type Attributes Default Description
isRead boolean optional
 true

Notification is marked as read
Overrides:
Source:
Mark this notification as read

onMarkAsReadButtonClick() #

Respond to mark as read button click

Inherited from:
Source:
Respond to mark as read button click

onPopupButtonWidgetChoose(item) #

Manage a click on a dynamic secondary link. We can't know what the link intends us to do in the API, so we trust the 'apiParams' to tell the controller. When the link is clicked, we will pass the information on to the controller, which will manage whatever promise and action is needed.

NOTE: The messages are parsed as HTML. If user-input is expected please make sure to properly escape it.

Parameters:

Name Type Description
item OO.ui.ButtonOptionWidget

The selected item
Inherited from:
Source:
Manage a click on a dynamic secondary link.

onPrimaryLinkClick() → {boolean} #

Respond to primary link click. Override this in the descendents.

Inherited from:
Source:

Returns:

true

Type
boolean
Respond to primary link click.

populateFromModel() #

Populate the items in this widget according to the data in the model

Source:

Populate the items in this widget according to the data in the model

resetInitiallyUnseen() #

Remove the 'initiallyUnseen' class, which was only used for the unseen animation when the user has first seen it.

Inherited from:
Source:

Remove the 'initiallyUnseen' class, which was only used for the unseen animation when the user has first seen it.

toggleExpanded(show) #

Toggle the expand/collapsed state of this group widget

Parameters:

Name Type Description
show boolean

Show the widget expanded
Source:
Toggle the expand/collapsed state of this group widget

toggleListDisplay(showList) #

Toggle the visibility of the notification item list and the placeholder/error widget.

Parameters:

Name Type Description
showList boolean

Show the list
Source:
Toggle the visibility of the notification item list and the placeholder/error widget.

toggleMarkAsReadButtons([showMarkAsRead]) #

Toggle the function of the 'mark as read' buttons from 'mark as read' to 'mark as unread' and vice versa.

Parameters:

Name Type Attributes Description
showMarkAsRead boolean optional

Show the 'mark as read' buttons

  • "false" means that the item is marked as read, whereby we show the user 'mark unread' buttons.
  • "true" means that the item is marked as unread and we show the user 'mark as read' buttons
Inherited from:
Source:

Toggle the function of the 'mark as read' buttons from 'mark as read' to 'mark as unread' and vice versa.

toggleRead([read]) #

Toggle the read state of the widget

Parameters:

Name Type Attributes Description
read boolean optional

The current read state. If not given, the state will become the opposite of its current state.
Inherited from:
Source:
Toggle the read state of the widget

toggleSeen([seen]) #

Toggle the seen state of the widget

Parameters:

Name Type Attributes Description
seen boolean optional

The current seen state. If not given, the state will become the opposite of its current state.
Inherited from:
Source:
Toggle the seen state of the widget

updateDataFromModel() #

Update item state when the item model changes.

Source:

Fires:

Update item state when the item model changes.

updateExpandButton() #

Update the expand button label

Source:
Update the expand button label