Manuel:CopyTextLayout

From mediawiki.org
This page is a translated version of the page Manual:CopyTextLayout and the translation is 100% complete.

CopyTextLayout est un widget MediaWiki qui affiche un bouton pour copier le texte fourni. C'est un widget basé sur OOUI. C'est une combinaison de TextInputWidget avec ButtonWidget de OOUI.

Exemples JavaScript

Dans les extensions de MediaWiki

L'utilisation du widget dans l'extension MediaWiki sera possible à travers trois étapes. Créez d'abord le fichier resource JavaScript, puis enregistrez le fichier js dans le fichier extension.json. De sorte que le module puisse être chargé par le ResourceLoader. Et finalement chargez-le par Output Context.

  • Créez le fichier resource.js dans le répertoire des extensions avec le code suivant.
var copyText = new mw.widgets.CopyTextLayout( {
        title: 'Copy the text', 
        copyText: 'Text to be copied'
    } );

$( '#bodyContent' ).append( copyText.$element );
  • Enregistrez le fichier js en tant que module dans extension.json
"ResourceModules": {
    "ext.myExtResource": {
        "scripts": [
            "resource.js"
        ],
        "dependencies": [
            "mediawiki.widgets"
        ]
    }
}
  • Chargez-le enfin avec un objet Output Context dans votre SpecialPage/ParserHook.
......
// obtenir un Output Context
$out = $this->getOutput();
$out->addModules( 'ext.myExtResource' );
......

Dans les scripts utilisateurs

L'utilisation du widget dans UserScript est très facile, il suffit de charger les dépendances avec mw.loader.using(). et de placer le code dans le bloc. Essayez le code ci-dessous dans votre Special:MyPage/common.js

mw.loader.using('mediawiki.widgets').then( function (){

	var copyText = new mw.widgets.CopyTextLayout( {
            title: 'Copy the text', 
            copyText: 'Text to be copied'
        } );

	$( '#bodyContent' ).append( copyText.$element );

});

Dans les gadgets

Pour utiliser les gadgets, vous devez ajouter une entrée mediawiki.widgets dans le champ dependencies de la description du gadget. Voir la Documentation des gadgets pour les instructions et les exemples.

* mygadget[ResourceLoader|dependencies=mediawiki.widgets]|mygadget.js
  • Créez la page MediaWiki:Gadget-mygadget.js avec le code. Il n'est pas nécessaire d'utiliser mw.loader.using() comme nous l'avons fait dans UserScript.
var copyText = new mw.widgets.CopyTextLayout( {
        title: 'Copy the text', 
        copyText: 'Text to be copied'
    } );

$( '#bodyContent' ).append( copyText.$element );

Voir aussi