mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-16 05:46:52 +00:00
Document brightness step for light.turn_on (#11973)
* Document brightness step * Clarify light.toggle service
This commit is contained in:
parent
cb98ebb5f0
commit
4ac3c4c92d
@ -36,6 +36,8 @@ Most lights do not support all attributes. You can check the integration documen
|
||||
| `color_name` | yes | A human-readable string of a color name, such as `blue` or `goldenrod`. All [CSS3 color names](https://www.w3.org/TR/css-color-3/#svg-color) are supported.
|
||||
| `brightness` | yes | Integer between 0 and 255 for how bright the light should be, where 0 means the light is off, 1 is the minimum brightness and 255 is the maximum brightness supported by the light.
|
||||
| `brightness_pct`| yes | Alternatively, you can specify brightness in percent (a number between 0 and 100), where 0 means the light is off, 1 is the minimum brightness and 100 is the maximum brightness supported by the light.
|
||||
| `brightness_step` | yes | Change brightness by an amount. Should be between -255..255.
|
||||
| `brightness_step_pct` | yes | Change brightness by a percentage. Should be between -100..100.
|
||||
| `flash` | yes | Tell light to flash, can be either value `short` or `long`.
|
||||
| `effect`| yes | Applies an effect such as `colorloop` or `random`.
|
||||
|
||||
@ -87,7 +89,6 @@ Turns one or multiple lights off.
|
||||
|
||||
### Service `light.toggle`
|
||||
|
||||
Toggles the state of one or multiple lights using [groups]({{site_root}}/integrations/group/).
|
||||
Takes the same arguments as [`turn_on`](#service-lightturn_on) service.
|
||||
Toggles the state of one or multiple lights. Takes the same arguments as [`turn_on`](#service-lightturn_on) service.
|
||||
|
||||
*Note*: If `light.toggle` is used for a group of lights, it will toggle the individual state of each light.
|
||||
*Note*: If `light.toggle` is used for a group of lights, it will toggle the individual state of each light. If you want the lights to be treated as a single light, use [Light Groups](/integrations/light.group/) instead.
|
||||
|
Loading…
x
Reference in New Issue
Block a user