jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-07-15 13:26:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

Some remarks

Browse Source
This commit is contained in:
G Johansson 2024-11-09 21:19:04 +00:00
parent ec175df14e
commit ee15f47a9f
1 changed files with 3 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/core/entity.md
View File

@ -121,13 +121,13 @@ The following properties are also available on entities. However, they are for a
## State attributes
Entities can provide additional state attributes besides the built-in ones, to provide further details to it's state.
Entities can provide additional state attributes besides the built-in ones, to provide further details to its state.
This should be done by providing a dictionary with keys and values to the `extra_state_attributes` property.
Providing additional state attributes comes with some rules:
Providing state attributes comes with the following rules:
- If an attribute is expected, it should be in the dictionary. Attributes should not "come and go".
- If an attribute is expected, but it's not providing a value right now, its value should be `None` and remain in the dictionary
- If an attribute is expected, but it's not providing a value right now, its value should be `None` and remain in the dictionary.
- If an attributes is not expected, it should not be in the dictionary. As example, only some attributes might provide additional context to the state when the entity runs with a certain configuration.
## System properties