Build HTML with Python, not strings.
NitroUI is a zero-dependency Python library that lets you construct HTML documents using a clean, composable class-based API. No template files, no string concatenation, no runtime dependencies.
from nitro_ui import *
page = HTML(
Head(Title("Dashboard")),
Body(
Nav(
Anchor("Home", href="/"),
Anchor("Settings", href="/settings", cls="active")
),
Main(
H1("Welcome back!"),
Div(
Paragraph("You have ", Strong("3"), " new notifications."),
Button("View All", type="button", cls="btn-primary")
)
)
)
)
print(page.render(pretty=True))
Why NitroUI?
- Type-safe: IDE autocomplete and type hints for every element
- Composable: Build reusable components as Python classes
- Zero dependencies: Just Python 3.8+, nothing else
- Framework agnostic: Works with FastAPI, Django, Flask, or standalone
- Serializable: Convert to/from JSON for drag-and-drop builders
- Secure by default: Automatic HTML escaping, CSS injection prevention, tag/attribute validation
- SVG-aware: Correct camelCase attribute handling for SVG elements
- LLM-friendly: Perfect for AI-generated interfaces
Installation
pip install nitro-ui
AI Assistant Integration
Add NitroUI knowledge to your AI coding assistant:
npx skills add nitrosh/nitro-ui
This enables AI assistants like Claude Code to understand NitroUI and generate correct HTML code.
Quick Examples
Dynamic Content
from nitro_ui import *
def render_user_card(user):
return Div(
Image(src=user["avatar"], alt=user["name"]),
H3(user["name"]),
Paragraph(user["bio"]),
Anchor("View Profile", href=f"/users/{user['id']}"),
cls="user-card"
)
users = [
{"id": 1, "name": "Alice", "bio": "Backend engineer", "avatar": "/avatars/alice.jpg"},
{"id": 2, "name": "Bob", "bio": "Frontend developer", "avatar": "/avatars/bob.jpg"},
]
grid = Div(*[render_user_card(u) for u in users], cls="user-grid")
Method Chaining
from nitro_ui import *
card = (Div()
.add_attribute("id", "hero")
.add_styles({"background": "linear-gradient(135deg, #667eea 0%, #764ba2 100%)", "padding": "4rem"})
.append(H1("Ship faster with NitroUI"))
.append(Paragraph("Stop fighting with templates. Start building.")))
Reusable Components
from nitro_ui import *
class Card(Component):
tag = "div"
class_name = "card"
def template(self, title: str):
return [
H3(title, cls="card-title"),
Slot() # children go here
]
class Alert(Component):
tag = "div"
class_name = "alert"
def template(self, message: str, variant: str = "info"):
self.add_attribute("class", f"alert-{variant}")
self.add_attribute("role", "alert")
return [Paragraph(message), Slot()]
# Usage
page = Div(
Alert("Your changes have been saved.", variant="success"),
Card("Statistics",
Paragraph("Total users: 1,234"),
Paragraph("Active today: 89")
)
)
Components support named slots for complex layouts:
class Modal(Component):
tag = "div"
class_name = "modal"
def template(self, title: str):
return [
Div(H2(title), Slot("actions"), cls="modal-header"),
Div(Slot(), cls="modal-body"),
Div(Slot("footer"), cls="modal-footer")
]
# Named slots via kwargs
Modal("Confirm Delete",
Paragraph("Are you sure?"),
actions=Button("×", cls="close"),
footer=[Button("Cancel"), Button("Delete", cls="danger")]
)
External Stylesheets with Themes
from nitro_ui import *
from nitro_ui.styles import CSSStyle, StyleSheet, Theme
# Use a preset theme
theme = Theme.modern()
stylesheet = StyleSheet(theme=theme)
# Register component styles
btn = stylesheet.register("btn", CSSStyle(
background_color="var(--color-primary)",
color="var(--color-white)",
padding="var(--spacing-sm) var(--spacing-md)",
border_radius="6px",
border="none",
cursor="pointer",
_hover=CSSStyle(background_color="var(--color-primary-dark)")
))
# Use in your HTML
page = HTML(
Head(
Title("Styled Page"),
Style(stylesheet.render())
),
Body(
Button("Click Me", cls=btn)
)
)
Framework Integration
FastAPI
from fastapi import FastAPI
from fastapi.responses import HTMLResponse
from nitro_ui import *
app = FastAPI()
@app.get("/", response_class=HTMLResponse)
async def home():
return HTML(
Head(Title("FastAPI + NitroUI")),
Body(H1("Hello from FastAPI"))
).render()
Flask
from flask import Flask
from nitro_ui import *
app = Flask(__name__)
@app.route("/")
def home():
return HTML(
Head(Title("Flask + NitroUI")),
Body(H1("Hello from Flask"))
).render()
Django
from django.http import HttpResponse
from nitro_ui import *
def home(request):
return HttpResponse(HTML(
Head(Title("Django + NitroUI")),
Body(H1("Hello from Django"))
).render())
Core Features
Pretty Printing
# Compact output (default) - ideal for production
page.render()
# Indented output - ideal for debugging
page.render(pretty=True)
JSON Serialization
Perfect for drag-and-drop builders, undo/redo, or API communication:
from nitro_ui import *
from nitro_ui.core.element import HTMLElement
# Serialize
json_data = page.to_json(indent=2)
# Deserialize
restored = HTMLElement.from_json(json_data)
HTML Parsing
Import existing HTML into NitroUI for manipulation:
from nitro_ui import from_html
element = from_html('<div class="card"><h1>Hello</h1></div>')
element.append(Paragraph("Added with NitroUI"))
Fragments
Group elements without a wrapper tag:
from nitro_ui import *
def table_rows(items):
return Fragment(*[
TableRow(TableDataCell(item["name"]), TableDataCell(item["price"]))
for item in items
])
Form Builder
Generate HTML5 forms with validation using the Field class:
from nitro_ui import *
form = Form(
Field.email("email", label="Email", required=True),
Field.password("password", label="Password", min_length=8),
Field.select("country", ["USA", "Canada", "Mexico"], label="Country"),
Field.checkbox("terms", label="I agree to the Terms", required=True),
Button("Sign Up", type="submit"),
action="/register"
)
Field types: text, email, password, url, tel, search, textarea, number, range, date, time, datetime_local, select, checkbox, radio, file, hidden, color. See SKILL.md for full API.
HTMX Integration
Build interactive UIs without JavaScript. NitroUI converts hx_* kwargs to hx-* attributes automatically:
from nitro_ui import *
# Live search
Input(
type="text",
hx_get="/search",
hx_trigger="keyup changed delay:300ms",
hx_target="#results"
)
# Delete with confirmation
Button(
"Delete",
hx_delete="/items/1",
hx_confirm="Are you sure?",
hx_swap="outerHTML"
)
# Load more
Button("Load More", hx_get="/items?page=2", hx_target="#list", hx_swap="beforeend")
All HTMX attributes are supported: hx_get, hx_post, hx_put, hx_delete, hx_target, hx_swap, hx_trigger, hx_confirm, hx_indicator, hx_boost, and more. See SKILL.md for the complete reference.
Raw HTML Partials
Embed raw HTML for trusted content like analytics tags:
from nitro_ui import Head, Meta, Title, Partial
Head(
Meta(charset="utf-8"),
Partial("""
<!-- Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GA_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'GA_ID');
</script>
"""),
Title("My Page")
)
# Or load from a file (lazy-loaded at render time)
Partial(file="partials/analytics.html")
Warning: Partial bypasses HTML escaping. Only use with trusted content.
CSS Style Helpers
div = Div("Content")
div.add_style("color", "blue")
div.add_styles({"padding": "20px", "margin": "10px"})
div.remove_style("margin")
color = div.get_style("color") # "blue"
Available Elements
Import all elements with from nitro_ui import *:
| Module | Elements |
|---|---|
nitro_ui.tags.html | HTML, Head, Body, Title, Meta, Link, Script, Style, Base, Noscript, IFrame, Template, Svg, Math |
nitro_ui.tags.layout | Div, Section, Article, Header, Nav, Footer, Main, Aside, Details, Summary, Dialog, Address, Hgroup, Search, Menu |
nitro_ui.tags.text | H1-H6, Paragraph, Span, Strong, Em, Bold, Italic, Anchor (alias: Href), Code, Pre, Blockquote, Br, Wbr, Bdi, Bdo, Ruby, Rt, Rp, Data, and more |
nitro_ui.tags.form | Form, Input, Button, Select, Option, Textarea, Label, Fieldset, Legend, Optgroup, Output, Progress, Meter, Datalist |
nitro_ui.tags.lists | UnorderedList, OrderedList, ListItem, DescriptionList, DescriptionTerm, DescriptionDetails |
nitro_ui.tags.media | Image, Video, Audio, Source, Track, Picture, Figure, Figcaption, Canvas, Embed, Object, Param, Map, Area |
nitro_ui.tags.table | Table, TableRow, TableHeader, TableBody, TableFooter, TableHeaderCell, TableDataCell, Caption, Col, Colgroup |
Element API
Manipulation - append(*children) / prepend(*children) - Add children - clear() - Remove all children - clone() - Deep copy element - find_by_attribute(attr, value) - Find child by attribute
Attributes - add_attribute(key, value) / add_attributes(list) - get_attribute(key) / has_attribute(key) - remove_attribute(key) - HTML5 boolean attributes (disabled, checked, required, etc.) render correctly: True renders as a bare attribute, False omits it, None omits it - SVG camelCase attributes are supported via snake_case kwargs: view_box renders as viewBox, preserve_aspect_ratio as preserveAspectRatio, etc.
Styles - add_style(prop, value) / add_styles(dict) - get_style(prop) / remove_style(prop)
Output - render(pretty=False) - Generate HTML string - to_json() / from_json() - JSON serialization - to_dict() / from_dict() - Dictionary conversion
All manipulation methods return self for chaining.
For AI/LLM Integration
NitroUI is designed to work seamlessly with AI code generation. See SKILL.md for a complete technical reference including method signatures, all tags, and common patterns.
Development
# Setup
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
# Run tests
pytest
# Format
black src/ tests/
Ecosystem
- nitro-cli - Python-powered static site generator
- nitro-datastore - Schema-free JSON data store with dot notation access
- nitro-dispatch - Framework-agnostic plugin system
- nitro-image - Fast, friendly image processing for the web
- nitro-validate - Dependency-free data validation
License
This project is licensed under the BSD 3-Clause License. See the LICENSE file for details.
API Reference
Auto-generated from the installed package's public API. Signatures and docstrings come directly from the source.
Components
Component#
Component(*args, **kwargs)Base class for building reusable components with declarative templates. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. Override to define this component's structure. Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()template(self) -> List[Any]text()
Element base
HTMLElement#
HTMLElement(*children: Union[ForwardRef('HTMLElement'), str, List[Any]], tag: str, self_closing: bool = False, **attributes: str)Foundation class for every HTML element in NitroUI. Set a single HTML attribute on this element. Set multiple HTML attributes in one call. Add a single inline CSS declaration to this element. Merge a dict of inline CSS declarations into this element. Add children to the end of this element. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Remove all children from this element. Return a deep copy of this element and its entire subtree. Return the number of direct children (not including text content). Yield children (and optionally descendants) matching a predicate. Return the first descendant (or self) whose attribute matches. Return the first child, or ``None`` if this element has none. Reconstruct an element tree from a ``to_dict()`` result. Reconstruct an element tree from a ``to_json()`` result. Assign an auto-generated ``id`` attribute if one is not already set. Return the value of a named attribute, or ``None`` if absent. Return a copy of attributes, optionally restricted to given keys. Return the inline CSS value for a property, or ``None`` if unset. Return ``True`` if the given attribute is set on this element. Return the last child, or ``None`` if this element has none. Hook called immediately after this element finishes rendering. Hook called immediately before this element renders itself. Hook called at the end of ``__init__``. Override for custom setup. Hook called from ``__del__``. Do not rely on this for cleanup. Remove and return a child by position. Insert children at the front of this element. Remove every direct child matching a predicate. Remove an attribute by key. Missing keys are silently ignored. Remove an inline CSS declaration by property name. Serialize this element and its subtree to an HTML string. Swap a child at the given index with a new element. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source). Serialize this element and its subtree to a plain dict. Serialize this element and its subtree to a JSON string.37 methods
add_attribute(self, key: str, value: str) -> 'HTMLElement'add_attributes(self, attributes: List[Tuple[str, str]]) -> 'HTMLElement'add_style(self, key: str, value: str) -> 'HTMLElement'add_styles(self, styles: dict) -> 'HTMLElement'append(self, *children: Union[ForwardRef('HTMLElement'), str, List[Any]]) -> 'HTMLElement'attributes()children()clear(self) -> 'HTMLElement'clone(self) -> 'HTMLElement'count_children(self) -> intfilter(self, condition: Callable[[Any], bool], recursive: bool = False, max_depth: int = 1000, _current_depth: int = 0) -> Iterator[ForwardRef('HTMLElement')]find_by_attribute(self, attr_name: str, attr_value: Any, max_depth: int = 1000) -> Optional[ForwardRef('HTMLElement')]first(self) -> Optional[ForwardRef('HTMLElement')]from_dict(data: dict, _depth: int = 0, max_depth: int = 1000) -> 'HTMLElement'from_json(json_str: str) -> 'HTMLElement'generate_id(self) -> Noneget_attribute(self, key: str) -> Optional[str]get_attributes(self, *keys: str) -> dictget_style(self, key: str) -> Optional[str]has_attribute(self, key: str) -> boollast(self) -> Optional[ForwardRef('HTMLElement')]on_after_render(self) -> Noneon_before_render(self) -> Noneon_load(self) -> Noneon_unload(self) -> Nonepop(self, index: int = 0) -> 'HTMLElement'prepend(self, *children: Union[ForwardRef('HTMLElement'), str, List[Any]]) -> 'HTMLElement'remove_all(self, condition: Callable[[Any], bool]) -> 'HTMLElement'remove_attribute(self, key: str) -> 'HTMLElement'remove_style(self, key: str) -> 'HTMLElement'render(self, pretty: bool = False, _indent: int = 0, max_depth: int = 1000) -> strreplace_child(self, old_index: int, new_child: 'HTMLElement') -> Noneself_closing()tag()text()to_dict(self, _depth: int = 0, max_depth: int = 1000) -> dictto_json(self, indent: Optional[int] = None) -> str
Fragments & slots
Fragment#
Fragment(*children: Union[ForwardRef('HTMLElement'), str, List[Any]], **attributes: str)A container that renders only its children without wrapping tags. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Renders only the children without the fragment wrapper. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).6 methods
attributes()children()render(self, pretty: bool = False, _indent: int = 0, max_depth: int = 1000) -> strself_closing()tag()text()
Slot#
Slot(name: str = None, default: Union[ForwardRef('HTMLElement'), List[Any], NoneType] = None)Marker for where content should be inserted in a Component template. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Return an empty string - ``Component`` replaces slots before render. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).6 methods
attributes()children()render(self, pretty: bool = False, _indent: int = 0, max_depth: int = 1000) -> strself_closing()tag()text()
Raw HTML partials
Partial#
Partial(html: str = None, *, file: str = None)Embeds raw HTML directly without escaping. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Reconstruct a ``Partial`` from a ``to_dict()`` result. Reconstruct a ``Partial`` from a ``to_json()`` result. Renders the raw HTML content. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source). Return a dict with ``type="partial"`` plus the source marker. Serialize this Partial to a JSON string.10 methods
attributes()children()from_dict(data: dict) -> 'Partial'from_json(json_str: str) -> 'Partial'render(self, pretty: bool = False, _indent: int = 0, max_depth: int = 1000) -> strself_closing()tag()text()to_dict(self) -> dictto_json(self, indent: int = None) -> str
HTML parser
from_html#
from_html(html_string: str, fragment: bool = False) -> Union[nitro_ui.core.element.HTMLElement, List[nitro_ui.core.element.HTMLElement], NoneType]Parse an HTML string into a NitroUI element tree.
Form builder
Field#
Field()Factory of static methods that emit common HTML5 form inputs. Build an ``<input type="checkbox">``, with the label wrapping the input. Build an ``<input type="color">`` color picker. Build an ``<input type="date">`` picker constrained to ``YYYY-MM-DD`` dates. Build an ``<input type="datetime-local">`` picker for local datetimes. Build an ``<input type="email">`` with browser-side format validation. Build an ``<input type="file">`` for attaching files from the client. Build an ``<input type="hidden">`` for carrying state through a form. Build an ``<input type="number">`` for numeric entry. Build an ``<input type="password">`` with optional length constraints. Build a radio-button group wrapped in an accessible ``<fieldset>``. Build an ``<input type="range">`` slider with a bounded numeric range. Build an ``<input type="search">`` with browser-provided clear affordance. Build a ``<select>`` dropdown populated from a flexible options list. Build an ``<input type="tel">`` for phone-number entry. Build a single-line ``<input type="text">`` with validation attrs. Build a multi-line ``<textarea>`` input. Build an ``<input type="time">`` picker constrained to ``HH:MM`` times. Build an ``<input type="url">`` with browser-side URL validation.18 methods
checkbox(name: str, label: Optional[str] = None, checked: bool = False, value: str = 'on', wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[str] = None, required: bool = False, **attrs) -> nitro_ui.core.elem...color(name: str, label: Optional[str] = None, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[str] = None, **attrs) -> nitro_ui.core.element.HTMLElementdate(name: str, label: Optional[str] = None, required: bool = False, min: Optional[str] = None, max: Optional[str] = None, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[st...datetime_local(name: str, label: Optional[str] = None, required: bool = False, min: Optional[str] = None, max: Optional[str] = None, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[st...email(name: str, label: Optional[str] = None, required: bool = False, placeholder: Optional[str] = None, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[str] = None, **attrs)...file(name: str, label: Optional[str] = None, required: bool = False, accept: Optional[str] = None, multiple: bool = False, wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[str] = None, **attrs) -> nitro_...hidden(name: str, value: str, **attrs) -> nitro_ui.core.element.HTMLElementnumber(name: str, label: Optional[str] = None, required: bool = False, min: Union[int, float, NoneType] = None, max: Union[int, float, NoneType] = None, step: Union[int, float, str, NoneType] = None, value: Union[int, float...password(name: str, label: Optional[str] = None, required: bool = False, min_length: Optional[int] = None, max_length: Optional[int] = None, placeholder: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = N...radio(name: str, options: List[Union[tuple, Dict[str, Any]]], label: Optional[str] = None, required: bool = False, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, **attrs) -> nitro_ui.cor...range(name: str, label: Optional[str] = None, min: Union[int, float] = 0, max: Union[int, float] = 100, step: Union[int, float, str, NoneType] = None, value: Union[int, float, NoneType] = None, wrapper: Union[str, Dict[str...search(name: str, label: Optional[str] = None, required: bool = False, placeholder: Optional[str] = None, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[str] = None, **attrs)...select(name: str, options: List[Union[str, tuple, Dict[str, Any]]], label: Optional[str] = None, required: bool = False, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[str] =...tel(name: str, label: Optional[str] = None, required: bool = False, pattern: Optional[str] = None, placeholder: Optional[str] = None, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, id:...text(name: str, label: Optional[str] = None, required: bool = False, min_length: Optional[int] = None, max_length: Optional[int] = None, pattern: Optional[str] = None, placeholder: Optional[str] = None, value: Optional[st...textarea(name: str, label: Optional[str] = None, required: bool = False, rows: Optional[int] = None, cols: Optional[int] = None, min_length: Optional[int] = None, max_length: Optional[int] = None, placeholder: Optional[str] =...time(name: str, label: Optional[str] = None, required: bool = False, min: Optional[str] = None, max: Optional[str] = None, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[st...url(name: str, label: Optional[str] = None, required: bool = False, placeholder: Optional[str] = None, value: Optional[str] = None, wrapper: Union[str, Dict[str, Any], NoneType] = None, id: Optional[str] = None, **attrs)...
Styling
CSSStyle#
CSSStyle(**kwargs)Declarative CSS style with pseudo-selector and breakpoint support. Reconstruct a ``CSSStyle`` from a ``to_dict()`` result. Return ``True`` if this style carries any pseudo-selector or breakpoint. Return ``True`` when the base declaration count exceeds a threshold. Combine another style into a new ``CSSStyle`` without mutating either. Serialize this style (including nested pseudo/breakpoint maps) to a dict. Render the base declarations as a single ``style`` attribute value.6 methods
from_dict(data: Dict[str, Any]) -> 'CSSStyle'has_pseudo_or_breakpoints(self) -> boolis_complex(self, threshold: int = 3) -> boolmerge(self, other: 'CSSStyle') -> 'CSSStyle'to_dict(self) -> Dict[str, Any]to_inline(self) -> str
StyleSheet#
StyleSheet(theme: Optional[ForwardRef('Theme')] = None)Registry of named CSS classes that renders to a ``<style>`` block. Drop every registered class and reset the auto-name counter. Return the number of classes currently registered on this sheet. Reconstruct a ``StyleSheet`` from a ``to_dict()`` result. Return a list of every registered class name, in insertion order. Return the style registered for a class name, or ``None`` if absent. Return ``True`` if a style is registered under this class name. Store a style under a class name and return the name for use in HTML. Register a style with a BEM-formatted class name. Emit the full CSS text for every registered class. Override the ``min-width`` value used for a named breakpoint. Serialize registered classes and breakpoint overrides to a dict. Return the rendered CSS wrapped in a ready-to-drop ``<style>`` tag. Remove a registered class and return whether it existed.13 methods
clear(self) -> Nonecount_classes(self) -> intfrom_dict(data: Dict, theme: Optional[ForwardRef('Theme')] = None) -> 'StyleSheet'get_all_class_names(self) -> List[str]get_style(self, name: str) -> Optional[nitro_ui.styles.style.CSSStyle]has_class(self, name: str) -> boolregister(self, name: Optional[str] = None, style: Optional[nitro_ui.styles.style.CSSStyle] = None) -> strregister_bem(self, block: str, element: Optional[str] = None, modifier: Optional[str] = None, style: Optional[nitro_ui.styles.style.CSSStyle] = None) -> strrender(self, pretty: bool = True) -> strset_breakpoint(self, name: str, value: str) -> Noneto_dict(self) -> Dictto_style_tag(self, pretty: bool = True) -> strunregister(self, name: str) -> bool
Theme#
Theme(name: str = 'Default', colors: Optional[Dict[str, str]] = None, typography: Optional[Dict[str, Any]] = None, spacing: Optional[Dict[str, str]] = None, components: Optional[Dict[str, Any]] = None)Named design tokens plus component style presets. Return the built-in "Classic" preset. Reconstruct a ``Theme`` from a ``to_dict()`` result. Look up a preset ``CSSStyle`` for a component, optionally by variant. Flatten colors, spacing, and typography into CSS custom properties. Return the built-in "Minimal" preset. Return the built-in "Modern" preset. Serialize the theme (including nested component styles) to a dict.7 methods
classic() -> 'Theme'from_dict(data: Dict[str, Any]) -> 'Theme'get_component_style(self, component: str, variant: str = 'default') -> Optional[nitro_ui.styles.style.CSSStyle]get_css_variables(self) -> Dict[str, str]minimal() -> 'Theme'modern() -> 'Theme'to_dict(self) -> Dict[str, Any]
HTML elements
Textarea#
Textarea(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Select#
Select(*args, **kwargs)HTML ``<select>`` dropdown with a convenience option builder. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source). Build a ``<select>`` and wrap plain items as ``<option>`` children.6 methods
attributes()children()self_closing()tag()text()with_items(*items, **kwargs) -> 'Select'
Option#
Option(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Button#
Button(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Fieldset#
Fieldset(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Form#
Form(*args, **kwargs)HTML ``<form>`` element with a convenience field-appending builder. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source). Build a ``<form>`` from a flat list of fields and text nodes.6 methods
attributes()children()self_closing()tag()text()with_fields(*items, **kwargs) -> 'Form'
Input#
Input(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Label#
Label(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Optgroup#
Optgroup(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Legend#
Legend(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Output#
Output(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Progress#
Progress(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Meter#
Meter(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Datalist#
Datalist(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
HTML#
HTML(*args, **kwargs)Root ``<html>`` element that also emits ``<!DOCTYPE html>``. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Head#
Head(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Body#
Body(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Title#
Title(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Meta#
Meta(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Link#
Link(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Script#
Script(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Style#
Style(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
IFrame#
IFrame(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Base#
Base(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Noscript#
Noscript(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Template#
Template(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Svg#
Svg(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Math#
Math(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Div#
Div(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Section#
Section(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Header#
Header(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Nav#
Nav(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Footer#
Footer(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
HorizontalRule#
HorizontalRule(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Main#
Main(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Article#
Article(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Aside#
Aside(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Details#
Details(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Summary#
Summary(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Dialog#
Dialog(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Address#
Address(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Hgroup#
Hgroup(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Search#
Search(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Menu#
Menu(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
UnorderedList#
UnorderedList(*args, **kwargs)HTML ``<ul>`` element with a convenience item-wrapping builder. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source). Build a ``<ul>`` and wrap plain items as ``<li>`` children.6 methods
attributes()children()self_closing()tag()text()with_items(*items, **kwargs) -> 'UnorderedList'
OrderedList#
OrderedList(*args, **kwargs)HTML ``<ol>`` element with a convenience item-wrapping builder. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source). Build an ``<ol>`` and wrap plain items as ``<li>`` children.6 methods
attributes()children()self_closing()tag()text()with_items(*items, **kwargs) -> 'OrderedList'
ListItem#
ListItem(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
DescriptionDetails#
DescriptionDetails(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
DescriptionList#
DescriptionList(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
DescriptionTerm#
DescriptionTerm(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Image#
Image(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Video#
Video(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Audio#
Audio(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Source#
Source(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Picture#
Picture(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Figure#
Figure(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Figcaption#
Figcaption(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Canvas#
Canvas(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Track#
Track(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Embed#
Embed(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Object#
Object(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Param#
Param(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Map#
Map(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Area#
Area(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Table#
Table(*args, **kwargs)HTML ``<table>`` element with helpers for loading data from files. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Load a CSV file into a ``<table>`` of ``<tr>`` / ``<td>`` rows. Load a JSON file (a list of row-lists) into a ``<table>``. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).7 methods
attributes()children()from_csv(file_path: str, encoding: str = 'utf-8') -> 'Table'from_json(file_path: str, encoding: str = 'utf-8') -> 'Table'self_closing()tag()text()
TableFooter#
TableFooter(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
TableHeaderCell#
TableHeaderCell(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
TableHeader#
TableHeader(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
TableBody#
TableBody(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
TableDataCell#
TableDataCell(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
TableRow#
TableRow(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Caption#
Caption(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Col#
Col(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Colgroup#
Colgroup(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
H1#
H1(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
H2#
H2(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
H3#
H3(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
H4#
H4(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
H5#
H5(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
H6#
H6(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Paragraph#
Paragraph(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Blockquote#
Blockquote(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Pre#
Pre(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Quote#
Quote(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Cite#
Cite(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Em#
Em(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Italic#
Italic(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Span#
Span(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Strong#
Strong(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Abbr#
Abbr(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Anchor#
Anchor(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Href#
Href(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Small#
Small(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Superscript#
Superscript(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Subscript#
Subscript(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Time#
Time(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Code#
Code(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Bold#
Bold(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Del#
Del(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Ins#
Ins(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Strikethrough#
Strikethrough(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Underline#
Underline(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Kbd#
Kbd(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Samp#
Samp(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Var#
Var(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Mark#
Mark(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Dfn#
Dfn(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Br#
Br(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Wbr#
Wbr(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Bdi#
Bdi(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Bdo#
Bdo(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Ruby#
Ruby(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Rt#
Rt(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Rp#
Rp(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()
Data#
Data(*args, **kwargs)HTML element class for a single fixed tag. Live dict of attributes. Mutation invalidates the styles cache on assign. A shallow copy of the list of child elements. Whether this element renders as a void/self-closing tag. The HTML tag name (e.g. ``"div"``, ``"span"``). Text content of this element (already-joined, unescaped source).5 methods
attributes()children()self_closing()tag()text()