diff --git a/source/_docs/blueprint/selectors.markdown b/source/_docs/blueprint/selectors.markdown index 25147d1f704..47581ccb39b 100644 --- a/source/_docs/blueprint/selectors.markdown +++ b/source/_docs/blueprint/selectors.markdown @@ -33,6 +33,7 @@ The following selectors are currently available: - [Object selector](#object-selector) - [RGB color selector](#rgb-color-selector) - [Select selector](#select-selector) +- [State selector](#state-selector) - [Target selector](#target-selector) - [Template selector](#template-selector) - [Text selector](#text-selector) @@ -820,6 +821,29 @@ When `multiple` is `true`, the output of this selector is the list of selected option values. In this case, if `Green` was selected, in the first example it would return ["Green"] and in the last example it returns ["g"]. +## State selector + +The state selector shows a list of states for a provided entity of which +one can be selected. + +![Screenshot of an state selector](/images/blueprints/selector-state.png) + +{% configuration state %} +entity_id: + description: The entity ID of which an state can be selected from. + type: string + required: true +attribute: + description: The attribute of which an attribute state can be selected from. + type: string + required: false +{% endconfiguration %} + +The output of this selector is the select state (not the translated or +prettified name shown in the frontend). + +For example: `heat_cool`. + ## Target selector The target selector is a rather special selector, allowing the user to select diff --git a/source/images/blueprints/selector-state.png b/source/images/blueprints/selector-state.png new file mode 100644 index 00000000000..e88e413ee5e Binary files /dev/null and b/source/images/blueprints/selector-state.png differ