2 * MediaWiki Widgets - TitleWidget class.
4 * @copyright 2011-2015 MediaWiki Widgets Team and others; see AUTHORS.txt
5 * @license The MIT License (MIT); see LICENSE.txt
10 * Mixin for title widgets
16 * @param {Object} [config] Configuration options
17 * @cfg {number} [limit=10] Number of results to show
18 * @cfg {number} [namespace] Namespace to prepend to queries
19 * @cfg {number} [maxLength=255] Maximum query length
20 * @cfg {boolean} [relative=true] If a namespace is set, display titles relative to it
21 * @cfg {boolean} [suggestions=true] Display search suggestions
22 * @cfg {boolean} [showRedirectTargets=true] Show the targets of redirects
23 * @cfg {boolean} [showImages] Show page images
24 * @cfg {boolean} [showDescriptions] Show page descriptions
25 * @cfg {boolean} [excludeCurrentPage] Exclude the current page from suggestions
26 * @cfg {boolean} [validateTitle=true] Whether the input must be a valid title (if set to true,
27 * the widget will marks itself red for invalid inputs, including an empty query).
28 * @cfg {Object} [cache] Result cache which implements a 'set' method, taking keyed values as an argument
29 * @cfg {mw.Api} [api] API object to use, creates a default mw.Api instance if not specified
31 mw
.widgets
.TitleWidget
= function MwWidgetsTitleWidget( config
) {
32 // Config initialization
39 this.limit
= config
.limit
;
40 this.maxLength
= config
.maxLength
;
41 this.namespace = config
.namespace !== undefined ? config
.namespace : null;
42 this.relative
= config
.relative
!== undefined ? config
.relative
: true;
43 this.suggestions
= config
.suggestions
!== undefined ? config
.suggestions
: true;
44 this.showRedirectTargets
= config
.showRedirectTargets
!== false;
45 this.showImages
= !!config
.showImages
;
46 this.showDescriptions
= !!config
.showDescriptions
;
47 this.excludeCurrentPage
= !!config
.excludeCurrentPage
;
48 this.validateTitle
= config
.validateTitle
!== undefined ? config
.validateTitle
: true;
49 this.cache
= config
.cache
;
50 this.api
= config
.api
|| new mw
.Api();
53 this.$element
.addClass( 'mw-widget-titleWidget' );
58 OO
.initClass( mw
.widgets
.TitleWidget
);
60 /* Static properties */
62 mw
.widgets
.TitleWidget
.static.interwikiPrefixesPromiseCache
= {};
67 * Get the current value of the search query
70 * @return {string} Search query
72 mw
.widgets
.TitleWidget
.prototype.getQueryValue
= null;
75 * Get the namespace to prepend to titles in suggestions, if any.
77 * @return {number|null} Namespace number
79 mw
.widgets
.TitleWidget
.prototype.getNamespace = function () {
80 return this.namespace;
84 * Set the namespace to prepend to titles in suggestions, if any.
86 * @param {number|null} namespace Namespace number
88 mw
.widgets
.TitleWidget
.prototype.setNamespace = function ( namespace ) {
89 this.namespace = namespace;
92 mw
.widgets
.TitleWidget
.prototype.getInterwikiPrefixesPromise = function () {
93 var api
= this.getApi(),
94 cache
= this.constructor.static.interwikiPrefixesPromiseCache
,
95 key
= api
.defaults
.ajax
.url
;
96 if ( !cache
.hasOwnProperty( key
) ) {
97 cache
[ key
] = api
.get( {
100 siprop
: 'interwikimap'
101 } ).then( function ( data
) {
102 return $.map( data
.query
.interwikimap
, function ( interwiki
) {
103 return interwiki
.prefix
;
111 * Get a promise which resolves with an API repsonse for suggested
112 * links for the current query.
114 * @return {jQuery.Promise} Suggestions promise
116 mw
.widgets
.TitleWidget
.prototype.getSuggestionsPromise = function () {
119 query
= this.getQueryValue(),
121 promiseAbortObject
= { abort: function () {
122 // Do nothing. This is just so OOUI doesn't break due to abort being undefined.
125 if ( mw
.Title
.newFromText( query
) ) {
126 return this.getInterwikiPrefixesPromise().then( function ( interwikiPrefixes
) {
128 interwiki
= query
.substring( 0, query
.indexOf( ':' ) );
130 interwiki
&& interwiki
!== '' &&
131 interwikiPrefixes
.indexOf( interwiki
) !== -1
133 return $.Deferred().resolve( { query
: {
137 } } ).promise( promiseAbortObject
);
141 prop
: [ 'info', 'pageprops' ],
142 generator
: 'prefixsearch',
144 gpsnamespace
: widget
.namespace !== null ? widget
.namespace : undefined,
145 gpslimit
: widget
.limit
,
146 ppprop
: 'disambiguation'
148 if ( widget
.showRedirectTargets
) {
149 params
.redirects
= true;
151 if ( widget
.showImages
) {
152 params
.prop
.push( 'pageimages' );
153 params
.pithumbsize
= 80;
154 params
.pilimit
= widget
.limit
;
156 if ( widget
.showDescriptions
) {
157 params
.prop
.push( 'pageterms' );
158 params
.wbptterms
= 'description';
160 req
= api
.get( params
);
161 promiseAbortObject
.abort
= req
.abort
.bind( req
); // TODO ew
162 return req
.then( function ( ret
) {
163 if ( ret
.query
=== undefined ) {
164 ret
= api
.get( { action
: 'query', titles
: query
} );
165 promiseAbortObject
.abort
= ret
.abort
.bind( ret
);
170 } ).promise( promiseAbortObject
);
172 // Don't send invalid titles to the API.
173 // Just pretend it returned nothing so we can show the 'invalid title' section
174 return $.Deferred().resolve( {} ).promise( promiseAbortObject
);
179 * Get the API object for title requests
181 * @return {mw.Api} MediaWiki API
183 mw
.widgets
.TitleWidget
.prototype.getApi = function () {
188 * Get option widgets from the server response
190 * @param {Object} data Query result
191 * @return {OO.ui.OptionWidget[]} Menu items
193 mw
.widgets
.TitleWidget
.prototype.getOptionsFromData = function ( data
) {
194 var i
, len
, index
, pageExists
, pageExistsExact
, suggestionPage
, page
, redirect
, redirects
,
195 currentPageName
= new mw
.Title( mw
.config
.get( 'wgRelevantPageName' ) ).getPrefixedText(),
198 titleObj
= mw
.Title
.newFromText( this.getQueryValue() ),
202 if ( data
.redirects
) {
203 for ( i
= 0, len
= data
.redirects
.length
; i
< len
; i
++ ) {
204 redirect
= data
.redirects
[ i
];
205 redirectsTo
[ redirect
.to
] = redirectsTo
[ redirect
.to
] || [];
206 redirectsTo
[ redirect
.to
].push( redirect
.from );
210 for ( index
in data
.pages
) {
211 suggestionPage
= data
.pages
[ index
];
212 // When excludeCurrentPage is set, don't list the current page unless the user has type the full title
213 if ( this.excludeCurrentPage
&& suggestionPage
.title
=== currentPageName
&& suggestionPage
.title
!== titleObj
.getPrefixedText() ) {
216 pageData
[ suggestionPage
.title
] = {
217 known
: suggestionPage
.known
!== undefined,
218 missing
: suggestionPage
.missing
!== undefined,
219 redirect
: suggestionPage
.redirect
!== undefined,
220 disambiguation
: OO
.getProp( suggestionPage
, 'pageprops', 'disambiguation' ) !== undefined,
221 imageUrl
: OO
.getProp( suggestionPage
, 'thumbnail', 'source' ),
222 description
: OO
.getProp( suggestionPage
, 'terms', 'description' ),
224 index
: suggestionPage
.index
227 // Throw away pages from wrong namespaces. This can happen when 'showRedirectTargets' is true
228 // and we encounter a cross-namespace redirect.
229 if ( this.namespace === null || this.namespace === suggestionPage
.ns
) {
230 titles
.push( suggestionPage
.title
);
233 redirects
= redirectsTo
[ suggestionPage
.title
] || [];
234 for ( i
= 0, len
= redirects
.length
; i
< len
; i
++ ) {
235 pageData
[ redirects
[ i
] ] = {
239 disambiguation
: false,
240 description
: mw
.msg( 'mw-widgets-titleinput-description-redirect', suggestionPage
.title
),
241 // Sort index, just below its target
242 index
: suggestionPage
.index
+ 0.5
244 titles
.push( redirects
[ i
] );
248 titles
.sort( function ( a
, b
) {
249 return pageData
[ a
].index
- pageData
[ b
].index
;
252 // If not found, run value through mw.Title to avoid treating a match as a
253 // mismatch where normalisation would make them matching (bug 48476)
256 Object
.prototype.hasOwnProperty
.call( pageData
, this.getQueryValue() ) &&
258 !pageData
[ this.getQueryValue() ].missing
||
259 pageData
[ this.getQueryValue() ].known
262 pageExists
= pageExistsExact
|| (
264 Object
.prototype.hasOwnProperty
.call( pageData
, titleObj
.getPrefixedText() ) &&
266 !pageData
[ titleObj
.getPrefixedText() ].missing
||
267 pageData
[ titleObj
.getPrefixedText() ].known
272 this.cache
.set( pageData
);
275 // Offer the exact text as a suggestion if the page exists
276 if ( pageExists
&& !pageExistsExact
) {
277 titles
.unshift( this.getQueryValue() );
280 for ( i
= 0, len
= titles
.length
; i
< len
; i
++ ) {
281 page
= pageData
[ titles
[ i
] ] || {};
282 items
.push( new mw
.widgets
.TitleOptionWidget( this.getOptionWidgetData( titles
[ i
], page
) ) );
289 * Get menu option widget data from the title and page data
291 * @param {string} title Title object
292 * @param {Object} data Page data
293 * @return {Object} Data for option widget
295 mw
.widgets
.TitleWidget
.prototype.getOptionWidgetData = function ( title
, data
) {
296 var mwTitle
= new mw
.Title( title
),
297 description
= data
.description
;
298 if ( data
.missing
&& !description
) {
299 description
= mw
.msg( 'mw-widgets-titleinput-description-new-page' );
302 data
: this.namespace !== null && this.relative
?
303 mwTitle
.getRelativeText( this.namespace ) :
305 url
: mwTitle
.getUrl(),
306 imageUrl
: this.showImages
? data
.imageUrl
: null,
307 description
: this.showDescriptions
? description
: null,
308 missing
: data
.missing
,
309 redirect
: data
.redirect
,
310 disambiguation
: data
.disambiguation
,
311 query
: this.getQueryValue()
316 * Get title object corresponding to given value, or #getQueryValue if not given.
318 * @param {string} [value] Value to get a title for
319 * @return {mw.Title|null} Title object, or null if value is invalid
321 mw
.widgets
.TitleWidget
.prototype.getTitle = function ( value
) {
322 var title
= value
!== undefined ? value
: this.getQueryValue(),
323 // mw.Title doesn't handle null well
324 titleObj
= mw
.Title
.newFromText( title
, this.namespace !== null ? this.namespace : undefined );
330 * Check if the query is valid
332 * @return {boolean} The query is valid
334 mw
.widgets
.TitleWidget
.prototype.isQueryValid = function () {
335 return this.validateTitle
? !!this.getTitle() : true;
338 }( jQuery
, mediaWiki
) );