1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
/*!
* JavaScript for Special:Preferences: section navigation.
*/
( function () {
let switchingNoHash;
const session = require( 'mediawiki.storage' ).session;
/**
* @ignore
*/
module.exports = {
switchingNoHash: switchingNoHash,
/**
* Make sure the accessibility tip is focussable so that keyboard users take notice,
* but hide it by default to reduce visual clutter.
* Make sure it becomes visible when focused.
*
* @ignore
* @param {string} hintMsg the layout-specific navigation hint message
* @return {jQuery}
*/
insertHints: function ( hintMsg ) {
return $( '<div>' ).addClass( 'mw-navigation-hint' )
.text( hintMsg )
.attr( {
tabIndex: 0
} )
.insertBefore( '.mw-htmlform-ooui-wrapper' );
},
/**
* Call layout-specific function for jumping to the correct section and manage hash state.
*
* @ignore
* @param {Function} setSection callback for opening the section
* @param {string} sectionName The name of a section
* @param {string} [fieldset] A fieldset containing a subsection
* @param {boolean} [noHash] A hash will be set according to the current
* open section. Use this flag to suppress this.
*/
switchPrefSection: function ( setSection, sectionName, fieldset, noHash ) {
if ( noHash ) {
this.switchingNoHash = true;
}
setSection( sectionName, fieldset );
if ( noHash ) {
this.switchingNoHash = false;
}
},
/**
* Determine the correct section indicated by the hash.
* This function is called onload and onhashchange.
*
* @ignore
* @param {Function} setSection callback for opening the section
*/
detectHash: function ( setSection ) {
const hash = location.hash;
if ( /^#mw-prefsection-[\w]+$/.test( hash ) ) {
session.remove( 'mwpreferences-prevTab' );
// Open proper section.
this.switchPrefSection( setSection, hash.slice( 1 ) );
} else if ( /^#mw-[\w-]+$/.test( hash ) ) {
const subsection = document.getElementById( hash.slice( 1 ) );
const $section = $( subsection ).closest( '.mw-prefs-section-fieldset' );
if ( $section.length ) {
session.remove( 'mwpreferences-prevTab' );
// Open proper section and scroll to selected fieldset.
this.switchPrefSection( setSection, $section.attr( 'id' ), subsection, true );
}
}
},
/**
* Determine if there is a valid hash or default section.
*
* @ignore
* @param {Function} setSection callback for opening the section
* @param {string} defaultSectionName The name of a section to load by default
*/
onHashChange: function ( setSection, defaultSectionName ) {
const hash = location.hash;
if ( /^#mw-[\w-]+/.test( hash ) ) {
this.detectHash( setSection );
} else if ( hash === '' && defaultSectionName ) {
this.switchPrefSection( setSection, defaultSectionName, undefined, true );
}
},
/**
* Trigger onHashChange onload to select the proper tab on startup.
*
* @ignore
* @param {Function} setSection callback for opening the section
* @param {string} defaultSection The name of a section to load by default
*/
onLoad: function ( setSection, defaultSection ) {
$( window ).on( 'hashchange', this.onHashChange.bind( this, setSection, defaultSection )
).trigger( 'hashchange' );
},
/**
* Restore the active tab after saving the preferences
*
* @ignore
* @param {Function} setSection callback for opening the section
* @param {Function} onSubmit callback for saving the active section name
*/
restorePrevSection: function ( setSection, onSubmit ) {
const sectionName = session.get( 'mwpreferences-prevTab' );
if ( sectionName ) {
this.switchPrefSection( setSection, sectionName, undefined, true );
// Deleting the key, the section states should be reset until we press Save
session.remove( 'mwpreferences-prevTab' );
}
$( '#mw-prefs-form' ).on( 'submit', onSubmit );
}
};
}() );
|
