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>
This commit is contained in:
william
co-authored by
Claude Sonnet 5
Claude Sonnet 5
parent
6c7675fad0
commit
9ad50c58b8
@@ -71,6 +71,7 @@ from .labels.scenario_config import (
|
||||
sanitize_scenario_config,
|
||||
)
|
||||
from .pages.add_document_page import add_document_page
|
||||
from .pages.delete_all_document_pages import delete_all_document_pages
|
||||
from .pages.delete_document_page import delete_document_page
|
||||
from .pages.get_document_page import get_document_page
|
||||
from .pages.list_document_pages import list_document_pages
|
||||
@@ -109,6 +110,7 @@ __all__ = [
|
||||
"VERTICAL_ALIGNS",
|
||||
"add_document_element",
|
||||
"add_document_page",
|
||||
"delete_all_document_pages",
|
||||
"delete_document_element",
|
||||
"delete_document_page",
|
||||
"element_default_attributes",
|
||||
|
||||
@@ -48,10 +48,6 @@ _TEXT_DEFAULTS = {
|
||||
"strikethrough": False,
|
||||
"align": "left",
|
||||
"color": "var(--forge-text)",
|
||||
# Vide par défaut = pleine largeur de .docPageContent (comportement
|
||||
# historique) ; une valeur CSS libre (ex. "60ch", "480px") restreint
|
||||
# la largeur du bloc — voir render_document_element._render_text.
|
||||
"max_width": "",
|
||||
# Vides par défaut = valeurs du préréglage `style` inchangées (voir
|
||||
# _STYLE_PRESETS dans render_document_element.py) — une valeur
|
||||
# explicite les remplace (retour utilisateur du 26/09/2026, audit des
|
||||
@@ -62,8 +58,10 @@ _TEXT_DEFAULTS = {
|
||||
"letter_spacing": "",
|
||||
"text_transform": "none",
|
||||
"text_shadow": "",
|
||||
# Attributs de boîte partagés avec d'autres kinds (padding/margin/
|
||||
# background_color/border_radius/align_self) — voir rendering/box_style.py.
|
||||
# Attributs de boîte partagés avec d'autres kinds (dont `max_width`,
|
||||
# ex. "60ch"/"480px" — retour utilisateur du 24/09/2026 : un
|
||||
# paragraphe doit pouvoir rester plus étroit que la page) — voir
|
||||
# rendering/box_style.py.
|
||||
**BOX_DEFAULTS,
|
||||
}
|
||||
|
||||
@@ -88,7 +86,44 @@ def element_default_attributes(kind: str) -> dict[str, Any]:
|
||||
# svg_markup (optionnel) prend le pas sur src au rendu (voir
|
||||
# render_document_element._render_image) — un contenu vectoriel
|
||||
# dessiné/collé directement plutôt qu'un fichier hébergé.
|
||||
return {"src": "", "alt": "", "svg_markup": ""}
|
||||
# aspect_ratio/filter_preset : vides par défaut (aucun style
|
||||
# ajouté). click_behavior/link_url/lazy_load/caption :
|
||||
# comportement/contenu, pas du style (retour utilisateur du
|
||||
# 26/09/2026, audit des réglages manquants — colonne "Image").
|
||||
# click_behavior ("" | "link" | "lightbox") et link_url sont
|
||||
# mutuellement dépendants (un lien sans URL ne fait rien au
|
||||
# rendu, voir _render_image) mais jamais revalidés l'un par
|
||||
# rapport à l'autre ici : cette combinaison reste sans risque
|
||||
# quelle qu'elle soit.
|
||||
#
|
||||
# object_fit="cover" + height="220px" (au lieu de vides) : cadre
|
||||
# FIXE par défaut (retour utilisateur du 26/09/2026 : "ce cadre
|
||||
# ne devrait pas changer de taille en fonction de la taille de
|
||||
# l'image mais être fixe et contraindre l'image dedans") — une
|
||||
# photo importée est désormais TOUJOURS rognée pour remplir ce
|
||||
# cadre, quelle que soit sa résolution native, plutôt que de
|
||||
# dicter elle-même la taille du bloc. "Taille réelle" reste
|
||||
# sélectionnable explicitement dans le panneau Propriétés
|
||||
# (segmented "Ajustement dans son cadre") pour qui préfère
|
||||
# revenir à l'ancien comportement (hauteur libre, aucun
|
||||
# object-fit) ; un défaut CSS aveugle sur TOUTE image aurait
|
||||
# rendu ce choix impossible à distinguer de "jamais réglé", les
|
||||
# deux valant la chaîne vide.
|
||||
return {
|
||||
"src": "",
|
||||
"alt": "",
|
||||
"svg_markup": "",
|
||||
"object_fit": "cover",
|
||||
"aspect_ratio": "",
|
||||
"filter_preset": "",
|
||||
"click_behavior": "",
|
||||
"link_url": "",
|
||||
"lazy_load": False,
|
||||
"caption": "",
|
||||
**BOX_DEFAULTS,
|
||||
"height": "220px",
|
||||
"border": default_border(),
|
||||
}
|
||||
if kind == "bouton":
|
||||
# attachment_stored_name/attachment_filename (optionnels) : un
|
||||
# fichier téléchargeable joint au bouton (voir routes/document/
|
||||
|
||||
@@ -44,18 +44,26 @@ l'affichage/debug hors bibliothèque).
|
||||
## `element_default_attributes(kind: str) -> dict[str, Any]`
|
||||
Attributs posés à la création d'un élément de ce type (voir
|
||||
`document_engine/elements/add_document_element.py`).
|
||||
- **Retour** : un dict d'attributs par défaut, dépendant du `kind` :
|
||||
- **Retour** : un dict d'attributs par défaut, dépendant du `kind` (les
|
||||
"attributs de boîte partagés" mentionnés ci-dessous — `padding/margin/
|
||||
background_color/border_radius/width/max_width/height/min_height/
|
||||
max_height/min_width/box_shadow/opacity/align_self/border` — sont
|
||||
toujours les mêmes, voir `rendering/box_style.py` : tous vides,
|
||||
`False` ou `"none"`/`"stretch"` par défaut = comportement historique
|
||||
inchangé pour le kind qui les gagne) :
|
||||
texte (`content/style` + `bold/italic/underline/strikethrough/align/
|
||||
color/max_width/font_family/font_size/line_height/letter_spacing/
|
||||
text_transform/text_shadow` + les attributs de boîte partagés
|
||||
`padding/margin/background_color/border_radius/height/min_height/
|
||||
max_height/min_width/box_shadow/opacity/align_self/border`, voir
|
||||
`rendering/box_style.py` — tous vides, `False` ou `"none"`/`"stretch"`
|
||||
par défaut = comportement historique inchangé ; `max_width`
|
||||
restreint la largeur du bloc, une valeur CSS libre ex. `"60ch"`/
|
||||
`"480px"`, voir `rendering.md`),
|
||||
color/font_family/font_size/line_height/letter_spacing/
|
||||
text_transform/text_shadow` + les attributs de boîte partagés),
|
||||
image (`src/alt/svg_markup` — `svg_markup` prend le pas sur `src` au
|
||||
rendu, voir rendering.md), bouton (`label/target/
|
||||
rendu, voir rendering.md — `object_fit="cover"` et `height="220px"`
|
||||
par défaut (retour utilisateur du 26/09/2026 : "ce cadre ne devrait
|
||||
pas changer de taille en fonction de la taille de l'image mais être
|
||||
fixe et contraindre l'image dedans" — un cadre FIXE, jamais dicté par
|
||||
la résolution native du fichier importé ; "Taille réelle" reste un
|
||||
choix explicite possible via le panneau), `aspect_ratio/filter_preset`
|
||||
vides par défaut, `click_behavior` (`""`/`"link"`/`"lightbox"`) +
|
||||
`link_url` + `lazy_load` + `caption` : comportement/contenu, pas du
|
||||
style + les attributs de boîte partagés), bouton (`label/target/
|
||||
attachment_stored_name/attachment_filename` — la pièce jointe est
|
||||
indépendante de `target`, réservé à la navigation), liste à
|
||||
puces/numérotée (`items`, une liste de chaînes), badge
|
||||
|
||||
@@ -0,0 +1,16 @@
|
||||
from db.supports import connect_support, ensure_document_pages_schema
|
||||
|
||||
|
||||
def delete_all_document_pages(slug: str) -> None:
|
||||
"""Supprime toutes les pages d'un support d'un coup (retour
|
||||
utilisateur : "une option dans page pour supprimer toute les page
|
||||
d'un coup") — CASCADE (contrainte FK, voir create_support.py) retire
|
||||
aussi tous les éléments de contenu du support. Résultat : un support
|
||||
à 0 page, état volontairement valide (voir list_document_pages.py) ;
|
||||
l'utilisateur repart d'un éditeur vide comme un support neuf."""
|
||||
ensure_document_pages_schema(slug)
|
||||
conn = connect_support(slug)
|
||||
conn.execute("DELETE FROM _document_elements")
|
||||
conn.execute("DELETE FROM _document_pages")
|
||||
conn.commit()
|
||||
conn.close()
|
||||
@@ -7,8 +7,9 @@ def list_document_pages(slug: str) -> list[dict[str, Any]]:
|
||||
"""Toutes les pages d'un support, triées par order_index — la bande
|
||||
d'onglets du panneau Propriétés (voir static/document/js/
|
||||
document-editor.js) et le sélecteur de page du Mode Aperçu en dérivent
|
||||
directement. Un support a toujours au moins une page (voir
|
||||
db/supports/create_support.py / ensure_document_pages_schema)."""
|
||||
directement. Peut renvoyer une liste VIDE (retour utilisateur : un
|
||||
support neuf, ou vidé via "Supprimer toutes les pages", s'ouvre sans
|
||||
aucune page — voir routes/document/document_edit.py, qui gère ce cas)."""
|
||||
ensure_document_pages_schema(slug)
|
||||
conn = connect_support(slug)
|
||||
rows = conn.execute("SELECT * FROM _document_pages ORDER BY order_index").fetchall()
|
||||
|
||||
@@ -4,13 +4,21 @@ CRUD des pages d'un support de formation (`_document_pages`, voir
|
||||
`db/supports/create_support.py`) — retour utilisateur du 21/09/2026:
|
||||
"il faut implémenter un système de page". Un support est désormais
|
||||
composé de plusieurs pages, chacune portant son propre flux d'éléments
|
||||
(voir `document_engine/elements/`, filtré par `page_id`). Un support a
|
||||
TOUJOURS au moins une page (`create_support` en crée une par défaut,
|
||||
`ensure_document_pages_schema` en garantit une pour les supports plus
|
||||
anciens) — la garde "jamais supprimer la dernière page" est un
|
||||
garde-fou métier posé par l'appelant (voir
|
||||
`routes/document/document_page_delete.py`), pas une contrainte de ce
|
||||
paquet.
|
||||
(voir `document_engine/elements/`, filtré par `page_id`).
|
||||
|
||||
**Un support peut avoir 0 page** (retour utilisateur du 26/09/2026 :
|
||||
"l'éditeur ne dois plus etre obliger d'avoir une page active ou créer,
|
||||
il peut etre ouvert sans aucune page") — `create_support` n'en crée plus
|
||||
aucune par défaut, et `ensure_document_pages_schema` ne recrée plus
|
||||
"Page 1" dès que la table est vide (seule exception : la migration
|
||||
ponctuelle et historique d'un support pré-pages qui avait déjà des
|
||||
éléments sans `page_id`). `routes/document/document_edit.py` et le
|
||||
frontend (`static/document/js/document-editor.js`) gèrent explicitement
|
||||
cet état "aucune page" (pas de page active, canevas vide avec une
|
||||
invite à en créer une). La garde "jamais supprimer la dernière page" a
|
||||
été retirée du côté route (voir `delete_all_document_pages` ci-dessous
|
||||
et `routes/document/document_page_delete.py`) : ce paquet n'a jamais
|
||||
posé cette contrainte lui-même.
|
||||
|
||||
## `add_document_page(slug: str, title: str | None = None) -> int`
|
||||
Ajoute une page en fin de la bande d'onglets. `title` par défaut :
|
||||
@@ -87,9 +95,18 @@ Supprime une page ET ses éléments (`DELETE FROM _document_elements
|
||||
WHERE page_id = ?` explicite — la contrainte `FOREIGN KEY ... ON DELETE
|
||||
CASCADE` n'existe que pour les supports créés après l'ajout des pages,
|
||||
voir `db/supports/ensure_document_pages_schema.py` pour les anciens).
|
||||
Ne refuse JAMAIS de supprimer la dernière page restante — cette règle
|
||||
est posée par l'appelant, pas par cette fonction bas niveau (même
|
||||
découpage que `routes/game/screens/screen_delete.py` côté jeu, où le
|
||||
garde-fou vit aussi dans la route).
|
||||
Ne refuse JAMAIS de supprimer la dernière page restante — un support à
|
||||
0 page est un état valide (voir plus haut).
|
||||
- **Retour** : aucun.
|
||||
- **Exceptions** : aucune.
|
||||
|
||||
## `delete_all_document_pages(slug: str) -> None`
|
||||
Supprime TOUTES les pages du support d'un coup, et tous leurs éléments
|
||||
de contenu avec elles (retour utilisateur : "une option dans page pour
|
||||
supprimer toute les page d'un coup") — action destructive et
|
||||
irréversible côté serveur, jamais appelée sans confirmation explicite
|
||||
côté client (voir `static/document/js/document-editor.js`,
|
||||
`forgeDocDeleteAllPages`). Le support se retrouve à 0 page, exactement
|
||||
comme un support neuf.
|
||||
- **Retour** : aucun.
|
||||
- **Exceptions** : aucune.
|
||||
|
||||
@@ -29,11 +29,10 @@ def replace_document_content(slug: str, seed_pages: list[dict[str, Any]]) -> Non
|
||||
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
|
||||
# support a TOUJOURS au moins une page), qui recréerait une "Page 1"
|
||||
# vide juste avant l'ajout de la première page du thème — bug réel
|
||||
# rencontré en écrivant les tests de cette fonction.
|
||||
# (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)
|
||||
|
||||
@@ -27,6 +27,8 @@ BOX_DEFAULTS = {
|
||||
"background_color": "",
|
||||
"border_radius": "",
|
||||
"align_self": "stretch",
|
||||
"width": "",
|
||||
"max_width": "",
|
||||
"height": "",
|
||||
"min_height": "",
|
||||
"max_height": "",
|
||||
@@ -36,58 +38,39 @@ BOX_DEFAULTS = {
|
||||
}
|
||||
|
||||
|
||||
def render_box_style(a: dict[str, Any]) -> str:
|
||||
"""Construit les déclarations CSS inline communes à plusieurs kinds à
|
||||
partir des attributs `padding`/`margin`/`background_color`/
|
||||
`border_radius`/`height`/`min_height`/`max_height`/`min_width`/
|
||||
`box_shadow`/`opacity`/`border`/`align_self` de `a` — chaîne vide pour
|
||||
tout attribut absent ou à sa valeur par défaut (aucun style ajouté,
|
||||
comportement historique inchangé). `border` est un dict à 4 clés
|
||||
(`BORDER_SIDES`), chacune `{"style", "width", "color"}` — un côté à
|
||||
`style="none"` (ou absent) ne produit aucune déclaration pour ce
|
||||
côté, jamais un `border-top:none` explicite.
|
||||
- **Retour** : les déclarations CSS (`"propriete:valeur; ..."`),
|
||||
jamais vide ni `None`.
|
||||
- **Exceptions** : aucune."""
|
||||
parts: list[str] = []
|
||||
# (clé d'attribut, propriété CSS) — chaque paire suit exactement le même
|
||||
# patron (lire/nettoyer/ajouter si non vide) ; une simple table de
|
||||
# correspondance ici évite un enchaînement de blocs `if` identiques
|
||||
# (complexité cognitive réduite, voir _render_simple_properties).
|
||||
_SIMPLE_PROPERTIES = (
|
||||
("padding", "padding"),
|
||||
("margin", "margin"),
|
||||
("background_color", "background-color"),
|
||||
("border_radius", "border-radius"),
|
||||
("width", "width"),
|
||||
("max_width", "max-width"),
|
||||
("height", "height"),
|
||||
("min_height", "min-height"),
|
||||
("max_height", "max-height"),
|
||||
("min_width", "min-width"),
|
||||
("box_shadow", "box-shadow"),
|
||||
("opacity", "opacity"),
|
||||
)
|
||||
|
||||
padding = str(a.get("padding", "")).strip()
|
||||
if padding:
|
||||
parts.append(f"padding:{html_lib.escape(padding)};")
|
||||
|
||||
margin = str(a.get("margin", "")).strip()
|
||||
if margin:
|
||||
parts.append(f"margin:{html_lib.escape(margin)};")
|
||||
def _render_simple_properties(a: dict[str, Any]) -> list[str]:
|
||||
parts = []
|
||||
for attr_key, css_prop in _SIMPLE_PROPERTIES:
|
||||
value = str(a.get(attr_key, "")).strip()
|
||||
if value:
|
||||
parts.append(f"{css_prop}:{html_lib.escape(value)};")
|
||||
return parts
|
||||
|
||||
background_color = str(a.get("background_color", "")).strip()
|
||||
if background_color:
|
||||
parts.append(f"background-color:{html_lib.escape(background_color)};")
|
||||
|
||||
border_radius = str(a.get("border_radius", "")).strip()
|
||||
if border_radius:
|
||||
parts.append(f"border-radius:{html_lib.escape(border_radius)};")
|
||||
|
||||
height = str(a.get("height", "")).strip()
|
||||
if height:
|
||||
parts.append(f"height:{html_lib.escape(height)};")
|
||||
min_height = str(a.get("min_height", "")).strip()
|
||||
if min_height:
|
||||
parts.append(f"min-height:{html_lib.escape(min_height)};")
|
||||
max_height = str(a.get("max_height", "")).strip()
|
||||
if max_height:
|
||||
parts.append(f"max-height:{html_lib.escape(max_height)};")
|
||||
min_width = str(a.get("min_width", "")).strip()
|
||||
if min_width:
|
||||
parts.append(f"min-width:{html_lib.escape(min_width)};")
|
||||
|
||||
box_shadow = str(a.get("box_shadow", "")).strip()
|
||||
if box_shadow:
|
||||
parts.append(f"box-shadow:{html_lib.escape(box_shadow)};")
|
||||
|
||||
opacity = str(a.get("opacity", "")).strip()
|
||||
if opacity:
|
||||
parts.append(f"opacity:{html_lib.escape(opacity)};")
|
||||
|
||||
def _render_border(a: dict[str, Any]) -> list[str]:
|
||||
"""Un côté à `style="none"` (ou absent) ne produit aucune déclaration
|
||||
pour ce côté, jamais un `border-top:none` explicite."""
|
||||
parts = []
|
||||
border = a.get("border") or {}
|
||||
for side in BORDER_SIDES:
|
||||
side_border = border.get(side) or {}
|
||||
@@ -96,6 +79,20 @@ def render_box_style(a: dict[str, Any]) -> str:
|
||||
width = html_lib.escape(str(side_border.get("width", "1px")))
|
||||
color = html_lib.escape(str(side_border.get("color", "var(--doc-border)")))
|
||||
parts.append(f"border-{side}:{width} {html_lib.escape(style)} {color};")
|
||||
return parts
|
||||
|
||||
|
||||
def render_box_style(a: dict[str, Any]) -> str:
|
||||
"""Construit les déclarations CSS inline communes à plusieurs kinds à
|
||||
partir des attributs listés dans `_SIMPLE_PROPERTIES` + `border`/
|
||||
`align_self` de `a` — chaîne vide pour tout attribut absent ou à sa
|
||||
valeur par défaut (aucun style ajouté, comportement historique
|
||||
inchangé). `border` est un dict à 4 clés (`BORDER_SIDES`), chacune
|
||||
`{"style", "width", "color"}`.
|
||||
- **Retour** : les déclarations CSS (`"propriete:valeur; ..."`),
|
||||
jamais vide ni `None`.
|
||||
- **Exceptions** : aucune."""
|
||||
parts = _render_simple_properties(a) + _render_border(a)
|
||||
|
||||
# align-self ne fait quoi que ce soit d'utile QUE si l'élément a par
|
||||
# ailleurs une taille bornée (max_width/width) — voir la note dans
|
||||
|
||||
@@ -94,15 +94,11 @@ def _render_text(el: dict[str, Any], _children_by_parent: dict[int | None, list[
|
||||
if text_shadow:
|
||||
style += f" text-shadow:{html_lib.escape(text_shadow)};"
|
||||
|
||||
# max_width optionnel (ex. "60ch", "480px") — vide par défaut (pleine
|
||||
# largeur de .docPageContent, comportement inchangé). Retour
|
||||
# utilisateur du 24/09/2026 : un paragraphe doit pouvoir rester plus
|
||||
# étroit que la page, comme un sous-titre sous un grand titre, sans
|
||||
# dépendre d'une rangée (qui partagerait la largeur avec un frère).
|
||||
max_width = str(a.get("max_width", "")).strip()
|
||||
if max_width:
|
||||
style += f" max-width:{html_lib.escape(max_width)};"
|
||||
|
||||
# max_width (ex. "60ch", "480px" — retour utilisateur du 24/09/2026 :
|
||||
# un paragraphe doit pouvoir rester plus étroit que la page, sans
|
||||
# dépendre d'une rangée qui en partagerait la largeur avec un frère)
|
||||
# fait maintenant partie des attributs de boîte partagés
|
||||
# (render_box_style), jamais géré ici en double.
|
||||
box_style = render_box_style(a)
|
||||
if box_style:
|
||||
style += f" {box_style}"
|
||||
@@ -110,8 +106,53 @@ def _render_text(el: dict[str, Any], _children_by_parent: dict[int | None, list[
|
||||
return f'<div class="docText" data-element-id="{el["id"]}" data-kind="{el["kind"]}" style="{style}">{content}</div>'
|
||||
|
||||
|
||||
_IMAGE_OBJECT_FITS = ("cover", "contain", "fill")
|
||||
_IMAGE_FILTERS = {
|
||||
"grayscale": "grayscale(1)",
|
||||
"sepia": "sepia(0.8)",
|
||||
"blur": "blur(3px)",
|
||||
}
|
||||
|
||||
|
||||
def _image_extra_style(a: dict[str, Any]) -> str:
|
||||
"""Déclarations CSS spécifiques à l'image (`object-fit`/`aspect-ratio`/
|
||||
`filter`) — jamais dans `box_style.py` (partagé), qui ne connaît que
|
||||
des attributs communs à plusieurs kinds."""
|
||||
parts = []
|
||||
object_fit = str(a.get("object_fit", ""))
|
||||
if object_fit in _IMAGE_OBJECT_FITS:
|
||||
parts.append(f"object-fit:{object_fit};")
|
||||
aspect_ratio = str(a.get("aspect_ratio", "")).strip()
|
||||
if aspect_ratio:
|
||||
parts.append(f"aspect-ratio:{html_lib.escape(aspect_ratio)};")
|
||||
filter_value = _IMAGE_FILTERS.get(str(a.get("filter_preset", "")))
|
||||
if filter_value:
|
||||
parts.append(f"filter:{filter_value};")
|
||||
return " ".join(parts)
|
||||
|
||||
|
||||
def _render_image(el: dict[str, Any], _children_by_parent: dict[int | None, list[dict[str, Any]]]) -> str:
|
||||
a = el["attributes"]
|
||||
click_behavior = str(a.get("click_behavior", ""))
|
||||
link_url = str(a.get("link_url", "")).strip()
|
||||
caption = str(a.get("caption", "")).strip()
|
||||
# render_box_style (padding/margin/fond/bordure/largeur/position du
|
||||
# bloc, dont align-self) doit se poser sur l'élément RÉELLEMENT
|
||||
# top-niveau — celui qui est l'enfant direct du flex-column de la
|
||||
# page (voir .docPageContent, static/document/document-editor.css) —
|
||||
# jamais sur l'<img>/<div> interne dès qu'une légende ou un
|
||||
# comportement au clic l'enveloppe : un align-self posé sur un
|
||||
# DESCENDANT du flex-item n'a strictement aucun effet côté CSS (bug
|
||||
# réel constaté le 26/09/2026 : "la position de bloc ne fonctionne
|
||||
# pas sur l'image"). has_wrapper détermine qui, de l'image elle-même
|
||||
# ou de son enveloppe, est ce top-niveau.
|
||||
has_wrapper = bool(caption) or (click_behavior == "link" and link_url) or click_behavior == "lightbox"
|
||||
box_style = render_box_style(a)
|
||||
|
||||
media_style = " ".join(p for p in (_image_extra_style(a), "" if has_wrapper else box_style) if p)
|
||||
media_style_attr = f' style="{media_style}"' if media_style else ""
|
||||
loading_attr = ' loading="lazy"' if a.get("lazy_load") else ""
|
||||
|
||||
svg_markup = str(a.get("svg_markup", "")).strip()
|
||||
if svg_markup:
|
||||
# Contenu vectoriel dessiné/collé par le créateur plutôt qu'un
|
||||
@@ -120,15 +161,51 @@ def _render_image(el: dict[str, Any], _children_by_parent: dict[int | None, list
|
||||
# CHAQUE rendu (jamais seulement à l'écriture) par sanitize_svg_markup,
|
||||
# même défense en profondeur que html.escape sur les autres kinds.
|
||||
sanitized = sanitize_svg_markup(svg_markup)
|
||||
return f'<div class="docImage" data-element-id="{el["id"]}" data-kind="image">{sanitized}</div>'
|
||||
src = html_lib.escape(str(a.get("src", "")))
|
||||
alt = html_lib.escape(str(a.get("alt", "")))
|
||||
if not src:
|
||||
return (
|
||||
f'<div class="docImage docImagePlaceholder" data-element-id="{el["id"]}" data-kind="image">'
|
||||
f"Image — aucun fichier choisi</div>"
|
||||
media = (
|
||||
f'<div class="docImage" data-element-id="{el["id"]}" data-kind="image"{media_style_attr}>{sanitized}</div>'
|
||||
)
|
||||
return f'<img class="docImage" data-element-id="{el["id"]}" data-kind="image" src="{src}" alt="{alt}">'
|
||||
else:
|
||||
src = html_lib.escape(str(a.get("src", "")))
|
||||
alt = html_lib.escape(str(a.get("alt", "")))
|
||||
if not src:
|
||||
media = (
|
||||
f'<div class="docImage docImagePlaceholder" data-element-id="{el["id"]}" '
|
||||
f'data-kind="image"{media_style_attr}>Image — aucun fichier choisi</div>'
|
||||
)
|
||||
else:
|
||||
media = (
|
||||
f'<img class="docImage" data-element-id="{el["id"]}" data-kind="image" '
|
||||
f'src="{src}" alt="{alt}"{media_style_attr}{loading_attr}>'
|
||||
)
|
||||
|
||||
# Comportement au clic (mutuellement exclusif, voir panneau
|
||||
# Propriétés) — "lien" ouvre une URL externe dans un nouvel onglet
|
||||
# (jamais dans l'éditeur lui-même), "plein écran" ouvre un aperçu
|
||||
# agrandi géré côté client (voir static/document/js/
|
||||
# document-editor.js::forgeDocOpenImageLightbox), tous deux
|
||||
# UNIQUEMENT actifs en Mode Aperçu (même principe que les mini-jeux
|
||||
# et la pièce jointe d'un bouton). Reçoit le style de bloc UNIQUEMENT
|
||||
# s'il n'y a pas de légende par-dessus (sinon c'est elle, plus
|
||||
# englobante encore, qui le reçoit juste plus bas).
|
||||
if click_behavior == "link" and link_url:
|
||||
href = html_lib.escape(link_url)
|
||||
wrapper_style_attr = f' style="{box_style}"' if (box_style and not caption) else ""
|
||||
media = (
|
||||
f'<a class="docImageLink" href="{href}" target="_blank" '
|
||||
f'rel="noopener noreferrer"{wrapper_style_attr}>{media}</a>'
|
||||
)
|
||||
elif click_behavior == "lightbox":
|
||||
wrapper_style_attr = f' style="{box_style}"' if (box_style and not caption) else ""
|
||||
media = f'<div class="docImageLightboxTrigger"{wrapper_style_attr}>{media}</div>'
|
||||
|
||||
if caption:
|
||||
figure_style_attr = f' style="{box_style}"' if box_style else ""
|
||||
media = (
|
||||
f'<figure class="docImageFigure"{figure_style_attr}>{media}'
|
||||
f'<figcaption class="docImageCaption">{html_lib.escape(caption)}</figcaption></figure>'
|
||||
)
|
||||
|
||||
return media
|
||||
|
||||
|
||||
def _render_list(el: dict[str, Any], _children_by_parent: dict[int | None, list[dict[str, Any]]]) -> str:
|
||||
|
||||
@@ -52,7 +52,21 @@ regroupement à chaque appel.
|
||||
`<div>` portant directement ce fragment SVG nettoyé par
|
||||
`sanitize_svg_markup` (voir `sanitize_svg_markup.py` ci-dessous) : un
|
||||
contenu vectoriel dessiné/collé par le créateur plutôt qu'un fichier
|
||||
hébergé, sans aucun style qui lui soit propre.
|
||||
hébergé. Style inline : `object_fit` (`"cover"`/`"contain"`/`"fill"`,
|
||||
toute autre valeur ignorée), `aspect_ratio` (valeur CSS libre, ex.
|
||||
`"16 / 9"`), `filter_preset` (`"grayscale"`/`"sepia"`/`"blur"`, mappé
|
||||
vers une vraie valeur `filter` CSS fixe — jamais une valeur de filtre
|
||||
libre) + les attributs de boîte partagés (`render_box_style`, voir
|
||||
`box_style.py`). `lazy_load` (`True`) ajoute `loading="lazy"` sur
|
||||
l'`<img>` uniquement (comportement, pas du style). `click_behavior`
|
||||
(`""`/`"link"`/`"lightbox"`) enveloppe le tout dans un `<a target="_blank"
|
||||
rel="noopener noreferrer">` (si `link_url` est aussi renseigné) ou un
|
||||
`<div class="docImageLightboxTrigger">` — les deux ne deviennent
|
||||
réellement cliquables qu'en Mode Aperçu (voir static/document/js/
|
||||
document-editor.js::forgeDocBindCanvasInteractions/
|
||||
forgeDocOpenImageLightbox), même principe que les mini-jeux et la
|
||||
pièce jointe d'un bouton. `caption` (non vide) enveloppe le tout dans
|
||||
un `<figure><figcaption>` échappée.
|
||||
- **Bouton** : `<button>` avec son `label`, un `data-target` optionnel
|
||||
(navigation) et un `data-attachment-filename` optionnel — marqueur
|
||||
mécanique posé quand un fichier a été joint (voir
|
||||
@@ -213,17 +227,22 @@ Un dict à 4 clés (`BORDER_SIDES`), chacune `{"style": "none", "width":
|
||||
|
||||
### `BOX_DEFAULTS: dict[str, Any]`
|
||||
`{"padding": "", "margin": "", "background_color": "", "border_radius":
|
||||
"", "align_self": "stretch", "height": "", "min_height": "",
|
||||
"max_height": "", "min_width": "", "box_shadow": "", "opacity": ""}` —
|
||||
`border` n'y figure PAS (voir `default_border()`, à ajouter séparément
|
||||
par chaque appelant pour éviter le partage par référence).
|
||||
"", "align_self": "stretch", "width": "", "max_width": "", "height": "",
|
||||
"min_height": "", "max_height": "", "min_width": "", "box_shadow": "",
|
||||
"opacity": ""}` — `border` n'y figure PAS (voir `default_border()`, à
|
||||
ajouter séparément par chaque appelant pour éviter le partage par
|
||||
référence).
|
||||
|
||||
### `render_box_style(a: dict[str, Any]) -> str`
|
||||
Construit les déclarations CSS inline pour `padding`/`margin`/
|
||||
`background_color`/`border_radius`/`height`/`min_height`/`max_height`/
|
||||
`min_width`/`box_shadow`/`opacity`/`border`/`align_self` de `a` — un
|
||||
attribut absent ou à sa valeur par défaut ne produit AUCUNE déclaration
|
||||
(comportement historique inchangé). `border` est un dict à 4 clés
|
||||
Construit les déclarations CSS inline pour chaque attribut listé dans
|
||||
`BOX_DEFAULTS` (padding/margin/background_color/border_radius/width/
|
||||
max_width/height/min_height/max_height/min_width/box_shadow/opacity) +
|
||||
`border`/`align_self` de `a`, via une table de correspondance
|
||||
(clé d'attribut, propriété CSS) plutôt qu'un bloc `if` par attribut
|
||||
(complexité cognitive — voir `_render_simple_properties`/`_render_border`,
|
||||
privées) — un attribut absent ou à sa valeur par défaut ne produit
|
||||
AUCUNE déclaration (comportement historique inchangé). `border` est un
|
||||
dict à 4 clés
|
||||
(`BORDER_SIDES`), chacune `{"style", "width", "color"}` — un côté à
|
||||
`style="none"` (ou absent) ne produit rien pour ce côté, jamais un
|
||||
`border-top:none` explicite. `align-self` n'est ajouté que si différent
|
||||
|
||||
Reference in New Issue
Block a user