Méthode append

htmlElement

public function append($item) : htmlTextNode

Description

La méthode append est une des méthodes clés de la classe htmlElement. A elle seule, elle fait toute la différence entre htmlTag et htmlElement puisqu'au lieu de simplement définir une balise HTML, htmlElement va pouvoir définir une arborescence DOM.

La valeur de retour de la fonction est l'objet inséré.

Voir aussi htmlDocument->append().

Usage

Le paramètre $item peut être au choix une simple chaîne de caractère qui sera insérée en tant que htmlTextNode ou un dérivé de htmlTag.

Si vous utiliser un texte simple, il sera transformé par la fonction PHP htmlspecialchars; si vous voulez intégrer directement du code HTML, il faudra passer par un htmlTextNode.

Exemple


<?php
  $div1 
$document->append(new htmlDiv('content'));

  
$div2 = new htmlDiv('sample');
  
$div2->append("Exemple <b> n'est pas une balise");
  
$div2->append(new htmlTextNode(', balise <b>gras</b>'));

  
$div1->append($div2);

Exemple <b> n'est pas une balise, balise gras

<div class="content">
 <div class="sample">
  Exemple &lt;b&gt; n'est pas une balise, balise <b>gras</b>
 </div>
</div>