html form Télécharger - html form Téléchargement du code source

Formulaire HTML

Classes PHP légères pour générer des éléments HTML.

Ce package n'a aucune dépendance autre que php-5.4

Licence : MIT

Exigences

PHP 5.4.0 ou supérieur

Installation

Compositeur

Composer est un gestionnaire de dépendances largement utilisé pour les packages PHP. Ce formulaire HTML est disponible sur Packagist sous le nom user-meta/html et peut être installé en exécutant la commande composer require . Pour activer Composer pour votre projet, reportez-vous à la documentation de démarrage du projet.

Pour ajouter cette dépendance à l'aide de la commande, exécutez ce qui suit depuis le répertoire de votre projet :

 composer require user-meta/html

Commencer

Un exemple rapide de génération de saisie de texte avec Html-Form à l'aide de Composer :

 <?php
require __DIR__ . ' /vendor/autoload.php ' ;
use UserMeta  Html  Html ;
echo Html:: text ( ' example ' );

Sortir:

 < input type =" text " value =" example " />

Presque tous les types d’éléments HTML peuvent être utilisés. (ex : bouton, email, div, p etc)

 echo Html:: button ( ' Submit Me ' );
echo Html:: email ( ' example email ' );
echo Html:: div ( ' example text ' );
echo Html:: p ( ' example text ' );

Sortir:

 < input type =" button " value =" Submit Me " />
< input type =" email " value =" example email " />
< div > example text </ div >
< p > example text </ p >

Usage

Utilisation de base

Arguments acceptés

La plupart des éléments acceptent deux arguments :

$default : Valeur par défaut
$attributes : Tableau d'attributs
echo Html::text($default, attributes);

Pour les éléments d'options comme select, radio, il accepte le troisième argument comme $options

$options : Tableau d'options. Le tableau peut contenir une paire clé-valeur ou uniquement des valeurs
echo Html::select($default, attributes, $options);

en utilisant le nom, l'identifiant et la classe

Pour attribuer un nom, un identifiant, une classe ou tout autre attribut, utilisez un deuxième argument ( $attributes )

Un champ de texte avec les attributs valeur par défaut, nom, identifiant et classe :

 echo Html:: text ( ' Example_Value ' , [ ' name ' => ' Example_Name ' , ' id ' => ' Example_ID ' , ' class ' => ' Example_Class ' ]);

Sortir:

 < input type =" text " name =" Example_Name " value =" Example_Value " id =" Example_ID " class =" Example_Class " />

Ajouter des attributs à l'élément

Vous pouvez également ajouter n'importe quel attribut dans n'importe quel élément :

 echo Html:: text ( ' Example_Value ' , [ ' name ' => ' Example_Name ' , ' data-example ' => ' Example_Data ' ]);

Sortir:

 < input type =" text " name =" Example_Name " value =" Example_Value " data-example =" Example_Data " />

utilisation obligatoire, en lecture seule et désactivée

 echo Html:: email ( null , [ ' name ' => ' Email ' , ' required ' ]);
echo Html:: email ( null , [ ' name ' => ' Email ' , ' readonly ' ]);
echo Html:: email ( null , [ ' name ' => ' Email ' , ' disabled ' ]);

Sortir:

 < input type =" email " name =" Email " required =" required " />
< input type =" email " name =" Email " readonly =" readonly " />
< input type =" email " name =" Email " disabled =" disabled " />

Utiliser l'étiquette

 echo Html:: email ( null , [
    ' name ' => ' Example_Name ' ,
    ' label ' => ' Email '
]);

 echo Html:: email ( null , [
    ' name ' => ' Example_Name ' ,
    ' label ' => [
        ' Example ' ,
        ' class ' => ' Class '
    ]
]);

Sortir:

 < label > Email </ label >
< input type =" email " name =" Example_Name " />

 < label class =" Class " > Example </ label >
< input type =" email " name =" Example_Name " />

Un div avec les attributs id et class :

 echo Html:: div ( ' example text ' , [ ' id ' => ' Example_ID ' , ' class ' => ' Example_Class ' ]);

Sortir:

 < div id =" Example_ID " class =" Example_Class " > example text </ div >

lebel avec le texte de l'étiquette, l'identifiant, la classe et les attributs

 echo Html:: label ( ' Some text ' , [ ' id ' => ' ID ' , ' class ' => ' Class ' , ' for ' => ' For ' ]);

Sortir:

 < label id =" ID " class =" Class " for =" For " > Some text </ label >

Utiliser la case à cocher

Case à cocher simple avec cochée par défaut

 echo Html:: checkbox ( true , [ ' name ' => ' Name ' ]);
echo Html:: checkbox ( true , [ ' name ' => ' Name ' , ' value ' => ' Value ' ]);

Sortir:

 < input type =" checkbox " name =" Name " value =" 1 " checked =" checked " />
< input type =" checkbox " name =" Name " value =" Value " checked =" checked " />

Passez le premier argument comme faux pour que la valeur par défaut soit décochée. echo Html::checkbox(false)

Liste des cases à cocher

Créer une liste de cases à cocher avec des valeurs par défaut

 echo Html:: checkbox ( ' cat ' , [ ' name ' => ' Name ' , ' id ' => ' ID ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);
echo Html:: checkbox ([ ' cat ' ], [ ' name ' => ' Name ' , ' id ' => ' ID ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);

Sortir

 < label > < input type =" checkbox " value =" dog " name =" Name " id =" ID_1 " /> Dog </ label >
< label > < input type =" checkbox " value =" cat " name =" Name " id =" ID_2 " checked =" checked " /> Cat </ label >

Pour obtenir un tableau de valeurs par la méthode POST ou GET

 echo Html:: checkbox ([ ' cat ' ], [ ' name ' => ' Name[] ' , ' id ' => ' ID ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);

Sortir

 < label > < input type =" checkbox " value =" dog " name =" Name[] " id =" ID_1 " /> Dog </ label >
< label > < input type =" checkbox " value =" cat " name =" Name[] " id =" ID_2 " checked =" checked " /> Cat </ label >

Utilisation de la sélection / radio

Créer une sélection avec les attributs valeur par défaut, nom et identifiant

 echo Html:: select ([ ' cat ' ], [ ' name ' => ' Name ' ], [ ' dog ' => ' Dog ' , ' cat ' => ' Cat ' ]);
echo Html:: select ([ ' cat ' ], [ ' name ' => ' Name ' ], [ ' dog ' , ' cat ' ]);

Sortir

 < select name =" Name " >
    < option value =" dog " > Dog </ option >
    < option value =" cat " selected =" selected " > Cat </ option >
</ select >

< select name =" Name " >
    < option value =" dog " > dog </ option >
    < option value =" cat " selected =" selected " > cat </ option >
</ select >

Créer une liste de radios

 echo Html:: radio ([ ' cat ' ], [ ' name ' => ' Name ' , ' id ' => ' ID ' ], [ ' dog ' , ' cat ' ]);

Sortir

 < label > < input type =" radio " value =" dog " name =" Name " id =" ID_1 " /> dog </ label >
< label > < input type =" radio " value =" cat " name =" Name " id =" ID_2 " checked =" checked " /> cat </ label >

Utilisation de la collection

Plusieurs éléments peuvent être regroupés en collection

 $ div = new Html ( ' div ' );
$ div -> p ( ' Hello World ' );
$ div -> text ( ' example ' );
$ div -> add ( ' Some plain text ' );
echo $ div -> render ();

Sortir:

 < div >
    < p > Hello World </ p >
    < input type =" text " value =" example " />
    Some plain text
</ div >

La collection utilise le constructeur Html et accepte deux paramètres.

$type (facultatif) : nom de la balise. (par exemple formulaire, div)
$attributes (facultatif) : tableau d'attributs

Exemple de formulaire

Générer un formulaire à l'aide de collections :

 $ form = new Html ( ' form ' , [ ' method ' => ' POST ' ]);
$ form -> div ( ' Enter your email and password for login ' );
$ form -> email ( '' , [ ' name ' => ' email ' , ' label ' => ' Email ' ]);
$ form -> password ( '' , [ ' name ' => ' password ' , ' label ' => ' Password ' ]);
$ form -> submit ( ' login ' );
echo $ form -> render ();

Sortir:

 < form method =" POST " >
    < div > Enter your email and password for login </ div >
    < label > Email </ label >
    < input type =" email " name =" email " />
    < label > Password </ label >
    < input type =" password " name =" password " />
    < input type =" submit " value =" login " />
</ form >

Collections imbriquées

Génération d'un modèle HTML à l'aide de collections imbriquées :

 $ html = new Html ( ' html ' );
$ head = $ html -> import ( ' head ' );
$ head -> title ( ' Example Title ' );
$ body = $ html -> import ( ' body ' );
$ body -> p ( ' Hello World ' );
echo $ html -> render ();

 < html >
    < head >
        < title > Example Title </ title >
    </ head >
    < body >
        < p > Hello World </ p >
    </ body >
</ html >

Utiliser comme générateur XML

 $ book = new Html ( ' book ' );
$ book -> title ( ' The Da Vinci Code ' );
$ author = $ book -> import ( ' author ' );
$ author -> name ( ' Dan Brown ' );
$ author -> nationality ( ' American ' );
echo $ book -> render ();

Sortir

< book >
    < title >The Da Vinci Code</ title >
    < author >
        < name >Dan Brown</ name >
        < nationality >American</ nationality >
    </ author >
</ book >

Avancé

Il est possible de créer n'importe quel élément HTML en appelant son nom.

 echo Html:: email ( ' [email protected] ' );
echo Html:: h1 ( ' Example Heading ' );

Sous le capot, nous utilisons Html::input() pour l'élément d'entrée et Html::tag() pour la balise html.

Créez une entrée d'e-mail en utilisant la méthode input :

 echo Html:: input ( ' email ' , ' [email protected] ' );

Créez h1 en utilisant la méthode tag :

 echo Html:: tag ( ' h1 ' , ' Example Heading ' );

Ajouter du HTML aux éléments avant et après

 echo Html:: email ( '' , [ ' _before ' => ' Before ' , ' _after ' => ' After ' ]);

Sortir

Before < input type =" email " /> After

Joindre avec un autre élément.

 echo Html:: email ( '' , [ ' _enclose ' => ' div ' ]);
echo Html:: email ( '' , [ ' _enclose ' => [ ' div ' , ' class ' => ' Class ' ]]);

Sortir

 < div >
    < input type =" email " />
</ div >
< div class =" Class " >
    < input type =" email " />
</ div >

plusieurs façons de définir les options de sélection / multisélection / radio / case à cocher

 // Same value and label
echo Html:: select ( null , [], [ ' audi ' , ' bmw ' ]);

// Different value and label
echo Html:: select ( null , [], [ ' audi ' => ' Audi ' , ' bmw ' => ' BMW ' ]);

// Option with extra attributes
echo Html:: select ( null , [], [ ' ferrari ' => [ ' Ferrari ' , ' data-origin ' => ' Italy ' ]]);
echo Html:: select ( null , [], [[ ' value ' => ' ferrari ' , ' label ' => ' Ferrari ' , ' data-origin ' => ' Italy ' ]]);

Sortir

 < select > < option value =" audi " > audi </ option > < option value =" bmw " > bmw </ option > </ select >
< select > < option value =" audi " > Audi </ option > < option value =" bmw " > BMW </ option > </ select >
< select > < option value =" ferrari " data-origin =" Italy " > Ferrari </ option > </ select >
< select > < option value =" ferrari " data-origin =" Italy " > Ferrari </ option > </ select >

Mélanger de plusieurs manières avec un seul tableau d'options

 echo Html:: select ( null , [], [
    ' audi ' ,
    ' bmw ' => ' BMW ' ,
    ' honda ' => [
        ' Honda ' ,
        ' data-origin ' => ' Japan '
    ],
    [
        ' value ' => ' ferrari ' ,
        ' label ' => ' Ferrari ' ,
        ' data-origin ' => ' Italy '
    ]
]);

Sortir

 < select >
    < option value =" audi " > audi </ option >
    < option value =" bmw " > BMW </ option >
    < option value =" honda " data-origin =" Japan " > Honda </ option >
    < option value =" ferrari " data-origin =" Italy " > Ferrari </ option >
</ select >

Utiliser une valeur numérique

 echo Html:: select ( null , [], [ 2 => ' Two ' , 4 => ' Four ' ]);

Sortir

 < select >
    < option value =" 2 " > Two </ option >
    < option value =" 4 " > Four </ option >
</ select >

Sécurité

Sortie d'échappement

S'échapper signifie supprimer les données indésirables, telles que les balises HTML ou de script malformées.

La bibliothèque applique esc_attr à l'attribut value. esc_url vers les attributs href et src .

Développer