Ces fonctions permettent de créer une chaîne de caractère au format HTML, pour des messages courant d'indication dans les questions.
temps_necessaire.moodle( temps, couleur = getOption( "Sm.temps_couleur" ),
nv.ligne = TRUE,
masque = getOption( "Sm.temps_masque" ) )
Ces fonctions renvoient une unique chaîne de caractères, en HTML, prête à être intégrée dans un énoncé.
Le temps conseillé pour la question. Ce peut être un nombre, le temps est alors supposé exprimé en minutes, ou une chaîne de caractères à un format de temps classique (par exemple 45s, 2'30...).
La couleur à utiliser pour le message. N'importe quelle
couleur reconnue en CSS peut être utilisée. Par défaut, utilise la
valeur dans l'option Sm.temps_couleur
(qui correspond à une
consigne en bleue si elle n'est pas modifiée).
Si TRUE
, le message est précédé d'un retour à
la ligne (balise HTML <br />
).
Le masque à utiliser pour la consigne indiquant le temps
nécessaire; dans ce masque, le code #T
sera remplacé par le
temps construit. Par défaut, utilise la valeur dans l'option
Sm.temps_masque
(qui correspond à “Temps conseillé
pour répondre : <b>#T</b>”).
Emmanuel Curis emmanuel.curis@parisdescartes.fr
Ces fonctions sont utilisées par les fonctions générant les questions classiques pour ajouter des consignes en fin d'énoncé. Elles peuvent être utilisées directement pour davantage de souplesse.
Le message créé par temps_necessaire.moodle
est par défaut
“Temps conseillé pour cette question : x min y s”, où x et y
sont construits à partir du temps indiqué en minutes (par exemple, si
temps=1.5
, x=1 et y=30). Pour les questions classiques, il
correspond à l'option temps
. Ce message peut être modifié
grâce à l'option Sm.temps_masque
, qui doit contenir une chaîne
de caractère. Dans cette chaîne, #T
sera remplacé par “x
min y s”.
# Indication d'un temps conseillé de 2 min 30
temps_necessaire.moodle( 2.5 )
# Indication d'un temps conseillé de 10 secondes
temps_necessaire.moodle( "10s" )
Run the code above in your browser using DataLab