/*!
* JavaScript for Special:Preferences: Tab navigation.
*/
( function ( mw, $ ) {
$( function () {
var $preftoc, $preferences, $fieldsets, labelFunc, previousTab;
labelFunc = function () {
return this.id.replace( /^mw-prefsection/g, 'preftab' );
};
$preftoc = $( '#preftoc' );
$preferences = $( '#preferences' );
$fieldsets = $preferences.children( 'fieldset' )
.attr( {
role: 'tabpanel',
'aria-labelledby': labelFunc
} );
$fieldsets.not( '#mw-prefsection-personal' )
.hide()
.attr( 'aria-hidden', 'true' );
// T115692: The following is kept for backwards compatibility with older skins
$preferences.addClass( 'jsprefs' );
$fieldsets.addClass( 'prefsection' );
$fieldsets.children( 'legend' ).addClass( 'mainLegend' );
// Make sure the accessibility tip is selectable so that screen reader users take notice,
// but hide it per default to reduce interface clutter. Also make sure it becomes visible
// when selected. Similar to jquery.mw-jump
$( '
' ).addClass( 'mw-navigation-hint' )
.text( mw.msg( 'prefs-tabs-navigation-hint' ) )
.attr( 'tabIndex', 0 )
.on( 'focus blur', function ( e ) {
if ( e.type === 'blur' || e.type === 'focusout' ) {
$( this ).css( 'height', '0' );
} else {
$( this ).css( 'height', 'auto' );
}
} ).insertBefore( $preftoc );
/**
* It uses document.getElementById for security reasons (HTML injections in $()).
*
* @ignore
* @param {string} name the name of a tab without the prefix ("mw-prefsection-")
* @param {string} [mode] A hash will be set according to the current
* open section. Set mode 'noHash' to surpress this.
*/
function switchPrefTab( name, mode ) {
var $tab, scrollTop;
// Handle hash manually to prevent jumping,
// therefore save and restore scrollTop to prevent jumping.
scrollTop = $( window ).scrollTop();
if ( mode !== 'noHash' ) {
location.hash = '#mw-prefsection-' + name;
}
$( window ).scrollTop( scrollTop );
$preftoc.find( 'li' ).removeClass( 'selected' )
.find( 'a' ).attr( {
tabIndex: -1,
'aria-selected': 'false'
} );
$tab = $( document.getElementById( 'preftab-' + name ) );
if ( $tab.length ) {
$tab.attr( {
tabIndex: 0,
'aria-selected': 'true'
} ).focus()
.parent().addClass( 'selected' );
$preferences.children( 'fieldset' ).hide().attr( 'aria-hidden', 'true' );
$( document.getElementById( 'mw-prefsection-' + name ) ).show().attr( 'aria-hidden', 'false' );
}
}
// Enable keyboard users to use left and right keys to switch tabs
$preftoc.on( 'keydown', function ( event ) {
var keyLeft = 37,
keyRight = 39,
$el;
if ( event.keyCode === keyLeft ) {
$el = $( '#preftoc li.selected' ).prev().find( 'a' );
} else if ( event.keyCode === keyRight ) {
$el = $( '#preftoc li.selected' ).next().find( 'a' );
} else {
return;
}
if ( $el.length > 0 ) {
switchPrefTab( $el.attr( 'href' ).replace( '#mw-prefsection-', '' ) );
}
} );
// Jump to correct section as indicated by the hash.
// This function is called onload and onhashchange.
function detectHash() {
var hash = location.hash,
matchedElement, parentSection;
if ( hash.match( /^#mw-prefsection-[\w]+$/ ) ) {
mw.storage.session.remove( 'mwpreferences-prevTab' );
switchPrefTab( hash.replace( '#mw-prefsection-', '' ) );
} else if ( hash.match( /^#mw-[\w-]+$/ ) ) {
matchedElement = document.getElementById( hash.slice( 1 ) );
parentSection = $( matchedElement ).parent().closest( '[id^="mw-prefsection-"]' );
if ( parentSection.length ) {
mw.storage.session.remove( 'mwpreferences-prevTab' );
// Switch to proper tab and scroll to selected item.
switchPrefTab( parentSection.attr( 'id' ).replace( 'mw-prefsection-', '' ), 'noHash' );
matchedElement.scrollIntoView();
}
}
}
// In browsers that support the onhashchange event we will not bind click
// handlers and instead let the browser do the default behavior (clicking the
//
will naturally set the hash, handled by onhashchange.
// But other things that change the hash will also be caught (e.g. using
// the Back and Forward browser navigation).
// Note the special check for IE "compatibility" mode.
if ( 'onhashchange' in window &&
( document.documentMode === undefined || document.documentMode >= 8 )
) {
$( window ).on( 'hashchange', function () {
var hash = location.hash;
if ( hash.match( /^#mw-[\w-]+/ ) ) {
detectHash();
} else if ( hash === '' ) {
switchPrefTab( 'personal', 'noHash' );
}
} )
// Run the function immediately to select the proper tab on startup.
.trigger( 'hashchange' );
// In older browsers we'll bind a click handler as fallback.
// We must not have onhashchange *and* the click handlers, otherwise
// the click handler calls switchPrefTab() which sets the hash value,
// which triggers onhashchange and calls switchPrefTab() again.
} else {
$preftoc.on( 'click', 'li a', function ( e ) {
switchPrefTab( $( this ).attr( 'href' ).replace( '#mw-prefsection-', '' ) );
e.preventDefault();
} );
// If we've reloaded the page or followed an open-in-new-window,
// make the selected tab visible.
detectHash();
}
// Restore the active tab after saving the preferences
previousTab = mw.storage.session.get( 'mwpreferences-prevTab' );
if ( previousTab ) {
switchPrefTab( previousTab, 'noHash' );
// Deleting the key, the tab states should be reset until we press Save
mw.storage.session.remove( 'mwpreferences-prevTab' );
}
$( '#mw-prefs-form' ).on( 'submit', function () {
var value = $( $preftoc ).find( 'li.selected a' ).attr( 'id' ).replace( 'preftab-', '' );
mw.storage.session.set( 'mwpreferences-prevTab', value );
} );
} );
}( mediaWiki, jQuery ) );