Format de résultat « list »

From semantic-mediawiki.org
< Help:List format
List formatFormat de résultat « list »
List format/fr
Sujet :
Liste de valeurs séparées par des virgules, avec des indications supplémentaires signalées entre parenthèses
Fourni par :
Semantic MediaWiki
Ajouté dans la version :
0.7
Retiré depuis la version :
toujours supporté
Nécessite en plus :
rien
Nom du format :
list
Auteurs :
=Markus Krötzsch
Catégories :
misc

Le format de résultat list est utilisé pour formater les résultats des requêtes commes des listes séparées par des virgules. Le format list est la manière par défaut de formater les résultats d'une requête pour toutes les requêtes qui ne possèdent pas d'informations supplémentaires d'impression. Les formats similaires de résultat sont ol et ul.

Paramètres[edit]

Paramètre Alias Type Par défaut Description
propsep - texte , Le séparateur entre les propriétés d’une entrée de résultat
valuesep - texte , Le séparateur entre les valeurs pour une propriété de résultat
template - texte vide Le nom d'un modèle qui servira à afficher les résultats
named args namedargs oui/non no Nommez les arguments transmis au modèle
userparam - texte vide Une valeur passée dans chaque appel de modèle, si un modèle est utilisé
class - texte vide Une classe CSS supplémentaire à définir pour la liste
introtemplate - texte vide Le nom d'un modèle à afficher avant les résultats de requête, s'il y en a
outrotemplate - texte vide Le nom d'un modèle à afficher après les résultats de la requête, s'il y en a
sep - texte , Le séparateur entre les résultats

L'utilisation de modèles pour la mise en forme est expliquée sur la page d'aide des modèles de format.

Exemples[edit]

{{#ask: [[Category:City]] [[located in::Germany]] }}

Résultat: Berlin, Cologne, Frankfurt, Munich, Stuttgart, Würzburg

Si davantage de valeurs sont retournées, alors le format doit être précisé explicitement :

{{#ask: [[Category:City]] [[located in::Germany]] 
| ?population
| ?area#km² = Size in km²
| format=list
}}

Résultat: Berlin (PopulationThe number of inhabitants of some geographical place.: 3,520,061, Size in km²: 891.85 km²344.34 sqmi <br />), Cologne (PopulationThe number of inhabitants of some geographical place.: 1,080,394, Size in km²: 405.02 km²156.38 sqmi <br />), Frankfurt (PopulationThe number of inhabitants of some geographical place.: 679,664, Size in km²: 248.31 km²95.87 sqmi <br />), Munich (PopulationThe number of inhabitants of some geographical place.: 1,353,186, Size in km²: 310.43 km²119.86 sqmi <br />), Stuttgart (PopulationThe number of inhabitants of some geographical place.: 606,588, Size in km²: 207.35 km²80.06 sqmi <br />), Würzburg (PopulationThe number of inhabitants of some geographical place.: 126,635, Size in km²: 87.63 km²33.83 sqmi <br />)

Les entêtes peuvent être masqués en leur assignant un texte vide:

{{#ask: [[Category:City]] [[located in::Germany]] 
| ?population =
| ?area#km² = 
| format=list
}}

Résultat: Berlin (3,520,061, 891.85 km²344.34 sqmi <br />), Cologne (1,080,394, 405.02 km²156.38 sqmi <br />), Frankfurt (679,664, 248.31 km²95.87 sqmi <br />), Munich (1,353,186, 310.43 km²119.86 sqmi <br />), Stuttgart (606,588, 207.35 km²80.06 sqmi <br />), Würzburg (126,635, 87.63 km²33.83 sqmi <br />)

Le même effet est obtenu avec headers=hide.

Un autre séparateur que «,» - par exemple «and» - peut être utilisé s'il est mentionné par sep:

{{#ask: [[Category:City]] [[located in::Germany]] | sep =  &nbsp;and&nbsp; }}

Résultat: Berlin and Cologne and Frankfurt and Munich and Stuttgart and Würzburg

Le code HTML &nbsp; (espace insécable) est utilisé pour créer des espaces qui ne sont pas supprimés par MediaWiki quand il lit le paramètre.

Remarques[edit]

Utiliser le format list avec des modèles a l'avantage d'obtenir le nombre correct de séparateurs (par exemple «,») entre les résultats. Par exemple, on peut avoir un modèle qui formate une liste d'adresses courriels recopiées ou collées dans un client de messagerie, où chaque entrée est de la forme

Name of person <email@example.com>

Il est cohérent de mettre sep=,&nbsp; pour obtenir une liste qui utilise des virgules pour tous les séparateurs au lieu d'avoir «and» pour le dernier.



Cette page de documentation concerne toutes les versions de SMW depuis la 1.7.0 jusqu'à la version la plus récente.
      Autres langues : dezh-hans

Help:List format fr 1.7.0