Ajoute l'alignement vertical du contenu d'une page, réglable depuis l'onglet "Pages"
Nouvelle colonne _document_pages.vertical_align (top/center/bottom,
"top" par défaut, migration incluse pour les supports existants).
Quand l'onglet "Pages" du panneau gauche est actif, le panneau
Propriétés (droite) affiche maintenant l'alignement de la page active
au lieu des propriétés d'un élément — un contrôle segmenté qui persiste
via une nouvelle route dédiée et met à jour le canevas immédiatement.
Le contenu-seed des thèmes porte désormais aussi ce réglage par page
(seed_pages devient une liste de {vertical_align, blocks} plutôt qu'une
liste de listes de blocs) : la page de titre du thème "Sécurité
Incendie" est centrée verticalement, comme demandé, cohérente avec la
maquette d'origine. L'aperçu de thème (iframe de la modale) reflète
aussi ce réglage par page.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
william
co-authored by
Claude Sonnet 5
Claude Sonnet 5
parent
be62275675
commit
746feb3796
@@ -39,6 +39,7 @@ def create_support(name: str, owner_folder: str) -> str:
|
||||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||
title TEXT NOT NULL DEFAULT 'Page 1',
|
||||
order_index INTEGER NOT NULL DEFAULT 0,
|
||||
vertical_align TEXT NOT NULL DEFAULT 'top',
|
||||
created_at TEXT DEFAULT CURRENT_TIMESTAMP
|
||||
);
|
||||
|
||||
|
||||
@@ -24,6 +24,15 @@ def ensure_document_pages_schema(slug: str) -> None:
|
||||
if page_count == 0:
|
||||
conn.execute("INSERT INTO _document_pages (title, order_index) VALUES ('Page 1', 0)")
|
||||
|
||||
# vertical_align : alignement vertical du contenu de la page
|
||||
# (top/center/bottom — voir document_engine/pages/
|
||||
# set_document_page_vertical_align.py), ajouté après la création
|
||||
# initiale des pages — même pragmatisme que page_id ci-dessous, une
|
||||
# valeur par défaut CONSTANTE plutôt qu'une contrainte CHECK.
|
||||
page_cols = {r["name"] for r in conn.execute("PRAGMA table_info(_document_pages)").fetchall()}
|
||||
if "vertical_align" not in page_cols:
|
||||
conn.execute("ALTER TABLE _document_pages ADD COLUMN vertical_align TEXT NOT NULL DEFAULT 'top'")
|
||||
|
||||
cols = {r["name"] for r in conn.execute("PRAGMA table_info(_document_elements)").fetchall()}
|
||||
if "page_id" not in cols:
|
||||
first_page_id = conn.execute("SELECT id FROM _document_pages ORDER BY order_index LIMIT 1").fetchone()["id"]
|
||||
|
||||
@@ -76,6 +76,7 @@ from .pages.get_document_page import get_document_page
|
||||
from .pages.list_document_pages import list_document_pages
|
||||
from .pages.move_document_page import move_document_page
|
||||
from .pages.replace_document_content import replace_document_content
|
||||
from .pages.set_document_page_vertical_align import VERTICAL_ALIGNS, set_document_page_vertical_align
|
||||
from .pages.update_document_page import update_document_page
|
||||
from .rendering.render_document_element import render_document, render_document_element
|
||||
from .rendering.sanitize_svg_markup import sanitize_svg_markup
|
||||
@@ -105,6 +106,7 @@ __all__ = [
|
||||
"MIN_TIMER_SECONDS",
|
||||
"MIN_WORDS",
|
||||
"MINIGAME_KINDS",
|
||||
"VERTICAL_ALIGNS",
|
||||
"add_document_element",
|
||||
"add_document_page",
|
||||
"delete_document_element",
|
||||
@@ -130,6 +132,7 @@ __all__ = [
|
||||
"sanitize_scenario_config",
|
||||
"sanitize_svg_markup",
|
||||
"seed_blocks_to_elements",
|
||||
"set_document_page_vertical_align",
|
||||
"update_document_element_attributes",
|
||||
"update_document_page",
|
||||
]
|
||||
|
||||
@@ -43,21 +43,42 @@ décalage un par un).
|
||||
- **Retour** : aucun.
|
||||
- **Exceptions** : aucune.
|
||||
|
||||
## `replace_document_content(slug: str, seed_pages: list[list[dict[str, Any]]]) -> None`
|
||||
## `set_document_page_vertical_align(slug: str, page_id: int, vertical_align: str) -> None`
|
||||
Règle l'alignement vertical du CONTENU d'une page (`justify-content` de
|
||||
`.docPageContent`, voir `static/document/document-editor.css`) —
|
||||
réglable depuis le panneau Propriétés quand l'onglet "Pages" de
|
||||
l'éditeur est actif (retour utilisateur du 24/09/2026 : "quand je suis
|
||||
sur l'onglet page, dans les propriétés s'affiche l'option de
|
||||
l'alignement de la page"). Une valeur hors de `VERTICAL_ALIGNS`
|
||||
(`"top"`/`"center"`/`"bottom"`) retombe silencieusement sur `"top"`,
|
||||
même philosophie défensive que `update_document_page` pour un titre
|
||||
vide.
|
||||
- **Retour** : aucun.
|
||||
- **Exceptions** : aucune.
|
||||
|
||||
### `VERTICAL_ALIGNS: tuple[str, ...]`
|
||||
`("top", "center", "bottom")` — valeurs valides de `vertical_align`,
|
||||
`"top"` étant la valeur par défaut posée en base (voir
|
||||
`db/supports/create_support.py`/`ensure_document_pages_schema.py`).
|
||||
|
||||
## `replace_document_content(slug: str, seed_pages: list[dict[str, Any]]) -> None`
|
||||
Remplace TOUT le contenu du support par `seed_pages` — utilisée
|
||||
UNIQUEMENT quand le créateur choisit "utiliser le contenu du modèle" en
|
||||
appliquant un thème (voir `routes/document/document_theme_apply.py` et
|
||||
`document_engine/themes/`), jamais appelée sans confirmation explicite
|
||||
côté client (action destructive, irréversible côté serveur). `seed_pages`
|
||||
est une liste de pages, chaque page une liste de blocs
|
||||
`{"kind", "attributes", "children"}` (`children` optionnel, uniquement
|
||||
pour un bloc `kind="row"` — un seul niveau de profondeur, comme le moteur
|
||||
de rangées lui-même). Les attributs fournis sont fusionnés sur
|
||||
`element_default_attributes(kind)`, jamais un remplacement brut. Les
|
||||
nouvelles pages sont créées AVANT que les anciennes soient supprimées
|
||||
(jamais l'inverse) : passer par zéro page, même brièvement, déclenche le
|
||||
filet de sécurité de `ensure_document_pages_schema` (un support a
|
||||
toujours au moins une page), qui recréerait une "Page 1" vide parasite.
|
||||
est une liste de pages, chaque page un dict
|
||||
`{"vertical_align": "top"|"center"|"bottom", "blocks": [...]}`
|
||||
(`vertical_align` optionnel, retombe sur `"top"`) ; chaque bloc de
|
||||
`blocks` est `{"kind", "attributes", "children"}` (`children` optionnel,
|
||||
uniquement pour un bloc `kind="row"` — un seul niveau de profondeur,
|
||||
comme le moteur de rangées lui-même). Les attributs fournis sont
|
||||
fusionnés sur `element_default_attributes(kind)`, jamais un remplacement
|
||||
brut. Les nouvelles pages sont créées AVANT que les anciennes soient
|
||||
supprimées (jamais l'inverse) : passer par zéro page, même brièvement,
|
||||
déclenche le filet de sécurité de `ensure_document_pages_schema` (un
|
||||
support a toujours au moins une page), qui recréerait une "Page 1" vide
|
||||
parasite.
|
||||
- **Retour** : aucun.
|
||||
- **Exceptions** : aucune levée explicitement.
|
||||
|
||||
|
||||
@@ -6,24 +6,28 @@ from ..labels.element_kind_labels import element_default_attributes
|
||||
from .add_document_page import add_document_page
|
||||
from .delete_document_page import delete_document_page
|
||||
from .list_document_pages import list_document_pages
|
||||
from .set_document_page_vertical_align import set_document_page_vertical_align
|
||||
|
||||
|
||||
def replace_document_content(slug: str, seed_pages: list[list[dict[str, Any]]]) -> None:
|
||||
def replace_document_content(slug: str, seed_pages: list[dict[str, Any]]) -> None:
|
||||
"""Remplace TOUT le contenu du support par `seed_pages` — utilisé
|
||||
UNIQUEMENT quand le créateur choisit explicitement "utiliser le
|
||||
contenu du modèle" en appliquant un thème (voir routes/document/
|
||||
document_theme_apply.py, jamais appelée sans confirmation explicite
|
||||
côté client : action destructive, irréversible côté serveur).
|
||||
|
||||
`seed_pages` est une liste de pages, chaque page une liste de blocs
|
||||
`{"kind": str, "attributes": dict, "children": [...]}` (`children`
|
||||
optionnel, uniquement pour un bloc `kind="row"` — chaque enfant a la
|
||||
même forme `{"kind", "attributes"}`, sans petit-enfant : le moteur de
|
||||
rangées ne descend jamais à plus d'un niveau, voir document_engine/
|
||||
rendering/render_document_element.py::_render_row). Les attributs
|
||||
fournis sont FUSIONNÉS sur element_default_attributes(kind) (jamais un
|
||||
remplacement brut) pour rester valides même si `seed_pages` n'en
|
||||
précise qu'une partie."""
|
||||
`seed_pages` est une liste de pages, chaque page un dict
|
||||
`{"vertical_align": "top"|"center"|"bottom", "blocks": [...]}`
|
||||
(`vertical_align` optionnel, retombe sur "top" — voir
|
||||
set_document_page_vertical_align.VERTICAL_ALIGNS) ; chaque bloc de
|
||||
`blocks` est `{"kind": str, "attributes": dict, "children": [...]}`
|
||||
(`children` optionnel, uniquement pour un bloc `kind="row"` — chaque
|
||||
enfant a la même forme `{"kind", "attributes"}`, sans petit-enfant :
|
||||
le moteur de rangées ne descend jamais à plus d'un niveau, voir
|
||||
document_engine/rendering/render_document_element.py::_render_row).
|
||||
Les attributs fournis sont FUSIONNÉS sur
|
||||
element_default_attributes(kind) (jamais un remplacement brut) pour
|
||||
rester valides même si `seed_pages` n'en précise qu'une partie."""
|
||||
# Les nouvelles pages sont créées AVANT de supprimer les anciennes
|
||||
# (jamais l'inverse) : passer par zéro page, même un court instant,
|
||||
# déclenche le filet de sécurité de ensure_document_pages_schema (un
|
||||
@@ -31,9 +35,12 @@ def replace_document_content(slug: str, seed_pages: list[list[dict[str, Any]]])
|
||||
# vide juste avant l'ajout de la première page du thème — bug réel
|
||||
# rencontré en écrivant les tests de cette fonction.
|
||||
old_page_ids = [page["id"] for page in list_document_pages(slug)]
|
||||
for page_blocks in seed_pages:
|
||||
for seed_page in seed_pages:
|
||||
page_id = add_document_page(slug)
|
||||
for block in page_blocks:
|
||||
vertical_align = seed_page.get("vertical_align")
|
||||
if vertical_align:
|
||||
set_document_page_vertical_align(slug, page_id, vertical_align)
|
||||
for block in seed_page.get("blocks", []):
|
||||
_add_seed_block(slug, page_id, block, parent_id=None)
|
||||
for old_page_id in old_page_ids:
|
||||
delete_document_page(slug, old_page_id)
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
from db.supports import connect_support, ensure_document_pages_schema
|
||||
|
||||
VERTICAL_ALIGNS = ("top", "center", "bottom")
|
||||
|
||||
|
||||
def set_document_page_vertical_align(slug: str, page_id: int, vertical_align: str) -> None:
|
||||
"""Règle l'alignement vertical du CONTENU d'une page (`justify-content`
|
||||
de `.docPageContent`, voir static/document/document-editor.css) —
|
||||
réglable depuis le panneau Propriétés quand l'onglet "Pages" est actif
|
||||
(retour utilisateur du 24/09/2026), jamais un attribut par élément (ça
|
||||
concerne la page entière, pas un bloc de contenu particulier). Une
|
||||
valeur hors de `VERTICAL_ALIGNS` retombe silencieusement sur "top"
|
||||
(état par défaut) plutôt que de lever — même philosophie défensive que
|
||||
`update_document_page` pour un titre vide."""
|
||||
ensure_document_pages_schema(slug)
|
||||
clean_align = vertical_align if vertical_align in VERTICAL_ALIGNS else "top"
|
||||
conn = connect_support(slug)
|
||||
conn.execute("UPDATE _document_pages SET vertical_align = ? WHERE id = ?", (clean_align, page_id))
|
||||
conn.commit()
|
||||
conn.close()
|
||||
@@ -8,9 +8,12 @@ modifiables ensuite comme n'importe quel contenu créé à la main."""
|
||||
|
||||
from typing import Any
|
||||
|
||||
SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
# Page 1 — Titre
|
||||
[
|
||||
SECURITE_INCENDIE_SEED_PAGES: list[dict[str, Any]] = [
|
||||
# Page 1 — Titre (contenu centré verticalement, comme une page de
|
||||
# garde — retour utilisateur du 24/09/2026)
|
||||
{
|
||||
"vertical_align": "center",
|
||||
"blocks": [
|
||||
{"kind": "badge", "attributes": {"content": "Module obligatoire"}},
|
||||
{"kind": "titre", "attributes": {"content": "Formation Sécurité Incendie", "style": "titre1"}},
|
||||
{
|
||||
@@ -23,8 +26,10 @@ SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
},
|
||||
},
|
||||
],
|
||||
},
|
||||
# Page 2 — Objectifs
|
||||
[
|
||||
{
|
||||
"blocks": [
|
||||
{"kind": "titre", "attributes": {"content": "À l'issue de ce module, vous saurez", "style": "titre2"}},
|
||||
{
|
||||
"kind": "liste_puces",
|
||||
@@ -46,8 +51,10 @@ SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
},
|
||||
},
|
||||
],
|
||||
},
|
||||
# Page 3 — Classes de feu
|
||||
[
|
||||
{
|
||||
"blocks": [
|
||||
{"kind": "titre", "attributes": {"content": "Les 5 classes de feu", "style": "titre2"}},
|
||||
{
|
||||
"kind": "paragraphe",
|
||||
@@ -71,7 +78,10 @@ SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
"attributes": {"label": "B", "title": "Liquides", "description": "Essence, solvants"},
|
||||
},
|
||||
{"kind": "carte", "attributes": {"label": "C", "title": "Gaz", "description": "Butane, propane"}},
|
||||
{"kind": "carte", "attributes": {"label": "D", "title": "Métaux", "description": "Sodium, magnésium"}},
|
||||
{
|
||||
"kind": "carte",
|
||||
"attributes": {"label": "D", "title": "Métaux", "description": "Sodium, magnésium"},
|
||||
},
|
||||
{
|
||||
"kind": "carte",
|
||||
"attributes": {"label": "F", "title": "Huiles", "description": "Friteuses, graisses"},
|
||||
@@ -82,14 +92,20 @@ SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
"kind": "badge",
|
||||
"attributes": {
|
||||
"content": (
|
||||
"⚠ Un feu électrique n'est pas une classe à part : coupez toujours le courant avant d'intervenir."
|
||||
"⚠ Un feu électrique n'est pas une classe à part : coupez toujours le "
|
||||
"courant avant d'intervenir."
|
||||
)
|
||||
},
|
||||
},
|
||||
],
|
||||
},
|
||||
# Page 4 — Méthode P.A.S.S.
|
||||
[
|
||||
{"kind": "titre", "attributes": {"content": "Utiliser un extincteur : la méthode P.A.S.S.", "style": "titre2"}},
|
||||
{
|
||||
"blocks": [
|
||||
{
|
||||
"kind": "titre",
|
||||
"attributes": {"content": "Utiliser un extincteur : la méthode P.A.S.S.", "style": "titre2"},
|
||||
},
|
||||
{
|
||||
"kind": "liste_numerotee",
|
||||
"attributes": {
|
||||
@@ -113,8 +129,10 @@ SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
# Page 5 — Évacuation
|
||||
[
|
||||
{
|
||||
"blocks": [
|
||||
{"kind": "titre", "attributes": {"content": "Consignes d'évacuation", "style": "titre2"}},
|
||||
{
|
||||
"kind": "paragraphe",
|
||||
@@ -132,10 +150,12 @@ SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
},
|
||||
},
|
||||
],
|
||||
},
|
||||
# Page 6 — Quiz (SEUL sur sa page : règle du moteur, voir
|
||||
# routes/document/document_element_add.py — respectée ici dès la
|
||||
# conception du contenu-seed, jamais contournée).
|
||||
[
|
||||
{
|
||||
"blocks": [
|
||||
{
|
||||
"kind": "quiz",
|
||||
"attributes": {
|
||||
@@ -145,7 +165,8 @@ SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
"questions": [
|
||||
{
|
||||
"text": (
|
||||
"Quelle classe de feu concerne les liquides inflammables comme l'essence ou les solvants ?"
|
||||
"Quelle classe de feu concerne les liquides inflammables comme "
|
||||
"l'essence ou les solvants ?"
|
||||
),
|
||||
"choices": ["Classe A", "Classe B", "Classe D"],
|
||||
"correct_index": 1,
|
||||
@@ -175,4 +196,5 @@ SECURITE_INCENDIE_SEED_PAGES: list[list[dict[str, Any]]] = [
|
||||
},
|
||||
}
|
||||
],
|
||||
},
|
||||
]
|
||||
|
||||
@@ -17,14 +17,15 @@ Un dict par thème : `id` (identifiant stable, utilisé dans les URLs et
|
||||
persisté via `db.set_document_theme`), `name`, `category`, `description`
|
||||
(affichage dans la modale), `css_path` (chemin sous `static/`, passé à
|
||||
`url_for('static', filename=...)`), `font_url` (optionnel, lien Google
|
||||
Fonts), `seed_pages` (contenu de démonstration, voir
|
||||
`document_engine.replace_document_content`). L'auteur d'un thème est
|
||||
responsable de respecter les règles structurelles du moteur dans son
|
||||
`seed_pages` (ex. un mini-jeu seul sur sa page — voir
|
||||
`routes/document/document_element_add.py` — jamais revérifié
|
||||
automatiquement puisque ce contenu vient du thème, pas de l'utilisateur ;
|
||||
voir `tests/document/test_document_themes.py` pour la vérification
|
||||
statique de cette règle sur tout le catalogue).
|
||||
Fonts), `seed_pages` (contenu de démonstration — une liste de dicts
|
||||
`{"vertical_align": "top"|"center"|"bottom", "blocks": [...]}`, voir
|
||||
`document_engine.replace_document_content` pour la forme exacte de
|
||||
`blocks`). L'auteur d'un thème est responsable de respecter les règles
|
||||
structurelles du moteur dans son `seed_pages` (ex. un mini-jeu seul sur
|
||||
sa page — voir `routes/document/document_element_add.py` — jamais
|
||||
revérifié automatiquement puisque ce contenu vient du thème, pas de
|
||||
l'utilisateur ; voir `tests/document/test_document_themes.py` pour la
|
||||
vérification statique de cette règle sur tout le catalogue).
|
||||
|
||||
## `get_document_theme_entry(theme_id: str) -> dict[str, Any] | None`
|
||||
- **Retour** : l'entrée de `DOCUMENT_THEMES` dont `id == theme_id`, ou
|
||||
@@ -32,8 +33,9 @@ statique de cette règle sur tout le catalogue).
|
||||
- **Exceptions** : aucune.
|
||||
|
||||
## `seed_blocks_to_elements(blocks: list[dict[str, Any]]) -> list[dict[str, Any]]`
|
||||
Convertit une liste de blocs de contenu-seed (`seed_pages[i]`) en une
|
||||
liste d'éléments "à plat" (id/kind/parent_id/attributes) directement
|
||||
Convertit une liste de blocs de contenu-seed (`seed_pages[i]["blocks"]`)
|
||||
en une liste d'éléments "à plat" (id/kind/parent_id/attributes)
|
||||
directement
|
||||
exploitable par `document_engine.render_document` — ids synthétiques
|
||||
NÉGATIFS, jamais persistés. Utilisée UNIQUEMENT pour l'aperçu d'un thème
|
||||
(voir `routes/document/document_theme_preview.py`, destiné à un
|
||||
|
||||
@@ -18,6 +18,7 @@ from . import ( # noqa: F401 - enregistre les routes definies dans chaque modul
|
||||
document_page_delete,
|
||||
document_page_move,
|
||||
document_page_rename,
|
||||
document_page_vertical_align,
|
||||
document_render,
|
||||
document_theme_apply,
|
||||
document_theme_preview,
|
||||
|
||||
@@ -0,0 +1,22 @@
|
||||
from flask import jsonify, request
|
||||
from werkzeug.wrappers import Response
|
||||
|
||||
import document_engine
|
||||
from core.flask_app import app
|
||||
|
||||
|
||||
@app.route("/document/<slug>/pages/<int:page_id>/vertical-align", methods=["POST"])
|
||||
def document_page_vertical_align(slug: str, page_id: int) -> Response | tuple[Response, int]:
|
||||
"""Règle l'alignement vertical du contenu d'une page (voir panneau
|
||||
Propriétés affiché quand l'onglet "Pages" est actif, static/document/
|
||||
js/document-editor.js::forgeDocRenderPageProps) — renvoie la valeur
|
||||
RÉELLEMENT persistée (jamais celle envoyée telle quelle) : une valeur
|
||||
invalide retombe silencieusement sur "top", même convention que
|
||||
document_page_rename.py pour un titre vide."""
|
||||
if document_engine.get_document_page(slug, page_id) is None:
|
||||
return jsonify({"error": "page introuvable"}), 404
|
||||
payload = request.get_json(force=True) or {}
|
||||
document_engine.set_document_page_vertical_align(slug, page_id, str(payload.get("vertical_align", "")))
|
||||
page = document_engine.get_document_page(slug, page_id)
|
||||
vertical_align = page["vertical_align"] if page else "top"
|
||||
return jsonify({"ok": True, "vertical_align": vertical_align})
|
||||
@@ -20,10 +20,19 @@ def document_render(slug: str) -> Response | tuple[Response, int]:
|
||||
document_edit.py : le panneau Propriétés reçoit `data.elements`
|
||||
directement depuis cette route à chaque rafraîchissement du canevas."""
|
||||
page_id = request.args.get("page_id", type=int)
|
||||
if page_id is None or document_engine.get_document_page(slug, page_id) is None:
|
||||
if page_id is None:
|
||||
return jsonify({"error": "page introuvable"}), 404
|
||||
page = document_engine.get_document_page(slug, page_id)
|
||||
if page is None:
|
||||
return jsonify({"error": "page introuvable"}), 404
|
||||
elements = [
|
||||
{**el, "attributes": document_engine.sanitize_element_attributes(el["kind"], el["attributes"])}
|
||||
for el in document_engine.list_document_elements(slug, page_id)
|
||||
]
|
||||
return jsonify({"html": document_engine.render_document(elements), "elements": elements})
|
||||
return jsonify(
|
||||
{
|
||||
"html": document_engine.render_document(elements),
|
||||
"elements": elements,
|
||||
"vertical_align": page["vertical_align"],
|
||||
}
|
||||
)
|
||||
|
||||
@@ -23,8 +23,11 @@ def document_theme_preview(slug: str, theme_id: str) -> str:
|
||||
theme = document_engine.get_document_theme_entry(theme_id)
|
||||
if theme is None:
|
||||
raise NotFound
|
||||
rendered_pages = [
|
||||
document_engine.render_document(document_engine.seed_blocks_to_elements(page_blocks))
|
||||
for page_blocks in theme["seed_pages"]
|
||||
pages = [
|
||||
{
|
||||
"vertical_align": seed_page.get("vertical_align", "top"),
|
||||
"html": document_engine.render_document(document_engine.seed_blocks_to_elements(seed_page["blocks"])),
|
||||
}
|
||||
for seed_page in theme["seed_pages"]
|
||||
]
|
||||
return render_template("document/document_theme_preview.html", theme=theme, rendered_pages=rendered_pages)
|
||||
return render_template("document/document_theme_preview.html", theme=theme, pages=pages)
|
||||
|
||||
@@ -476,6 +476,20 @@ body.objectEditBody > main.content {
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
/* Alignement vertical du contenu d'une page (retour utilisateur du
|
||||
24/09/2026 : réglable depuis le panneau Propriétés quand l'onglet
|
||||
"Pages" est actif, voir document_engine.set_document_page_vertical_align
|
||||
et static/document/js/document-editor.js::forgeDocRenderPageProps) —
|
||||
"top" reste la valeur par défaut (justify-content:flex-start déjà
|
||||
posé ci-dessus), aucune règle supplémentaire nécessaire pour elle. */
|
||||
.docPageContent[data-vertical-align="center"] {
|
||||
justify-content: center;
|
||||
}
|
||||
|
||||
.docPageContent[data-vertical-align="bottom"] {
|
||||
justify-content: flex-end;
|
||||
}
|
||||
|
||||
.docPage.docPage--fixedWidth {
|
||||
--doc-page-width: var(--doc-preview-width, 760px);
|
||||
|
||||
|
||||
@@ -169,7 +169,9 @@ function forgeDocCheckPageOverflow() {
|
||||
|
||||
function forgeDocRefreshCanvas() {
|
||||
return forgeDocApiRender().then((data) => {
|
||||
document.getElementById('docPageContent').innerHTML = data.html;
|
||||
const contentEl = document.getElementById('docPageContent');
|
||||
contentEl.innerHTML = data.html;
|
||||
contentEl.dataset.verticalAlign = data.vertical_align;
|
||||
window.forgeDocState.elements = data.elements;
|
||||
forgeDocRebuildIndex();
|
||||
forgeDocBindCanvasInteractions();
|
||||
@@ -178,7 +180,7 @@ function forgeDocRefreshCanvas() {
|
||||
forgeDocApplySelectionClass();
|
||||
} else {
|
||||
window.forgeDocState.selectedId = null;
|
||||
forgeDocRenderProps(null);
|
||||
forgeDocRefreshRightPanelDefault();
|
||||
}
|
||||
}).then(() => forgeDocCheckPageOverflow());
|
||||
}
|
||||
@@ -518,6 +520,14 @@ function forgeDocApiPageMove(pageId, newIndex) {
|
||||
}).then((r) => r.json());
|
||||
}
|
||||
|
||||
function forgeDocApiPageVerticalAlign(pageId, verticalAlign) {
|
||||
return fetch(`/document/${window.forgeDocState.slug}/pages/${pageId}/vertical-align`, {
|
||||
method: 'POST',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify({ vertical_align: verticalAlign }),
|
||||
}).then((r) => r.json());
|
||||
}
|
||||
|
||||
function forgeDocOrderedPages() {
|
||||
return [...window.forgeDocState.pages].sort((a, b) => a.order_index - b.order_index);
|
||||
}
|
||||
@@ -542,7 +552,7 @@ function forgeDocSwitchPage(pageId) {
|
||||
window.forgeDocState.redoStack = [];
|
||||
forgeDocUpdateHistoryButtons();
|
||||
window.forgeDocState.selectedId = null;
|
||||
forgeDocRenderProps(null);
|
||||
forgeDocRefreshRightPanelDefault();
|
||||
forgeDocRenderPageManagerList();
|
||||
forgeDocUpdatePageNavPill();
|
||||
return forgeDocRefreshCanvas();
|
||||
@@ -565,6 +575,18 @@ function forgeDocRenamePage(pageId, title) {
|
||||
});
|
||||
}
|
||||
|
||||
function forgeDocSetPageVerticalAlign(pageId, verticalAlign) {
|
||||
return forgeDocApiPageVerticalAlign(pageId, verticalAlign).then((result) => {
|
||||
const page = window.forgeDocState.pages.find((p) => p.id === pageId);
|
||||
if (page) page.vertical_align = result.vertical_align;
|
||||
if (pageId === window.forgeDocState.activePageId) {
|
||||
const contentEl = document.getElementById('docPageContent');
|
||||
if (contentEl) contentEl.dataset.verticalAlign = result.vertical_align;
|
||||
}
|
||||
forgeDocRenderPageProps();
|
||||
});
|
||||
}
|
||||
|
||||
function forgeDocDeletePage(pageId) {
|
||||
// Filet de sécurité client (en plus du refus serveur, voir
|
||||
// routes/document/document_page_delete.py) : jamais même tenter de
|
||||
@@ -758,6 +780,16 @@ function forgeDocSwitchSidebarTab(tabName) {
|
||||
tabs[name].setAttribute('aria-selected', String(isActive));
|
||||
panels[name].hidden = !isActive;
|
||||
});
|
||||
// Le panneau Propriétés (droite) suit l'onglet actif (retour
|
||||
// utilisateur du 24/09/2026) : la page active sur "Pages", l'élément
|
||||
// sélectionné (ou rien) sur "Mise en page" — jamais les deux en même
|
||||
// temps.
|
||||
if (tabName === 'pages') {
|
||||
forgeDocRenderPageProps();
|
||||
} else {
|
||||
const { selectedId } = window.forgeDocState;
|
||||
forgeDocRenderProps(selectedId !== null ? window.forgeDocState.elementsById[selectedId] : null);
|
||||
}
|
||||
}
|
||||
|
||||
function forgeDocBindSidebarTabs() {
|
||||
@@ -1608,6 +1640,53 @@ function forgeDocDeleteButtonHtml() {
|
||||
return '<button type="button" class="docDeleteBtn" id="docDeletePropBtn">🗑 Supprimer cet élément</button>';
|
||||
}
|
||||
|
||||
/* ---------------------------------------------------------------------
|
||||
* Propriétés de PAGE (alignement vertical du contenu) — affichées dans
|
||||
* le panneau de droite quand l'onglet "Pages" du panneau de gauche est
|
||||
* actif (retour utilisateur du 24/09/2026), à la place des propriétés
|
||||
* d'un élément sélectionné. Jamais les deux en même temps : changer
|
||||
* d'onglet ou sélectionner un élément bascule l'un ou l'autre (voir
|
||||
* forgeDocSwitchSidebarTab/forgeDocRefreshRightPanelDefault).
|
||||
* ------------------------------------------------------------------- */
|
||||
|
||||
function forgeDocIsPagesTabActive() {
|
||||
const tab = document.getElementById('docTabPages');
|
||||
return !!tab && tab.classList.contains('is-active');
|
||||
}
|
||||
|
||||
function forgeDocRenderPageProps() {
|
||||
const panel = document.getElementById('docPropsPanel');
|
||||
if (!panel) return;
|
||||
const page = window.forgeDocState.pages.find((p) => p.id === window.forgeDocState.activePageId);
|
||||
if (!page) {
|
||||
panel.innerHTML = '<div class="docSectionLabel">Propriétés</div><div class="docEmptyState">Aucune page active.</div>';
|
||||
return;
|
||||
}
|
||||
const align = page.vertical_align || 'top';
|
||||
const options = [
|
||||
{ value: 'top', label: 'Haut' },
|
||||
{ value: 'center', label: 'Centré' },
|
||||
{ value: 'bottom', label: 'Bas' },
|
||||
];
|
||||
panel.innerHTML = `
|
||||
${forgeDocPropsHeader('page')}
|
||||
<div class="docField">
|
||||
<span class="docFieldLabel">Alignement vertical du contenu</span>
|
||||
<div class="docSegmented" id="docPageAlignSeg">
|
||||
${options.map((o) => `<button type="button" class="docSegBtn ${align === o.value ? 'is-active' : ''}" data-align="${o.value}">${o.label}</button>`).join('')}
|
||||
</div>
|
||||
</div>
|
||||
`;
|
||||
panel.querySelectorAll('#docPageAlignSeg .docSegBtn').forEach((btn) => {
|
||||
btn.addEventListener('click', () => forgeDocSetPageVerticalAlign(page.id, btn.dataset.align));
|
||||
});
|
||||
}
|
||||
|
||||
function forgeDocRefreshRightPanelDefault() {
|
||||
if (forgeDocIsPagesTabActive()) forgeDocRenderPageProps();
|
||||
else forgeDocRenderProps(null);
|
||||
}
|
||||
|
||||
function forgeDocRenderTextProps(panel, el) {
|
||||
const a = el.attributes;
|
||||
panel.innerHTML = `
|
||||
@@ -3091,7 +3170,7 @@ function forgeDocBindDeselectOnBackgroundClick() {
|
||||
if (e.target.closest('[data-element-id]')) return;
|
||||
window.forgeDocState.selectedId = null;
|
||||
forgeDocApplySelectionClass();
|
||||
forgeDocRenderProps(null);
|
||||
forgeDocRefreshRightPanelDefault();
|
||||
});
|
||||
}
|
||||
|
||||
|
||||
@@ -205,7 +205,9 @@
|
||||
</div>
|
||||
<div class="docCanvasArea" id="docCanvasArea">
|
||||
<div class="docPage" id="docPage">
|
||||
<div class="docPageContent" id="docPageContent">{{ rendered_document|safe }}</div>
|
||||
<div class="docPageContent"
|
||||
id="docPageContent"
|
||||
data-vertical-align="{{ active_page.vertical_align }}">{{ rendered_document|safe }}</div>
|
||||
{# //NOSONAR S5247 - rendered_document vient de document_engine.render_document, qui échappe (html.escape) tout contenu utilisateur avant interpolation (voir document_engine/rendering/render_document_element.py) ; jamais de HTML brut non échappé ici #}
|
||||
</div>
|
||||
<button type="button"
|
||||
|
||||
@@ -78,15 +78,15 @@
|
||||
</head>
|
||||
<body>
|
||||
<div class="previewPages">
|
||||
{% for rendered_page in rendered_pages %}
|
||||
{% for page in pages %}
|
||||
<div class="docPage" data-page-index="{{ loop.index0 }}" {% if not loop.first %}hidden{% endif %}>
|
||||
<div class="docPageContent">
|
||||
{{ rendered_page | safe }}
|
||||
<div class="docPageContent" data-vertical-align="{{ page.vertical_align }}">
|
||||
{{ page.html | safe }}
|
||||
</div>
|
||||
</div>
|
||||
{% endfor %}
|
||||
</div>
|
||||
{% if rendered_pages|length > 1 %}
|
||||
{% if pages|length > 1 %}
|
||||
<div class="previewNav">
|
||||
<button type="button" id="previewPrevBtn">‹ Précédent</button>
|
||||
<span id="previewPageLabel"></span>
|
||||
|
||||
@@ -335,8 +335,10 @@ def test_replace_document_content_rebuilds_pages_and_elements_from_seed(tmp_supp
|
||||
slug, page_id = _new_support(tmp_support_slug_cleanup)
|
||||
doc_engine.add_document_element(slug, "titre", page_id=page_id)
|
||||
|
||||
seed_pages: list[list[dict[str, Any]]] = [
|
||||
[
|
||||
seed_pages: list[dict[str, Any]] = [
|
||||
{
|
||||
"vertical_align": "center",
|
||||
"blocks": [
|
||||
{"kind": "titre", "attributes": {"content": "Page 1 du modèle"}},
|
||||
{
|
||||
"kind": "row",
|
||||
@@ -347,12 +349,15 @@ def test_replace_document_content_rebuilds_pages_and_elements_from_seed(tmp_supp
|
||||
],
|
||||
},
|
||||
],
|
||||
[{"kind": "liste_puces", "attributes": {"items": ["Un", "Deux"]}}],
|
||||
},
|
||||
{"blocks": [{"kind": "liste_puces", "attributes": {"items": ["Un", "Deux"]}}]},
|
||||
]
|
||||
doc_engine.replace_document_content(slug, seed_pages)
|
||||
|
||||
pages = doc_engine.list_document_pages(slug)
|
||||
assert len(pages) == 2
|
||||
assert pages[0]["vertical_align"] == "center"
|
||||
assert pages[1]["vertical_align"] == "top"
|
||||
|
||||
page1_elements = doc_engine.list_document_elements(slug, pages[0]["id"])
|
||||
titre = next(el for el in page1_elements if el["kind"] == "titre")
|
||||
@@ -369,7 +374,9 @@ def test_replace_document_content_rebuilds_pages_and_elements_from_seed(tmp_supp
|
||||
|
||||
def test_replace_document_content_merges_attributes_onto_defaults(tmp_support_slug_cleanup: Any) -> None:
|
||||
slug, _page_id = _new_support(tmp_support_slug_cleanup)
|
||||
doc_engine.replace_document_content(slug, [[{"kind": "titre", "attributes": {"content": "Seulement le contenu"}}]])
|
||||
doc_engine.replace_document_content(
|
||||
slug, [{"blocks": [{"kind": "titre", "attributes": {"content": "Seulement le contenu"}}]}]
|
||||
)
|
||||
page_id = doc_engine.list_document_pages(slug)[0]["id"]
|
||||
element = doc_engine.list_document_elements(slug, page_id)[0]
|
||||
assert element["attributes"]["content"] == "Seulement le contenu"
|
||||
|
||||
@@ -93,3 +93,33 @@ def test_document_page_move_reorders_the_tab_strip(client: FlaskClient, support:
|
||||
|
||||
def test_document_page_move_rejects_an_unknown_page(client: FlaskClient, support: str) -> None:
|
||||
assert client.post(f"/document/{support}/pages/999/move", json={"new_index": 0}).status_code == 404
|
||||
|
||||
|
||||
def test_new_page_defaults_to_top_vertical_align(client: FlaskClient, support: str) -> None:
|
||||
page_id = _page_id(support)
|
||||
page = document_engine.get_document_page(support, page_id)
|
||||
assert page is not None
|
||||
assert page["vertical_align"] == "top"
|
||||
|
||||
|
||||
def test_document_page_vertical_align_persists_a_valid_value(client: FlaskClient, support: str) -> None:
|
||||
page_id = _page_id(support)
|
||||
resp = client.post(f"/document/{support}/pages/{page_id}/vertical-align", json={"vertical_align": "center"})
|
||||
assert resp.status_code == 200
|
||||
assert resp.get_json() == {"ok": True, "vertical_align": "center"}
|
||||
page = document_engine.get_document_page(support, page_id)
|
||||
assert page is not None
|
||||
assert page["vertical_align"] == "center"
|
||||
|
||||
|
||||
def test_document_page_vertical_align_falls_back_to_top_for_an_invalid_value(client: FlaskClient, support: str) -> None:
|
||||
page_id = _page_id(support)
|
||||
client.post(f"/document/{support}/pages/{page_id}/vertical-align", json={"vertical_align": "center"})
|
||||
resp = client.post(f"/document/{support}/pages/{page_id}/vertical-align", json={"vertical_align": "n-importe-quoi"})
|
||||
assert resp.status_code == 200
|
||||
assert resp.get_json()["vertical_align"] == "top"
|
||||
|
||||
|
||||
def test_document_page_vertical_align_rejects_an_unknown_page(client: FlaskClient, support: str) -> None:
|
||||
resp = client.post(f"/document/{support}/pages/999/vertical-align", json={"vertical_align": "center"})
|
||||
assert resp.status_code == 404
|
||||
|
||||
@@ -224,6 +224,21 @@ def test_document_render_rejects_a_missing_or_unknown_page(client: FlaskClient,
|
||||
assert client.get(f"/document/{support}/render", query_string={"page_id": 999}).status_code == 404
|
||||
|
||||
|
||||
def test_document_render_includes_the_page_vertical_align(client: FlaskClient, support: str) -> None:
|
||||
page_id = _page_id(support)
|
||||
client.post(f"/document/{support}/pages/{page_id}/vertical-align", json={"vertical_align": "center"})
|
||||
resp = client.get(f"/document/{support}/render", query_string={"page_id": page_id})
|
||||
assert resp.status_code == 200
|
||||
assert resp.get_json()["vertical_align"] == "center"
|
||||
|
||||
|
||||
def test_document_edit_reflects_the_active_page_vertical_align(client: FlaskClient, support: str) -> None:
|
||||
page_id = _page_id(support)
|
||||
client.post(f"/document/{support}/pages/{page_id}/vertical-align", json={"vertical_align": "center"})
|
||||
resp = client.get(f"/document/{support}/edit")
|
||||
assert 'data-vertical-align="center"' in resp.get_data(as_text=True)
|
||||
|
||||
|
||||
def test_document_element_add_rejects_a_minigame_on_a_non_empty_page(client: FlaskClient, support: str) -> None:
|
||||
"""Retour utilisateur du 23/09/2026 : "un mini jeu dois occupper
|
||||
toute une page" -> "une page avec mini-jeu = uniquement ce
|
||||
|
||||
@@ -22,6 +22,16 @@ def test_get_document_theme_entry_returns_the_matching_entry() -> None:
|
||||
assert len(entry["seed_pages"]) > 0
|
||||
|
||||
|
||||
def test_securite_incendie_title_page_is_vertically_centered() -> None:
|
||||
"""Retour utilisateur du 24/09/2026 : la page de garde doit être
|
||||
centrée verticalement, comme une page de titre — les pages suivantes
|
||||
restent alignées en haut (comportement par défaut)."""
|
||||
entry = doc_engine.get_document_theme_entry("securite-incendie")
|
||||
assert entry is not None
|
||||
assert entry["seed_pages"][0]["vertical_align"] == "center"
|
||||
assert entry["seed_pages"][1].get("vertical_align", "top") == "top"
|
||||
|
||||
|
||||
def test_seed_blocks_to_elements_assigns_unique_synthetic_ids() -> None:
|
||||
blocks: list[dict[str, Any]] = [
|
||||
{"kind": "titre", "attributes": {"content": "Titre"}},
|
||||
@@ -53,11 +63,18 @@ def test_seed_blocks_to_elements_merges_onto_default_attributes() -> None:
|
||||
def test_seed_blocks_to_elements_renders_without_error() -> None:
|
||||
theme = doc_engine.get_document_theme_entry("securite-incendie")
|
||||
assert theme is not None
|
||||
elements = doc_engine.seed_blocks_to_elements(theme["seed_pages"][0])
|
||||
elements = doc_engine.seed_blocks_to_elements(theme["seed_pages"][0]["blocks"])
|
||||
html = doc_engine.render_document(elements)
|
||||
assert "docText" in html
|
||||
|
||||
|
||||
def test_every_theme_seed_page_has_a_valid_vertical_align() -> None:
|
||||
for theme in doc_engine.DOCUMENT_THEMES:
|
||||
for seed_page in theme["seed_pages"]:
|
||||
align = seed_page.get("vertical_align", "top")
|
||||
assert align in doc_engine.VERTICAL_ALIGNS, f"thème {theme['id']!r} : vertical_align invalide {align!r}"
|
||||
|
||||
|
||||
def test_every_theme_seed_page_respects_the_minigame_exclusivity_rule() -> None:
|
||||
"""Un mini-jeu doit toujours être SEUL sur sa page (règle appliquée
|
||||
côté route pour un ajout manuel, voir routes/document/
|
||||
@@ -66,7 +83,8 @@ def test_every_theme_seed_page_respects_the_minigame_exclusivity_rule() -> None:
|
||||
ne la revérifie pas elle-même (contenu fourni par le thème, pas par
|
||||
l'utilisateur)."""
|
||||
for theme in doc_engine.DOCUMENT_THEMES:
|
||||
for page_blocks in theme["seed_pages"]:
|
||||
for seed_page in theme["seed_pages"]:
|
||||
page_blocks = seed_page["blocks"]
|
||||
minigame_blocks = [b for b in page_blocks if b["kind"] in doc_engine.MINIGAME_KINDS]
|
||||
if minigame_blocks:
|
||||
assert len(page_blocks) == 1, (
|
||||
|
||||
Reference in New Issue
Block a user