diff --git a/source/_includes/asides/lovelace_navigation.html b/source/_includes/asides/lovelace_navigation.html index 589f838ee21..fd5b58c70ab 100644 --- a/source/_includes/asides/lovelace_navigation.html +++ b/source/_includes/asides/lovelace_navigation.html @@ -7,11 +7,20 @@
+
+Visual comparison of old configuration versus new configuration
+
-This is an experimental feature. Configuration might change in future versions. -
- -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 are configured the same way. [Check the docs.](https://developers.home-assistant.io/docs/en/lovelace_custom_card.html) -- **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. +Lovelace is the name of the Home Assistant user interface. It is a fast, customizable and powerful way for users to manage their homes, working both on mobile and desktop.-If you're not using Firefox 63+ or Chrome, please be sure to [read the FAQ](/lovelace/#faq) below. -
- -## {% linkable_title 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 separate file, controlled by the user. - -
-
-Visual comparison of old configuration versus new configuration
-
- Lovelace only has limited file splitting functionality, due to the fact that Home Assistant - will be writing directly to the `ui-lovelace.yaml` file. - - Only `!include` and `!secret` are supported at the moment. - - If you want to split your configuration you can use one of the tools listed above, but edits done with the UI will - be overwritten by those tools, so you should not use both. -
- -## {% linkable_title Tips and Tricks %} - -### {% linkable_title Header Using Panel and Stacks %} - -You can create a header by using `panel: true` with nested -[Vertical Stack][vertical-stack] and [Horizontal Stack][horizontal-stack] -cards. See the code [here][header-stacks]. ([@dale3h]) - -### {% linkable_title Disable Click on Elements %} - -If you do not want an element to be clickable you can add `pointer-events: none` -to the element's `style:` configuration. This is quite useful when building a -[Picture Elements][picture-elements] card that will be viewed mostly in a -mobile browser. (@Toast) +The [Lovelace Jinja2 Script][lovelace-jinja] by [@skalavala] is a simple Jinja2 script that you run in the template editor to generate lovelace configuration based on the entities that are already setup. [@dale3h]: https://github.com/dale3h [@thomasloven]: https://github.com/thomasloven diff --git a/source/lovelace/yaml-mode.markdown b/source/lovelace/yaml-mode.markdown new file mode 100644 index 00000000000..eaff16c8035 --- /dev/null +++ b/source/lovelace/yaml-mode.markdown @@ -0,0 +1,107 @@ +--- +layout: page +title: "Lovelace YAML mode" +description: "Advanced users can switch on the advanced YAML mode." +date: 2018-07-01 10:28 +00:00 +sidebar: true +comments: false +sharing: true +footer: true +--- + +It is possible to write your Lovelace config in YAML instead of via the UI. To do so, you will need to configure the Lovelace component to be in yaml mode: + +```yaml +lovelace: + mode: yaml +``` + +Restart Home Assistant for the mode to be changed. Create a new file `