From 067210ec0a2292da16e0b3d08c781a5d8f9436b5 Mon Sep 17 00:00:00 2001
From: bartbutenaers <bart.butenaers@gmail.com>
Date: Sat, 21 Dec 2024 23:38:41 +0100
Subject: [PATCH] ui-control colon in group name (docs)

---
 docs/nodes/widgets/ui-control.md            | 3 ++-
 nodes/widgets/locales/en-US/ui_control.html | 5 +++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/nodes/widgets/ui-control.md b/docs/nodes/widgets/ui-control.md
index f0642119..e86229d8 100644
--- a/docs/nodes/widgets/ui-control.md
+++ b/docs/nodes/widgets/ui-control.md
@@ -123,6 +123,7 @@ msg.payload = {
 ```
 
 _Note:_ `pages` can be subbed with `tabs` as per Dashboard 1.0 and `groups` can also be subbed with `group` as per Dashboard 1.0.
+_Note:_ when the `group` name contains a colon `:`, then that should be escaped using a backslash `\`.
 
 ### Enable/Disable
 
@@ -187,4 +188,4 @@ msg = {
     tab: '<Page Index>',
     name: '<Page Name>'
 }
-```
\ No newline at end of file
+```
diff --git a/nodes/widgets/locales/en-US/ui_control.html b/nodes/widgets/locales/en-US/ui_control.html
index fe435bf2..42201a1a 100644
--- a/nodes/widgets/locales/en-US/ui_control.html
+++ b/nodes/widgets/locales/en-US/ui_control.html
@@ -33,7 +33,7 @@ <h4>Show/Hide Pages & Groups</h4>
     }
 }</pre>
     <h4>Enable/Disable Pages & Groups</h4>
-    <p>Dashboard pages & groups can be disabled & re-enabled by sending a <code>msg.payload</code> object with the format
+    <p>Dashboard pages & groups can be disabled & re-enabled by sending a <code>msg.payload</code> object with the format</p>
     <pre>msg.payload = {
     pages: {
         enable: ['&lt;Page Name&gt;', '&lt;Page Name&gt;'],
@@ -44,6 +44,7 @@ <h4>Enable/Disable Pages & Groups</h4>
         disable: ['&lt;Group Name&gt;']
     }
 }</pre>
+    <p>When the group name contains a colon <code>:</code>, that needs to be escaped using a backslash <code>\</code>. </p>
     <h4>External URL</h4>
     <p>It is possible to trigger navigation to an external site, away from your Dashboard by passing in a URL string.</p>
     <pre>msg.payload = {
@@ -64,4 +65,4 @@ <h3>Events List</h3>
     <li><code>name</code> - the name of the tab. (only for 'change' event).
     </ul>
     <p>Optional - report only connect events - useful to use to trigger a resend of data to a new client without needing to filter out other events.</p>
-</script>
\ No newline at end of file
+</script>