saisies_manipuler.php
Gestion de la manipulation des saisies.
Table of Contents
Functions
- saisies_supprimer() : array<string|int, mixed>
- Supprimer une saisie dont on donne l'identifiant, le nom ou le chemin.
- saisies_inserer() : array<string|int, mixed>
- Insère une saisie à une position donnée dans un tableau de donnée - soit en lui passant un chemin - soit en lui passant une saisie devant laquelle se placer
- saisies_inserer_avant() : array<string|int, mixed>
- Insère une saisie avant une autre saisie.
- saisies_inserer_apres() : array<string|int, mixed>
- Insère une saisie après une autre saisie.
- saisies_inserer_selon_chemin() : array<string|int, mixed>
- Insère une saisie à une position donnée, en lui passant un chemin.
- saisies_dupliquer() : array<string|int, mixed>
- Duplique une saisie (ou groupe de saisies) en placant la copie à la suite de la saisie d'origine.
- saisies_deplacer() : array<string|int, mixed>
- Déplace une saisie existante autre part.
- saisies_deplacer_avant() : array<string|int, mixed>
- Déplacer une saisie existante avant une autre
- saisies_deplacer_apres() : array<string|int, mixed>
- Déplacer une saisie existante après une autre
- saisies_modifier() : array<string|int, mixed>
- Modifie une saisie.
- saisies_transformer_noms() : array<string|int, mixed>
- Transforme tous les noms du formulaire avec un preg_replace.
- saisies_encapsuler_noms() : array<string|int, mixed>
- Transforme tous les noms en les encapsulant avec un préfixe.
- saisies_transformer_option() : array<string|int, mixed>
- Transforme toutes les options textuelles d'un certain nom, avec un preg_replace.
- saisies_mapper_option() : array<string|int, mixed>
- Modifie toutes les options d'un certain nom, avec une fonction de rappel.
- saisies_supprimer_option() : array<string|int, mixed>
- Supprime toutes les options d'un certain nom.
- saisies_mapper_verifier() : array<string|int, mixed>
- Modifie les vérifications des saisies avec une fonction de rappel
- saisies_transformer_noms_auto() : array<string|int, mixed>
- Transforme les noms d'une liste de saisies pour qu'ils soient uniques dans le formulaire donné.
- saisies_inserer_html() : array<string|int, mixed>
- Insère du HTML au début ou à la fin d'une saisie.
- saisies_fieldsets_en_onglets() : array<string|int, mixed>
- Ajoute l'option onglet aux fieldset de premier niveau dans un tableau de $saisie Ajoute également un identifiant unique, éventuellement préfixé
- saisies_supprimer_sans_reponse() : array<string|int, mixed>
- Prend un tableau de saisies Enlève les saisies qui n'ont rien dans _request Ou dont l'ensemble des sous-saisies sont vides
- saisies_saisie_possede_reponse() : bool
- Indique si une saisie possède une réponse
- saisies_supprimer_depublie() : array<string|int, mixed>
- Prend un tableau de saisies Enlève les saisies dépubliées Ou dont l'ensemble des sous-saisies sont dépubliés
- saisies_supprimer_depublie_sans_reponse() : array<string|int, mixed>
- Prend un tableau de saisies Enlève les saisies dépubliées Et qui n'ont pas de réponse Ou dont l'ensemble des saisies répondent au critère ci-dessus
- saisies_supprimer_callback() : array<string|int, mixed>
- Prend un tableau de saisies supprime les saisies selon une fonction de rappel
- saisies_wrapper_fieldset() : array<string|int, mixed>
- Transforme un tableau de saisies en englobant le tout dans un fieldset utilisé pour la prévisualisation
Functions
saisies_supprimer()
Supprimer une saisie dont on donne l'identifiant, le nom ou le chemin.
saisies_supprimer(array<string|int, mixed> $saisies, string|array<string|int, mixed> $id_ou_nom_ou_chemin) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Tableau des descriptions de saisies
- $id_ou_nom_ou_chemin : string|array<string|int, mixed>
-
L'identifiant unique ou le nom de la saisie à supprimer ou son chemin sous forme d'une liste de clés
Return values
array<string|int, mixed> —Tableau modifié décrivant les saisies
saisies_inserer()
Insère une saisie à une position donnée dans un tableau de donnée - soit en lui passant un chemin - soit en lui passant une saisie devant laquelle se placer
saisies_inserer(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie[, array<string|int, mixed>|string $id_ou_nom_ou_chemin = [] ]) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Tableau des descriptions de saisies
- $saisie : array<string|int, mixed>
-
Description de la saisie à insérer
- $id_ou_nom_ou_chemin : array<string|int, mixed>|string = []
-
- Si array c'est un chemin Position complète où insérer la saisie - Si directement à la racine du tableau : array(<index_où_inserer>) - Si au sein d'un fieldset ou assimilé : array(<index_du _fieldset>, 'saisies', <index_où_inserer_au_sein_du_fieldset>)
- Si string
- Si entre crochets, ca veut dire qu'on insère à la fin d'un fieldset
[fieldset]
- Si entre crochets, suivis d'un entier entre crochet, on insère à une position données dans le fieldset
[fieldset][0]
- Si pas de crochet, on insère avant la saisie
saisie
- Si entre crochets, ca veut dire qu'on insère à la fin d'un fieldset
- En absence, insère la saisie à la fin.
Return values
array<string|int, mixed> —Tableau des saisies complété de la saisie insérée
saisies_inserer_avant()
Insère une saisie avant une autre saisie.
saisies_inserer_avant(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie, array<string|int, mixed> $id_ou_nom_ou_chemin) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Tableau des descriptions de saisies
- $saisie : array<string|int, mixed>
-
Description de la saisie à insérer
- $id_ou_nom_ou_chemin : array<string|int, mixed>
-
identifiant ou nom ou chemin de la saisie devant laquelle inserer
Return values
array<string|int, mixed> —Tableau des saisies complété de la saisie insérée
saisies_inserer_apres()
Insère une saisie après une autre saisie.
saisies_inserer_apres(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie, array<string|int, mixed> $id_ou_nom_ou_chemin) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Tableau des descriptions de saisies
- $saisie : array<string|int, mixed>
-
Description de la saisie à insérer
- $id_ou_nom_ou_chemin : array<string|int, mixed>
-
identifiant ou nom ou chemin de la saisie derrière laquelle inserer
Return values
array<string|int, mixed> —Tableau des saisies complété de la saisie insérée
saisies_inserer_selon_chemin()
Insère une saisie à une position donnée, en lui passant un chemin.
saisies_inserer_selon_chemin(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie[, array<string|int, mixed> $chemin = [] ]) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Tableau des descriptions de saisies
- $saisie : array<string|int, mixed>
-
Description de la saisie à insérer
- $chemin : array<string|int, mixed> = []
-
Position complète où insérer la saisie
- Si directement à la racine du tableau : array(<index_où_inserer>)
- Si au sein d'un fieldset ou assimilé : array(<index_du _fieldset>, 'saisies', <index_où_inserer_au_sein_du_fieldset>) En absence, insère la saisie à la fin.
Return values
array<string|int, mixed> —Tableau des saisies complété de la saisie insérée
saisies_dupliquer()
Duplique une saisie (ou groupe de saisies) en placant la copie à la suite de la saisie d'origine.
saisies_dupliquer(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin) : array<string|int, mixed>
Modifie automatiquement les identifiants des saisies.
Parameters
- $saisies : array<string|int, mixed>
-
Un tableau décrivant les saisies
- $id_ou_nom_ou_chemin : unknown_type
-
L'identifiant unique ou le nom ou le chemin de la saisie a dupliquer
Return values
array<string|int, mixed> —Retourne le tableau modifié des saisies
saisies_deplacer()
Déplace une saisie existante autre part.
saisies_deplacer(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin, string $ou[, string $avant_ou_apres = 'avant' ]) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Un tableau décrivant les saisies
- $id_ou_nom_ou_chemin : unknown_type
-
L'identifiant unique ou le nom ou le chemin de la saisie à déplacer
- $ou : string
-
- Le nom de la saisie devant laquelle on déplacera
- OU le nom d'un conteneur entre crochets [conteneur] (et dans ce cas on déplace à la fin de conteneur)
- OU le nom d'un conteneur entre crochets suivi d'un identifiant numérique entre crochets [conteneur][x] (et dans ce cas on déplace à la position x au sein du conteneur)
- $avant_ou_apres : string = 'avant'
-
(optionel) : valeur possible :
'avant'
ou'apres'
, pour inserer respectivent avant/après la saisie$ou
Return values
array<string|int, mixed> —Retourne le tableau modifié des saisies
saisies_deplacer_avant()
Déplacer une saisie existante avant une autre
saisies_deplacer_avant(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin, string $ou) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Un tableau décrivant les saisies
- $id_ou_nom_ou_chemin : unknown_type
-
L'identifiant unique ou le nom ou le chemin de la saisie à déplacer
- $ou : string
-
la saisie devant laquelle déplacer
Tags
Return values
array<string|int, mixed> —$string
saisies_deplacer_apres()
Déplacer une saisie existante après une autre
saisies_deplacer_apres(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin, string $ou) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Un tableau décrivant les saisies
- $id_ou_nom_ou_chemin : unknown_type
-
L'identifiant unique ou le nom ou le chemin de la saisie à déplacer
- $ou : string
-
la saisie devant laquelle déplacer
Tags
Return values
array<string|int, mixed> —$string
saisies_modifier()
Modifie une saisie.
saisies_modifier(array<string|int, mixed> $saisies, array<string|int, mixed>|string $id_ou_nom_ou_chemin, array<string|int, mixed> $modifs[, bool $fusion = false ]) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Un tableau décrivant les saisies
- $id_ou_nom_ou_chemin : array<string|int, mixed>|string
-
L'identifiant unique ou le nom ou le chemin de la saisie à modifier
- $modifs : array<string|int, mixed>
-
Le tableau des modifications à apporter à la saisie
- $fusion : bool = false
-
True si on veut simplifier rajouter des choses, sans tout remplacer
Return values
array<string|int, mixed> —Retourne le tableau décrivant les saisies, mais modifié
saisies_transformer_noms()
Transforme tous les noms du formulaire avec un preg_replace.
saisies_transformer_noms(array<string|int, mixed> $saisies, string $masque, string $remplacement) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Un tableau décrivant les saisies
- $masque : string
-
Ce que l'on doit chercher dans le nom
- $remplacement : string
-
Ce par quoi on doit remplacer
Return values
array<string|int, mixed> —Retourne le tableau modifié des saisies
saisies_encapsuler_noms()
Transforme tous les noms en les encapsulant avec un préfixe.
saisies_encapsuler_noms(array<string|int, mixed> $saisies, string $prefixe[, bool $recursif = true ]) : array<string|int, mixed>
Cela permet d'avoir toutes les valeurs postées dans un unique tableau.
Après transformation, on pourra faire _request(<prefixe>)
pour les récupérer.
Utilisation possible : on mélange les saisies de plusieurs formulaires, et on a dans ce cas besoin de cloisonner les valeurs.
Parameters
- $saisies : array<string|int, mixed>
-
Un tableau décrivant les saisies
- $prefixe : string
-
Préfixe
- $recursif : bool = true
-
Pour procéder récursivement dans les fieldsets
Tags
Return values
array<string|int, mixed>saisies_transformer_option()
Transforme toutes les options textuelles d'un certain nom, avec un preg_replace.
saisies_transformer_option(mixed $saisies, mixed $option, mixed $masque, mixed $remplacement[, bool $recursif = true ]) : array<string|int, mixed>
Parameters
- $saisies : mixed
-
Tableau décrivant les saisies
- $option : mixed
-
Nom de l'option à transformer (par ex "nom", ou "afficher_si"), ou tableau Note : si l'option n'existe pas, elle est automatiquement mise à
''
avant toute transformation - $masque : mixed
-
Ce que l'on doit chercher dans le texte
- $remplacement : mixed
-
Ce par quoi on doit remplacer
- $recursif : bool = true
Return values
array<string|int, mixed> —Retourne le tableau modifié des saisies
saisies_mapper_option()
Modifie toutes les options d'un certain nom, avec une fonction de rappel.
saisies_mapper_option(array<string|int, mixed> $saisies, string|array<string|int, mixed> $options, string $callback[, array<string|int, mixed> $args = [] ][, bool $recursif = true ]) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Tableau décrivant les saisies
- $options : string|array<string|int, mixed>
-
Nom de l'option à transformer (par ex "nom", ou "afficher_si") Ou tableau de noms Note : si l'option n'existe pas, elle est automatiquement mise à
''
avant toute transformation - $callback : string
-
Nom de la fonction à appliquer
- $args : array<string|int, mixed> = []
-
Arguments de la fonction de rappel La valeur de l'option est passée automatiquement en premier
- $recursif : bool = true
-
=True
Return values
array<string|int, mixed> —Retourne le tableau modifié des saisies
saisies_supprimer_option()
Supprime toutes les options d'un certain nom.
saisies_supprimer_option(mixed $saisies, mixed $option[, bool $recursif = true ]) : array<string|int, mixed>
Parameters
- $saisies : mixed
-
Tableau décrivant les saisies
- $option : mixed
-
Nom de l'option à supprimer (par ex "nom", ou "afficher_si")
- $recursif : bool = true
Return values
array<string|int, mixed> —Retourne le tableau modifié des saisies
saisies_mapper_verifier()
Modifie les vérifications des saisies avec une fonction de rappel
saisies_mapper_verifier(array<string|int, mixed> $saisies, string $callback[, array<string|int, mixed> $args = [] ][, bool $recursif = true ]) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
Tableau décrivant les saisies
- $callback : string
-
Nom de la fonction à appliquer, elle doit retourner la nouvelle version du tableau de vérification
- Les vérifs telles que disponibles actuellement sont passées en premier (on modifie donc l'ensemble des vérifications, charge à la fonction de rappel de choisir quelle vérification modifier). Toutefois le tableau de vérification est normalisé pour utiliser uniquement la "nouvelle" syntaxe permettant d'avoir plusieurs vérifications
- La description complète de la saisie est passée en second
- $args : array<string|int, mixed> = []
-
Arguments supplémentaires passées à la fonction de rappel
- $recursif : bool = true
-
=True
Return values
array<string|int, mixed> —Retourne le tableau modifié des saisies
saisies_transformer_noms_auto()
Transforme les noms d'une liste de saisies pour qu'ils soient uniques dans le formulaire donné.
saisies_transformer_noms_auto(array<string|int, mixed> $formulaire, array<string|int, mixed> $saisies) : array<string|int, mixed>
Parameters
- $formulaire : array<string|int, mixed>
-
Le formulaire à analyser
- $saisies : array<string|int, mixed>
-
Un tableau décrivant les saisies.
Return values
array<string|int, mixed> —Retourne le tableau modifié des saisies
saisies_inserer_html()
Insère du HTML au début ou à la fin d'une saisie.
saisies_inserer_html(array<string|int, mixed> $saisie, string $insertion[, string $ou = 'fin' ]) : array<string|int, mixed>
Parameters
- $saisie : array<string|int, mixed>
-
La description d'une seule saisie
- $insertion : string
-
Du code HTML à insérer dans la saisie
- $ou : string = 'fin'
-
L'endroit où insérer le HTML : "debut" ou "fin"
Return values
array<string|int, mixed> —Retourne la description de la saisie modifiée
saisies_fieldsets_en_onglets()
Ajoute l'option onglet aux fieldset de premier niveau dans un tableau de $saisie Ajoute également un identifiant unique, éventuellement préfixé
saisies_fieldsets_en_onglets(array<string|int, mixed> $saisies[, string $identifiant_prefixe = '' ][, bool $vertical = false ]) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
- $identifiant_prefixe : string = ''
- $vertical : bool = false
Return values
array<string|int, mixed> —$saisies modifiées
saisies_supprimer_sans_reponse()
Prend un tableau de saisies Enlève les saisies qui n'ont rien dans _request Ou dont l'ensemble des sous-saisies sont vides
saisies_supprimer_sans_reponse(array<string|int, mixed> $saisies[, optional $tableau = null ]) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
- $tableau : optional = null
-
(tableau pour chercher dans request)
Return values
array<string|int, mixed>saisies_saisie_possede_reponse()
Indique si une saisie possède une réponse
saisies_saisie_possede_reponse(array<string|int, mixed> $saisie[, null|array<string|int, mixed> $tableau = null ]) : bool
Parameters
- $saisie : array<string|int, mixed>
-
la saisie individuelle
- $tableau : null|array<string|int, mixed> = null
-
(tableau pour chercher les valeurs, à défaut request
Return values
boolsaisies_supprimer_depublie()
Prend un tableau de saisies Enlève les saisies dépubliées Ou dont l'ensemble des sous-saisies sont dépubliés
saisies_supprimer_depublie(array<string|int, mixed> $saisies) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
Return values
array<string|int, mixed>saisies_supprimer_depublie_sans_reponse()
Prend un tableau de saisies Enlève les saisies dépubliées Et qui n'ont pas de réponse Ou dont l'ensemble des saisies répondent au critère ci-dessus
saisies_supprimer_depublie_sans_reponse(array<string|int, mixed> $saisies[, array<string|int, mixed>|null $reponses = null ]) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
- $reponses : array<string|int, mixed>|null = null
-
null pour chercher dans _request
Return values
array<string|int, mixed>saisies_supprimer_callback()
Prend un tableau de saisies supprime les saisies selon une fonction de rappel
saisies_supprimer_callback(array<string|int, mixed> $saisies, callable $callback) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
-
tableau de saisies
- $callback : callable
-
fonction de rappel la fonction doit renvoyer
true
si on garde,false
sinon
Return values
array<string|int, mixed>saisies_wrapper_fieldset()
Transforme un tableau de saisies en englobant le tout dans un fieldset utilisé pour la prévisualisation
saisies_wrapper_fieldset(array<string|int, mixed> $saisies, array<string|int, mixed> $options) : array<string|int, mixed>
Parameters
- $saisies : array<string|int, mixed>
- $options : array<string|int, mixed>
-
du fieldset