2023.4: new selectors

This commit is contained in:
Franck Nijhof 2023-04-05 13:07:53 +02:00
parent 35d4135b71
commit f2b0a6d6ec
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3

View File

@ -350,46 +350,40 @@ entity, wait 24 hours after upgrading before renaming.
## New selector capabilities ## New selector capabilities
{% details "TODO" %} [Selectors](/docs/blueprint/selectors) are user inputs for the user interface
that drive things like [Blueprints](/get-blueprints). A new selector for use
in Blueprints has been added by [@emontnemery] and [@piitaya]: The constant selector.
- Keep or move to other noteworthy? The constant selector provides an optional input, which returns a fixed value
- Proof read/spelling/grammar (the constant) when enabled, otherwise doesn't provide any value at all.
- Improve/better examples?
- Docs missing?
- Add filter options to entity and device selectors ([@piitaya] - [#87536]) (noteworthy) Example use in a Blueprint:
- Add support for constant selector ([@emontnemery] - [#89573]) (noteworthy)
{% enddetails %}
A new selector for use in your Blueprints has been added by [@emontnemery]
and [@piitaya]: The constant selector.
The constant select provides an optional input, that provides a fixed value
(the constant) or doesn't provide anything at all.
<video width="620px" controls="controls"><source src="https://user-images.githubusercontent.com/5878303/224061490-358c6dc8-587a-4c54-8ed0-2358a764b226.mp4" type="video/mp4"></video>
```yaml ```yaml
white: example:
name: White name: Constant selector example
description: Set the light to white mode
advanced: true
selector: selector:
constant: constant:
value: true
label: Enabled label: Enabled
value: true
``` ```
Also improved this release, are the device and entity filters on the Area, Which results in the following:
Entity, Device, and Target selectors. Previously, you could filter with a
single set of conditions, now you can pass in a list of filters.
If you are building Blueprints, this can be really helpful, if a user should <p class='img'>
be able to select, for example, one of multiple different devices. <img src='/images/blueprints/selector-constant.png' alt='A screenshot showing the new constant selector.'></a>
When checked, the selector returns the set value.
</p>
Also improved are the device and entity filters on the [Area],
[Entity], [Device], and [Target] selectors. Previously, you could filter with a
single set of conditions; now, you can pass in a list of filters.
If you are building Blueprints, this can be really helpful if a user should
be able to select one of multiple different devices.
An example, this selector allows you to select the batter sensor of An example, this selector allows you to select the batter sensor of
either an Philips Hue RWL020 (US) or RWL021 (EU) remote in your Blueprint. either a Philips Hue RWL020 (US) or RWL021 (EU) remote in your Blueprint.
```yaml ```yaml
device: device:
@ -405,6 +399,13 @@ device:
device_class: battery device_class: battery
``` ```
[@emontnemery]: https://github.com/emontnemery
[@piitaya]: https://github.com/piitaya
[area]: /docs/blueprint/selectors/#area-selector
[device]: /docs/blueprint/selectors/#device-selector
[entity]: /docs/blueprint/selectors/#entity-selector
[target]: /docs/blueprint/selectors/#target-selector
## Translating entities ## Translating entities
Over the past releases, weve been slowly extending translation support in more Over the past releases, weve been slowly extending translation support in more