Countdown/fr

Le script Countdown créer un compte à rebours à l'endroit spécifié.

Ce qu'il fait
Vous ajoutez un élément avec une date voulue dans la page et le script replacera cette date par un compte à rebours jusqu'à ce que le jour/heure/minute/second soit atteint.

Installation

 * Voir aussi : Aide:CSS et JS avancés

En utilisant le nouveau MediaWiki:ImportJS, vous pouvez l'inclure immédiatement à votre wiki en ajoutant :

Si vous souhaitez l'inclure de l'ancienne manière, copiez-collez ce qui suit dans la page MediaWiki:Common.js page votre wiki :

Si votre page MediaWiki:Common.js contient déjà un import comme celui ci-dessus, ajoutez simplement "w:c:dev:MediaWiki:Countdown/code.js" à la liste, comme décrit ici.

Créer un compte à rebours
Un compte à rebours peut être ajouté à une page en utilisant le format suivant :Le texte au sein de "countdown" apparaîtra seulement lorsque le compte à rebours est actif. Tout texte avant "countdowndate" précédera le compte à rebours, et tout texte après "countdowndate" sera affiché après.

L'exemple ci-dessus donne :

Seulement January 01 00:00:00 jusqu'au Nouvel An… (Exemple de compte à rebours)

Un span optionnel avec une classe "nocountdown" peut être utilisé comme texte alternatif lorsque le script de compte à rebours ne fonctionne pas ou qu'il est en train de charger. Ce span doit être placé directement après le code du compte à rebours ci-dessous.
 * Par exemple, en utilisant  donne « C'est presque le Nouvel An ! » le temps que le script charge.

Fuseaux horaires
En utilisant le code présenté précédemment, le compte à rebours fonctionne relativement bien pour les utilisateurs dans le même fuseau que l'horloge système. Bien que cela puisse être utile dans des cas comme celui de compter jusqu'au prochain jour de l'an, cela peut s'avérer non-pratique dans les autres cas.

Deux méthodes peuvent être utilisées pour que le compte à rebours se base sur un fuseau horaire spécifique. Le plus simple étant d'ajouter l'identifiant du fuseau horaire à la fin du code. Par exemple, pour faire un compte à rebours pour le fuseau Heure de l'Est (EST ; Eastern Standard Time)

Bien que cette méthode fonctionne avec le plupart des identifiants, il ne fonctionne pas avec certaines variantes pour l'heure d'été (par exemple Heure d'Été du Royaume-Uni (BST ; British Summer Time).

Une autre méthode plus fiable consiste à ajouter le décalage par rapport au Temps Universel Coordonné (UTC) à la fin du code. Par exemple, pour faire un compte à rebours à l'heure CET, qui a un décalage de -5 heures :

Veuillez noter que les changements vers ou depuis l'heure d'été ne sont pas faits automatiquement et doivent être fait par l'utilisateur — soit avec l'identifiant de l'heure d'été, soit en utilisant le décalage UTC.

Arrêt du compte à rebours
De quelle manière souhaitez vous que le compte à rebours se termine ? Il existe cinq options :
 * 1) compter à partir de zéro — c'est celui par défaut pour des raisons historiques
 * 2) retrait du conteneur du compte à rebours
 * 3) arrêter le compteur à zéro
 * 4) remplacer le compteur par autre chose
 * 5) appeler une fonction JavaScript personnalisée de votre choix

Continuer de compter
Du fait que c'est l'option par défaut, vous n'avez besoin de rien faire.

Retrait
Ajoutez un attribut  avec la valeur "remove" au conteneur :

Arrêt
Ajoutez un attribut  avec la valeur "stop" au conteneur :

Remplacement
Ajoutez un attribut  avec la valeur "toggle" au conteneur. Vous devrez également ajouter un attribut  avec un sélecteur qui pointe vers le remplaçant :

Veuillez noter que le point dans la valeur du  ! La valeur attendue est un sélecteur CSS ou jQuery. Donc, c'est ".nom" pour les classes. "#nom" pour les identifiants. Etc.

Autre variante, si le conteneur toggle est celui qui suit celui du compteur, la valeur spéciale  peut être utilisée à la place, sans avoir besoin de spécifier de sélecteur. C'est utile lorsqu'il y a plusieurs comptes à rebours dans un même modèle, à titre d'exemple.

Appel personnalisé
Ajoutez un attribut  avec la valeur "callback" au conteneur. Vous devrez également ajouter un attribut  avec le nom de la fonction que vous souhaitez appeler :

Le compte à rebours s'arrêtera à zéro et ensuite votre fonction sera appelée. Le conteneur du compte à rebours sera l'objet   de la fonction.

Pour rendre la fonction disponible au module Countdown, vous devrez l'ajouter au module lui-même :

Zéros de tête
Par défaut, les zéros de tête seront affichés :

0 jours, 0 heures, 10 minutes et 10 secondes

Si vous préférez obtenir ceci à la place :

10 minutes et 10 secondes

vous devez ajouter l'attribut  avec la valeur "no-leading-zeros" :

Format court
Si vous préférez affichier le compte à rebours dans un format court comme  au lieu des mots entiers, vous devez ajouter l'attribut   avec la valeur "short-format".

Si vous avez déjà défini l'attribut, ajoutez toutes les options en les séparant par des espaces :

Contenu dynamique
Ce script supporte le contenu inséré dynamiquement, tel que des commentaires d'article ou les aperçus des éditeurs. Cependant, si vous insérez un compteur via du JavaScript, vous devez déclencher (fire) l'événement après l'avoir inséré :

Où  est le sélecteur de l'élément dans lequel le compteur a été inséré.

Localisation
Des messages localisés peuvent être ajoutés en utilisant le code langue comme clé et ensuite créer un objet pour les messages. Consultez l'exemple ci-dessous pour voir comment écraser les valeurs par défaut utilisées pour la langue anglaise.

Ajouter des tranductions
Les équivalents locaux des intervalles de temps suivants sont requis par le script :
 * second/seconds
 * minute/minutes
 * hour/hours
 * day/days

De plus, la version localisée de "and" (et) est requise.

Si vous souhaitez nous aider, merci de poster les tranductions pour ce script dans la page de duscussion du script (ou ajoutez les directement dans MediaWiki:Countdown/code.js si vous vous sentez à l'aise pour le faire vous-même).

Mises à jour majeures

 * 21 octobre 2017
 * Jorgemg14: ajout de l'option pour le format court


 * 15 juin 2017
 * Jorgemg14: support du contenu dynamique


 * 9 décembre 2012
 * Pecoes: réécriture complète et ajout de plusieurs options


 * 28 juin 2012
 * Eladkse: simplification du code pour singulier/pluriel.


 * 31 janvier 2012
 * Eladkse: ajout du code pour la localisation par Dantman.


 * 7 juillet 2011
 * Eladkse: ajout du code permettant la définition des formes au singulier et au pluriel de l'heure.