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à
  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
 

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