Skip to content

Consistency and readability #11897

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
frenck merged 5 commits into from
Jan 28, 2020
Merged

Consistency and readability #11897

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
253102d
Consistency and readability
perjury Jan 28, 2020
c182963
Update views.markdown
perjury Jan 28, 2020
b81e2c0
Update views.markdown
perjury Jan 28, 2020
71dac88
Update source/lovelace/views.markdown
perjury Jan 28, 2020
2bd5320
Update source/lovelace/views.markdown
perjury Jan 28, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions source/lovelace/views.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ views:
default: true
{% endconfiguration %}

## Options For Visible
### Options For Visible

If you define `visible` as objects instead of a boolean to specify conditions for displaying the view tab:

Expand All @@ -83,11 +83,11 @@ View config:
image: /local/lights.png
```

## Paths
## Path

You can link to one view from another view by its path. For this use cards that support navigation (`navigation_path`). Do not use special characters in paths. Do not begin a path with a number. This will cause the parser to read your path as a view index.
You can link to one view from a card in another view when using cards that support navigation (`navigation_path`). The string supplied here will be appended to the string `/lovelace/` to create the path to the view. Do not use special characters in paths. Do not begin a path with a number. This will cause the parser to read your path as a view index.

### Example
#### Example

View config:

Expand All @@ -107,11 +107,11 @@ Picture card config:
navigation_path: /lovelace/living_room
```

## Icons
## Icon

If you define an icon the title will be used as a tool-tip.

### Example
#### Example

```yaml
- title: Garden
Expand All @@ -122,7 +122,7 @@ If you define an icon the title will be used as a tool-tip.

You can specify the visibility of views as a whole or per-user. (Note: This is only for the display of the tabs. The url path is still accessible)

### Example
#### Example

```yaml
views:
Expand All @@ -142,11 +142,11 @@ views:
...
```

## Panel mode
## Panel

This renders the first card on full width, other cards in this view will not be rendered. Good for cards like `map`, `stack` or `picture-elements`.
Setting panel true sets the view to panel mode. In this mode the first card is rendered full-width, other cards in the view will not be rendered. This mode is good when using cards like `map`, `stack` or `picture-elements`.

### Example
#### Example

```yaml
- title: Map
Expand All @@ -158,18 +158,18 @@ This renders the first card on full width, other cards in this view will not be
- zone.home
```

## Themes
## Theme

Set a separate [theme](/integrations/frontend/#themes) for the view and its cards.

### Example
#### Example

```yaml
- title: Home
theme: happy
```

### Background
## Background

You can style the background of your views with a [theme](/integrations/frontend/#themes). You can use the CSS variable `lovelace-background`. For wallpapers you probably want to use the example below, more options can be found [here](https://developer.mozilla.org/en-US/docs/Web/CSS/background).

Expand Down