Extension:Page Forms/Creating query forms/fr

Les formulaires peuvent également être utilisés pour les requêtes, par opposition à l'ajout ou à l'édition de données. To do so, use the  page, which displays a form in a manner similar to , but with no associated 'target page'. Au lieu de cela, lorsque l'utilisateur soumet le formulaire en appuyant sur le bouton, il voit à quoi ressemble le modèle lorsqu'il est affiché avec les valeurs qu'il a entrées.

The template that the form uses should most likely contain one or more queries (using Semantic MediaWiki inline queries, Cargo queries, External Data queries, etc.) to query data using values that the user entered. You can see an example of a query form here.



Bouton
By default, a button called "Run query" shows up at the bottom of forms if they are accessed via. You can change the location and text of this button, using the tag " " (or " ", etc.) within the form definition.

See part "standard input" tag (Defining forms manual) for more information.



Formulaire de requête en haut
If you add the parameter " " to the  tag, the query input field will show up at the top of the results page, instead of the bottom.



Créer des liens vers les formulaires de requête
Once a query form has been created, you can link to it using syntax that looks like this:



However, the preferred solution, because it's easier and more powerful, is to use the  parser function. A basic call to that function would look like:



Here's the complete syntax of :



Les paramètres sont presque identiques à ceux utilisés par ; pour une explication complète des paramètres, voir utiliser   (manuel Lier des formulaires).



Inclure des formulaires de requête
Vous pouvez également intégrer un formulaire de requête dans une autre page. Pour faire cela, ajoutez ce qui suit à une page où vous souhaitez que le formulaire de requête apparaisse :



Vous pouvez également intégrer plusieurs formulaires  sur la même page.



Précharger les données de la requête
In case query data needs to be pre-loaded, the  should follow the convention:



For example, like this:



The construction   might cause a problem in connection with the wiki markup, and therefore the square brackets—  and   —can be replaced with either   and , or   and  ).

Finally, make sure that the case in the query string matches the declaration in the form (e.g.,  must match   and   must match.

Alternatively, you can preload data by using the  parameter for form fields.



Afficher les résultats automatiquement
The above technique will produce pre-selected values in the form, but the user will still has to press the "Run query" button to see the results of the query. If you want the results to be displayed automatically as well, you simply have to add  to the query string, like the following:



You can see a live example of this here.

As before, the recommended way to link to such a page internally is with ; such a call would look as follows: