mirror of
https://github.com/home-assistant/developers.home-assistant.git
synced 2025-07-09 10:26:30 +00:00
Add docs for experimental UI
This commit is contained in:
parent
f1cc17f618
commit
16c9deb95f
54
docs/frontend_experiment_index.md
Normal file
54
docs/frontend_experiment_index.md
Normal 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
|
@ -91,6 +91,7 @@
|
|||||||
"frontend_creating_custom_ui": "Creating custom UI",
|
"frontend_creating_custom_ui": "Creating custom UI",
|
||||||
"frontend_development": "Frontend development",
|
"frontend_development": "Frontend development",
|
||||||
"Development": "Development",
|
"Development": "Development",
|
||||||
|
"frontend_experiment_index": "Experimental UI",
|
||||||
"frontend_index": "Home Assistant Frontend",
|
"frontend_index": "Home Assistant Frontend",
|
||||||
"hassio_addon_communication": "Add-On Communication",
|
"hassio_addon_communication": "Add-On Communication",
|
||||||
"hassio_addon_config": "Add-On Configuration",
|
"hassio_addon_config": "Add-On Configuration",
|
||||||
@ -127,6 +128,7 @@
|
|||||||
"Entity Registry": "Entity Registry",
|
"Entity Registry": "Entity Registry",
|
||||||
"Extending the frontend": "Extending the frontend",
|
"Extending the frontend": "Extending the frontend",
|
||||||
"Custom UI": "Custom UI",
|
"Custom UI": "Custom UI",
|
||||||
|
"Experimental UI": "Experimental UI",
|
||||||
"Developing a feature": "Developing a feature",
|
"Developing a feature": "Developing a feature",
|
||||||
"Development 101": "Development 101",
|
"Development 101": "Development 101",
|
||||||
"Creating Platforms": "Creating Platforms",
|
"Creating Platforms": "Creating Platforms",
|
||||||
|
@ -55,6 +55,9 @@
|
|||||||
"Custom UI": [
|
"Custom UI": [
|
||||||
"frontend_creating_custom_ui",
|
"frontend_creating_custom_ui",
|
||||||
"frontend_creating_custom_panels"
|
"frontend_creating_custom_panels"
|
||||||
|
],
|
||||||
|
"Experimental UI": [
|
||||||
|
"frontend_experiment_index"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
"Extending HASS": {
|
"Extending HASS": {
|
||||||
|
Loading…
x
Reference in New Issue
Block a user