mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-09 20:48:59 +00:00
40 lines
1.6 KiB
Markdown
40 lines
1.6 KiB
Markdown
---
|
|
layout: page
|
|
title: "Creating custom UI"
|
|
description: "Introduction to create custom ui for Home Assistant."
|
|
date: 2017-02-04 13:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
ha_release: 0.38
|
|
---
|
|
If you would like to use your own [State card](/developers/frontend_add_card/) without merging your code into [home-assistant-polymer](https://github.com/home-assistant/home-assistant-polymer/) you can create your own implementation.
|
|
|
|
Put the element source file and its dependencies in `www/custom_ui/` directory under your Home Assistant [configuration](/docs/configuration/) directory.
|
|
|
|
For example if creating a state card for the `light` domain named `my_custom_light_card` put `my_custom_light_card.html` in `www/custom_ui/`.
|
|
|
|
That file should implement `<my_custom_light_card>` tag with Polymer.
|
|
|
|
In `my_custom_light_card.html` you should use `<link rel="import">` to import all the dependencies **not** used by Home Assistant's UI.
|
|
Do not import any dependencies used by the Home Assistant UI.
|
|
Importing those will work in `development: 1` mode, but will fail in production mode.
|
|
|
|
1) In the `customize:` section of the `configuration.yaml` file put `custom_ui_state_card: <element-name>`.
|
|
2) In the `frontend` section use `extra_html_url` to specify the URL to load.
|
|
|
|
For example:
|
|
```yaml
|
|
homeassistant:
|
|
customize:
|
|
light.bedroom:
|
|
custom_ui_state_card: my_custom_light_card
|
|
|
|
frontend:
|
|
extra_html_url:
|
|
- /local/custom_ui/my_custom_light_card.html
|
|
```
|
|
|
|
For more possibilities, see the [Custom UI section](/cookbook/#user-interface) on our Examples page.
|