mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-12-27 17:37:45 +01:00
59 lines
2.1 KiB
ReStructuredText
59 lines
2.1 KiB
ReStructuredText
|
Template Select
|
||
|
|
===============
|
||
|
|
|
||
|
|
.. seo::
|
||
|
|
:description: Instructions for setting up template selects with ESPHome.
|
||
|
|
:image: description.png
|
||
|
|
|
||
|
|
The ``template`` select platform allows you to create a select with templated values
|
||
|
|
using :ref:`lambdas <config-lambda>`.
|
||
|
|
|
||
|
|
.. code-block:: yaml
|
||
|
|
|
||
|
|
# Example configuration entry
|
||
|
|
select:
|
||
|
|
- platform: template
|
||
|
|
name: "Template select"
|
||
|
|
update_interval: never
|
||
|
|
options:
|
||
|
|
- one
|
||
|
|
- two
|
||
|
|
- three
|
||
|
|
initial_option: two
|
||
|
|
|
||
|
|
|
||
|
|
Configuration variables:
|
||
|
|
------------------------
|
||
|
|
|
||
|
|
- **name** (**Required**, string): The name of the select.
|
||
|
|
- **options** (**Required**, list): The list of options this select has.
|
||
|
|
- **lambda** (*Optional*, :ref:`lambda <config-lambda>`):
|
||
|
|
Lambda to be evaluated every update interval to get the new option of the select.
|
||
|
|
- **set_action** (*Optional*, :ref:`Action <config-action>`): The action that should
|
||
|
|
be performed when the remote (like Home Assistant's frontend) requests to set the select option.
|
||
|
|
- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the
|
||
|
|
select ``lambda``. Defaults to ``60s``.
|
||
|
|
- **optimistic** (*Optional*, boolean): Whether to operate in optimistic mode - when in this mode,
|
||
|
|
any command sent to the template select will immediately update the reported state.
|
||
|
|
Cannot be used with ``lambda``. Defaults to ``false``.
|
||
|
|
- **restore_value** (*Optional*, boolean): Saves and loads the state to RTC/Flash.
|
||
|
|
Cannot be used with ``lambda``. Defaults to ``false``.
|
||
|
|
- **initial_option** (*Optional*, string): The option to set the option to on setup if not
|
||
|
|
restored with ``restore_value``.
|
||
|
|
Cannot be used with ``lambda``. Defaults to the first option in the ``options`` list.
|
||
|
|
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
|
||
|
|
- All other options from :ref:`Select <config-select>`.
|
||
|
|
|
||
|
|
``select.set`` Action
|
||
|
|
----------------------------------
|
||
|
|
|
||
|
|
You can also set an option to a template select from elsewhere in your YAML file
|
||
|
|
with the :ref:`select-set_action`.
|
||
|
|
|
||
|
|
See Also
|
||
|
|
--------
|
||
|
|
|
||
|
|
- :ref:`automation`
|
||
|
|
- :apiref:`template/select/template_select.h`
|
||
|
|
- :ghedit:`Edit`
|