View & ExtendTags - QuentinBubu/bubu Wiki

Les vues et les balises supplémentaire

Vues

Pour appeler un template, vous pouvez appeler la class Page avec sa méthode show comme ceci: (new Page)->show('example');

Par défaut, le fichier appelé sera dans le dossier App/Views/templates. Il doit avoir l'extension .bubu.php.

Le chemin d'appel peut être modifier dans le fichier .env, au paramètre TEMPLATES.

L'on peut également spécifier un code HTTP et un message. Attention: vous pouvez spécifier un code HTTP sans message, mais vous ne pouvez pas spécifier un message sans code HTTP.

Pour pouvoir définir un code HTTP et un HTTP message, il vous suffira d'appeler les fonctions httpCode (param: int) et httpMessage (param: str). Vous DEVREZ appeler la fonction show en dernière! Ex: (new Page)->httpCode(201)->httpMessage('Hello World!')->show('home');.

Vous pourrez trouver le fichier src/Http/httpMessages.json où dedans vous pourrez définir en index un code HTTP et en valeur un message. Dans ce cas, vous n'aurez qu'à spécifier un code HTTP et le message sera automatiquement chargé.

Un message spécifié est prioritaire sur un message provenant du fichier httpMessages.json.

ExtendTags

Une liste de balises ont été ajoutés, dans votre page, vous pouvez ajouter simplement une liste de fonction. Le préfix par défaut de ces tags est +. Ce dernier est modifiable en changeant la variable prefix située dans src/ExtendHtmlTags/ExtendHtmlTags.php.

Vous pouvez ajouter un fichier css ou js avec cette méthode: +css('css/style').

Par défaut, le fichier sera cherché dans public/assets/. L'extension est ajoutée automatiquement. Il est de même pour les fichiers javascript.

Pour ajouter une image, vous pouvez faire +picture('image/monImage.png'). Ici, l'extension du fichier est requise!

Attributs

Il est possible de rajouter des attributs en les séparant par des |, ce qui peut donner: +js('js/main')|defer| ou encore +picture('img/monImage.png')|alt="Image"|.

Flash

Vous avez également la possibilité d'ajouter des messages flash. Tous vos messages flash seront affichés là où le tag +flash sera.

Incluable

Vous pouvez inclure des fichiers. Par défaut vous pouvez inclure que les fichier se trouvant dans le dossier App/Views/incluable; ce paramètre est modifiable dans le fichier .env, au paramètre INCLUABLE.

Pour inclure un fichier, il suffit de faire +include('MonFichier'). Le fichier doit avoir l'extension .bubu.php.

Variables

Vous pouvez ajouter facilement des variables dans votre script. Une fois définie auparavant, il vous suffira de faire +||myVariable|| pour inclure une variable avec la protection htmlspecialchars (ce qui équivaut en PHP à <?= htmlspecialchars($myvariable) ?>).

Vous avez également la possibilité d'inclure des variables sans la protection en faisant +|!myVariable!|. Ici, il n'y aura pas la protection htmlspecialchars.