mirror of
https://gerrit.wikimedia.org/r/mediawiki/skins/Vector.git
synced 2024-11-12 09:21:11 +00:00
fca03c873b
- Update naming convention to use dropdown instead of menu Follow-up: Iac0586893fec26a8a6c2c904ce08fbf1e19b339c Change-Id: Ie51f7fc280eeef8470613c07850dad83e4435ee8
132 lines
4 KiB
JavaScript
132 lines
4 KiB
JavaScript
/** @interface CheckboxHack */
|
|
|
|
var
|
|
checkboxHack = /** @type {CheckboxHack} */ require( /** @type {string} */( 'mediawiki.page.ready' ) ).checkboxHack,
|
|
CHECKBOX_HACK_CONTAINER_SELECTOR = '.vector-menu-dropdown',
|
|
CHECKBOX_HACK_CHECKBOX_SELECTOR = '.vector-menu-checkbox',
|
|
CHECKBOX_HACK_BUTTON_SELECTOR = '.vector-menu-heading',
|
|
CHECKBOX_HACK_TARGET_SELECTOR = '.vector-menu-content';
|
|
|
|
/**
|
|
* Enhance dropdownMenu functionality and accessibility using core's checkboxHack.
|
|
*/
|
|
function bind() {
|
|
// Search for all dropdown containers using the CHECKBOX_HACK_CONTAINER_SELECTOR.
|
|
var containers = document.querySelectorAll( CHECKBOX_HACK_CONTAINER_SELECTOR );
|
|
|
|
Array.prototype.forEach.call( containers, function ( container ) {
|
|
var
|
|
checkbox = container.querySelector( CHECKBOX_HACK_CHECKBOX_SELECTOR ),
|
|
button = container.querySelector( CHECKBOX_HACK_BUTTON_SELECTOR ),
|
|
target = container.querySelector( CHECKBOX_HACK_TARGET_SELECTOR );
|
|
|
|
if ( !( checkbox && button && target ) ) {
|
|
return;
|
|
}
|
|
|
|
checkboxHack.bind( window, checkbox, button, target );
|
|
} );
|
|
}
|
|
|
|
/**
|
|
* Create an icon element to be appended inside the anchor tag.
|
|
*
|
|
* @param {HTMLElement|null} menuElement
|
|
* @param {HTMLElement|null} parentElement
|
|
* @param {string|null} id
|
|
*
|
|
* @return {HTMLElement|undefined}
|
|
*/
|
|
function createIconElement( menuElement, parentElement, id ) {
|
|
// Only the p-personal menu in the user links dropdown supports icons
|
|
var isIconCapable = menuElement &&
|
|
[ 'p-personal' ].indexOf( menuElement.getAttribute( 'id' ) || 'p-unknown' ) > -1;
|
|
|
|
if ( !isIconCapable || !parentElement ) {
|
|
return;
|
|
}
|
|
|
|
var iconElement = document.createElement( 'span' );
|
|
iconElement.classList.add( 'mw-ui-icon' );
|
|
|
|
if ( id ) {
|
|
// The following class allows gadgets developers to style or hide an icon.
|
|
// * mw-ui-icon-vector-gadget-<id>
|
|
// The class is considered stable and should not be removed without
|
|
// a #user-notice.
|
|
iconElement.classList.add( 'mw-ui-icon-vector-gadget-' + id );
|
|
}
|
|
|
|
return iconElement;
|
|
}
|
|
|
|
var /** @type {Object} */handledLinks = {};
|
|
|
|
/**
|
|
* Adds icon placeholder for gadgets to use.
|
|
*
|
|
* @typedef {Object} PortletLinkData
|
|
* @property {string|null} id
|
|
*/
|
|
/**
|
|
* @param {HTMLElement} item
|
|
* @param {PortletLinkData} data
|
|
*/
|
|
function addPortletLinkHandler( item, data ) {
|
|
var link = item.querySelector( 'a' );
|
|
var $menu = $( item ).parents( '.vector-menu' );
|
|
var menuElement = $menu.length && $menu.get( 0 ) || null;
|
|
var iconElement = createIconElement( menuElement, link, data.id );
|
|
// @ts-ignore see gerrit:836861
|
|
if ( data.id && handledLinks[ data.id ] ) {
|
|
return;
|
|
}
|
|
|
|
// The views menu has limited space so we need to decide whether there is space
|
|
// to accomodate the new item and if not to redirect to the more dropdown.
|
|
/* eslint-disable no-jquery/no-global-selector */
|
|
if ( $menu.prop( 'id' ) === 'p-views' ) {
|
|
// @ts-ignore if undefined as NaN will be ignored
|
|
var availableWidth = $( '.vector-page-toolbar-container' ).width() -
|
|
// @ts-ignore
|
|
$( '#p-namespaces' ).width() - $( '#p-variants' ).width() -
|
|
// @ts-ignore
|
|
$( '#p-views' ).width() - $( '#p-cactions' ).width();
|
|
var moreDropdown = document.querySelector( '#p-cactions ul' );
|
|
// If the screen width is less than 720px then the views menu is hidden
|
|
if ( moreDropdown && ( availableWidth < 0 || window.innerWidth < 720 ) ) {
|
|
moreDropdown.appendChild( item );
|
|
// reveal if hidden
|
|
mw.util.showPortlet( 'p-cactions' );
|
|
}
|
|
}
|
|
|
|
// Check link.prepend exists for older browser since this is ES5 code
|
|
if ( link && iconElement && link.prepend ) {
|
|
link.prepend( iconElement );
|
|
}
|
|
|
|
// Mark the link as handled.
|
|
if ( data.id ) {
|
|
// @ts-ignore see gerrit:836861
|
|
handledLinks[ data.id ] = true;
|
|
}
|
|
}
|
|
|
|
// Enhance previously added items.
|
|
Array.prototype.forEach.call(
|
|
document.querySelectorAll( '.mw-list-item-js' ),
|
|
function ( item ) {
|
|
addPortletLinkHandler( item, {
|
|
id: item.getAttribute( 'id' )
|
|
} );
|
|
}
|
|
);
|
|
|
|
mw.hook( 'util.addPortletLink' ).add( addPortletLinkHandler );
|
|
|
|
module.exports = {
|
|
dropdownMenus: function dropdownMenus() { bind(); },
|
|
addPortletLinkHandler: addPortletLinkHandler
|
|
};
|