upd

Author: GyverLibs

README.md

@@ -36,13 +36,13 @@ ESP8266, ESP32
 > Подключение в проект библиотеки FastLED версии старше [3.7.8](https://github.com/GyverLibs/Settings/issues/35#issuecomment-2691839527) ломает вебсервер! Ждём фиксов со стороны ESP или FastLED
 
 ### Зависимости
-- [GTL](https://github.com/GyverLibs/GTL) v1.2.1+
-- [GyverDB](https://github.com/GyverLibs/GyverDB) v1.2.3+
+- [GTL](https://github.com/GyverLibs/GTL) v1.3.0+
+- [GyverDB](https://github.com/GyverLibs/GyverDB) v1.3.0+
 - [StringUtils](https://github.com/GyverLibs/StringUtils) v1.4.30+
-- [GyverHTTP](https://github.com/GyverLibs/GyverHTTP) v1.0.23+
-- [BSON](https://github.com/GyverLibs/BSON) v2.0.5+
+- [GyverHTTP](https://github.com/GyverLibs/GyverHTTP) v1.0.26+
+- [BSON](https://github.com/GyverLibs/BSON) v2.1.0+
 - [Stamp](https://github.com/GyverLibs/Stamp) v1.4.0+
-- [Table](https://github.com/GyverLibs/Table) v1.1.0+
+- [Table](https://github.com/GyverLibs/Table) v1.2.0+
 - [StreamIO](https://github.com/GyverLibs/StreamIO) v1.0.5+
 
 > [!TIP]
@@ -135,10 +135,6 @@ ESP8266, ESP32
   - Добавлен минимум и максимум в Number
   - Мелкие исправления и улучшения
 
-## Благодарочки
-- Александр Инфинити - материальная поддержка проекта, идеи
-- TontonMacout - идеи, десктопное приложение
-
 ## Баги и обратная связь
 При нахождении багов создавайте **Issue**, а лучше сразу пишите на почту [[email protected]](mailto:[email protected])  
 Библиотека открыта для доработки и ваших **Pull Request**'ов!

docs/1.main.md

@@ -171,6 +171,9 @@ void endGroup();
 bool beginMenu(Text title);
 void endMenu();
 
+// true, если в вебморде было открыто текущее меню
+bool enterMenu();
+
 // горизонтальная группа виджетов [DivType::Line | DivType::Block]
 bool beginRow(Text title = Text(), DivType divtype = DivType::Default);
 void endRow();
@@ -322,6 +325,11 @@ bool Time(Text label = "", uint32_t* value = nullptr);
 bool DateTime(size_t id, Text label = "", uint32_t* value = nullptr, float zone_hours = NAN);
 bool DateTime(Text label = "", uint32_t* value = nullptr, float zone_hours = NAN);
 
+// ================= SPINNER =================
+// сипннер [результат - число], подключаемая переменная - любой тип
+bool Spinner(size_t id, Text label = "", float min = 0, float max = 100, float step = 1, AnyPtr value = nullptr);
+bool Spinner(Text label = "", float min = 0, float max = 100, float step = 1, AnyPtr value = nullptr);
+
 // ================= SLIDER =================
 // слайдер [результат - число], подключаемая переменная - любой тип
 bool Slider(size_t id, Text label = "", float min = 0, float max = 100, float step = 1, Text unit = Text(), AnyPtr value = nullptr, uint32_t color = SETS_DEFAULT_COLOR);
@@ -332,12 +340,17 @@ bool Slider(Text label, float min, float max, float step, Text unit, AnyPtr valu
 // двойной слайдер [результат - число], подключаемая переменная - любой тип
 bool Slider2(size_t id_min, size_t id_max, Text label = "", float min = 0, float max = 100, float step = 1, Text unit = Text(), AnyPtr value_min = nullptr, AnyPtr value_max = nullptr, uint32_t color = SETS_DEFAULT_COLOR);
 bool Slider2(size_t id_min, size_t id_max, Text label, float min, float max, float step, Text unit, AnyPtr value_min, AnyPtr value_max, Colors color);
+bool Slider2(Text label = "", float min = 0, float max = 100, float step = 1, Text unit = Text(), AnyPtr value_min = nullptr, AnyPtr value_max = nullptr, uint32_t color = SETS_DEFAULT_COLOR);
+bool Slider2(Text label, float min, float max, float step, Text unit, AnyPtr value_min, AnyPtr value_max, Colors color);
 
 // ================= SELECT =================
 // опции разделяются ; или \n [результат - индекс (число)]
 bool Select(size_t id, Text label, Text options, AnyPtr value = nullptr);
 bool Select(Text label, Text options, AnyPtr value = nullptr);
 
+// опции разделяются ; или \n [результат - строка]
+bool SelectText(Text label, Text options);
+
 // ================= TABS =================
 // опции разделяются ; или \n [результат - индекс (число)]
 bool Tabs(size_t id, Text tabs, AnyPtr value = nullptr);

docs/2.start.md

@@ -2,13 +2,13 @@
 Библиотека доступна в менеджере библиотек Arduino и PlatformIO
 
 ### Зависимости
-- [GTL](https://github.com/GyverLibs/GTL) v1.2.1+
-- [GyverDB](https://github.com/GyverLibs/GyverDB) v1.2.3+
+- [GTL](https://github.com/GyverLibs/GTL) v1.3.0+
+- [GyverDB](https://github.com/GyverLibs/GyverDB) v1.3.0+
 - [StringUtils](https://github.com/GyverLibs/StringUtils) v1.4.30+
-- [GyverHTTP](https://github.com/GyverLibs/GyverHTTP) v1.0.23+
-- [BSON](https://github.com/GyverLibs/BSON) v2.0.5+
+- [GyverHTTP](https://github.com/GyverLibs/GyverHTTP) v1.0.26+
+- [BSON](https://github.com/GyverLibs/BSON) v2.1.0+
 - [Stamp](https://github.com/GyverLibs/Stamp) v1.4.0+
-- [Table](https://github.com/GyverLibs/Table) v1.1.0+
+- [Table](https://github.com/GyverLibs/Table) v1.2.0+
 - [StreamIO](https://github.com/GyverLibs/StreamIO) v1.0.5+
 
 > [!TIP]

docs/4.widgets.md

@@ -228,6 +228,9 @@ b.Input("", nullptr, R"(^\d+$)", "Только цифры");
 ### Time
 Принимает и отправляет время в секундах с начала суток независимо от часового пояса.
 
+### Spinner
+Как Number, но с кнопками + и -, увеличивают значение на заданный шаг.
+
 ### Slider
 Слайдер для ввода значений, при движении отправляет значения с указанным в настройках вебморды периодом. Строка результата кликабельная, можно задать значение вручную - подчиняется настройкам min/max/step.
 
@@ -245,6 +248,21 @@ b.Input("", nullptr, R"(^\d+$)", "Только цифры");
 > [!TIP]
 > Список опций (в том числе в группе) может заканчиваться `;` - пустая опция добавлена не будет. Это позволяет удобно "собирать" список опций, прибавляя к строке опций `"опция;"` (сразу с разделителем на конце), например `"опция;опция;опция;"`
 
+### SelectText
+То же самое что Select, но является просто выбором из списка, не хранит выбранный пункт - просто отправляет его. Прочитать можно в `b.build.value` - `if (b.SelectText("", "foo;bar;option")) Serial.println(b.build.value);`.
+
+Например вот так можно сделать выбор файла и открытие при выборе:
+
+```cpp
+if (b.SelectText("Select file", sett.fs.listDir())) {
+    File f = sett.fs.openRead(b.build.value.c_str());
+    Serial.print("File ");
+    Serial.print(b.build.value);
+    Serial.print(" size ");
+    Serial.println(f.size());
+}
+```
+
 ### Tabs
 Вкладки, принимает и отправляет индекс вкладки (начиная с 0). Имена вкладок передаются в виде строки с разделителем `;`: `"tab 1;tab 2;my tab"`. Если вкладок слишком много - их можно перемещать пальцем и курсором. Вернёт `true` при клике по вкладке. Далее в программе можно строить билдер по условиям или в `switch` исходя из значения вкладки.
 

docs/5.containers.md

@@ -54,6 +54,26 @@ void build(sets::Builder& b) {
 }
 ```
 
+Когда пользователь входит в меню - вызывается билдер, для того чтобы можно было например обновить некоторые поля внутри этого меню. Для опроса события входа используется `b.enterMenu()`:
+
+```cpp
+{
+    sets::Menu m(b, "menu 1");
+    if (b.enterMenu()) Serial.println("menu 1");
+    // b.Input();
+}
+{
+    sets::Menu m(b, "menu 2");
+    if (b.enterMenu()) Serial.println("menu 2");
+    // b.Input();
+    {
+        sets::Menu m(b, "menu 2.1");
+        if (b.enterMenu()) Serial.println("menu 2.1");
+        // b.Input();
+    }
+}
+```
+
 ### Строка
 Можно располагать виджеты горизонтально в строку, у них может быть общее название. Вне группы строка получит белый фон. Если у виджета задано название - он будет пытаться растянуться на всю ширину, если нет - то не будет. Частый вариант использования - первый виджет с названием, остальные мелкие без:
 

docs/7.other.md

@@ -57,4 +57,28 @@ void loop() {
         Serial.println(sett.rtc.toString());
     }
 }
-```
+```
+
+## Другой вебсервер
+Можно поднять библиотеку на любом вебсервере, для этого нужно наследоваться от `sets::SettingsBase` и реализовать нужные методы по аналогии со стандартными `SettingsGyver`, `SettingsESP` и проч.
+
+Самый простой вариант - сделать класс на базе `SettingsT` - он использует вебсервер `GyverHTTP` на базе любого указанного стороннего сервера и клиента:
+
+```cpp
+#include "SettingsT.h"
+
+class MySettings : public SettingsT<MyServer, MyClient> {
+   public:
+    using SettingsT<MyServer, MyClient>::SettingsT;
+
+   private:
+    String getMac() override {
+        // mac адрес для приложения поиска Settings Discover (необязательно)
+    }
+    int getRSSI() override {
+        // качество связи в % (необязательно)
+    }
+};
+```
+
+где `MyServer` и `MyClient` - класс сервера и клиента для вашей реализации связи, например классы от Ethernet модуля.

library.properties

@@ -1,5 +1,5 @@
 name=Settings
-version=1.3.2
+version=1.3.3
 author=AlexGyver <[email protected]>
 maintainer=AlexGyver <[email protected]>
 sentence=Simple UI webface builder for esp8266/esp32

src/SettingsAsync.h

@@ -142,6 +142,16 @@ class SettingsAsync : public sets::SettingsBase {
     sets::DnsWrapper _dns;
     File _file;
 
+    String getMac() override {
+        return WiFi.macAddress();
+    }
+    int getRSSI() override {
+        return constrain(2 * (WiFi.RSSI() + 100), 0, 100);
+    }
+    IPAddress getIP() override {
+        return WiFi.localIP();
+    }
+
     void answer(uint8_t *data, size_t len) override {
         if (_response) _response->write(data, len);
     }

src/SettingsESP.h

@@ -10,8 +10,8 @@
 #include <WebServer.h>
 #endif
 
-#include "./core/SettingsBase.h"
 #include "./core/DnsWrapper.h"
+#include "./core/SettingsBase.h"
 #include "./core/ota.h"
 #include "./web/settings.h"
 
@@ -149,6 +149,16 @@ class SettingsESP : public sets::SettingsBase {
     File _file;
     bool _first = true;
 
+    String getMac() override {
+        return WiFi.macAddress();
+    }
+    int getRSSI() override {
+        return constrain(2 * (WiFi.RSSI() + 100), 0, 100);
+    }
+    IPAddress getIP() override {
+        return WiFi.localIP();
+    }
+
     void answer(uint8_t* data, size_t len) override {
         if (_first) {
             _first = false;

src/SettingsGyver.h

@@ -6,4 +6,15 @@
 class SettingsGyver : public SettingsT<WiFiServer, WiFiClient> {
    public:
     using SettingsT<WiFiServer, WiFiClient>::SettingsT;
+
+   private:
+    String getMac() override {
+        return WiFi.macAddress();
+    }
+    int getRSSI() override {
+        return constrain(2 * (WiFi.RSSI() + 100), 0, 100);
+    }
+    IPAddress getIP() override {
+        return WiFi.localIP();
+    }
 };