Les étapes pour créer un formulaire utilisant un widget ActiveForm dans YII2 sont les suivantes: 1. Créez une instance ActiveForm dans le fichier de vue avec ActiveForm :: begin () et activeForm :: end (); 2. Ajoutez un champ de formulaire à l'aide de $ form-> champ ($ modèle, ?attribut?) et sélectionnez les types d'entrée appropriés tels que TextInput, PasswordInput, etc.; 3. Ajoutez un bouton de soumission à l'aide de HTML :: SoumitButton () et assurez-vous que le modèle définit les règles de validation pour la vérification automatique; 4. Vous pouvez personnaliser le style de formulaire et la mise en page en emballage des champs, des modèles personnalisés ou des cadres CSS intégrés tels que Bootstrap. De plus, lors du téléchargement de fichiers, vous devez définir ENCTYPE = "Multipart / Form-Data". Pour les formulaires sans modèle, vous pouvez passer des tableaux ordinaires ou des objets dynamiques au lieu du modèle.

L'utilisation du widget ActiveForm dans YII2 pour créer des formulaires est simple une fois que vous comprenez la structure de base et les méthodes impliquées. Voici comment commencer, ainsi que quelques conseils pratiques pour l'utiliser efficacement.

Configuration de base de la forme active

Pour commencer, vous devez créer une instance d' ActiveForm dans votre fichier de vue. Cela se fait généralement à l'aide d'un bloc begin() et end() .

 Utilisez yii \ widgets \ activeform;
Utilisez des aides yii \ html;

<? php $ form = activeform :: begin (); ?>

    <! - Les champs de formulaire vont ici ->

<? Php ActiveForm :: end (); ?>

Cela enveloppe le contenu de votre formulaire et gère des choses comme l'ouverture et la fermeture des balises <form> , la protection CSRF, etc.

Une chose à noter: enveloppez toujours votre formulaire dans une variable ( $form dans ce cas), car vous utiliserez cette variable pour générer des champs d'entrée individuels.

Création de champs d'entrée

à l'intérieur du bloc ActiveForm , vous pouvez commencer à ajouter des éléments de formulaire à l'aide de la méthode $form->field($model, 'attribute') . Chaque champ est généralement associé à un attribut de modèle.

Voici un exemple simple:

 <? = $ form-> champ ($ modèle, &#39;username&#39;) -> textInput ([&#39;maxLength&#39; => true])?>

Cela générera une étiquette, un champ de saisie et tout message d'erreur de validation automatiquement. Vous pouvez personnaliser le type d'entrée en fonction du type de données que vous collectez:

• textInput() - pour les entrées de texte régulières
• passwordInput() - pour les champs de mot de passe
• dropDownList() - pour les dropdowns
• checkbox() - pour les bo?tes à cocher
• fileInput() - Pour les téléchargements de fichiers (n'oubliez pas de définir enctype="multipart/form-data" dans la balise de formulaire)

Vous pourriez également vouloir ajouter des conseils ou des espaces réservés:

 <? = $ form-> field ($ modèle, &#39;email&#39;) -> textInput ([&#39;placeholder&#39; => &#39;you@example.com&#39;])?>
<? = $ Form-> Field ($ Model, &#39;Notes&#39;) -> TextArea ([&#39;Rows&#39; => 3])?>

Si vous travaillez avec des formulaires sans modèle (comme les formulaires de recherche), vous pouvez toujours utiliser ActiveForm , mais vous devrez passer un tableau simple ou un objet dynamique au lieu d'un modèle.

Soumettre le bouton et la validation

Une fois tous les champs en place, vous avez besoin d'un bouton de soumission. Utilisez Html::submitButton() pour en créer un:

 <? = Html :: soumebutton (&#39;soumider&#39;, [&#39;class&#39; => &#39;btn btn-primary&#39;])?>

La validation est gérée automatiquement si votre modèle a des règles définies. Par exemple, si votre modèle comprend:

 Règles de fonction publique ()
{
    Retour [
        [[?nom d'utilisateur?, ?e-mail?], ?requis?],
        [?e-mail?, ?e-mail?],
    ]]
}

Ensuite, le formulaire affichera des erreurs sous chaque champ pertinent lorsque la validation échoue.

Quelques conseils:

• Assurez-vous que votre contr?leur charge et enregistre correctement le modèle.
• Vérifiez toujours $model->load(Yii::$app->request->post()) && $model->validate() avant d'économiser.
• Si vous téléchargez des fichiers, n'oubliez pas d'inclure 'enctype' => 'multipart/form-data' dans les options de formulaire:

 <? php $ form = activeform :: begin ([&#39;options&#39; => [&#39;enctype&#39; => &#39;multipart / form-data&#39;]]); ?>

Style et personnalisation de la mise en page

Par défaut, ActiveForm génère un balisage compatible bootstrap si vous utilisez le bundle d'actifs bootstrap. Mais vous pouvez modifier l'apparence des champs en modifiant leurs modèles ou en les envelopvant dans un HTML personnalisé.

Par exemple, pour ajuster la disposition d'un champ spécifique:

 <? = $ form-> champ ($ modèle, &#39;d&#39;accord&#39;) -> checkbox () -> label (&#39;je suis d&#39;accord sur les termes&#39;)?>?>

Ou enveloppez les champs dans un système de grille:

 <div class = "row">
    <div class = "col-md-6">
        <? = $ Form-> Field ($ Model, &#39;First_name&#39;) -> textInput ()?>
    </div>
    <div class = "col-md-6">
        <? = $ form-> champ ($ modèle, &#39;last_name&#39;) -> textInput ()?>
    </div>
</div>

Si vous avez besoin de plus de contr?le, vous pouvez personnaliser le modèle de champ à l'échelle mondiale ou par champ:

 <? = $ form-> champ ($ modèle, ?nom d&#39;utilisateur?, [
    &#39;template&#39; => "{label} \ n <div class = \" personnalisé-Input \ "> {input} </ div> \ n {error}"
]) -> textInput ()?>

C'est le c?ur de travailler avec ActiveForm . Il vous donne un moyen propre de construire rapidement des formulaires tout en gardant la validation et le rendu cohérent. Assurez-vous simplement que vos modèles ont des règles appropriées et que vous gérez correctement les données dans vos contr?leurs.

Fondamentalement, c'est tout.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!