# List

The [`List`][list] widget lays a set of [`WidgetList`][children] as a list of
items with an optional indicator. It creates lists in a similar fashion to
HTML's `<ol>` and `<ul>` tags.

A [`ListStyle`][liststyle] controls the indicator and whether a [trailing
delimiter][trailingdelimiter] is shown next to the indicator.

[list]: <{{ docs }}/widgets/list/struct.List.html>
[children]: <{{ docs }}/widget/struct.WidgetList.html>
[liststyle]: <{{ docs }}/widgets/list/enum.ListStyle.html>
[trailingdelimiter]: <{{ docs }}/widgets/list/struct.TrailingDelimiter.html>