Add docs for experimental UI

This commit is contained in:
Paulus Schoutsen 2018-06-16 17:29:02 -04:00
parent f1cc17f618
commit 16c9deb95f
3 changed files with 59 additions and 0 deletions

View File

@ -0,0 +1,54 @@
---
title: "Experimental UI"
sidebar_label: Introduction
---
Starting with Home Assistant 0.72, we're experimenting with a way of defining your user interface. The aproach is fundamentally different from the current approach.
The current approach will look at your groups and entities and will sort them on the fly. With our experimental UI, it is purely based on configuration that is provided by the user, defined in `<config>/experimental-ui.yaml`.
## Trying it out
Create `<config>/experimental-ui.yaml`:
```yaml
views:
- cards:
- type: entities
title: Example
entities:
- input_boolean.switch_ac_kitchen
- input_boolean.switch_ac_livingroom
- input_boolean.switch_tv
- type: entity-filter
filter:
domain: input_boolean
state: 'on'
card_config:
title: Input booleans that are on
theme: dark-mode
```
Add to your `configuration.yaml`:
```yaml
input_boolean:
switch_ac_kitchen:
name: AC kitchen
switch_ac_livingroom:
name: AC living room
switch_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.
## Current limitations
This is the very very early version aimed at gathering feedback. Discussion and suggestions are welcome in the [ui-schema repository](https://github.com/home-assistant/ui-schema).
## Change log
**Home Assistant 0.72**
- Initial release

View File

@ -91,6 +91,7 @@
"frontend_creating_custom_ui": "Creating custom UI",
"frontend_development": "Frontend development",
"Development": "Development",
"frontend_experiment_index": "Experimental UI",
"frontend_index": "Home Assistant Frontend",
"hassio_addon_communication": "Add-On Communication",
"hassio_addon_config": "Add-On Configuration",
@ -127,6 +128,7 @@
"Entity Registry": "Entity Registry",
"Extending the frontend": "Extending the frontend",
"Custom UI": "Custom UI",
"Experimental UI": "Experimental UI",
"Developing a feature": "Developing a feature",
"Development 101": "Development 101",
"Creating Platforms": "Creating Platforms",

View File

@ -55,6 +55,9 @@
"Custom UI": [
"frontend_creating_custom_ui",
"frontend_creating_custom_panels"
],
"Experimental UI": [
"frontend_experiment_index"
]
},
"Extending HASS": {