mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-13 04:16:48 +00:00
Merge pull request #3403 from BioSehnsucht/rename-input-slider
Rename input_slider to input_number and add numeric text box option
This commit is contained in:
commit
decb5d2f56
@ -31,7 +31,7 @@ To use the `dweet` component in your installation, add the following to your `co
|
||||
dweet:
|
||||
name: HAExport
|
||||
whitelist:
|
||||
- input_slider.brightness
|
||||
- input_number.brightness
|
||||
- input_boolean.notify_home
|
||||
- sensor.weather_temperature
|
||||
- sensor.cpu
|
||||
|
@ -1,8 +1,8 @@
|
||||
---
|
||||
layout: page
|
||||
title: "Input Slider"
|
||||
description: "Instructions how to integrate the Input Slider component into Home Assistant."
|
||||
date: 2016-03-15 06:00
|
||||
title: "Input Number"
|
||||
description: "Instructions how to integrate the Input Number component into Home Assistant."
|
||||
date: 2017-09-19 03:30
|
||||
sidebar: true
|
||||
comments: false
|
||||
sharing: true
|
||||
@ -12,40 +12,48 @@ ha_category: Automation
|
||||
ha_release: 0.16
|
||||
---
|
||||
|
||||
The `input_slider` component allows the user to define values that can be controlled via the frontend and can be used within conditions of automation. Changes to the slider generate state events. These state events can be utilized as `automation` triggers as well.
|
||||
The `input_number` component allows the user to define values that can be controlled via the frontend and can be used within conditions of automation. The frontend can display a slider, or a numeric input box. Changes to the slider or numeric input box generate state events. These state events can be utilized as `automation` triggers as well.
|
||||
|
||||
To enable this input sliders in your installation, add the following lines to your `configuration.yaml`:
|
||||
To enable this input number in your installation, add the following lines to your `configuration.yaml`:
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
input_slider:
|
||||
input_number:
|
||||
slider1:
|
||||
name: Slider 1
|
||||
name: Slider
|
||||
initial: 30
|
||||
min: -20
|
||||
max: 35
|
||||
step: 1
|
||||
box1:
|
||||
name: Numeric Input Box
|
||||
initial: 30
|
||||
min: -20
|
||||
max: 35
|
||||
step: 1
|
||||
mode: box
|
||||
```
|
||||
|
||||
Configuration variables:
|
||||
|
||||
- **[alias]** (*Required*): Alias for the slider input. Multiple entries are allowed.
|
||||
- **min** (*Required*): Minimum value for the slider.
|
||||
- **max** (*Required*): Maximum value for the slider.
|
||||
- **name** (*Optional*): Friendly name of the slider input.
|
||||
- **[alias]** (*Required*): Alias for the input. Multiple entries are allowed.
|
||||
- **min** (*Required*): Minimum value.
|
||||
- **max** (*Required*): Maximum value.
|
||||
- **name** (*Optional*): Friendly name of the input.
|
||||
- **initial** (*Optional*): Initial value when Home Assistant starts. Defaults to 0.
|
||||
- **step** (*Optional*): Step value for the slider. Defaults to 1.
|
||||
- **mode** (*Optional*): Can specify `box`, or `slider`. Defaults to `slider`.
|
||||
|
||||
## {% linkable_title Automation Examples %}
|
||||
|
||||
Here's an example of `input_slider` being used as a trigger in an automation.
|
||||
Here's an example of `input_number` being used as a trigger in an automation.
|
||||
|
||||
```yaml
|
||||
{% raw %}
|
||||
# Example configuration.yaml entry using 'input_slider' as a trigger in an automation
|
||||
# Example configuration.yaml entry using 'input_number' as a trigger in an automation
|
||||
|
||||
# Define input_slider
|
||||
input_slider:
|
||||
# Define input_number
|
||||
input_number:
|
||||
bedroom_brightness:
|
||||
name: Brightness
|
||||
initial: 254
|
||||
@ -58,7 +66,7 @@ automation:
|
||||
- alias: Bedroom Light - Adjust Brightness
|
||||
trigger:
|
||||
platform: state
|
||||
entity_id: input_slider.bedroom_brightness
|
||||
entity_id: input_number.bedroom_brightness
|
||||
action:
|
||||
- service: light.turn_on
|
||||
# Note the use of 'data_template:' below rather than the normal 'data:' if you weren't using an input variable
|
||||
@ -68,11 +76,11 @@ automation:
|
||||
{% endraw %}
|
||||
```
|
||||
|
||||
Another code example using `input_slider`, this time being used in an action in an automation.
|
||||
Another code example using `input_number`, this time being used in an action in an automation.
|
||||
|
||||
```yaml
|
||||
{% raw %}
|
||||
# Example configuration.yaml entry using 'input_slider' in an action in an automation
|
||||
# Example configuration.yaml entry using 'input_number' in an action in an automation
|
||||
|
||||
# Define 'input_select'
|
||||
input_select:
|
||||
@ -87,8 +95,8 @@ input_select:
|
||||
- 'OFF'
|
||||
initial: 'Select'
|
||||
|
||||
# Define input_slider
|
||||
input_slider:
|
||||
# Define input_number
|
||||
input_number:
|
||||
bedroom_brightness:
|
||||
name: Brightness
|
||||
initial: 254
|
||||
@ -108,19 +116,19 @@ automation:
|
||||
# Again, note the use of 'data_template:' rather than the normal 'data:' if you weren't using an input variable.
|
||||
data_template:
|
||||
entity_id: light.bedroom
|
||||
brightness: '{{ states.input_slider.bedroom_brightness.state | int }}'
|
||||
brightness: '{{ states.input_number.bedroom_brightness.state | int }}'
|
||||
{% endraw %}
|
||||
```
|
||||
|
||||
|
||||
Example of `input_slider` being used in a bidirectional manner, both being set by and controlled by an MQTT action in an automation.
|
||||
Example of `input_number` being used in a bidirectional manner, both being set by and controlled by an MQTT action in an automation.
|
||||
|
||||
```yaml
|
||||
{% raw %}
|
||||
# Example configuration.yaml entry using 'input_slider' in an action in an automation
|
||||
# Example configuration.yaml entry using 'input_number' in an action in an automation
|
||||
|
||||
# Define input_slider
|
||||
input_slider:
|
||||
# Define input_number
|
||||
input_number:
|
||||
target_temp:
|
||||
name: Target Heater Temperature Slider
|
||||
min: 1
|
||||
@ -136,11 +144,11 @@ input_slider:
|
||||
trigger:
|
||||
platform: mqtt
|
||||
topic: "setTemperature"
|
||||
# entity_id: input_slider.target_temp
|
||||
# entity_id: input_number.target_temp
|
||||
action:
|
||||
service: input_slider.select_value
|
||||
service: input_number.set_value
|
||||
data_template:
|
||||
entity_id: input_slider.target_temp
|
||||
entity_id: input_number.target_temp
|
||||
value: '{{ trigger.payload}}'
|
||||
|
||||
# This automation script runs when the target temperature slider is moved.
|
||||
@ -148,12 +156,12 @@ input_slider:
|
||||
- alias: Temp slider moved
|
||||
trigger:
|
||||
platform: state
|
||||
entity_id: input_slider.target_temp
|
||||
entity_id: input_number.target_temp
|
||||
action:
|
||||
service: mqtt.publish
|
||||
data_template:
|
||||
topic: "setTemperature"
|
||||
retain: true
|
||||
payload: '{{ states.input_slider.target_temp.state | int }}'
|
||||
payload: '{{ states.input_number.target_temp.state | int }}'
|
||||
{% endraw %}
|
||||
```
|
@ -39,11 +39,11 @@ automation:
|
||||
- alias: run_set_ac
|
||||
trigger:
|
||||
platform: state
|
||||
entity_id: input_slider.ac_temperature
|
||||
entity_id: input_number.ac_temperature
|
||||
action:
|
||||
service: shell_command.set_ac_to_slider
|
||||
|
||||
input_slider:
|
||||
input_number:
|
||||
ac_temperature:
|
||||
name: A/C Setting
|
||||
initial: 24
|
||||
@ -53,6 +53,6 @@ input_slider:
|
||||
|
||||
{% raw %}
|
||||
shell_command:
|
||||
set_ac_to_slider: 'irsend SEND_ONCE DELONGHI AC_{{ states.input_slider.ac_temperature.state }}_AUTO'
|
||||
set_ac_to_slider: 'irsend SEND_ONCE DELONGHI AC_{{ states.input_number.ac_temperature.state }}_AUTO'
|
||||
{% endraw %}
|
||||
```
|
||||
|
@ -78,10 +78,10 @@ automation:
|
||||
|
||||
There are 2 variables that control the speed of the change for the scripts below. The first is the `step`, small steps create a smooth transition. The second is the delay, larger delays will create a slower transition.
|
||||
|
||||
To allow flexibility, an [Input Slider](/components/input_slider/) is used for the step (at the time of writing this, it's not possible to template the delay when the delay uses milliseconds). Two additional [Input Sliders](/components/input_slider/) are used to set the minimum and maximum brightness, so that it's easy to tune that (or manage it through an automation).
|
||||
To allow flexibility, an [Input Number](/components/input_number/) is used for the step (at the time of writing this, it's not possible to template the delay when the delay uses milliseconds). Two additional [Input Numbers](/components/input_number/) are used to set the minimum and maximum brightness, so that it's easy to tune that (or manage it through an automation).
|
||||
|
||||
```yaml
|
||||
input_slider:
|
||||
input_number:
|
||||
light_step:
|
||||
name: 'Step the lights this much'
|
||||
initial: 20
|
||||
@ -116,10 +116,10 @@ script:
|
||||
entity_id: light.YOUR_LIGHT
|
||||
brightness: >-
|
||||
{% raw %}{% set current = states.light.YOUR_LIGHT.attributes.brightness|default(0)|int %}
|
||||
{% set step = states('input_slider.light_step')|int %}
|
||||
{% set step = states('input_number.light_step')|int %}
|
||||
{% set next = current + step %}
|
||||
{% if next > states('input_slider.light_maximum')|int %}
|
||||
{% set next = states('input_slider.light_maximum')|int %}
|
||||
{% if next > states('input_number.light_maximum')|int %}
|
||||
{% set next = states('input_number.light_maximum')|int %}
|
||||
{% endif %}
|
||||
{{ next }}{% endraw %}
|
||||
|
||||
@ -142,10 +142,10 @@ script:
|
||||
entity_id: light.YOUR_LIGHT
|
||||
brightness: >-
|
||||
{% raw %}{% set current = states.light.YOUR_LIGHT.attributes.brightness|default(0)|int %}
|
||||
{% set step = states('input_slider.light_step')|int %}
|
||||
{% set step = states('input_number.light_step')|int %}
|
||||
{% set next = current - step %}
|
||||
{% if next < states('input_slider.light_minimum')|int %}
|
||||
{% set next = states('input_slider.light_minimum')|int %}
|
||||
{% if next < states('input_number.light_minimum')|int %}
|
||||
{% set next = states('input_number.light_minimum')|int %}
|
||||
{% endif %}
|
||||
{{ next }}{% endraw %}
|
||||
|
||||
|
@ -1257,7 +1257,7 @@ self.toggle("light.office_1", color_name = "green")
|
||||
|
||||
### {% linkable_title select_value() %}
|
||||
|
||||
This is a convenience function for the `input_slider.select_value` function. It is able to set the value of an input_slider in Home Assistant.
|
||||
This is a convenience function for the `input_number.select_value` function. It is able to set the value of an input_number in Home Assistant.
|
||||
|
||||
#### {% linkable_title Synopsis %}
|
||||
|
||||
@ -1273,16 +1273,16 @@ None
|
||||
|
||||
##### {% linkable_title entity_id %}
|
||||
|
||||
Fully qualified entity_id of the input_slider to be changed, e.g. `input_slider.alarm_hour`.
|
||||
Fully qualified entity_id of the input_number to be changed, e.g. `input_number.alarm_hour`.
|
||||
|
||||
##### {% linkable_title value %}
|
||||
|
||||
The new value to set the input slider to.
|
||||
The new value to set the input number to.
|
||||
|
||||
#### {% linkable_title Examples %}
|
||||
|
||||
```python
|
||||
self.select_value("input_slider.alarm_hour", 6)
|
||||
self.select_value("input_number.alarm_hour", 6)
|
||||
```
|
||||
|
||||
### {% linkable_title select_option() %}
|
||||
@ -1307,7 +1307,7 @@ Fully qualified entity_id of the input_select to be changed, e.g. `input_select.
|
||||
|
||||
##### {% linkable_title value %}
|
||||
|
||||
The new value to set the input slider to.
|
||||
The new value to set the input number to.
|
||||
|
||||
#### {% linkable_title Examples %}
|
||||
|
||||
|
@ -71,9 +71,9 @@ delay:
|
||||
```
|
||||
|
||||
```yaml
|
||||
# Waits however many minutes input_slider.minute_delay is set to
|
||||
# Waits however many minutes input_number.minute_delay is set to
|
||||
# Valid formats include HH:MM and HH:MM:SS
|
||||
delay: {% raw %}'00:{{ states.input_slider.minute_delay.state | int }}:00'{% endraw %}
|
||||
delay: {% raw %}'00:{{ states.input_number.minute_delay.state | int }}:00'{% endraw %}
|
||||
```
|
||||
### {% linkable_title Wait %}
|
||||
|
||||
|
File diff suppressed because one or more lines are too long
Loading…
x
Reference in New Issue
Block a user