From 37abde04d7f73ab4e3d89e7ba897db6bb77124c3 Mon Sep 17 00:00:00 2001
From: Sli <antoine@bartuccio.fr>
Date: Mon, 11 Nov 2024 13:56:34 +0100
Subject: [PATCH] Improve fragment doc

---
 docs/tutorial/fragments.md | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/docs/tutorial/fragments.md b/docs/tutorial/fragments.md
index 8f3c2ff3..3a2074d5 100644
--- a/docs/tutorial/fragments.md
+++ b/docs/tutorial/fragments.md
@@ -9,4 +9,32 @@ Pour remédier à cela, il existe le mixin [AllowFragment][core.views.AllowFragm
 Une fois ajouté à une vue Django, il ajoute le boolean `is_fragment` dans les
 templates jinja. Sa valeur est `True` uniquement si HTMX envoi la requette.
 Il est ensuite très simple de faire un if/else pour hériter de
-`core/base_fragment.jinja` au lieu de `core/base.jinja` dans cette situation.
\ No newline at end of file
+`core/base_fragment.jinja` au lieu de `core/base.jinja` dans cette situation.
+
+Exemple d'utilisation d'une vue avec fragment:
+
+```python
+from django.views.generic import TemplateView
+from core.views import AllowFragment
+
+class FragmentView(AllowFragment, TemplateView):
+	template_name = "my_template.jinja"
+```
+
+Exemple de template (`my_template.jinja`)
+```jinja
+{% if is_fragment %}
+  {% extends "core/base_fragment.jinja" %}
+{% else %}
+  {% extends "core/base.jinja" %}
+{% endif %}
+
+
+{% block title %}
+  {% trans %}My view with a fragment{% endtrans %}
+{% endblock %}
+
+{% block content %}
+  <h3>{% trans %}This will be a fragment when is_fragment is True{% endtrans %}
+{% endblock %}
+```