vibe.web_core.html_fragments

HTML fragment rendering utilities.

This module provides functions to render common HTML patterns using Jinja templates instead of inline string construction. These are used for: - OOB swap divs (HTMX) - Question wrappers - Error messages - Placeholders

Usage

from vibe.web_core.html_fragments import ( render_oob_swap, render_question_wrapper, render_widget_error, render_preview_error, render_placeholder )

render_oob_swap

render_oob_swap(element_id: str, content: str, style: str = 'display: block;') -> str

Render an OOB swap div for HTMX.

Parameters:
  • element_id (str) –

    The HTML id attribute for the div

  • content (str) –

    The inner HTML content

  • style (str, default: 'display: block;' ) –

    CSS style string (default: "display: block;")

Returns:
  • str

    Rendered HTML string

render_question_wrapper

render_question_wrapper(safe_id: str, content: str, style: str = '') -> str

Render a question wrapper div.

Parameters:
  • safe_id (str) –

    The safe (escaped) question ID for the HTML id attribute

  • content (str) –

    The inner HTML content

  • style (str, default: '' ) –

    Optional CSS style string

Returns:
  • str

    Rendered HTML string with trailing newline

render_widget_error

render_widget_error(message: str, error_type: str = 'Error') -> str

Render a widget-level error div.

Parameters:
  • message (str) –

    The error message

  • error_type (str, default: 'Error' ) –

    Type of error (default: "Error")

Returns:
  • str

    Rendered HTML string

render_preview_error

render_preview_error(message: str) -> str

Render a preview error div.

Parameters:
  • message (str) –

    The error message

Returns:
  • str

    Rendered HTML string

render_placeholder

render_placeholder(label: str) -> str

Render a placeholder span.

Parameters:
  • label (str) –

    The placeholder text

Returns:
  • str

    Rendered HTML string