Modèle:Tableau boîte utilisateur
Ce modèle utilise le module Tableau boîte utilisateur, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via une sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.
Utilisation et paramètres modifier
Ce modèle permet de générer un tableau de présentation de boîtes utilisateurs. Voir la catégorie « Liste de boîtes utilisateur » pour les pages utilisant ce modèle.
Tableau simple modifier
Un tableau de boîtes utilisateur simple se présente de la manière suivante :
| Nom de la boîte | Visualisation |
|---|---|
| Wikipédia | |
| religion Wikipédia |
Chaque ligne est constituée de deux cases, celle de gauche présentant le nom de la boîte utilisateur, et celle de droite sa visualisation.
Pour construire un tableau de ce type, il faut un appel au modèle pour créer l'en-tête, un nombre arbitraire d'appels pour créer les lignes de contenu, et terminer par un appel pour clôturer le tableau. L'en-tête et la fin du tableau doivent préciser le paramètre type :
{{Tableau boîte utilisateur|type=enTete}}
{{Tableau boîte utilisateur|Wikipédia}}
{{Tableau boîte utilisateur|religion Wikipédia}}
{{Tableau boîte utilisateur|type=fin}}
Dans une utilisation simple, il suffit de passer le nom de la boîte utilisateur au modèle pour créer une ligne constituée de deux cases présentant ce modèle. Il est possible de mettre autant de lignes que nécessaire entre les éléments d'en-tête et de fin.
Ajout d'un commentaire modifier
Dans certains cas, il peut être utile de fournir un commentaire sur une boîte, par exemple pour indiquer son fonctionnement. Il est possible de le faire en utilisant le paramètre commentaire :
{{Tableau boîte utilisateur|type=enTete}}
{{Tableau boîte utilisateur|Wikipédia|commentaire=Ceci est un<br>commentaire}}
{{Tableau boîte utilisateur|type=fin}}
| Nom de la boîte | Visualisation |
|---|---|
| Wikipédia Ceci est un commentaire |
Personnalisation de l'en-tête modifier
Il est possible d'afficher un texte personnalisé dans la première colonne de l'en-tête. Pour cela, il suffit de passer un paramètre additionnel titre :
{{Tableau boîte utilisateur|type=enTete|titre=Titre personnalisé}}
{{Tableau boîte utilisateur|Wikipédia}}
{{Tableau boîte utilisateur|religion Wikipédia}}
{{Tableau boîte utilisateur|type=fin}}
| Titre personnalisé | Visualisation |
|---|---|
| Wikipédia | |
| religion Wikipédia |
Personnalisation du contenu modifier
Certaines boîtes utilisateur ont besoin de paramètres pour fonctionner : il n'est alors pas possible de les appeller directement sans fournir de valeur à ces paramètres. Dans ce cas, il est possible de fournir manuellement le contenu à placer dans la colonne de droite en utilisant le paramètre contenu. Dans ce cas, il est recommandé de fournir un commentaire précisant ces paramètres.
{{Tableau boîte utilisateur|type=enTete}}
{{Tableau boîte utilisateur|Wikipédia:Date|contenu={{Utilisateur Wikipédia:Date|année=2006|mois=05|jour=1}}|commentaire=Ce modèle prend trois paramètres :<br>année, mois et jour}}
{{Tableau boîte utilisateur|type=fin}}
| Nom de la boîte | Visualisation |
|---|---|
| Wikipédia:Date Ce modèle prend trois paramètres : année, mois et jour |
Tableau étendu modifier
Le tableau peut être étendu sur plusieurs colonnes ou plusieurs lignes. Attention, ici une colonne correspond à un tableau simple, c'est-à-dire comprenant deux cases.
Tableau multi colonnes modifier
Pour un tableau multi colonnes, il est nécessaire d'indiquer le nombre de colonnes à la fois dans l'en-tête et dans chaque ligne à l'aide du paramètre colonnes. Il est ensuite possible de l'utiliser simplement en ajoutant un nom de boîte par paramètre. Il est possible de personnaliser le titre de chaque colonne mais il est nécessaire de préciser le numéro de la colonne adressée en utilisant les paramètres titre1, titre2, etc. De la même manière, des commentaires peuvent être fournis pour chaque colonne en utilisant les paramètres commentaire1, commentaire2, etc. :
{{Tableau boîte utilisateur|type=enTete|colonnes=3|titre1=Gauche|titre2=Centre|titre3=Droite}}
{{Tableau boîte utilisateur|colonnes=3|Gauche|Centre|Droite|commentaire1=G|commentaire2=C|commentaire3=D}}
{{Tableau boîte utilisateur|type=fin}}
| Gauche | Visualisation | Centre | Visualisation | Droite | Visualisation |
|---|---|---|---|---|---|
| Gauche G |
Centre C |
Droite D |
Le paramètre contenu peut être utilisé pour spécifier manuellement le contenu d'une des colonnes Visualisation, mais il est alors nécessaire de le numéroter pour indiquer la colonne visée : contenu1, contenu2, etc.
Tableau multi lignes modifier
Pour des raisons de présentation, il peut être intéressant de rassembler des boîtes traitant du même sujet. Une ligne multiple de tableau permet de rassembler les noms de plusieurs boîtes, tout en conservant la visualisation des modèles sur des lignes séparées. Il faut alors utiliser le paramètre lignes. Le commentaire est commun aux deux lignes.
{{Tableau boîte utilisateur|type=enTete}}
{{Tableau boîte utilisateur|lignes=2|Wikipédia|religion Wikipédia}}
{{Tableau boîte utilisateur|type=fin}}
| Nom de la boîte | Visualisation |
|---|---|
| Wikipédia ou religion Wikipédia |
|
Il reste possible de spécifier manuellement le contenu de la colonne Visualisation à l'aide des paramètres contenu1, contenu2, etc. mais la numérotation est alors réalisée de haut en bas.
Tableau multi lignes et multi colonnes modifier
Enfin, tous ces paramètres peuvent continuer à être utilisés en spécifiant simultanément plusieurs lignes et plusieurs colonnes. Dans ce cas, la numérotation se fait d'abord de haut en bas, puis de gauche à droite. À noter que les commentaires ne changent pas de numérotation car il y en a toujours un par colonne.
{{Tableau boîte utilisateur|type=enTete|colonnes=2|titre1=Titre 1|titre2=Titre 2}}
{{Tableau boîte utilisateur|colonnes=2|lignes=2|Wikipédia|religion Wikipédia|étudiant|Wikipédia:Date|commentaire1=Commentaire 1|commentaire2=Commentaire 2|contenu4={{Utilisateur Wikipédia:Date|année=2006|mois=5|jour=1}} }}
{{Tableau boîte utilisateur|type=fin}}
| Titre 1 | Visualisation | Titre 2 | Visualisation |
|---|---|---|---|
| Wikipédia ou religion Wikipédia Commentaire 1 |
étudiant ou Wikipédia:Date Commentaire 2 |
||
La documentation de ce modèle est générée par le modèle {{Documentation}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (créer) et la page de test (créer).
Voir les statistiques d'utilisation du modèle sur l'outil wstat.