---
title: "datalist · RUAL Documentation"
description: "A datalist element."
canonical: https://docs.rual.nl/block-types/state%20ui/state_datalist
language: en
---

# datalist

This block is part of the [`state ui`](https://docs.rual.nl/block-types/state%20ui) group and was last modified in core [`v13.0.5`](https://docs.rual.nl/core-versions/130005).

A datalist element.

- id required `v13.0.1` `value` An unique ID whereby this list can be used on other elements

- options required `array` The options to be shown in the datalist. Can either be a list of values or `[{key, value}]`.

- class `uiclass` Assigns a CSS class to the element. • Hidden when unused

- style `uistyle` Applies inline CSS style to the element • Hidden when unused

- attributes `uiattributes` Adds custom attributes to the element. • Hidden when unused

- state `state` Returns the element to the frontend state.

| `datalist` |
| --- |

A typical wiring for [datalist](https://docs.rual.nl/block-types/state%2520ui/state_datalist): [value](https://docs.rual.nl/block-types/value/value_default) feeds the `id` pin; [with values](https://docs.rual.nl/block-types/array/array_of_values) feeds the `options` pin; the `state` out pin feeds [get component child](https://docs.rual.nl/block-types/state%2520actions/state_component_get_child).

![Studio canvas example for the datalist block: typical wiring for datalist.](https://docs.rual.nl/canvas-examples/state_datalist.png)

### Version history

Introduced in [`v13.0.1`](https://docs.rual.nl/core-versions/130001).

Last modified in [`v13.0.5`](https://docs.rual.nl/core-versions/130005).

- [Back to `state ui`](https://docs.rual.nl/block-types/state%20ui): Return to the main group to view all sub-groups

- [Back to `state elements`](https://docs.rual.nl/block-types/state%20ui?group=state%20elements): Return to the group to view all blocks within this group