
This adds documentation on how to use the input_select component services and how to use it in a scene. This is related to bug home-assistant/home-assistant#4673 Signed-off-by: Jan Losinski <losinski@wh2.tu-dresden.de>
2.5 KiB
layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_release |
---|---|---|---|---|---|---|---|---|---|---|
page | Input Select | Instructions how to integrate the Input Select component into Home Assistant. | 2016-02-02 17:00 | true | false | true | true | home-assistant.png | Automation | 0.13 |
The input_select
component allows the user to define a list of values that can be selected via the frontend and can be used within conditions of automation. When a user selects a new item, a state transition event is generated. This state event can be used in an automation
trigger.
To enable this platform, add the following lines to your configuration.yaml
:
# Example configuration.yaml entry
input_select:
who_cooks:
name: Who cooks today
options:
- Paulus
- Anne Therese
initial: Anne Therese
icon: mdi:panda
living_room_preset:
options:
- Visitors
- Visitors with kids
- Home Alone
Configuration variables:
- [alias] (Required): Alias for the input.
- name (Optional): Friendly name of the input.
- options array: List of options to choose from
- initial (Optional): Initial value when Home Assistant starts.
- icon (Optional): Icon for entry.
Pick an icon that you can find on materialdesignicons.com to use for your input and prefix the name with mdi:
. For example mdi:car
, mdi:ambulance
, or mdi:motorbike
.
{% linkable_title Services %}
This components provide three services to modify the state of the input_select
:
input_select.select_option
: This can be used to select a specific option. The option is passed asoption
attribute in the service data.input_select.select_previous
: Select the previous option.input_select.select_next
: Select the next option.
The following example shows the usage of the input_select.select_option
service in an automation:
# Example configuration.yaml entry
automation:
- alias: example automation
trigger:
platform: event
event_type: MY_CUSTOM_EVENT
action:
- service: input_select.select_option
data:
entity_id: input_select.who_cooks
option: Paulus
{% linkable_title Scenes %}
To specify a target option in a Scene you have to specify the target as option
attribute:
# Example configuration.yaml entry
scene:
- name: Example1
entities:
input_select.who_cooks:
option: Paulus