Type de champ de formulaire checkboxes

From Joomla! Documentation

This page is a translated version of the page Checkboxes form field type and the translation is 100% complete.

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎Nederlands

Le type de champ de formulaire checkboxes fournit un ensemble de cases à cocher.
Remarque : contrairement à la plupart des Types de champ de formulaire standard comme textfield ou checkbox, ce champ n'est pas une solution "tout en un". Il permettra la création de cases à cocher et retournera les valeurs sous la forme d'un tableau array, mais elles ne seront pas stockées dans la base de données. Exemple :

<field name="toppings" type="checkboxes">
    <option value="anch">Anchovies</option>
    <option value="chor">Chorizo</option>
    <option value="on">Onions</option>
    <option value="mush">Mushrooms</option>
</field>

L'ensemble des cases à cocher peut être généré dans votre formulaire avec une seule déclaration comme ceci :

<?php echo $this->form->getInput('toppings'); ?>

Cela va générer le code HTML suivant, qui peut être personnalisé à l'aide de CSS :

<fieldset id="jform_toppings" class="checkboxes">
	<ul>
		<li><input type="checkbox" id="jform_toppings0"
			name="jform[toppings][]" value="anch" /><label for="jform_toppings0">Anchovies</label></li>
		<li><input type="checkbox" id="jform_toppings1"
			name="jform[toppings][]" value="chor" /><label for="jform_toppings1">Chorizo</label></li>
		<li><input type="checkbox" id="jform_toppings2"
			name="jform[toppings][]" value="on" /><label for="jform_toppings2">Onions</label></li>
		<li><input type="checkbox" id="jform_toppings3"
			name="jform[toppings][]" value="mush" /><label for="jform_toppings3">Mushrooms</label></li>
	</ul>
</fieldset>

Si l'utilisateur coche la deuxième et la quatrième case et soumet le formulaire, Joomla! fournira le résultat suivant :

print_r(JRequest::getVar('jform')['toppings']) =>

Array
(
    [0] => chor
    [1] => mush
)