%PDF-
%PDF-
Mini Shell
Mini Shell
( function( M, $ ) {
var
View = M.require( 'View' ),
Section = M.require( 'Section' ),
Page;
/**
* @class Page
* @extends View
*/
Page = View.extend( {
template: M.template.get( 'page.hogan' ),
defaults: {
// id defaults to 0 which represents a new page. Be sure to override to avoid side effects.
id: 0,
/**
* Includes prefix where needed and is human readable.
* e.g. Talk:The man who lived
* @type {string}
*/
title: '',
displayTitle: '',
lead: '',
protection: {
edit: [ '*' ]
},
inBetaOrAlpha: M.isBetaGroupMember(),
isMainPage: false,
userCanUpload: mw.config.get( 'wgUserCanUpload' ),
talkLabel: mw.msg( 'mobile-frontend-talk-overlay-header' ),
editLabel: mw.msg( 'mobile-frontend-editor-edit' ),
languageLabel: mw.msg( 'mobile-frontend-language-article-heading' )
},
initialize: function( options ) {
// Fallback if no displayTitle provided
options.displayTitle = options.displayTitle || options.title;
// Surface the display title for M.reloadPage
this.displayTitle = options.displayTitle;
options.languageUrl = mw.util.getUrl( 'Special:MobileLanguages/' + options.title );
View.prototype.initialize.apply( this, arguments );
},
/**
* @method
* FIXME: Make this update with ajax page loads
* @return {Boolean}
*/
isWikiText: function() {
return mw.config.get( 'wgPageContentModel' ) === 'wikitext';
},
/**
* @method
* @return {Boolean}
*/
isMainPage: function() {
return this.options.isMainPage;
},
/**
* Checks whether the given user can edit the page.
* @method
* @param {mw.user} Object representing a user
* @return {jQuery.Deferred} With parameter boolean
*/
isEditable: function( user ) {
var editProtection = this.options.protection.edit,
resp = $.Deferred();
user.getGroups().done( function( groups ) {
var editable = false;
$.each( groups, function( i, group ) {
if ( $.inArray( group, editProtection ) > -1 ) {
editable = true;
return false;
}
} );
resp.resolve( editable );
} );
return resp;
},
// FIXME: This assumes only one page can be rendered at one time - emits a page-loaded event and sets wgArticleId
// FIXME: The Page object is pretty central and used more like a model at times than a view. Time to introduce Models?
render: function( options ) {
var pageTitle = options.title, self = this,
$el = this.$el;
// prevent talk icon being re-rendered after an edit to a talk page
options.isTalkPage = self.isTalkPage();
// FIXME: this is horrible, because it makes preRender run _during_ render...
if ( !options.sections ) {
$el.empty().addClass( 'spinner loading' );
// FIXME: api response should also return last modified timestamp and page_top_level_section_count property
M.pageApi.getPage( pageTitle ).done( function( pageData ) {
options = $.extend( options, pageData );
options.hasLanguages = pageData.languageCount > 0 || pageData.hasVariants;
// Resurface the display title for M.reloadPage
self.displayTitle = options.displayTitle;
View.prototype.render.apply( self, arguments );
// reset loader
$el.removeClass( 'spinner loading' );
self.emit( 'ready', self );
} ).fail( $.proxy( self, 'emit', 'error' ) );
} else {
View.prototype.render.apply( self, arguments );
}
},
/**
* Return the latest revision id for this page
* @method
* @return {Number}
*/
getRevisionId: function() {
return this.options.revId;
},
/**
* @method
* @return {string}
*/
getTitle: function() {
return this.options.title;
},
/**
* @method
* @return {Number}
*/
getId: function() {
return this.options.id;
},
/**
* @method
* @return {Number} namespace Number
*/
getNamespaceId: function() {
var args = this.options.title.split( ':' ), nsId;
if ( args[1] ) {
nsId = mw.config.get( 'wgNamespaceIds' )[ args[0].toLowerCase().replace( ' ', '_' ) ] || 0;
} else {
nsId = 0;
}
return nsId;
},
/**
* @method
* @return {Boolean} Whether the page is a talk page or not
*/
isTalkPage: function() {
var ns = this.getNamespaceId();
// all talk pages are odd Numbers (except the case of special pages)
return ns > 0 && ns % 2 === 1;
},
preRender: function( options ) {
var self = this;
this.sections = [];
this._sectionLookup = {};
this.title = options.title;
this.lead = options.lead;
$.each( options.sections, function() {
var section = new Section( this );
self.sections.push( section );
self._sectionLookup[section.id] = section;
} );
},
/**
* @method
*/
getReferenceSection: function() {
return this._referenceLookup;
},
/**
* FIXME: rename to getSection
* FIXME: Change function signature to take the anchor of the heading
* @method
* @return {Section}
*/
getSubSection: function( id ) {
return this._sectionLookup[ id ];
},
/**
* FIXME: rename to getSections
*
* @method
* @return Array
*/
getSubSections: function() {
return this.sections;
}
} );
M.define( 'Page', Page );
}( mw.mobileFrontend, jQuery ) );
Zerion Mini Shell 1.0