From 652d4ded91ce20002da4b4f381af663649b97013 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Bartosz=20Dziewo=C5=84ski?= Date: Wed, 4 Nov 2015 00:48:11 +0100 Subject: [PATCH] mediawiki.jqueryMsg: Extend mw.Message with new #parseDom method Unlike #parse, this one returns a jQuery set of DOM nodes and not a HTML string, for two benefits: * Allows to skip unnecessary HTML serialization and reconstruction when we just want to insert the message contents somewhere. Old way: $( '#foo' ).html( mw.message( 'foo' ).parse() ); New way: $( '#foo' ).append( mw.message( 'foo' ).parseDom() ); This is roughly equivalent to the old alternative: $( '#foo' ).msg( 'foo' ); But that way can't be used if you start with a mw.Message object, or don't yet know where the elements will be inserted. * Allows to preserve the event handlers when a function is passed as message parameter. mw.messages.set( 'foo', '[$1 Click me!]' ); $( '#foo' ).append( mw.message( 'foo', function () { console.log( 'Link clicked!' ); } ).parseDom() ); Change-Id: Ia09131c2ffc1d149ca6b1c32dcd918a539c3a719 --- resources/src/mediawiki/mediawiki.jqueryMsg.js | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/resources/src/mediawiki/mediawiki.jqueryMsg.js b/resources/src/mediawiki/mediawiki.jqueryMsg.js index 2fe831e448..ba2b6849c7 100644 --- a/resources/src/mediawiki/mediawiki.jqueryMsg.js +++ b/resources/src/mediawiki/mediawiki.jqueryMsg.js @@ -1279,4 +1279,20 @@ return messageFunction( this.key, this.parameters ); }; + /** + * Parse the message to DOM nodes, rather than HTML string like #parse. + * + * This method is only available when jqueryMsg is loaded. + * + * @method parseDom + * @member mw.Message + * @return {jQuery} + */ + mw.Message.prototype.parseDom = ( function () { + var reusableParent = $( '
' ); + return function () { + return reusableParent.msg( this.key, this.parameters ).contents().detach(); + }; + } )(); + }( mediaWiki, jQuery ) ); -- 2.20.1