Files
williamandClaude Sonnet 5 9ad50c58b8 Audit complet de mise en forme — Image (2e élément du tableau)
Implémente toutes les options manquantes identifiées pour l'élément
Image : dimensionnement/ratio/object-fit, filtres CSS, upload de
fichier (en plus de l'URL), lien/plein écran au clic, chargement
différé, légende, et tous les attributs de boîte partagés déjà créés
pour Titre/Paragraphe (padding/margin/fond/bordure/ombre/opacité/
position du bloc).

Système de pages : un support peut désormais avoir 0 page (un nouveau
support démarre vide), suppression de toutes les pages en un clic, et
la pagination automatique insère intelligemment la nouvelle page juste
après celle qui déborde plutôt qu'en toute fin de liste.

Bugs réels trouvés et corrigés en cours de route : le style de bloc
(dont align-self) ciblait l'élément interne au lieu de son enveloppe
(légende/lien) ; une image à sa taille native pouvait déclencher une
pagination infinie ; upload/mise à jour d'attribut ne déclenchaient
jamais le contrôle de débordement.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-26 12:06:44 +02:00

55 lines
3.0 KiB
Python

from typing import Any
from ..elements.add_document_element import add_document_element
from ..elements.update_document_element_attributes import update_document_element_attributes
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[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 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) : ça évite que le support affiche un état "0 page"
# transitoire pendant le remplacement (même si 0 page est désormais un
# état par ailleurs valide, voir list_document_pages.py — ce n'est
# qu'une question d'ordre d'écriture ici, plus un filet de sécurité).
old_page_ids = [page["id"] for page in list_document_pages(slug)]
for seed_page in seed_pages:
page_id = add_document_page(slug)
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)
def _add_seed_block(slug: str, page_id: int, block: dict[str, Any], parent_id: int | None) -> None:
kind = block["kind"]
element_id = add_document_element(slug, kind, page_id=page_id, parent_id=parent_id)
attributes = {**element_default_attributes(kind), **block.get("attributes", {})}
update_document_element_attributes(slug, element_id, attributes)
for child in block.get("children", []):
_add_seed_block(slug, page_id, child, parent_id=element_id)