class FormBuilder (View source)

Créer un formulaire conforme aux spécificités de HTML5.

Properties

protected string[] $attributesCss Attributs CSS.
protected string[] $attributesUnique Attributs HTML sans clés.
protected string[] $baliseGroup Balises autorisées pour les groupes de formulaire.
protected string[] $typeInputBasic Types des champs standards.
protected array $form Attributs du formulaire.
protected array $errors Messages d'erreurs.
protected array $success Messages de réussites.

Methods

__construct(array $attributes)

Déclare l'ouverture du formulaire.

$this
__call(string $type, array $arg)

Enregistre un input s'il est dans la liste des inputs standards.

$this
addBefore(string $key, callable $callback)

Ajoute un ou plusieurs inputs avant un élément existant.

$this
addAfter(string $key, callable $callback)

Ajoute un ou plusieurs inputs après un élément existant.

array
getForm()

Retourne les paramètres du formulaire.

string
renderForm()

Génère au format html le formulaire.

$this
openForm(array $attr = null)

Enregistre l'ouverture du formulaire.

$this
html(string $name, string $html, array $attr = null)

Enregistre une balise HTML. Exemple : :_content

$this
group(string $name, string $balise, callable $callback, array|null $attr = null)

Enregistre un groupe d'input.

$this
label(string $name, string $label, array $attr = null)

Enregistre un label.

$this
legend(string $name, string $legend, array $attr = null)

Enregistre une legende.

$this
textarea(string $name, string $id, string $content = '', array $attr = null)

Enregistre un textarea.

$this
select(string $name, string $id, array $options = [], array $attr = null)

Enregistre une liste de sélection.

$this
inputBasic(string $type, string $name, string $id, array $attr = null)

Enregistre un input standard.

$this
submit(string $name, string $value, array $attr = null)

Enregistre un submit.

$this
token()

Enregistre un token pour protéger des failles CRSF.

string
form_open(array $attrAdd = null)

Génère une balise formulaire ouvrante.

string
form_close()

Génère une balise form fermante.

string
form_label(string $key, array $attrAdd = null)

Génère une balise label.

string
form_legend(string $key, array $attrAdd = null)

Génère une balise legend.

string
form_input(string $key, array $attrAdd = null)

Génère une balise input standard.

string
form_select(string $key, array $attrAdd = null)

Génère une balise select.

string
form_textarea(string $key, array $attrAdd = null)

Génère une balise textarea.

string
form_group(string $key, array $attrAdd = null)

Génère une balise group.

string
form_html(string $key, array $attrAdd = null)

Génère une balise HTML.

string
form_token()

Génère une balise input hidden pour le token.

array
form_errors()

Retourne le tableau d'erreurs.

array
form_success()

Retourne le tableau des succès.

$this
setErrors(array $errs)

Ajoute les erreurs.

$this
addError(string $err)

Rajoute une erreur.

$this
addErrors(array $errs)

Rajoute plusieurs erreurs.

$this
setSuccess(array $success)

Ajoute les success.

$this
addSuccess(string $success)

Rajoute un success.

$this
addAttr(string $key, array $attr)

Ajoute à un élément du formulaire une liste d'attributs.

$this
addAttrs(array $keys, array $attr)

Ajoute à plusieurs éléments une liste d'attributs.

array
getItem(string $key)

Retourne un item du formulaire à partir de sa clé.

string
renderSubForm()

Génère un sous formulaire sans les balises d'ouverture et de fermeture.

string
renderInput(string $key, array $input)

Génère les inputs.

$this
input(string $name, array $attr)

Enregistre un input.

string
getAttributesCSS(array $attr)

Met en forme les attributs CSS pour les balises.

string
getAttributesInput(array $attr)

Met en forme les attributs pour les balises inputs standards.

array
merge_attr(array $tab1 = null, array $tab2 = null, bool $crushed = false)

Fusionne 2 tableaux sans écrasement de données si l'un des 2 est vide.

bool
isRequired(string $key)

Si une balise est requise.

bool
addAttrRecurses(string $key, array $attr)

Recherche récursive d'un élément du formulaire à partir de sa clé et lui ajoute une liste des attributs.

array|null
searchItem(string $key)

Recherche récursive d'un élément du formulaire à partir de sa clé.

Details

__construct(array $attributes)

Déclare l'ouverture du formulaire.

Parameters

array $attributes

$this __call(string $type, array $arg)

Enregistre un input s'il est dans la liste des inputs standards.

Parameters

string $type Type de l'input.
array $arg [$name, id, array attr = null]

Return Value

$this

Exceptions

BadMethodCallException Le type de champ d'existe pas.

$this addBefore(string $key, callable $callback)

Ajoute un ou plusieurs inputs avant un élément existant.

Parameters

string $key Clé unique.
callable $callback Fonction de création du sous-formulaire.

Return Value

$this

Exceptions

Exception L'élément n'a pas été trouvé.

$this addAfter(string $key, callable $callback)

Ajoute un ou plusieurs inputs après un élément existant.

Parameters

string $key Clé unique.
callable $callback Fonction de création du sous-formulaire.

Return Value

$this

Exceptions

Exception L'élément n'a pas été trouvé.

array getForm()

Retourne les paramètres du formulaire.

Return Value

array

string renderForm()

Génère au format html le formulaire.

Return Value

string HTML

$this openForm(array $attr = null)

Enregistre l'ouverture du formulaire.

Parameters

array $attr Attributs de la balise form.

Return Value

$this

$this html(string $name, string $html, array $attr = null)

Enregistre une balise HTML. Exemple : :_content

Parameters

string $name Clé unique.
string $html La balise HTML à utiliser.
array $attr Liste d'attributs.

Return Value

$this

$this group(string $name, string $balise, callable $callback, array|null $attr = null)

Enregistre un groupe d'input.

Parameters

string $name Nom du groupe.
string $balise Type de balise (div|span|fieldset).
callable $callback Fonction de création du sous-formulaire.
array|null $attr Liste d'attributs.

Return Value

$this

$this label(string $name, string $label, array $attr = null)

Enregistre un label.

Parameters

string $name Clé unique.
string $label Texte à afficher.
array $attr Liste d'attributs.

Return Value

$this

$this legend(string $name, string $legend, array $attr = null)

Enregistre une legende.

Parameters

string $name Clé unique.
string $legend Texte à afficher.
array $attr Liste d'attributs.

Return Value

$this

$this textarea(string $name, string $id, string $content = '', array $attr = null)

Enregistre un textarea.

Parameters

string $name Clé unique.
string $id Selecteur CSS.
string $content Contenu du textarea.
array $attr Liste d'attributs.

Return Value

$this

$this select(string $name, string $id, array $options = [], array $attr = null)

Enregistre une liste de sélection.

Parameters

string $name Clé unique.
string $id Selecteur CSS.
array $options Liste d'options [ 'value'=>'', 'label'=>'','selected' => 0|1 ].
array $attr Liste d'attributs.

Return Value

$this

$this inputBasic(string $type, string $name, string $id, array $attr = null)

Enregistre un input standard.

Parameters

string $type Type d'input.
string $name Clé unique.
string $id Selecteur CSS.
array $attr Liste d'attributs.

Return Value

$this

$this submit(string $name, string $value, array $attr = null)

Enregistre un submit.

Parameters

string $name Clé unique.
string $value Texte à afficher.
array $attr Liste d'attributs.

Return Value

$this

$this token()

Enregistre un token pour protéger des failles CRSF.

Return Value

$this

string form_open(array $attrAdd = null)

Génère une balise formulaire ouvrante.

Parameters

array $attrAdd Liste des attributs additionnels.

Return Value

string HTML

string form_close()

Génère une balise form fermante.

Return Value

string HTML

string form_label(string $key, array $attrAdd = null)

Génère une balise label.

Parameters

string $key Clé unique.
array $attrAdd Liste d'attributs additionnels.

Return Value

string HTML

string form_legend(string $key, array $attrAdd = null)

Génère une balise legend.

Parameters

string $key Clé unique.
array $attrAdd Liste d'attributs additionnels.

Return Value

string HTML

string form_input(string $key, array $attrAdd = null)

Génère une balise input standard.

Parameters

string $key Clé unique.
array $attrAdd Liste des attributs additionnels.

Return Value

string HTML

string form_select(string $key, array $attrAdd = null)

Génère une balise select.

Parameters

string $key Clé unique.
array $attrAdd Liste des attributs additionnels.

Return Value

string HTML

string form_textarea(string $key, array $attrAdd = null)

Génère une balise textarea.

Parameters

string $key Clé unique.
array $attrAdd Liste des attributs additionnels.

Return Value

string HTML

string form_group(string $key, array $attrAdd = null)

Génère une balise group.

Parameters

string $key Clé unique.
array $attrAdd Liste des attributs additionnels.

Return Value

string HTML

string form_html(string $key, array $attrAdd = null)

Génère une balise HTML.

Parameters

string $key Clé unique.
array $attrAdd Liste des attributs additionnels.

Return Value

string HTML

string form_token()

Génère une balise input hidden pour le token.

Return Value

string HTML

array form_errors()

Retourne le tableau d'erreurs.

Return Value

array Les erreurs.

array form_success()

Retourne le tableau des succès.

Return Value

array Les succès.

$this setErrors(array $errs)

Ajoute les erreurs.

Parameters

array $errs

Return Value

$this

$this addError(string $err)

Rajoute une erreur.

Parameters

string $err

Return Value

$this

$this addErrors(array $errs)

Rajoute plusieurs erreurs.

Parameters

array $errs

Return Value

$this

$this setSuccess(array $success)

Ajoute les success.

Parameters

array $success

Return Value

$this

$this addSuccess(string $success)

Rajoute un success.

Parameters

string $success

Return Value

$this

$this addAttr(string $key, array $attr)

Ajoute à un élément du formulaire une liste d'attributs.

Parameters

string $key Clé unique.
array $attr Liste des attributs.

Return Value

$this

Exceptions

Exception L'élément n'a pas été trouvé.

$this addAttrs(array $keys, array $attr)

Ajoute à plusieurs éléments une liste d'attributs.

Parameters

array $keys Liste de clé.
array $attr Liste des attributs.

Return Value

$this

array getItem(string $key)

Retourne un item du formulaire à partir de sa clé.

Parameters

string $key Clé unique.

Return Value

array Les données de l'élément.

Exceptions

Exception L'élément n'a pas été trouvé.

protected string renderSubForm()

Génère un sous formulaire sans les balises d'ouverture et de fermeture.

Return Value

string HTML

protected string renderInput(string $key, array $input)

Génère les inputs.

Parameters

string $key Clé unique.
array $input Paramètres du champ.

Return Value

string HTML

protected $this input(string $name, array $attr)

Enregistre un input.

Parameters

string $name Clé unique.
array $attr Options des champs et attributs de la balise.

Return Value

$this

protected string getAttributesCSS(array $attr)

Met en forme les attributs CSS pour les balises.

Parameters

array $attr Listes des attributs enregistrés.

Return Value

string

protected string getAttributesInput(array $attr)

Met en forme les attributs pour les balises inputs standards.

Parameters

array $attr Listes des attributs enregistrés.

Return Value

string

protected array merge_attr(array $tab1 = null, array $tab2 = null, bool $crushed = false)

Fusionne 2 tableaux sans écrasement de données si l'un des 2 est vide.

Parameters

array $tab1
array $tab2
bool $crushed

Return Value

array Fusion des 2 tableaux.

protected bool isRequired(string $key)

Si une balise est requise.

Parameters

string $key Clé unique.

Return Value

bool

protected bool addAttrRecurses(string $key, array $attr)

Recherche récursive d'un élément du formulaire à partir de sa clé et lui ajoute une liste des attributs.

Parameters

string $key Clé unique.
array $attr Liste des attributs à ajouter.

Return Value

bool

protected array|null searchItem(string $key)

Recherche récursive d'un élément du formulaire à partir de sa clé.

Parameters

string $key Clé unique.

Return Value

array|null Les données de l'élément recherché.