Modulo:ArrotondoPercentuale/man

Wikibooks, manuali e libri di testo liberi.
Jump to navigation Jump to search

Questa è la pagina di documentazione per Modulo:ArrotondoPercentuale

Questo modulo serve per correggere per eccesso o per difetto la percentuale di completamento dei moduli, qual ora venga scritto il {{Avanzamento}} con un parametro che altrimenti non sarebbe valido.

Sintassi[modifica]

Uso diretto[modifica]

{{#Invoke:ArrotondoPercentuale|main}}

Uso tramite template[modifica]

{{#Invoke:ArrotondoPercentuale|main|{{{1}}}}}

Esempio[modifica]

Vedremo come esempio l'uso diretto: {{#Invoke:ArrotondoPercentuale|main|14}} e {{#Invoke:ArrotondoPercentuale|main|87%}}

daranno come risultato: 25 e 75%, questo perché 14 è più vicino a 25 che alla categoria inferiore ( 00 ), mentre 87% è più vicino alla categoria inferiore, cioè 75% che a quella superiore, cioè 100%.

funzione per le immagini[modifica]

Se il vostro scopo è quello di usarlo per inserire le iconcine di avanzamento, la funzione da richiamare è {{#Invoke:ArrotondoPercentuale|immagine|''n''}} dove "n" è il numero da arrotondare.

Esempio
{{#Invoke:ArrotondoPercentuale|immagine|74%}}
restituirà
75%.svg che è l'arrotondamento per eccesso a 75%

Nota: a differenza della funzione principale, le immagini necessitano del segno di percentuale.

suddivisioni[modifica]

Tutti i valori si intendono implicitamente compresi

da 0 a 12 00
da 13 a 37 25
da 38 a 62 50
da 63 a 99 75
100 100

Parametri facoltativi[modifica]

Il modulo accetta anche 2 parametri facoltativi:

  1. px per modificare la dimensione dell'immagine (se non specificato, l'immagine verrà ridimensionata a 20px);
  2. txt per inserire la discascalia che appare quando si posiziona la freccia del mose sull'immagine. Usando {{!}} al posto del pipe( "|" ) è possibile passare parametri aggiunvi come ad asempio "destra" per allineare a destra l'immagine o "bordo" per rachiudere l'immagine in un riquado.
esempio
{{#Invoke:ArrotondoPercentuale|immagine|45%|px=25px|txt=bordo{{!}}Didascalia}}
risultato
Didascalia

Funzione pratica[modifica]

Questo modulo è stato pensato per essere usato con il {{Avanzamento}} in modo che restituisca sempre un valore corretto, anche se un utente aggiungesse un parametro non contemplato negli avanzamenti, in modo da evitare il più possibile gli errori dello script JS.

Richiamare la funzione all'interno di un altro modulo[modifica]

Se intendi usare la funzione main in un altro modulo Lua, devi prima caricarlo e trasformarlo in una variabile

local mArrotondo = require('Modulo:ArrotondoPercentuale')

Quindi supponendo di voler chiamare arrotondo la variabile, basta inserire la sintassi seguente all'interno della funzione che dovrà utilizzarlo:

arrotondo = mArrotondo.main(frame)

A questo punto basterà utilizzare soltanto la variabile arrotondo e il primo parametro del template verrà processato e arrotondato.

Per un esepio pratico vedere il Modulo:Avanzamento