> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rixxui.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forms, charts, media, math, and Mermaid

> Use constrained first-party rich components without allowing generated executable behavior.

## Forms

`Form` contains local `TextField` and `Select` inputs and emits one registered
action payload on submit. Fields remain inert until commit. The host owns saved
drafts, authorization, persistence, server validation, and submission effects.

```rui theme={null}
root = Form(action="profile.save", submitLabel="Save", children=[name])
name = TextField(name="name", label="Name", value="", required=true)
```

## Charts and tables

`Chart` supports `line`, `area`, `bar`, `horizontalBar`, `stackedBar`, `pie`,
`donut`, `scatter`, `sparkline`, and `heatmap`. Supply constrained row data and
field keys; use `showTable=true` for a visible tabular alternative.

```rui theme={null}
root = Chart(kind="bar", title="Revenue", data=[{month:"Jan",value:42}], x="month", y="value", format="currency", showTable=true)
```

`DataTable` supports declared columns, locale-aware sorting and formatting,
filtering, pagination, and mobile cards. Data and chart inputs have catalog
budgets.

## Images and galleries

`Image` and Markdown images share the same policy pipeline. `Gallery` supports
grid, carousel, and justified presentation with a keyboard-accessible media
viewer. Width, height, alt text, and captions improve layout stability and
accessibility. Video, audio, arbitrary embeds, and model-provided SVG are not
supported.

## Math and Mermaid

`Math` renders KaTeX from a bounded expression and supports inline or display
presentation. `Diagram` renders sanitized Mermaid only after authoritative
commit and requires a title and description.

```rui theme={null}
root = Stack(children=[formula, flow])
formula = Math(expression="E = mc^2", display=true, label="Mass-energy equivalence")
flow = Diagram(title="Request flow", description="Host validates before execution.", source="flowchart LR; A[Request] --> B[Host policy]")
```

Neither feature enables arbitrary HTML, JavaScript, CSS, imports, or network
definitions. See [core components](/reference/core-components) for the complete
catalog list.
