Add support for wide panels.

Allows for panels to be displayed in single column mode, regardless of screen width.
For more information, see updates to README.md

README.md

@@ -34,7 +34,7 @@ The Library runs fine on any kind of **ESP8266** and **ESP32** (NodeMCU Boards,
 - Graph Widget (Persist save graph in local storage #10)
 - Inline CSS styles by @iangray001
 - Separators by @iangray001
-- Grouped controls by @iangray001
+- Grouped and wide controls by @iangray001
 
 ## Further Roadmap
 
@@ -431,6 +431,23 @@ and buttons.
 
 If you group too many elements it might throw the layout of the rest of the UI out of line. Consider adding separators to correct this.
 
+### Advanced: Wide controls
+
+Controls can be set to be displayed "wide" with the function:
+
+```
+ ESPUI.setPanelWide(controlid, true);
+```
+
+*Important!* This function should be called _before_ `ESPUI.begin` or results will be unreliable.
+
+Setting a control to wide tells ESPUI to lay out that control as if there was only a single column, even on wide displays. 
+This can be applied to every element to force a single column layout, or to individual elements to customise the display.
+
+![Wide controls](docs/ui_widecontrols.png)
+
+Note that this will have no effect on small screens.
+
 # Notes for Development
 
 If you want to work on the HTML/CSS/JS files, do make changes in the _data_

data/js/controls.js

@@ -662,6 +662,7 @@ var rangeSlider = function (isDiscrete) {
 var addToHTML = function(data) {
   panelStyle = data.hasOwnProperty('panelStyle') ? " style='" + data.panelStyle + "' " : "";
   elementStyle = data.hasOwnProperty('elementStyle') ? " style='" + data.elementStyle + "' " : "";
+  panelwide = data.hasOwnProperty('wide') ? "wide" :  "";
 
   if(!data.hasOwnProperty('parentControl') || $("#tab" + data.parentControl).length > 0) {
     //We add the control with its own panel
@@ -683,7 +684,7 @@ var addToHTML = function(data) {
       case UI_GRAPH:
       case UI_GAUGE:
       case UI_ACCEL:
-        html = "<div id='id" + data.id + "' " + panelStyle + " class='two columns card tcenter " +
+        html = "<div id='id" + data.id + "' " + panelStyle + " class='two columns " + panelwide + " card tcenter " +
         colorClass(data.color) + "'><h5>" + data.label + "</h5><hr/>" +
         elementHTML(data.type, data.id, data.value, elementStyle) +
         "</div>";

data/js/controls.min.js

@@ -48,7 +48,7 @@ function buttonclick(number,isdown){if(isdown)websock.send("bdown:"+number);else
 function padclick(type,number,isdown){switch(type){case CENTER:if(isdown)websock.send("pcdown:"+number);else websock.send("pcup:"+number);break;case UP:if(isdown)websock.send("pfdown:"+number);else websock.send("pfup:"+number);break;case DOWN:if(isdown)websock.send("pbdown:"+number);else websock.send("pbup:"+number);break;case LEFT:if(isdown)websock.send("pldown:"+number);else websock.send("plup:"+number);break;case RIGHT:if(isdown)websock.send("prdown:"+number);else websock.send("prup:"+number);break;}}
 function switcher(number,state){if(state==null){if($("#s"+number).is(":checked")){websock.send("sactive:"+number);$("#sl"+number).addClass("checked");}else{websock.send("sinactive:"+number);$("#sl"+number).removeClass("checked");}}else if(state==1){$("#sl"+number).addClass("checked");$("#sl"+number).prop("checked",true);}else if(state==0){$("#sl"+number).removeClass("checked");$("#sl"+number).prop("checked",false);}}
 var rangeSlider=function(isDiscrete){var range=$(".range-slider__range");var slidercb=function(){sliderchange($(this).attr("id").replace(/^\D+/g,""));};range.on({input:function(){$(this).next().html(this.value)}});range.each(function(){$(this).next().html(this.value);if($(this).attr("callbackSet")!="true"){if(!isDiscrete){$(this).on({input:slidercb});}else{$(this).on({change:slidercb});}
-$(this).attr("callbackSet","true");}});};var addToHTML=function(data){panelStyle=data.hasOwnProperty('panelStyle')?" style='"+data.panelStyle+"' ":"";elementStyle=data.hasOwnProperty('elementStyle')?" style='"+data.elementStyle+"' ":"";if(!data.hasOwnProperty('parentControl')||$("#tab"+data.parentControl).length>0){var parent=data.hasOwnProperty('parentControl')?$("#tab"+data.parentControl):$("#row");var html="";switch(data.type){case UI_LABEL:case UI_BUTTON:case UI_SWITCHER:case UI_CPAD:case UI_PAD:case UI_SLIDER:case UI_NUMBER:case UI_TEXT_INPUT:case UI_SELECT:case UI_GRAPH:case UI_GAUGE:case UI_ACCEL:html="<div id='id"+data.id+"' "+panelStyle+" class='two columns card tcenter "+
+$(this).attr("callbackSet","true");}});};var addToHTML=function(data){panelStyle=data.hasOwnProperty('panelStyle')?" style='"+data.panelStyle+"' ":"";elementStyle=data.hasOwnProperty('elementStyle')?" style='"+data.elementStyle+"' ":"";panelwide=data.hasOwnProperty('wide')?"wide":"";if(!data.hasOwnProperty('parentControl')||$("#tab"+data.parentControl).length>0){var parent=data.hasOwnProperty('parentControl')?$("#tab"+data.parentControl):$("#row");var html="";switch(data.type){case UI_LABEL:case UI_BUTTON:case UI_SWITCHER:case UI_CPAD:case UI_PAD:case UI_SLIDER:case UI_NUMBER:case UI_TEXT_INPUT:case UI_SELECT:case UI_GRAPH:case UI_GAUGE:case UI_ACCEL:html="<div id='id"+data.id+"' "+panelStyle+" class='two columns "+panelwide+" card tcenter "+
 colorClass(data.color)+"'><h5>"+data.label+"</h5><hr/>"+
 elementHTML(data.type,data.id,data.value,elementStyle)+
 "</div>";break;case UI_SEPARATOR:html="<div id='id"+data.id+"' "+panelStyle+" class='sectionbreak columns'>"+

src/ESPUI.cpp

@@ -825,6 +825,14 @@ void ESPUIClass::setElementStyle(uint16_t id, String style, int clientId)
     }
 }
 
+void ESPUIClass::setPanelWide(uint16_t id, bool wide) {
+    Control* control = getControl(id);
+    if (control)
+    {
+        control->wide = wide;
+    }
+}
+
 void ESPUIClass::updateControl(uint16_t id, int clientId)
 {
     Control* control = getControl(id);
@@ -1038,6 +1046,8 @@ Control* ESPUIClass::prepareJSONChunk(AsyncWebSocketClient* client, Control* con
             item["panelStyle"] = String(control->panelStyle);
         if (control->elementStyle != 0)
             item["elementStyle"] = String(control->elementStyle);
+        if (control->wide == true)
+            item["wide"] = true;
 
         if (control->parentControl != Control::noParent)
         {

src/ESPUI.h

@@ -139,6 +139,7 @@ public:
     String value;
     ControlColor color;
     bool visible;
+    bool wide;
     uint16_t parentControl;
     String panelStyle;
     String elementStyle;
@@ -154,6 +155,7 @@ public:
           value(value),
           color(color),
           visible(visible),
+          wide(false),
           parentControl(parentControl),
           next(nullptr)
     {
@@ -289,6 +291,8 @@ public:
     void setPanelStyle(uint16_t id, String style, int clientId = -1);
     void setElementStyle(uint16_t id, String style, int clientId = -1);
 
+    void setPanelWide(uint16_t id, bool wide);
+
     // Variables
     const char* ui_title = "ESPUI"; // Store UI Title and Header Name
     Control* controls = nullptr;