mediawiki-skins-MinervaNeue/resources/skins.minerva.scripts/addPortletLink.js
Fomafix effd4fe133 Use eslint rule "no-var": "error" and replace all var
Change-Id: I67acf88e1b8de55054248d7cf8ca622d5772ea6f
2024-03-29 07:40:22 +00:00

112 lines
2.9 KiB
JavaScript

/**
* @param {jQuery} $item The added list item, or null if no element was added.
* @return {Object} of arrays with mandatory class names for list item elements.
*/
function getClassesForItem( $item ) {
const $parent = $item.parent();
// eslint-disable-next-line no-jquery/no-class-state
const isPageActionList = $parent.hasClass( 'page-actions-menu__list' );
// eslint-disable-next-line no-jquery/no-class-state
const isTabContainer = $parent.hasClass( 'minerva__tab-container' );
// eslint-disable-next-line no-jquery/no-class-state
const isToggleList = $parent.hasClass( 'toggle-list__list' );
if ( isToggleList ) {
return {
li: [ 'toggle-list-item' ],
span: [ 'toggle-list-item__label' ],
a: [ 'toggle-list-item__anchor' ]
};
} else if ( isPageActionList ) {
return {
li: [ 'page-actions-menu__list-item' ],
span: [],
a: [
'cdx-button',
'cdx-button--size-large',
'cdx-button--fake-button',
'cdx-button--fake-button--enabled',
'cdx-button--icon-only',
'cdx-button--weight-quiet'
]
};
} else if ( isTabContainer ) {
return {
li: [ 'minerva__tab' ],
span: [],
a: []
};
} else {
return {
li: [],
span: [],
a: []
};
}
}
/**
* Insert icon into the portlet link.
*
* @param {jQuery} $link
* @param {string|undefined} id for icon
*/
function insertIcon( $link, id ) {
const icon = document.createElement( 'span' );
let classes = 'minerva-icon';
if ( id ) {
classes += ` minerva-icon-portletlink-${ id }`;
// FIXME: Please remove when following URL returns zero results:
// https://global-search.toolforge.org/?q=mw-ui-icon-portletlink&regex=1&namespaces=&title=
classes += ` mw-ui-icon-portletlink-${ id }`;
}
icon.setAttribute( 'class', classes );
$link.prepend( icon );
}
/**
* @param {HTMLElement|null} listItem The added list item, or null if no element was added.
* @param {Object} data
*/
function hookHandler( listItem, data ) {
if ( listItem && !listItem.dataset.minervaPortlet ) {
const id = data.id;
const $item = $( listItem );
// add the corresponding classes
const classes = getClassesForItem( $item );
$item.addClass( classes.li );
const $a = $item.find( 'a' );
$a.addClass( classes.a );
$item.find( 'a > span' ).addClass( classes.span );
listItem.dataset.minervaPortlet = true;
// if the list item is not itself an icon, add the corresponding icon
// (except tabs, which do not have icons)
if ( classes.span.indexOf( 'minerva-icon' ) === -1 &&
classes.li.indexOf( 'minerva__tab' ) === -1 ) {
insertIcon( $a, id );
}
}
}
/**
* Init portlet link items added by gadgets prior to Minerva
* loading.
*/
function init() {
Array.prototype.forEach.call(
document.querySelectorAll( '.mw-list-item-js' ),
function ( item ) {
hookHandler( item, {
id: item.getAttribute( 'id' )
} );
}
);
}
module.exports = {
init: init,
hookHandler: hookHandler
};