mediawiki-skins-Vector/resources/skins.vector.es6/popupNotification.js
Moh'd Khier Abualruz 25f5f4975a Add indicator that appears when TOC & page tools menu have been hidden
Show a popup to the user to point them to the new location of the element

Bug: T311160
Change-Id: I967d027b23931d99767b31bd7a6af5f6410c8f5d
2023-03-23 21:46:51 +00:00

65 lines
1.5 KiB
JavaScript

/**
* Adds and show a popup to the user to point them to the new location of the element
*
* @param {Element} container
* @param {string} message
* @param {string[]} [classes]
* @param {number} [timeout]
* @param {boolean} [autoClose]
*/
function add( container, message, classes = [], timeout = 4000, autoClose = true ) {
/**
* @type {any}
*/
let popupWidget;
// load oojs-ui if it's not already loaded
mw.loader.using( 'oojs-ui-core' ).then( () => {
// @ts-ignore-next-line
popupWidget = new OO.ui.PopupWidget( {
$content: $( '<p>' ).text( message ),
autoClose,
padded: true,
anchor: true,
align: 'center',
position: 'below',
classes: [ 'vector-popup-notification' ].concat( classes ),
container
} );
popupWidget.$element.appendTo( container );
show( popupWidget, timeout );
} );
}
/**
* Toggle the popup widget
*
* @param {any} popupWidget popupWidget from oojs-ui
* cannot use type because it's not loaded yet
* @param {number} [timeout]
*/
function show( popupWidget, timeout = 4000 ) {
popupWidget.toggle( true );
popupWidget.toggleClipping( true );
// hide the popup after timeout ms
setTimeout( () => {
popupWidget.toggle( false );
popupWidget.$element.remove();
}, timeout );
}
/**
* Remove all popups
*
* @param {string} [selector]
*/
function removeAll( selector = '.vector-popup-notification' ) {
document.querySelectorAll( selector ).forEach( ( element ) => {
element.remove();
} );
}
module.exports = {
add,
removeAll
};