Wikisource:La fabbrica dei giocattoli/incapsula()

La funzione incapsula() non genera un singolo bottone, ma una serie di bottoni personalizzabili, in base ai due parametri che devono essere passati alla funzione all'interno delle due parentesi nel codice del bottone.

L'effetto è identico a quello dei più comuni tastini del toolbox, ossia aggiunge prima del testo selezionato "qualcosa" e dopo la il testo selezionato "qualcos'altro"; nel codice mediawiki questa azione è denominata encapsulate perchè incapsula il testo selezionato fra due codice/due testi.

Ad esempio, il vecchio tastino "centrato" di toolbox, , incapsula la selezione fra i due codici {{Centrato| e }}.

Per creare un bottone col la stessa funzione, occorre passare {{Centrato| come primo parametro e }} come secondo parametro. Il codice potrebbe essere:

newButton("center","incapsula('{{Centrato|','}}')");

Una bella raccolta di bottoni incapsula() a trovate in Utente:Barbaforcuta/vector.js.

Avvertenze e caratteri speciali

1. E' indispensabile prestare sempre la massima attenzione all'uso delle virgolette che delimitano i parametri di newButton() e a quelli che delimitano i parametri di incapsula(), al suo interno:
   1. i parametri di newButton() vanno delimitati con virgoletta doppia, "
   2. i parametri di incapsula() vanno delimitato con virgoletta singola, '

Per quanto riguarda il contenuto dei parametri di incapsula():

1. eventuali caratteri di acapo vanno inseriti con questo codice: \\n
2. eventuali doppie virgolette vanno inserite con questo codice: &quote;
3. eventuali caratteri < e > vanno inseriti con questo codice, rispettivamente: &lt; e &gt; (occhio: copiaincollate il codice dalla visualizzazione di questa pagina, non in modifica!!!)

Buon lavoro.