Charger les valeurs du formulaire

La fonction charger() permet d’indiquer quels champs doivent être récupérés lorsque le formulaire est soumis et permet aussi de définir les valeurs par défaut de ces champs.

Cette fonction renvoie tout simplement un tableau associatif « nom du champ » / « valeur par défaut » :

function formulaires_nom_charger_dist() {
	$valeurs = array(
		"champ" => "valeur par défaut",
		"autre champ" => "",
	);
	return $valeurs;
}

Toutes les clés qui sont indiquées seront envoyées dans l’environnement du squelette HTML du formulaire. On récupère alors ces données par #ENV{champ}. Dès que le formulaire est posté, ce sont les valeurs envoyées par l’utilisateur qui sont prioritaires sur les valeurs par défaut.

Il n’est pas utile de protéger les valeurs envoyées contenant des guillemets, SPIP s’en chargeant automatiquement. Ceci dit, les champs commençants par un souligné « _ » ne subissent pas ce traitement automatique, ce qui peut être utile pour transmettre des variables complexes.

Voir aussi : le pipeline formulaire_charger

Auteur Matthieu Marcillaud Publié le : Mis à jour : 12/07/23

Traductions : English, français