Helper HTML

Catégorie : Helpers
L'helper HTML a deux utilités. La première est d'éviter la répétition inutile et laborieuse de code, et la facilitation de la génération de formulaires.

La plupart des définitions de code HTML sont placées dans un fichier nommé tags.ini.php. Si vous souhaitez modifier ce fichier, il vous suffit de le copier depuis cake/config/tags.ini.php dans le dossier app/config/tags.ini.php. L'helper HTML utilise ce fichier pour générer les tags que vous demandez.

Il existe également une option dans le fichier de configuration de votre application (app/core/core.php), AUTO_OUTPUT qui, si elle est définie à true, permettra un affichage direct de la valeur retournée par votre helper. Sinon, vous devrez mettre l'echo dans votre vue.

Les fonctions de l'helper possèdent également un paramètre $htmlAttributes qui vous permet d'ajouter des paramètres à vos balises.
Par exemple,

array('class' => 'votreClasse');

donnera à l'attribut la classe votreClasse.

Insertion d'éléments pré-formatés
Voici une liste de fonction vous permettant d'insérer des éléments souvent et laborieusement répétés dans votre page :

  • charset

    • string $charset
    • boolean $return
Utilisé pour générer le charset de la page.

  • css
    • string $path
    • string $rel = 'stylesheet'
    • array $htmlAttributes
    • boolean $return = false
Crée un lien vers une feuille de style CSS

  • image

    • string $path
    • array $htmlAttributes
    • boolean $return = false
Retourne une image. L'élément peut être utilisé dans une fonction de l'helper rendant un lien.

  • link

    • string $title
    • string $url
    • array $htmlAttributes
    • string $confirmMessage = false
    • boolean $escapeTitle = true
    • boolean $return = false
Crée un lien. La variable $confirmMessage, si définie à une chaine de caractères, affichera le message de confirmation passé en paramètre avant de valider le clic sur le lien.

  • tableHeaders
    • array $names
    • array $tr_options
    • array $th_options
Crée un header de tableau.

  • tableCells

    • array $data
    • array $odd_tr_options
    • array $even_tr_options
Crée un ensemble de cellules d'un tableau

  • guilListTree

    • array $data
    • array $htmlAttributes
    • string $bodyKey = 'body'
    • string $childrenKey = 'children'
    • boolean $return = false
Génère une liste d'éléments depuis un tableau

Formulaires et validation
L'helper trouve réellement son utilité lorsqu'il vous permet d'améliorer votre code dans vos vues.
Il génère vos formulaires, remplit automatiquement les valeurs en cas de rechargement de la page, et affiche les erreurs générées.

Le nom des champs doit être au format modelName/fieldName.
Par exemple, pour un pseudonyme dans le modèle User, vous auriez :
<?php echo $html->input('User/username'); ?>

Liste des fonctions disponibles :
  • submit
    • string $buttonCaption
    • array $htmlAttributes
    • boolean $return = false
  • password

    • string $fieldName
    • array $htmlAttributes
    • boolean $return = false
  • textarea

    • string $fieldName
    • array $htmlAttributes
    • boolean $return = false
  • checkbox

    • string $fieldName
    • array $htmlAttributes
    • boolean $return = false
  • file

    • string $fieldName
    • array $htmlAttributes
    • boolean $return = false
  • hidden

    • string $fieldName
    • array $htmlAttributes
    • boolean $return = false
  • input

    • string $fieldName
    • array $htmlAttributes
    • boolean $return = false
  • radio

    • string $fieldName
    • array $options
    • array $inbetween
    • array $htmlAttributes
    • boolean $return = false
  • tagErrorMsg

    • string $fieldName
    • string $message




Identification

Statistiques

153 utilisateurs
32 articles
5 connectes

CakePHP-fr

Actualites

PHP 5.2.2 et PHP 4.4.7
L'équipe de développement de PHP ...
Poste le : 04/05/2007


Nouvelles version CakePHP
Deux nouvelles versions de Cake voient le jour ...
Poste le : 06/04/2007


PHP 4.4.6
L'équipe de développement de PHP ...
Poste le : 01/03/2007


Sortie de PHP 5.2.1
L'équipe de développement de PHP ...
Poste le : 09/02/2007


Cake 1.1.13.4450 et 1.2.0.4451alpha
PhpNut nous l'annonce aujourd'hui, les versions...
Poste le : 05/02/2007


Liens