mirror of
https://github.com/joBr99/nspanel-lovelace-ui.git
synced 2025-12-20 22:47:01 +01:00
82 lines
2.5 KiB
Markdown
82 lines
2.5 KiB
Markdown
# Entities
|
|
|
|
Entities are mainly used on cardEntities and cardGrid.
|
|
|
|
It is possible to overwrite and configure varrious things on Entities.
|
|
|
|
## Possible configuration values for entities key:
|
|
|
|
key | optional | type | default | description
|
|
-- | -- | -- | -- | --
|
|
`entity` | False | string | `None` | name of ha entity
|
|
`name` | True | string | `None` | Used to override names
|
|
`icon` | True | string | `None` | Used to override icons
|
|
`color` | True | array | `None` | Overwrite color of entity `color: [255, 0, 0]`
|
|
`state` | True | string | `None` | Only displayed if Entity state is equal to this value
|
|
`state_not` | True | string | `None` | Only displayed if Entity state is unequal to this value
|
|
`status` | True | string | `None` | Only valid for navigate items, adds a entity to track state for the icon
|
|
`assumed_state` | True | string | `None` | Only for cover items, up, down and stop buttons are always shown
|
|
|
|
## Override Icons or Names
|
|
|
|
To overwrite Icons or Names of entities you can configure an icon and/or name in your configuration, please see the following example.
|
|
Only the icons listed in the [Icon Cheatsheet](https://htmlpreview.github.io/?https://github.com/joBr99/nspanel-lovelace-ui/blob/main/HMI/icon-cheatsheet.html) are useable.
|
|
|
|
```yaml
|
|
entities:
|
|
- entity: light.test_item
|
|
name: NameOverride
|
|
icon: mdi:lightbulb
|
|
```
|
|
|
|
It is also possible to configure different icon overwrites per state:
|
|
|
|
```yaml
|
|
icon:
|
|
"on": mdi:lightbulb
|
|
"off": mdi:lightbulb
|
|
```
|
|
|
|
It is also possible to configure different color overwrites per state:
|
|
|
|
```yaml
|
|
color:
|
|
"on": [255,0,0]
|
|
"off": [0,0,255]
|
|
```
|
|
|
|
It is also possible to use text instead of icons with `text:X`
|
|
|
|
```yaml
|
|
icon:
|
|
"on": mdi:lightbulb
|
|
"off": "text:"
|
|
```
|
|
|
|
## Hide item based on state
|
|
|
|
This sensor will only be shown on the card if it's state is equal to `off`
|
|
|
|
```yaml
|
|
- entity: binary_sensor.sensor_bad_contact
|
|
state: "off"
|
|
```
|
|
|
|
This sensor will only be shown on the card if it's state is not equal to `on`
|
|
|
|
```yaml
|
|
- entity: binary_sensor.sensor_kueche_contact
|
|
state_not: "on"
|
|
```
|
|
|
|
## Calling service directly as button
|
|
|
|
The following example shows how to call services directly, this enables you to call services on entities not (yet) supported by the backend and also to pass data to services.
|
|
|
|
```yaml
|
|
- entity: service.light.turn_on
|
|
data:
|
|
entity_id: light.schreibtischlampe
|
|
color_name: "green"
|
|
```
|