Describes the global attribute

README.md

@@ -101,11 +101,12 @@ Full documentation is available on https://Hieromon.github.io/AutoConnect, some
 
 ## Change log
 
-### [1.0.0] Aug. 29, 2019
+### [1.0.0] Sept. 5, 2019
 - Supports Arduino core for ESP32 1.0.3.
 - Supports AutoConnectUpdate for the OTA update.
 - Supports Preferences for saving credentials with ESP32 core 1.0.3 and later. **In ESP32, the credentials stored past in EEPROM will lose**.
 - Supports AutoConnectAux::isValid function.
+- Supports the global attribute with all AutoConnectElements.
 
 ### [0.9.12] Aug. 18, 2019
 - Fixed missing captive portal notifications on the newer mobile OS client. As a result of this fix, the SoftAP default IP address and gateway have been changed to **172.217.28.1**. (issue #85) 

mkdocs/achandling.md

@@ -594,6 +594,76 @@ portal.on("/echo", [](AutoConnectAux& aux, PageArgument& args) {
 portal.begin();
 ```
 
+### <i class="fa fa-wrench"></i> Transfer of input values ​​across pages
+
+Since v1.0.0, AutoConnect supports a new attribute with each element that allows automatic transfer of input values across pages without sketching. AutoConnect will copy the input value of the elements with the [global](apielements.md#global_2) attribute to the same-named elements on a different custom web pages at the page transition timing.
+
+The **global** attribute will be useful for echoing input values back to another custom Web pages. The copy operation will be performed if the name matches and is global even if the copy source element and the destination have different types. Conversely, the value will not be copied unless the destination element is global.
+
+The following example reflects the input value of PAGE1 to the AutoConnectText field of PAGE2 without sketch code.
+
+```cpp hl_lines="8 10 28 30"
+static const char PAGE1[] PROGMEM = R"(
+{
+  "title": "PAGE1",
+  "uri": "/page1",
+  "menu": true,
+  "element": [
+    {
+      "name": "input1",
+      "type": "ACInput",
+      "global": true
+    },
+    {
+      "name": "send",
+      "type": "ACSubmit",
+      "value": "OK",
+      "uri": "/page2"
+    }
+  ]
+}
+)";
+static const char PAGE2[] PROGMEM = R"(
+{
+  "title": "PAGE2",
+  "uri": "/page2",
+  "menu": false,
+  "element": [
+    {
+      "name": "input1",
+      "type": "ACText",
+      "global": true
+    }
+  ]
+}
+)";
+
+AutoConnect portal;
+AutoConnectAux page1;
+AutoConnectAux page2;
+
+void setup() {
+  page1.load(PAGE1);
+  page2.load(PAGE2);
+  portal.join( { page1, page2 });
+  portal.begin();
+}
+
+void loop() {
+  portal.handleClient();
+}
+```
+
+<i class="fa fa-arrow-down"></i><br><i class="fa fa-eye"></i> It's shown as like:<br>
+<span style="width:300px;height:159px"><img align="top" width="300" height="159" src="images/global1.png"></span>
+<span style="margin-left:7px;"><img width="20" src="images/arrow_right.png"></span>
+<span style="margin-left:7px;width:300px;height:159px"><img width="300" height="159" src="images/global2.png"></span>
+
+The value entered in **input1 declared in PAGE1** is reflected in **input1 of PAGE2** as AutoConnectText value even if there is no sketch code to transfer it to PAGE2.
+
+!!! note "Copy only for same-named and the global"
+    Copied only if the global attribute of the destination element is true. Even if the name of the destination element is the same, the copy is not performed if the global attribute is false.
+
 ### <i class="fa fa-wrench"></i> Retrieve the values with WebServer::on handler
 
 ESP8266WebServer class and the WebServer class assume that the implementation of the ReqestHandler class contained in the WebServer library will handle the URL requests. Usually, it is sketch code registered by ESP8266WebServer::on function.
@@ -713,10 +783,8 @@ By giving a [pattern](apielements.md#pattern) to [AutoConnectInput](apielements.
 }
 ```
 
-<div>
+<i class="fa fa-arrow-down"></i><br><i class="fa fa-eye"></i> It's shown as like:<br>
-  <span style="display:block;margin-left:136px;"><img width="32px" height="32xp" src="images/arrow_down.png"></span>
 <span style="display:block;width:306px;height:136px;border:1px solid lightgrey;"><img data-gifffer="images/aux_pattern.gif" data-gifffer-height="134" data-gifffer-width="304" /></span>
-</div>
 
 If you are not familiar with regular expressions, you may feel that description very strange. Matter of fact, it's a strange description for those who are unfamiliar with the formal languages. If your regular expression can not interpret the intended syntax and semantics, you can use an online tester. The [regex101](https://regex101.com/) is an exceptional online tool for testing and debugging regular expressions.
 

mkdocs/apielements.md

@@ -27,10 +27,18 @@ HTML native code of the action script to be executed when the button is clicked.
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
+</dl>
+
+#### <i class="fa fa-caret-right"></i> global
+
+The global attribute copies input values ​​between elements of the same name on different custom Web pages.
+<dl class="apidl">
+    <dt>**Type**</dt>
+    <dd><span class="apidef">bool</span><span class="apidesc">An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition.<br>However, it will be copied only when the destination element has the true for a global attribute.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> name
@@ -98,15 +106,23 @@ Returns type of AutoConnectElement.
 It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">Boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc"></span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
+<dl class="apidl">
+    <dt>**Type**</dt>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
+</dl>
+
+#### <i class="fa fa-caret-right"></i> global
+
+The global attribute copies input values ​​between elements of the same name on different custom Web pages.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition.<br>However, it will be copied only when the destination element has the true for a global attribute.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> label
@@ -177,10 +193,18 @@ AutoConnectElement(const char* name = "", const char* value = "", const ACPoster
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
+</dl>
+
+#### <i class="fa fa-caret-right"></i> global
+
+The global attribute copies input values ​​between elements of the same name on different custom Web pages.
+<dl class="apidl">
+    <dt>**Type**</dt>
+    <dd><span class="apidef">bool</span><span class="apidesc">An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition.<br>However, it will be copied only when the destination element has the true for a global attribute.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> name
@@ -258,10 +282,18 @@ AutoConnectFile(const char* name = "", const char* value = "", const char* label
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
+<dl class="apidl">
+    <dt>**Type**</dt>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
+</dl>
+
+#### <i class="fa fa-caret-right"></i> global
+
+The global attribute copies input values ​​between elements of the same name on different custom Web pages.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition.<br>However, it will be copied only when the destination element has the true for a global attribute.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> label
@@ -364,10 +396,18 @@ AutoConnectInput(const char* name = "", const char* value = "", const char* labe
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
+</dl>
+
+#### <i class="fa fa-caret-right"></i> global
+
+The global attribute copies input values ​​between elements of the same name on different custom Web pages.
+<dl class="apidl">
+    <dt>**Type**</dt>
+    <dd><span class="apidef">bool</span><span class="apidesc">An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition.<br>However, it will be copied only when the destination element has the true for a global attribute.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> label
@@ -477,10 +517,18 @@ Specifies the index number (1-based) of the **values** to be checked. If this pa
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
+<dl class="apidl">
+    <dt>**Type**</dt>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
+</dl>
+
+#### <i class="fa fa-caret-right"></i> global
+
+The global attribute copies input values ​​between elements of the same name on different custom Web pages.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition.<br>However, it will be copied only when the destination element has the true for a global attribute.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> label
@@ -635,10 +683,18 @@ AutoConnectSelect(const char* name = "", std::vector<String> const& options = {}
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
+</dl>
+
+#### <i class="fa fa-caret-right"></i> global
+
+The global attribute copies input values ​​between elements of the same name on different custom Web pages.
+<dl class="apidl">
+    <dt>**Type**</dt>
+    <dd><span class="apidef">bool</span><span class="apidesc">An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition.<br>However, it will be copied only when the destination element has the true for a global attribute.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> name
@@ -786,10 +842,10 @@ AutoConnectStyle(const char* name = "", const char* value = "")
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> name
@@ -840,10 +896,18 @@ AutoConnectSubmit(const char* name = "", const char* value ="", char* uri = "",
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
+<dl class="apidl">
+    <dt>**Type**</dt>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
+</dl>
+
+#### <i class="fa fa-caret-right"></i> global
+
+The global attribute copies input values ​​between elements of the same name on different custom Web pages.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition.<br>However, it will be copied only when the destination element has the true for a global attribute.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> name
@@ -916,10 +980,10 @@ AutoConnectText(const char* name = "", const char* value = "", const char* style
 
 #### <i class="fa fa-caret-right"></i> enable
 
-Enable HTML tag generation for the element. AutoConnect will generate the element into HTML only if the enable attribute is true.
+Enable HTML tag generation for the element.
 <dl class="apidl">
     <dt>**Type**</dt>
-    <dd><span class="apidef">boolean</span><span class="apidesc"></span></dd>
+    <dd><span class="apidef">bool</span><span class="apidesc">AutoConnect will generate the element into HTML only if the enable attribute is true.</span></dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> format

mkdocs/changelog.md

@@ -1,9 +1,9 @@
-#### [1.0.0] Sep. 5, 2019
+#### [1.0.0] Sept. 5, 2019
 - Supports Arduino core for ESP32 1.0.3.
 - Supports AutoConnectUpdate for the [OTA update](otaupdate.md).
 - Supports Preferences for saving credentials with ESP32 core 1.0.3 and later. **In ESP32, the credentials stored past in EEPROM will lose**.
 - Supports [**AutoConnectAux::isValid**](apiaux.md#isvalid) function.
-- Supports the **global** attribute with all AutoConnectElements.
+- Supports the [**global**](achandling.md#transfer-of-input-values-across-pages) attribute with all AutoConnectElements.
 
 #### [0.9.12] Aug. 18, 2019
 - Fixed missing captive portal notifications on the newer mobile OS client. As a result of this fix, the SoftAP default IP address and gateway have been changed to **172.217.28.1**.