From f62a61cca76ab0d9f5860687a4b36a247c19fe17 Mon Sep 17 00:00:00 2001
From: Laurent Garnier <lg.hc@free.fr>
Date: Sat, 16 Dec 2023 12:47:21 +0100
Subject: [PATCH 1/2] Sitezmap: new Buttongrid element

Signed-off-by: Laurent Garnier <lg.hc@free.fr>
---
 ui/images/sitemap_demo_buttongrid.png | Bin 0 -> 11549 bytes
 ui/sitemaps.md                        |  38 ++++++++++++++++++++++++++
 2 files changed, 38 insertions(+)
 create mode 100644 ui/images/sitemap_demo_buttongrid.png

diff --git a/ui/images/sitemap_demo_buttongrid.png b/ui/images/sitemap_demo_buttongrid.png
new file mode 100644
index 0000000000000000000000000000000000000000..687db6bfac7dce03189c05ed9cf64aeb40400f71
GIT binary patch
literal 11549
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

literal 0
HcmV?d00001

diff --git a/ui/sitemaps.md b/ui/sitemaps.md
index 103e9b023b..642f4e6b61 100644
--- a/ui/sitemaps.md
+++ b/ui/sitemaps.md
@@ -144,6 +144,7 @@ The following element types may be used in a Sitemap definition file.
 
 | Element                                  | Description                                                                               |
 | ---------------------------------------- | ----------------------------------------------------------------------------------------- |
+| [Buttongrid](#element-type-buttongrid)   | Renders a grid of stateless buttons used to send commands to a given Item.                |
 | [Chart](#element-type-chart)             | Adds a time-series chart object for [persisted](persistence.html) data.                   |
 | [Colorpicker](#element-type-colorpicker) | Allows the user to choose a color from a color wheel.                                     |
 | [Default](#element-type-default)         | Renders an Item in the default UI representation specified by the type of the given Item. |
@@ -301,6 +302,43 @@ Switch item=LR_TV_Channel label="TV Channel" mappings=[0="DasErste", 1="BBC One"
 ![Presentation of the On/Off Switch element in BasicUI](images/sitemap_demo_switch1.png)
 ![Presentation of the multi-state Switch element in BasicUI](images/sitemap_demo_switch2.png)
 
+### Element Type 'Buttongrid'
+
+```java
+Buttongrid item=<itemname> [label="<labelname>"] [icon=<iconref>] [staticIcon=<iconref>] [buttons="<Button definition>"]
+```
+
+A Buttongrid will present a grid of buttons and allow sending commands to an Item.
+When you press a button, the associated command is sent to the linked Item.
+Buttons never appear as selected, they do not display the current state of the linked Item.
+
+This is the typical element to use to simulate a remote control for example.
+
+- `label` if set, a header row will be displayed containing this label and the icon.
+- `buttons` defines the position of each button inside the grid and the command associated with each button; comes as an array of buttons definition.
+
+Buttons syntax:
+
+```java
+buttons=[row_1:column_1:command_1="description_1", row_2:column_2:command_2="description_2"=<iconname>, ...]
+```
+
+The buttons can be defined in any order, their position in the grid is defined by a row index and a column index.
+The top left position is row index 1 and column index 1.
+The grid must not exceed 12 columns so the maximum allowed column index is 12.
+It is not mandatory to define a button in all grid cells.
+The user interfaces will automatically determine the grid size so that all buttons are presented.
+
+The content of each button can be text but also an icon; the icon will be used by default if provided.
+
+**Examples:**
+
+```java
+Buttongrid label="Remote Control" staticIcon=screen item=RemoteControl buttons=[1:1:POWER="Power"=switch-off , 1:2:MENU="Menu" , 1:3:EXIT="Exit" , 2:2:UP="Up"=f7:arrowtriangle_up , 4:2:DOWN="Down"=f7:arrowtriangle_down , 3:1:LEFT="Left"=f7:arrowtriangle_left , 3:3:RIGHT="Right"=f7:arrowtriangle_right , 3:2:OK="Ok" , 2:4:VOL_PLUS="Volume +" , 4:4:VOL_MINUS="Volume -" , 3:4:MUTE="Mute"=soundvolume_mute]
+```
+
+![Presentation of the Buttongrid element in BasicUI](images/sitemap_demo_buttongrid.png)
+
 ### Element Type 'Selection'
 
 ```java

From 5e5157c3bcdf67f2d9d7d0a787f4591a2ec0f911 Mon Sep 17 00:00:00 2001
From: Laurent Garnier <lg.hc@free.fr>
Date: Sat, 16 Dec 2023 17:23:59 +0100
Subject: [PATCH 2/2] Review comments addressed

Signed-off-by: Laurent Garnier <lg.hc@free.fr>
---
 ui/sitemaps.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/ui/sitemaps.md b/ui/sitemaps.md
index 642f4e6b61..8542752296 100644
--- a/ui/sitemaps.md
+++ b/ui/sitemaps.md
@@ -308,14 +308,14 @@ Switch item=LR_TV_Channel label="TV Channel" mappings=[0="DasErste", 1="BBC One"
 Buttongrid item=<itemname> [label="<labelname>"] [icon=<iconref>] [staticIcon=<iconref>] [buttons="<Button definition>"]
 ```
 
-A Buttongrid will present a grid of buttons and allow sending commands to an Item.
-When you press a button, the associated command is sent to the linked Item.
+A Buttongrid represents a grid of buttons and enables commands to be sent to an Item.
+When a button is pressed, the associated command is sent to the linked Item.
 Buttons never appear as selected, they do not display the current state of the linked Item.
 
-This is the typical element to use to simulate a remote control for example.
+This is a typical element for simulating a remote control, for example.
 
 - `label` if set, a header row will be displayed containing this label and the icon.
-- `buttons` defines the position of each button inside the grid and the command associated with each button; comes as an array of buttons definition.
+- `buttons` defines the position of each button within the grid and the command associated with each button; provided as an array.
 
 Buttons syntax:
 
@@ -325,7 +325,7 @@ buttons=[row_1:column_1:command_1="description_1", row_2:column_2:command_2="des
 
 The buttons can be defined in any order, their position in the grid is defined by a row index and a column index.
 The top left position is row index 1 and column index 1.
-The grid must not exceed 12 columns so the maximum allowed column index is 12.
+The grid must not exceed 12 columns so the maximum allowed column index is 12 columns.
 It is not mandatory to define a button in all grid cells.
 The user interfaces will automatically determine the grid size so that all buttons are presented.