jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Merge branch 'current' into next

Browse source
This commit is contained in:
Fabian Affolter 2016-12-17 23:48:57 +01:00
commit 73ed694fed
No known key found for this signature in database
GPG key ID: DDF3D6F44AAB1336
40 changed files with 313 additions and 230 deletions
Download patch file Download diff file Expand all files Collapse all files

22
source/_components/group.markdown
View file

@ -11,11 +11,11 @@ logo: home-assistant.png
ha_category: Organization
---
Groups allow the user to combine multiple entities into one. A group can be promoted to a **view** by setting the `view` option to `yes`. This will make the group available as a new tab in the frontend.
Groups allow the user to combine multiple entities into one. A group can be promoted to a **view** by setting `view: yes` under the group definition. This will make the group available as a new tab in the frontend.
Check the **Set State** <img src='/images/screenshots/developer-tool-states-icon.png' class='no-shadow' height='38' /> page from the **Developer Tools** and browse the **Current entities:** listing for all available entities.
By default, every group appears in the HOME tab. If you name a group `default_view` it will REPLACE the contents of the HOME tab so you can customize it as you wish.
By default, every group appears in the HOME tab. If you create a group `default_view` it will REPLACE the contents of the HOME tab so you can customize the HOME tab as you wish.
```yaml
# Example configuration.yaml entry
@ -23,6 +23,7 @@ group:
default_view:
view: yes
entities:
- group.kitchen
- group.awesome_people
- group.climate
kitchen:
@ -38,11 +39,26 @@ group:
- camera.demo_camera
- device_tracker.demo_paulus
- group.garden
climate:
name: Climate
view: no
entities:
- sensor.bedroom_temp
- sensor.porch_temp
- sensor.bathroom_humidity
awesome_people:
name: Awesome People
view: no
entities:
- device_tracker.dad_smith
- device_tracker.mom_smith
- device_tracker.dog_smith
```
Configuration variables:
- **view** (*Optional*): If yes then the entry will be shown as a view (tab).
- **view** (*Optional*): If yes then the entry will be shown as a view (tab) at the top.
- **name** (*Optional*): Name of the group.
- **icon** (*Optional*): If the group is a view, this icon will show at the top in the frontend instead of the name. If it's not a view, then the icon shows when this group is used in another group.
- **control** (*Optional*): If hidden then the group switch will be hidden.