{% extends '00_bases/base.html.twig' %}

{% block title %}Twig{% endblock %}

{% block body %}
<div class="example-wrapper">

  <h1>Utilisation du bundle dans Twig</h1>
  <p class="-lg">Certaines fonctions ont été rajouté a Twig pour permettre la génération plus simple des listes.</p>

  <div class="oka-spacer -md"></div>

  <h3>Générer la liste</h3>

  <p>C'est la fonction de base: <code>renderlist</code>, elle prend en paramètre la liste après avoir été build et permet de générer tout le nécessaire: </p>
  <ul>
    <li>Les filtres (si le rendu des filtres est activé pour cette liste)</li>
    <li>Le tableau/les vignettes</li>
    <li>La pagination</li>
    <li>Le loader (si la liste est lazy loadé)</li>
  </ul>

  <h4>Générer les filtres</h4>

  <p>Parfois, il peut être nécessaire de devoir placer les filtres en dehors de la boîte proposé par le bundle tout en gardant la même forme.</p>
  <p>Il est possible d'afficher les filtres ailleurs grâce à : <code>renderfilters</code>, prennant en paramètre la liste après avoir été build, elle générera toute la div <code>oka-filters</code></p>

  <h4>Générer le bouton d'export</h4>

  <p>Il faut utiliser la fonction twig: <code>downloadButton(list)</code> ajoutant ainsi le bouton pour exporter la liste.</p>
  <p>Si besoin de récupérer l'url permettant l'export, il est possible d'utiliser la fonction <code>downloadUrl(list)</code></p>

  <h4>Afficher le nombre total d'élements dans la liste</h4>

  <p><code>list.count</code> permettra d'accéder grâce à la fonction count de la liste, le nombre d'élements total de la liste, sans filtres</p>

  <h4>Itérer les éléments de la liste affiché à l'écran</h4>

  <p>Il est parfois nécessaire de parcourir une nouvelle fois les élements de la liste pour rajouter des modals etc ...</p>
  <p>Cette liste pourra être obtenu grâce à <code>list.pager</code> qui retournera tout les élements actuels de la liste</p>

  <h4>Accéder aux éléments de la liste</h4>

  <p>Si besoin d'accéder au formulaire symfony / au pagerfanta, ils sont accessible grâce à : </p>
  <ul>
    <li><code>list.form</code> retourne le formulaire symfony des filtres</li>
    <li><code>list.pager</code> retourne l'instance de pagerfanta utilisé pour la pagination</li>
    <li><code>list.configuration.all</code> retourne la configuration actuelle appliqué à la liste.</li>
    <li><code>list.active</code> retourne un booléen indiquant si la liste a actuellement au moins un filtre de soumis.</li>
  </ul>
</div>


{% endblock %}