mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 09:17:06 +00:00
We didn't document the services (#8147)
Adding documentation on how to use the services. Actually, adding documentation on _what_ the service is ;)
This commit is contained in:
parent
0ae3308daf
commit
26a3643f10
@ -70,6 +70,50 @@ input_text:
|
|||||||
default: text
|
default: text
|
||||||
{% endconfiguration %}
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
### {% linkable_title Services %}
|
||||||
|
|
||||||
|
This components provide three services to modify the state of the `input_text`.
|
||||||
|
|
||||||
|
| Service | Data | Description |
|
||||||
|
| ------- | ---- | ----------- |
|
||||||
|
| `set_value` | `value`<br>`entity_id(s)` | Set the value for specific `input_text` entities.
|
||||||
|
|
||||||
### {% linkable_title Restore State %}
|
### {% linkable_title Restore State %}
|
||||||
|
|
||||||
This component will automatically restore the state it had prior to Home Assistant stopping as long as your entity does **not** have a set value for `initial`. To disable this feature, set a valid value for `initial`.
|
This component will automatically restore the state it had prior to Home Assistant stopping as long as your entity does **not** have a set value for `initial`. To disable this feature, set a valid value for `initial`.
|
||||||
|
|
||||||
|
## {% linkable_title Automation Examples %}
|
||||||
|
|
||||||
|
Here's an example using `input_text` in an action in an automation.
|
||||||
|
|
||||||
|
{% raw %}
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry using 'input_text' in an action in an automation
|
||||||
|
input_select:
|
||||||
|
scene_bedroom:
|
||||||
|
name: Scene
|
||||||
|
options:
|
||||||
|
- Select
|
||||||
|
- Concentrate
|
||||||
|
- Energize
|
||||||
|
- Reading
|
||||||
|
- Relax
|
||||||
|
- 'OFF'
|
||||||
|
initial: 'Select'
|
||||||
|
input_text:
|
||||||
|
bedroom:
|
||||||
|
name: Brightness
|
||||||
|
|
||||||
|
automation:
|
||||||
|
- alias: Bedroom Light - Custom
|
||||||
|
trigger:
|
||||||
|
platform: state
|
||||||
|
entity_id: input_select.scene_bedroom
|
||||||
|
action:
|
||||||
|
- service: input_text.set_value
|
||||||
|
# Again, note the use of 'data_template:' rather than the normal 'data:' if you weren't using an input variable.
|
||||||
|
data_template:
|
||||||
|
entity_id: input_text.bedroom
|
||||||
|
value: "{{ states('input_select.scene_bedroom') }}"
|
||||||
|
```
|
||||||
|
{% endraw %}
|
||||||
|
Loading…
x
Reference in New Issue
Block a user