Merge branch 'main' into actions_colorutil

installation/synology.md

@@ -90,10 +90,12 @@ You can increase this in the future if you like.
 :::tip DSM 7.2 Access Zwave USB Stick
 
 - Set `/dev/ttyACM0` permissions inside the openhab container - [OH Docs](docker.html#usb-sticks)
+
    ```bash
    root@openhab:/openhab# chown openhab:openhab /dev/ttyACM0
    root@openhab:/openhab# chmod o+rw /dev/ttyACM0
    ```
+
    To preserve the changes on container reboot see [Executing shell scripts before openHAB is started](https://github.com/openhab/openhab-docker#executing-shell-scripts-before-openhab-is-started) article.
 :::
 
@@ -148,7 +150,6 @@ Several issues are already raised for this at Synology.
    :warning: This will result in Synology notification, like "Security risks detected on NAS02. Please go to Security Advisor for more information. Details."
 :::
 
-
 ### Network
 
 - Select 'host' if you are planning to use the IP stack in bindings or if you are not sure what this does.

ui/sitemaps.md

@@ -287,7 +287,7 @@ A Switch will present a discrete state Item and allow changing of its value.
 Note that Switch elements can be rendered differently on the user interface, based on the Item type and the `mappings` parameter.
 
 - `mappings` comes as an array of value-to-string translations, [documented further down](#mappings).
-  Without the mappings parameter, user interfaces will present an On/Off Switch, if mappings are given, several labeled buttons will be rendered.
+  Without the mappings parameter, user interfaces will present an On/Off Switch, if mappings are given, several buttons with label or icon will be rendered.
 
 **Examples:**
 
@@ -540,7 +540,7 @@ Mappings is an optional parameter for the [Switch](#element-type-switch) and [Se
 Mapping syntax:
 
 ```java
-mappings=[value_1="description_1", value_2="description_2", ...]
+mappings=[value_1="description_1", value_2="description_2"=<iconname>, ...]
 ```
 
 Examples:
@@ -551,6 +551,8 @@ mappings=[1="DasErste", 2="BBC One", 3="Cartoon Network"]
 
 mappings=[OFF="All heaters off"]
 mappings=[15="Gone", 19="Chilly", 21="Cozy"]
+
+mappings=[ON="Mic On"=material:mic, OFF="Mic Off"=material:mic_off]
 ```
 
 As you can see, different Item data types are accepted as mappings values.
@@ -566,6 +568,9 @@ Similarly, mapping above changes the numbers "1", "2", and "3" to "DasErste", "B
 In the third and fourth examples above, only a subset of the possible values of items belonging to a heating system are presented to the user.
 This limits the possible input values, which is yet another often occurring use case for mappings.
 
+In the fifth example above, user interfaces will display buttons using the provided icon rather than the provided description.
+Icons are usable in Switch element but ignored in Selection element.
+
 ## Dynamic Sitemaps
 
 All Sitemap elements can be configured to be hidden, color highlighted or to have a [dynamic icon]({{base}}/configuration/items.html#dynamic-icons), depending on certain Item states.