first commit

screens/rendering/render_element_html.py

@@ -0,0 +1,76 @@
+import html as html_lib
+
+from ..widgets.widget_meta import widget_meta
+from .visible_attrs import _visible_attrs
+from .style_string import _style_string
+from .attr_string import _attr_string
+from .apply_ctx import _apply_ctx
+from .render_children import _render_children
+from .render_table import _render_table
+from .render_select import _render_select
+from .render_fieldset import _render_fieldset
+from .render_checkbox_or_radio import _render_checkbox_or_radio
+from .render_repeater import _render_repeater
+from .render_jauge import _render_jauge
+from .render_overlay import _render_overlay
+
+
+def render_element_html(el, slug=None, children_map=None, ctx=None, parent_flex_direction=None):
+    """Construit le HTML réel (balise + attributs + style + contenu, y
+    compris les éléments physiquement posés à l'intérieur pour un
+    conteneur/répéteur/groupe de champs) — utilisé par l'éditeur (canevas)
+    et le mode jouable. N'écrit jamais rien sur disque : uniquement du HTML
+    généré à la volée à partir de ce qui est stocké en base. `slug` est
+    nécessaire pour le Répéteur de données (il doit lire les données du jeu
+    au moment de l'affichage). `ctx` porte les valeurs {{champ}} de la ligne
+    en cours quand cet élément est descendant d'un répéteur. `parent_flex_direction`
+    est la disposition interne (voir _parent_flex_direction) du conteneur qui
+    pose physiquement cet élément, s'il y en a un — elle influence la largeur
+    par défaut de cet élément (voir _style_string)."""
+    meta = widget_meta(el.get("widget"))
+    special = meta.get("special_render")
+    if special == "table":
+        return _render_table(el, meta, slug, children_map, ctx, parent_flex_direction)
+    if special == "select_options":
+        return _render_select(el, meta, slug, children_map, ctx, parent_flex_direction)
+    if special == "fieldset_legend":
+        return _render_fieldset(el, meta, slug, children_map, ctx, parent_flex_direction)
+    if special == "checkbox_label":
+        return _render_checkbox_or_radio(el, meta, slug, children_map, ctx, parent_flex_direction)
+    if special == "repeater":
+        return _render_repeater(el, meta, slug, children_map, ctx, parent_flex_direction)
+    if special == "jauge":
+        return _render_jauge(el, meta, slug, children_map, ctx, parent_flex_direction)
+    if special == "overlay":
+        return _render_overlay(el, meta, slug, children_map, ctx, parent_flex_direction)
+
+    tag = meta.get("tag")
+    if tag is None:  # widget à balise dynamique (ex: "titre" -> h1/h2/h3)
+        niveau = (el.get("attributes") or {}).get("_niveau", "2")
+        tag = f"h{niveau}"
+
+    attrs = _visible_attrs(el, meta, ctx)
+    style = _style_string(el, parent_flex_direction=parent_flex_direction, widget_key=el.get("widget"))
+
+    # 3.1 (Confort) — interactions au survol : un texte de remplacement
+    # optionnel, affiché à la place du contenu normal quand le joueur
+    # survole cet élément à la souris (voir bindHoverTexts() dans
+    # templates/play.html). Absent par défaut => aucun changement, donc
+    # aucune régression sur les éléments déjà créés.
+    hover_text = (el.get("attributes") or {}).get("_survol_texte")
+    if hover_text:
+        attrs["data-hover-text"] = _apply_ctx(hover_text, ctx)
+
+    if meta.get("self_closing"):
+        return f"<{tag} {_attr_string(attrs, style)}>"
+
+    content = _apply_ctx(el.get("content") or "", ctx)
+    child_html = _render_children(el, slug, children_map, ctx)
+
+    if tag in ("ul", "ol"):
+        items = [line.strip() for line in content.split("\n") if line.strip()]
+        inner = "".join(f"<li>{html_lib.escape(item)}</li>" for item in items) + child_html
+        return f"<{tag} {_attr_string(attrs, style)}>{inner}</{tag}>"
+
+    safe_content = html_lib.escape(content).replace("\n", "<br>") if content else ""
+    return f"<{tag} {_attr_string(attrs, style)}>{safe_content}{child_html}</{tag}>"