Todo List Card: Add customization options for empty text, visibility, and interaction

[halwehrenberg]

Overview

This PR adds three new customization options to the Todo List card:

1. Configurable empty list text: Users can customize the message shown when there are no tasks by setting the empty_list_text property.

2. Option to hide empty list message: Added a hide_empty_list property that, when set to true, completely hides the empty list message (including vertical space).

3. Disable editor with click actions: Added a disable_edit_on_click property that prevents the editor from opening when clicking on an item. When this option is enabled, clicking on an item toggles its completion status instead. (Particularly good for re-usable lists like weekly chores)

Why

These enhancements improve customization options for users who:

• Want to personalize the empty list message
• Prefer to hide the empty message entirely to save space
• Want a simpler interaction model where clicking items toggles them instead of opening the editor

Testing

I've tested all three features in my local environment:

• Custom empty list text displays correctly
• Empty list area is completely hidden when specified
• Item toggling works properly when editor is disabled

No performance issues or regressions were found.

Breaking Changes

None. These changes only add optional features that are disabled by default, maintaining backward compatibility.

[home-assistant]

Hi @halwehrenberg

It seems you haven't yet signed a CLA. Please do so here.

Once you do that we will be able to review and accept this pull request.

Thanks!

[home-assistant]

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

Stale

[halwehrenberg]

Screenshots of the visual editor and the different states visible when testing.

[MindFreeze]

Some comments from a UX perspective:

• hide_empty_list shouldn't be an option. It is not clear what it does. Sounds like it hides the whole list which should be done with visibility options instead. For removing margins, we should just always do that if there is not empty message. How to set the message to empty is not clear though
• disable_edit_on_click is again not clear. I get that it disables edit but I wouldn't expect it to toggle the item. Our established pattern is to set actions, like tap_action in this case

[halwehrenberg]

@MindFreeze, Thanks for the feedback! I like it. I plan to update to:

• empty_list_text - customizes the text shown when list is empty (this is current behavior)
• show_empty_text (default: true) - Controls whether to show the empty message text (and its margin)
• disable_item_editing (default: false) - Prevents the edit dialog from opening when clicking item labels. Remove toggle behavior
• toggle_on_item_label_click (default: false) - Split to separate option. Controls whether clicking the item label toggles its checkbox

Watching my own family interact with the cards, these are things that I had to implement via card mod & a lot of effort. I also seen enough traffic on forums to know that these features are useful from a Ux point of view within common use cases like Chores Lists for kids. Great comment, to my eyes this will help a lot!

[halwehrenberg]

@MindFreeze, I've updated the PR based on the feedback:

1. Renamed properties to better reflect their purpose:

   • Renamed hide_empty_list to show_empty_text (default: true)
   • Renamed disable_edit_on_click to disable_item_editing (default: false)

2. Split the item click behavior into two separate options:

   • disable_item_editing - Prevents the edit dialog from opening when clicking item labels
   • toggle_on_item_label_click (default: false) - Controls whether clicking the item label toggles its checkbox

3. Added proper default values in the editor component

These changes maintain the same functionality but with clearer option names and better separation of concerns.