mirror of
https://github.com/home-assistant/developers.home-assistant.git
synced 2025-07-09 18:36:29 +00:00
Update lovelace text
This commit is contained in:
parent
c91bb3bf50
commit
5dde87919f
@ -27,6 +27,14 @@ These cards are WIP and things may change.
|
|||||||
| type | string | **Required** | `entity-filter`
|
| type | string | **Required** | `entity-filter`
|
||||||
(wip: check introduction meanwhile)
|
(wip: check introduction meanwhile)
|
||||||
|
|
||||||
|
## Glance
|
||||||
|
|
||||||
|
| Name | Type | Default | Description
|
||||||
|
| ---- | ---- | ------- | -----------
|
||||||
|
| type | string | **Required** | `glance`
|
||||||
|
| entities | list | **Required** | Entity id's
|
||||||
|
| title | string | `None` | Card title
|
||||||
|
|
||||||
## History graph
|
## History graph
|
||||||
|
|
||||||
| Name | Type | Default | Description
|
| Name | Type | Default | Description
|
||||||
|
@ -70,10 +70,10 @@ Home Assistant is currently transitioning away from HTML imports but have not fi
|
|||||||
|
|
||||||
## Referencing your new card
|
## Referencing your new card
|
||||||
|
|
||||||
To use a custom card, set the card type in `experimental-ui.yaml` to `custom:<YOUR CUSTOM ELEMENT TAG>`. In the following example we're going to use a custom card which is registered as custom element `example-card`. Any other config defined with your card will be made available as the `config` property to your card.
|
To use a custom card, set the card type in `ui-lovelace.yaml` to `custom:<YOUR CUSTOM ELEMENT TAG>`. In the following example we're going to use a custom card which is registered as custom element `example-card`. Any other config defined with your card will be made available as the `config` property to your card.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# experimental-ui.yaml example
|
# ui-lovelace.yaml example
|
||||||
title: Example Main title
|
title: Example Main title
|
||||||
views:
|
views:
|
||||||
- name: Example
|
- name: Example
|
||||||
|
@ -3,9 +3,20 @@ title: "Lovelace UI"
|
|||||||
sidebar_label: Introduction
|
sidebar_label: Introduction
|
||||||
---
|
---
|
||||||
|
|
||||||
Starting with Home Assistant 0.72, we're experimenting with a way of defining your user interface. We're calling it the Lovelace UI.
|
> This is an experimental feature. Configuration might change in future versions.
|
||||||
|
|
||||||
The aproach is fundamentally different from the current approach. The old user interface relied solely on the state machine. This caused trouble as it meant that people wanted to store things in the state machine to control the user interface. That's a big violation of seperation of concern. With Lovelace, we're taking a completely different approach. All user interface configuration will live in a seperate file, controlled by the user. This means that we only have to build up the user interface when the UI configuration changes and can just render the states. It will also allow for more configuration options to be added.
|
Starting with Home Assistant 0.72, we're experimenting with a new way of defining your interface. We're calling it the Lovelace UI.
|
||||||
|
|
||||||
|
The Lovelace UI is:
|
||||||
|
|
||||||
|
- **Extremely fast**. We create the user interface when the UI configuration changes. When a state changes, we just make the UI represent the current state.
|
||||||
|
- **Extremely customizable**. We have a new file for just configuration. In the past, we declined UI specific options because they did not fit in the state machine. They will fit in a configuration file for a user interface.
|
||||||
|
- **Extremely extensible**. It's based on the web standard [custom elements](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements). Don't like the built-in cards? Make your own! Custom cards are treated the same as built-in cards and care configured the same way.
|
||||||
|
- **Making the backend faster**. With Lovelace, the backend will no longer need to maintain entities like groups for the sole purpose of showing them on the frontend.
|
||||||
|
|
||||||
|
## How it works
|
||||||
|
|
||||||
|
The old user interface relied solely on the state machine. This caused trouble as it meant that the state machine was now not only the source for device states, but also for user interface configuration. With Lovelace, we're taking a completely different approach. All user interface configuration will live in a seperate file, controlled by the user.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
@ -13,10 +24,10 @@ The aproach is fundamentally different from the current approach. The old user i
|
|||||||
|
|
||||||
## Trying it out
|
## Trying it out
|
||||||
|
|
||||||
Create a new file `<config>/experimental-ui.yaml` and add the following content:
|
Create a new file `<config>/ui-lovelace.yaml` and add the following content:
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
title: My Awesome Home
|
name: My Awesome Home
|
||||||
views:
|
views:
|
||||||
# The name of a view will be used as tab title.
|
# The name of a view will be used as tab title.
|
||||||
# Might be used for other things in the future.
|
# Might be used for other things in the future.
|
||||||
@ -75,7 +86,7 @@ input_boolean:
|
|||||||
name: TV
|
name: TV
|
||||||
```
|
```
|
||||||
|
|
||||||
Now restart Home Assistant, navigate to `<YOUR HASS URL>/experimental-ui`. When you make changes to `experimental-ui.yaml`, you don't have to restart Home Assistant or refresh the page. Just hit the refresh button at the top of the UI.
|
Now restart Home Assistant, navigate to `<YOUR HASS URL>/lovelace`. When you make changes to `ui-lovelace.yaml`, you don't have to restart Home Assistant or refresh the page. Just hit the refresh button at the top of the UI.
|
||||||
|
|
||||||
## Current limitations
|
## Current limitations
|
||||||
|
|
||||||
@ -85,4 +96,4 @@ This is the very very early version aimed at gathering feedback. Discussion and
|
|||||||
|
|
||||||
**Home Assistant 0.72**
|
**Home Assistant 0.72**
|
||||||
|
|
||||||
- Initial release supporting title, defining views with a name, tab icon, theme and cards. Supported cards are entities, entity-filter and custom.
|
- Initial release of the Lovelace UI.
|
||||||
|
@ -142,7 +142,7 @@
|
|||||||
"Intents": "Intents",
|
"Intents": "Intents",
|
||||||
"asyncio": "asyncio",
|
"asyncio": "asyncio",
|
||||||
"Hass.io Add-Ons": "Hass.io Add-Ons",
|
"Hass.io Add-Ons": "Hass.io Add-Ons",
|
||||||
"Maintainer docs": "Maintainer docs",
|
"Maintainer docs": "Maintainer docs"
|
||||||
},
|
},
|
||||||
"pages-strings": {
|
"pages-strings": {
|
||||||
"Learn more using the [documentation on this site.](/test-site/docs/en/doc1.html)|no description given": "Learn more using the [documentation on this site.](/test-site/docs/en/doc1.html)",
|
"Learn more using the [documentation on this site.](/test-site/docs/en/doc1.html)|no description given": "Learn more using the [documentation on this site.](/test-site/docs/en/doc1.html)",
|
||||||
|
Loading…
x
Reference in New Issue
Block a user