diff --git a/source/_docs/blueprint/selectors.markdown b/source/_docs/blueprint/selectors.markdown index c285ea460e8..2b489ecda7e 100644 --- a/source/_docs/blueprint/selectors.markdown +++ b/source/_docs/blueprint/selectors.markdown @@ -21,7 +21,9 @@ The following selectors are currently available: - [Device selector](#device-selector) - [Entity selector](#entity-selector) - [Number selector](#number-selector) +- [Object selector](#object-selector) - [Target selector](#target-selector) +- [Text selector](#text-selector) - [Time selector](#time-selector) If no selector is defined, a text input for a single line will be shown. @@ -367,6 +369,18 @@ number: mode: slider ``` +## Object selector + +The object selector can be used to input arbitrary data in YAML form. This is useful for e.g. lists and dictionaries like service data. The value of the input will contain the provided data. + +![Screenshot of an object selector](/images/blueprints/selector-object.png) + +This selector does not have any other options; therefore, it only has its key. + +```yaml +object: +``` + ## Target selector The target selector is a rather special selector, allowing the user to selector @@ -477,6 +491,26 @@ target: model: TRADFRI remote control ``` +## Text selector + +The text selector can be used to input a text string. The value of the input will contain the selected text. + +![Screenshot of a text selector](/images/blueprints/selector-text.png) + +Unless `multiline` is set to `true`, this selector behaves exactly like if no selector at all was specified, and will display a single line text input box on the user interface. + +```yaml +text: +``` + +{% configuration text %} +multiline: + description: Set to true to display the input as a multi-line text box on the user interface. + type: boolean + default: false + required: false +{% endconfiguration %} + ## Time selector The time selector shows a time input that allows the user to specify a time diff --git a/source/images/blueprints/selector-object.png b/source/images/blueprints/selector-object.png new file mode 100644 index 00000000000..3ed19fc834e Binary files /dev/null and b/source/images/blueprints/selector-object.png differ diff --git a/source/images/blueprints/selector-text.png b/source/images/blueprints/selector-text.png new file mode 100644 index 00000000000..f0457f9054c Binary files /dev/null and b/source/images/blueprints/selector-text.png differ