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>
107 lines
4.1 KiB
Python
107 lines
4.1 KiB
Python
"""Attributs de mise en forme de "boîte" PARTAGÉS par plusieurs kinds de
|
|
contenu (padding/margin/background_color/border_radius/border/align_self)
|
|
— un seul et même jeu d'attributs et une seule fonction de rendu pour ne
|
|
jamais dupliquer cette logique entre `_render_text`/`_render_image`/
|
|
`_render_button`/etc. (voir retour utilisateur du 26/09/2026 : audit
|
|
complet des réglages manquants, à ajouter élément par élément en
|
|
réutilisant CE module à chaque fois plutôt que de le réécrire)."""
|
|
|
|
import html as html_lib
|
|
from typing import Any
|
|
|
|
BORDER_SIDES = ("top", "right", "bottom", "left")
|
|
|
|
_DEFAULT_BORDER_SIDE = {"style": "none", "width": "1px", "color": "var(--doc-border)"}
|
|
|
|
|
|
def default_border() -> dict[str, dict[str, str]]:
|
|
"""Nouveau dict à chaque appel (jamais un littéral partagé/muté par
|
|
référence entre plusieurs éléments, même précaution que
|
|
DEFAULT_QUIZ_CONFIG côté labels)."""
|
|
return {side: dict(_DEFAULT_BORDER_SIDE) for side in BORDER_SIDES}
|
|
|
|
|
|
BOX_DEFAULTS = {
|
|
"padding": "",
|
|
"margin": "",
|
|
"background_color": "",
|
|
"border_radius": "",
|
|
"align_self": "stretch",
|
|
"width": "",
|
|
"max_width": "",
|
|
"height": "",
|
|
"min_height": "",
|
|
"max_height": "",
|
|
"min_width": "",
|
|
"box_shadow": "",
|
|
"opacity": "",
|
|
}
|
|
|
|
|
|
# (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"),
|
|
)
|
|
|
|
|
|
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
|
|
|
|
|
|
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 {}
|
|
style = str(side_border.get("style", "none"))
|
|
if style and style != "none":
|
|
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
|
|
# element_kind_labels.md — mais reste toujours sûr à poser seul
|
|
# ("stretch" est déjà le comportement par défaut d'un enfant flex en
|
|
# colonne, donc jamais ajouté explicitement pour ne rien changer).
|
|
align_self = str(a.get("align_self", "stretch"))
|
|
if align_self and align_self != "stretch":
|
|
parts.append(f"align-self:{html_lib.escape(align_self)};")
|
|
|
|
return " ".join(parts)
|