List Card 1.0.0 is a rewrite in TypeScript and Lit, with a visual editor, unit tests and automated releases. Existing YAML configs keep working. It also ships everything merged since 0.1.2 (January 2023), including the Folder integration support, actions and text selection from #56, which were never released.
New
- Visual editor. Configure every option from the dashboard UI. Everything is still available in YAML.
- Paging.
page_sizeadds previous/next buttons (#4).page_intervalrotates pages automatically, handy for headlines (#54). - Filtering.
filter.include,exclude,fieldsandcase_sensitivefor keyword filtering, Unicode-safe (#14). - Nested fields.
links.1.hrefstyle paths work infield,sort,add_link, templates and action placeholders (#37). - Enclosure images.
type: imageon feedparser'slinkslist finds the image enclosure (#43). The header row hides automatically when every column title is empty, so an images-only list needs no extra config (#17). - Templates and regex.
templatecombines fields, e.g."[[author]] – [[title]]"(#41, #58).regexshows the first capture group. - Dates.
format/format_optionsshowdate,time,datetimeorrelativevalues in your Home Assistant language (#55). Strings with no year (such as feedparser's defaultdate_format) are left as-is. - Layout and style.
full_widthcolumns (#33), a fixediconfor icon columns (#35),image_style(#22), andlink_target(#59). - Actions.
tap_action,hold_actionanddouble_tap_actionaccept any Home Assistant action (url,more-info,perform-action,navigate,fire-dom-event, …), with[[field]]placeholders (#18). - More data sources. Attributes holding a JSON string are parsed, so REST, MQTT and multiscrape sensors work (#50). Sorting, numeric and natural, works on any field (#38).
empty_messagereplaces an empty card. - Text selection. Cell text can be selected and copied (#47, #49).
Fixed
- The card stopped updating after its first render.
Cannot convert undefined or null to objectwhenfeed_attributeis wrong or the sensor has no data yet (#57, #46). The card now shows a warning naming the available attributes.- A card with no columns configured shows a warning listing the available fields instead of crashing.
- Hold works with mouse and touch, a double tap no longer also fires the tap action, and a hold no longer triggers a click.
- Folder integration: file names containing dots are no longer truncated.
- Removed the broken "Buy me a coffee" link (#51).
Upgrading
- Every existing option keeps its meaning, and per-field CSS classes are kept so card-mod styles still apply.
- A row now shows when any configured column has a value (it used to require all of them).
- A missing entity or attribute shows a warning instead of an empty or hidden card.
- HACS installs the
list-card.jsasset attached to each release. The built file is no longer in the repository.
Thanks
Pull request: @versile2 (Folder integration support and actions, #56).
Issue reporters: @emouawad (#4), @Amir974 (#14), @boojew (#17), @abdalians (#22), @cecheto (#33), @hudsonbrendon (#35), @joeydaal (#37), @kaizersoje (#38), @kongo09 (#41), @deam0n (#43), @viktak (#46, #47, #49), @Madelena (#50), @timgreen (#51), @frantzphilippe (#54), @MarkTimStafford (#55), @Bluscream (#57), @styphonthal (#58), @LoganJFisher (#59), and the reporter of #18.
Also thanks to everyone who tested the betas.
Full details are in #60.