mediawiki-extensions-Cite/modules/ext.cite.a11y.js
Adam Wight ba137fba88 Clean up top-level docs
* Include the README in generated JS docs.
* Tweak stray top-level files to explain their role.  Note that the
wmf template forces these files to appear on the docs home page...

Bug: T358641
Change-Id: If421414340903991f50a06a76551bd7cd2904c5e
2024-03-12 12:23:18 +01:00

34 lines
1.1 KiB
JavaScript

'use strict';
/**
* @file Adds accessibility attributes to citation links.
* @see https://phabricator.wikimedia.org/T40141
* @author Marius Hoch <hoo@online.de>
*/
mw.hook( 'wikipage.content' ).add( function ( $content ) {
const accessibilityLabelOne = mw.msg( 'cite_references_link_accessibility_label' );
const accessibilityLabelMany = mw.msg( 'cite_references_link_many_accessibility_label' );
$content.find( '.mw-cite-backlink' ).each( function () {
const $links = $( this ).find( 'a' );
if ( $links.length > 1 ) {
// This citation is used multiple times. Let's only set the accessibility
// label on the first link, the following ones should then be
// self-explaining. This is needed to make sure this isn't getting too
// wordy.
$links.eq( 0 ).prepend(
$( '<span>' )
.addClass( 'cite-accessibility-label' )
// Also make sure we have at least one space between the accessibility
// label and the visual one
.text( accessibilityLabelMany + ' ' )
);
} else {
$links
.attr( 'aria-label', accessibilityLabelOne )
.attr( 'title', accessibilityLabelOne );
}
} );
} );