adexterior.html 39 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140
  1. <!doctype html>
  2. <html lang="en" class="no-js">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <meta name="description" content="ESP8266/ESP32 WLAN configuration at run time with web interface">
  7. <link rel="canonical" href="https://Hieromon.github.io/AutoConnect/adexterior.html">
  8. <meta name="author" content="Hieromon Ikasamo">
  9. <link rel="shortcut icon" href="assets/images/favicon.png">
  10. <meta name="generator" content="mkdocs-1.1.2, mkdocs-material-6.1.6">
  11. <title>Customizing page appearance - AutoConnect for ESP8266/ESP32</title>
  12. <link rel="stylesheet" href="assets/stylesheets/main.6910b76c.min.css">
  13. <link rel="stylesheet" href="assets/stylesheets/palette.196e0c26.min.css">
  14. <meta name="theme-color" content="#4051b5">
  15. <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
  16. <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback">
  17. <style>body,input{font-family:"Roboto",-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono",SFMono-Regular,Consolas,Menlo,monospace}</style>
  18. <link rel="stylesheet" href="css/paragraph.css">
  19. <link rel="stylesheet" href="css/extra.css">
  20. <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.3/css/all.css">
  21. <script>window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)},ga.l=+new Date,ga("create","UA-116150854-1","auto"),ga("set","anonymizeIp",!0),ga("send","pageview"),document.addEventListener("DOMContentLoaded",function(){document.forms.search&&document.forms.search.query.addEventListener("blur",function(){if(this.value){var e=document.location.pathname;ga("send","pageview",e+"?q="+this.value)}})}),document.addEventListener("DOMContentSwitch",function(){ga("send","pageview",document.location.pathname)})</script>
  22. <script async src="https://www.google-analytics.com/analytics.js"></script>
  23. </head>
  24. <body dir="ltr" data-md-color-scheme="" data-md-color-primary="indigo" data-md-color-accent="indigo">
  25. <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
  26. <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
  27. <label class="md-overlay" for="__drawer"></label>
  28. <div data-md-component="skip">
  29. <a href="#make-different-menu-labels" class="md-skip">
  30. Skip to content
  31. </a>
  32. </div>
  33. <div data-md-component="announce">
  34. </div>
  35. <header class="md-header" data-md-component="header">
  36. <nav class="md-header-nav md-grid" aria-label="Header">
  37. <a href="https://Hieromon.github.io/AutoConnect/" title="AutoConnect for ESP8266/ESP32" class="md-header-nav__button md-logo" aria-label="AutoConnect for ESP8266/ESP32">
  38. <img src="images/arduino-logo.svg" alt="logo">
  39. </a>
  40. <label class="md-header-nav__button md-icon" for="__drawer">
  41. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg>
  42. </label>
  43. <div class="md-header-nav__title" data-md-component="header-title">
  44. <div class="md-header-nav__ellipsis">
  45. <span class="md-header-nav__topic md-ellipsis">
  46. AutoConnect for ESP8266/ESP32
  47. </span>
  48. <span class="md-header-nav__topic md-ellipsis">
  49. Customizing page appearance
  50. </span>
  51. </div>
  52. </div>
  53. <label class="md-header-nav__button md-icon" for="__search">
  54. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  55. </label>
  56. <div class="md-search" data-md-component="search" role="dialog">
  57. <label class="md-search__overlay" for="__search"></label>
  58. <div class="md-search__inner" role="search">
  59. <form class="md-search__form" name="search">
  60. <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active" required>
  61. <label class="md-search__icon md-icon" for="__search">
  62. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg>
  63. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
  64. </label>
  65. <button type="reset" class="md-search__icon md-icon" aria-label="Clear" data-md-component="search-reset" tabindex="-1">
  66. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg>
  67. </button>
  68. </form>
  69. <div class="md-search__output">
  70. <div class="md-search__scrollwrap" data-md-scrollfix>
  71. <div class="md-search-result" data-md-component="search-result">
  72. <div class="md-search-result__meta">
  73. Initializing search
  74. </div>
  75. <ol class="md-search-result__list"></ol>
  76. </div>
  77. </div>
  78. </div>
  79. </div>
  80. </div>
  81. <div class="md-header-nav__source">
  82. <a href="https://github.com/Hieromon/AutoConnect" title="Go to repository" class="md-source">
  83. <div class="md-source__icon md-icon">
  84. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05L244 40.45a28.87 28.87 0 00-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 01-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 000 40.81l195.61 195.6a28.86 28.86 0 0040.8 0l194.69-194.69a28.86 28.86 0 000-40.81z"/></svg>
  85. </div>
  86. <div class="md-source__repository">
  87. Hieromon/AutoConnect
  88. </div>
  89. </a>
  90. </div>
  91. </nav>
  92. </header>
  93. <div class="md-container" data-md-component="container">
  94. <main class="md-main" data-md-component="main">
  95. <div class="md-main__inner md-grid">
  96. <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
  97. <div class="md-sidebar__scrollwrap">
  98. <div class="md-sidebar__inner">
  99. <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
  100. <label class="md-nav__title" for="__drawer">
  101. <a href="https://Hieromon.github.io/AutoConnect/" title="AutoConnect for ESP8266/ESP32" class="md-nav__button md-logo" aria-label="AutoConnect for ESP8266/ESP32">
  102. <img src="images/arduino-logo.svg" alt="logo">
  103. </a>
  104. AutoConnect for ESP8266/ESP32
  105. </label>
  106. <div class="md-nav__source">
  107. <a href="https://github.com/Hieromon/AutoConnect" title="Go to repository" class="md-source">
  108. <div class="md-source__icon md-icon">
  109. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05L244 40.45a28.87 28.87 0 00-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 01-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 000 40.81l195.61 195.6a28.86 28.86 0 0040.8 0l194.69-194.69a28.86 28.86 0 000-40.81z"/></svg>
  110. </div>
  111. <div class="md-source__repository">
  112. Hieromon/AutoConnect
  113. </div>
  114. </a>
  115. </div>
  116. <ul class="md-nav__list" data-md-scrollfix>
  117. <li class="md-nav__item">
  118. <a href="index.html" class="md-nav__link">
  119. Overview
  120. </a>
  121. </li>
  122. <li class="md-nav__item">
  123. <a href="gettingstarted.html" class="md-nav__link">
  124. Getting started
  125. </a>
  126. </li>
  127. <li class="md-nav__item">
  128. <a href="menu.html" class="md-nav__link">
  129. AutoConnect menu
  130. </a>
  131. </li>
  132. <li class="md-nav__item">
  133. <a href="basicusage.html" class="md-nav__link">
  134. Basic usage
  135. </a>
  136. </li>
  137. <li class="md-nav__item md-nav__item--active md-nav__item--nested">
  138. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5" checked>
  139. <label class="md-nav__link" for="nav-5">
  140. Advanced usage
  141. <span class="md-nav__icon md-icon"></span>
  142. </label>
  143. <nav class="md-nav" aria-label="Advanced usage" data-md-level="1">
  144. <label class="md-nav__title" for="nav-5">
  145. <span class="md-nav__icon md-icon"></span>
  146. Advanced usage
  147. </label>
  148. <ul class="md-nav__list" data-md-scrollfix>
  149. <li class="md-nav__item">
  150. <a href="advancedusage.html" class="md-nav__link">
  151. Advanced usage
  152. </a>
  153. </li>
  154. <li class="md-nav__item">
  155. <a href="adconnection.html" class="md-nav__link">
  156. AutoConnect WiFi connection control
  157. </a>
  158. </li>
  159. <li class="md-nav__item">
  160. <a href="adcpcontrol.html" class="md-nav__link">
  161. Captive portal control
  162. </a>
  163. </li>
  164. <li class="md-nav__item">
  165. <a href="adnetwork.html" class="md-nav__link">
  166. Settings and controls for network and WiFi
  167. </a>
  168. </li>
  169. <li class="md-nav__item">
  170. <a href="adauthentication.html" class="md-nav__link">
  171. Authentication settings
  172. </a>
  173. </li>
  174. <li class="md-nav__item">
  175. <a href="adcredential.html" class="md-nav__link">
  176. Credential accesses
  177. </a>
  178. </li>
  179. <li class="md-nav__item md-nav__item--active">
  180. <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc">
  181. <label class="md-nav__link md-nav__link--active" for="__toc">
  182. Customizing page appearance
  183. <span class="md-nav__icon md-icon"></span>
  184. </label>
  185. <a href="adexterior.html" class="md-nav__link md-nav__link--active">
  186. Customizing page appearance
  187. </a>
  188. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  189. <label class="md-nav__title" for="__toc">
  190. <span class="md-nav__icon md-icon"></span>
  191. Table of contents
  192. </label>
  193. <ul class="md-nav__list" data-md-scrollfix>
  194. <li class="md-nav__item">
  195. <a href="#make-different-menu-labels" class="md-nav__link">
  196. Make different menu labels
  197. </a>
  198. </li>
  199. <li class="md-nav__item">
  200. <a href="#make-different-menu-title" class="md-nav__link">
  201. Make different menu title
  202. </a>
  203. </li>
  204. <li class="md-nav__item">
  205. <a href="#capture-the-legacy-web-pages-as-items-into-the-menu" class="md-nav__link">
  206. Capture the legacy web pages as items into the menu
  207. </a>
  208. </li>
  209. </ul>
  210. </nav>
  211. </li>
  212. <li class="md-nav__item">
  213. <a href="adothers.html" class="md-nav__link">
  214. Other operation settings and controls
  215. </a>
  216. </li>
  217. </ul>
  218. </nav>
  219. </li>
  220. <li class="md-nav__item md-nav__item--nested">
  221. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-6" type="checkbox" id="nav-6" >
  222. <label class="md-nav__link" for="nav-6">
  223. Custom Web pages
  224. <span class="md-nav__icon md-icon"></span>
  225. </label>
  226. <nav class="md-nav" aria-label="Custom Web pages" data-md-level="1">
  227. <label class="md-nav__title" for="nav-6">
  228. <span class="md-nav__icon md-icon"></span>
  229. Custom Web pages
  230. </label>
  231. <ul class="md-nav__list" data-md-scrollfix>
  232. <li class="md-nav__item">
  233. <a href="acintro.html" class="md-nav__link">
  234. Custom Web pages with AutoConnect
  235. </a>
  236. </li>
  237. <li class="md-nav__item">
  238. <a href="acelements.html" class="md-nav__link">
  239. AutoConnectElements
  240. </a>
  241. </li>
  242. <li class="md-nav__item">
  243. <a href="acjson.html" class="md-nav__link">
  244. Custom Web pages with JSON
  245. </a>
  246. </li>
  247. <li class="md-nav__item">
  248. <a href="achandling.html" class="md-nav__link">
  249. Handling the custom Web pages
  250. </a>
  251. </li>
  252. </ul>
  253. </nav>
  254. </li>
  255. <li class="md-nav__item md-nav__item--nested">
  256. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-7" type="checkbox" id="nav-7" >
  257. <label class="md-nav__link" for="nav-7">
  258. OTA Updates
  259. <span class="md-nav__icon md-icon"></span>
  260. </label>
  261. <nav class="md-nav" aria-label="OTA Updates" data-md-level="1">
  262. <label class="md-nav__title" for="nav-7">
  263. <span class="md-nav__icon md-icon"></span>
  264. OTA Updates
  265. </label>
  266. <ul class="md-nav__list" data-md-scrollfix>
  267. <li class="md-nav__item">
  268. <a href="otaupdate.html" class="md-nav__link">
  269. OTA Updates
  270. </a>
  271. </li>
  272. <li class="md-nav__item">
  273. <a href="otabrowser.html" class="md-nav__link">
  274. Using Web Browser
  275. </a>
  276. </li>
  277. <li class="md-nav__item">
  278. <a href="otaserver.html" class="md-nav__link">
  279. Using Update Server
  280. </a>
  281. </li>
  282. </ul>
  283. </nav>
  284. </li>
  285. <li class="md-nav__item md-nav__item--nested">
  286. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-8" type="checkbox" id="nav-8" >
  287. <label class="md-nav__link" for="nav-8">
  288. Library APIs
  289. <span class="md-nav__icon md-icon"></span>
  290. </label>
  291. <nav class="md-nav" aria-label="Library APIs" data-md-level="1">
  292. <label class="md-nav__title" for="nav-8">
  293. <span class="md-nav__icon md-icon"></span>
  294. Library APIs
  295. </label>
  296. <ul class="md-nav__list" data-md-scrollfix>
  297. <li class="md-nav__item">
  298. <a href="api.html" class="md-nav__link">
  299. AutoConnect API
  300. </a>
  301. </li>
  302. <li class="md-nav__item">
  303. <a href="apiaux.html" class="md-nav__link">
  304. AutoConnectAux API
  305. </a>
  306. </li>
  307. <li class="md-nav__item">
  308. <a href="apiconfig.html" class="md-nav__link">
  309. AutoConnectConfig API
  310. </a>
  311. </li>
  312. <li class="md-nav__item">
  313. <a href="apielements.html" class="md-nav__link">
  314. AutoConnectElements API
  315. </a>
  316. </li>
  317. <li class="md-nav__item">
  318. <a href="apiupdate.html" class="md-nav__link">
  319. AutoConnectUpdate API
  320. </a>
  321. </li>
  322. <li class="md-nav__item">
  323. <a href="apiextra.html" class="md-nav__link">
  324. Something extra
  325. </a>
  326. </li>
  327. </ul>
  328. </nav>
  329. </li>
  330. <li class="md-nav__item md-nav__item--nested">
  331. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-9" type="checkbox" id="nav-9" >
  332. <label class="md-nav__link" for="nav-9">
  333. Examples
  334. <span class="md-nav__icon md-icon"></span>
  335. </label>
  336. <nav class="md-nav" aria-label="Examples" data-md-level="1">
  337. <label class="md-nav__title" for="nav-9">
  338. <span class="md-nav__icon md-icon"></span>
  339. Examples
  340. </label>
  341. <ul class="md-nav__list" data-md-scrollfix>
  342. <li class="md-nav__item">
  343. <a href="howtoembed.html" class="md-nav__link">
  344. How to embed
  345. </a>
  346. </li>
  347. <li class="md-nav__item">
  348. <a href="datatips.html" class="md-nav__link">
  349. Tips for data conversion
  350. </a>
  351. </li>
  352. <li class="md-nav__item">
  353. <a href="menuize.html" class="md-nav__link">
  354. Attach the menus
  355. </a>
  356. </li>
  357. <li class="md-nav__item">
  358. <a href="wojson.html" class="md-nav__link">
  359. Custom Web pages w/o JSON
  360. </a>
  361. </li>
  362. </ul>
  363. </nav>
  364. </li>
  365. <li class="md-nav__item md-nav__item--nested">
  366. <input class="md-nav__toggle md-toggle" data-md-toggle="nav-10" type="checkbox" id="nav-10" >
  367. <label class="md-nav__link" for="nav-10">
  368. Appendix
  369. <span class="md-nav__icon md-icon"></span>
  370. </label>
  371. <nav class="md-nav" aria-label="Appendix" data-md-level="1">
  372. <label class="md-nav__title" for="nav-10">
  373. <span class="md-nav__icon md-icon"></span>
  374. Appendix
  375. </label>
  376. <ul class="md-nav__list" data-md-scrollfix>
  377. <li class="md-nav__item">
  378. <a href="lsbegin.html" class="md-nav__link">
  379. Inside AutoConnect::begin
  380. </a>
  381. </li>
  382. <li class="md-nav__item">
  383. <a href="credit.html" class="md-nav__link">
  384. Saved credentials access
  385. </a>
  386. </li>
  387. <li class="md-nav__item">
  388. <a href="acupload.html" class="md-nav__link">
  389. File upload handler
  390. </a>
  391. </li>
  392. <li class="md-nav__item">
  393. <a href="colorized.html" class="md-nav__link">
  394. Custom colorized
  395. </a>
  396. </li>
  397. <li class="md-nav__item">
  398. <a href="changelabel.html" class="md-nav__link">
  399. Change label text
  400. </a>
  401. </li>
  402. </ul>
  403. </nav>
  404. </li>
  405. <li class="md-nav__item">
  406. <a href="faq.html" class="md-nav__link">
  407. FAQ
  408. </a>
  409. </li>
  410. <li class="md-nav__item">
  411. <a href="changelog.html" class="md-nav__link">
  412. Change log
  413. </a>
  414. </li>
  415. <li class="md-nav__item">
  416. <a href="license.html" class="md-nav__link">
  417. License
  418. </a>
  419. </li>
  420. </ul>
  421. </nav>
  422. </div>
  423. </div>
  424. </div>
  425. <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
  426. <div class="md-sidebar__scrollwrap">
  427. <div class="md-sidebar__inner">
  428. <nav class="md-nav md-nav--secondary" aria-label="Table of contents">
  429. <label class="md-nav__title" for="__toc">
  430. <span class="md-nav__icon md-icon"></span>
  431. Table of contents
  432. </label>
  433. <ul class="md-nav__list" data-md-scrollfix>
  434. <li class="md-nav__item">
  435. <a href="#make-different-menu-labels" class="md-nav__link">
  436. Make different menu labels
  437. </a>
  438. </li>
  439. <li class="md-nav__item">
  440. <a href="#make-different-menu-title" class="md-nav__link">
  441. Make different menu title
  442. </a>
  443. </li>
  444. <li class="md-nav__item">
  445. <a href="#capture-the-legacy-web-pages-as-items-into-the-menu" class="md-nav__link">
  446. Capture the legacy web pages as items into the menu
  447. </a>
  448. </li>
  449. </ul>
  450. </nav>
  451. </div>
  452. </div>
  453. </div>
  454. <div class="md-content">
  455. <article class="md-content__inner md-typeset">
  456. <h1>Customizing page appearance</h1>
  457. <p>The design of various AutoConnect web pages is basically inflexible. Its appearance and layout don't have many customizable visual aspects but nevertheless, you can customize the following appearances of your AutoConnect web pages:</p>
  458. <ul>
  459. <li><a href="colorized.html">AutoConnect menu colorize</a> (See <a href="colorized.html">Appendix</a>)</li>
  460. <li><a href="#make-different-menu-labels">Make different menu labels</a></li>
  461. <li><a href="#make-different-menu-title">Make different menu title</a></li>
  462. <li><a href="#capture-the-legacy-web-pages-as-items-into-the-menu">Capture the legacy web pages as items into the menu</a></li>
  463. </ul>
  464. <h2 id="make-different-menu-labels">Make different menu labels<a class="headerlink" href="#make-different-menu-labels" title="Permanent link">&para;</a></h2>
  465. <p>You can change the label text for each menu item but cannot change them at run time. There are two ways to change the label text, both of which require coding the label literal.</p>
  466. <ol>
  467. <li>
  468. <p>Overwrite the label literal of library source code directly.</p>
  469. <p>You can change the label of the AutoConnect menu item by rewriting the default label literal in <a href="https://github.com/Hieromon/AutoConnect/blob/master/src/AutoConnectLabels.h">AutoConnectLabels.h</a> macros. However, changing menu items literal influences all the Sketch's build scenes.</p>
  470. <div class="highlight" style="background: #272822"><pre style="line-height: 125%; margin: 0;"><span></span><code><span style="color: #75715e">#define AUTOCONNECT_MENULABEL_CONFIGNEW &quot;Configure new AP&quot;</span>
  471. <span style="color: #75715e">#define AUTOCONNECT_MENULABEL_OPENSSIDS &quot;Open SSIDs&quot;</span>
  472. <span style="color: #75715e">#define AUTOCONNECT_MENULABEL_DISCONNECT &quot;Disconnect&quot;</span>
  473. <span style="color: #75715e">#define AUTOCONNECT_MENULABEL_RESET &quot;Reset...&quot;</span>
  474. <span style="color: #75715e">#define AUTOCONNECT_MENULABEL_UPDATE &quot;Update&quot;</span>
  475. <span style="color: #75715e">#define AUTOCONNECT_MENULABEL_HOME &quot;HOME&quot;</span>
  476. <span style="color: #75715e">#define AUTOCONNECT_MENULABEL_DEVINFO &quot;Device info&quot;</span>
  477. <span style="color: #75715e">#define AUTOCONNECT_BUTTONLABEL_RESET &quot;RESET&quot;</span>
  478. <span style="color: #75715e">#define AUTOCONNECT_BUTTONLABEL_UPDATE &quot;UPDATE&quot;</span>
  479. </code></pre></div>
  480. <div class="admonition note">
  481. <p class="admonition-title"><strong>build_flags</strong> with PlatformIO will no effect</p>
  482. <p>The mistake that many people make is to use PlatformIO's build_flags to try to redefine any literal at compile time.<br>
  483. The AutoConnect library statically contains the label literals which are embedded as binary data when compiling the library code. The label literals will not change without compiling the library source.<br>
  484. And PlatformIO is a build system. Library sources will not be compiled unless AutoConnectLabels.h is updated.</p>
  485. </div>
  486. </li>
  487. <li>
  488. <p>Change the label literals for each Arduino project</p>
  489. <p>Another way to change the label literal is to provide a header file that defines the label literals, as mentioned in <a href="changelabel.html#change-the-items-label-text">Appendix</a>. You can also use this method to display label text and fixed text in the local language on the AutoConnect page. See <a href="changelabel.html#change-the-items-label-text">Change the item's label text</a> section for details.</p>
  490. </li>
  491. </ol>
  492. <h2 id="make-different-menu-title">Make different menu title<a class="headerlink" href="#make-different-menu-title" title="Permanent link">&para;</a></h2>
  493. <p>Although the default menu title is <strong>AutoConnect</strong>, you can change the title by setting <a href="apiconfig.html#title"><em>AutoConnectConfig::title</em></a>. To set the menu title properly, you must set before calling <a href="api.html#begin">AutoConnect::begin</a>.</p>
  494. <div class="highlight" style="background: #272822"><pre style="line-height: 125%; margin: 0;"><span></span><code><span style="color: #f8f8f2">AutoConnect</span> <span style="color: #f8f8f2">Portal;</span>
  495. <span style="color: #f8f8f2">AutoConnectConfig</span> <span style="color: #f8f8f2">Config;</span>
  496. <span style="color: #66d9ef">void</span> <span style="color: #a6e22e">setup</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
  497. <span style="color: #75715e">// Set menu title</span>
  498. <span style="background-color: #49483e"> <span style="color: #f8f8f2">Config.title</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">&quot;FSBrowser&quot;</span><span style="color: #f8f8f2">;</span>
  499. </span><span style="background-color: #49483e"> <span style="color: #f8f8f2">Portal.config(Config);</span>
  500. </span> <span style="color: #f8f8f2">Portal.begin();</span>
  501. <span style="color: #f8f8f2">}</span>
  502. </code></pre></div>
  503. <p>Executing the above sketch will rewrite the menu title for the <strong>FSBrowser</strong> as the below.</p>
  504. <div style="float:left;width:40%;height:470px;overflow:hidden;"><img src="images/fsbmenu.png"></div>
  505. <p><img style="margin-left:70px;width:40%;height:470px;" src="images/fsbmenu_expand.png"></p>
  506. <h2 id="capture-the-legacy-web-pages-as-items-into-the-menu">Capture the legacy web pages as items into the menu<a class="headerlink" href="#capture-the-legacy-web-pages-as-items-into-the-menu" title="Permanent link">&para;</a></h2>
  507. <p>You can embed the ordinary page processed by the ESP8266WebServer request handler as an item into the AutoConnect menu. AutoConnect can capture the legacy web pages for ESP8266WebServer or WebServer of ESP32 and extends the menu containing these items.<br />
  508. In ordinary, the Sketch registers the request handler for the page depending on URI using the <a href="https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer#client-request-handlers">ESP8266WebServer::on</a> function. AutoConnect allows Sketch to bundle the registered legacy page into a menu. the Sketch is able to include its URI to a menu item using <a href="api.html#append">AutoConnect::append</a> function that creates internally an <a href="acintro.html"><strong>AutoConnectAux</strong></a> depended on its URI and integrates into the menu.</p>
  509. <p>The following code has a mixture of both AutoConnectAux and the legacy web page. An AutoConnectAux page is menued automatically with the <a href="api.html#join">AutoConnect::join</a> or <a href="api.html#load">AutoConnect::load</a> function. Similarly, a legacy page is integrated by the <a href="api.html#append">AutoConnect::append</a> function.</p>
  510. <div class="highlight" style="background: #272822"><pre style="line-height: 125%; margin: 0;"><span></span><code><span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;ESP8266WiFi.h&gt;</span>
  511. <span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;ESP8266WebServer.h&gt;</span>
  512. <span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;AutoConnect.h&gt;</span>
  513. <span style="color: #f8f8f2">ESP8266WebServer</span> <span style="color: #f8f8f2">server;</span>
  514. <span style="color: #f8f8f2">AutoConnect</span> <span style="color: #a6e22e">portal</span><span style="color: #f8f8f2">(server);</span>
  515. <span style="color: #75715e">// Definitions of AutoConnectAux page</span>
  516. <span style="color: #66d9ef">static</span> <span style="color: #66d9ef">const</span> <span style="color: #66d9ef">char</span> <span style="color: #f8f8f2">PAGE[]</span> <span style="color: #f8f8f2">PROGMEM</span> <span style="color: #f92672">=</span> <span style="color: #e6db74">R&quot;(</span>
  517. <span style="color: #e6db74">{</span>
  518. <span style="color: #e6db74"> &quot;title&quot;: &quot;PAGE&quot;,</span>
  519. <span style="color: #e6db74"> &quot;uri&quot;: &quot;/page&quot;,</span>
  520. <span style="color: #e6db74"> &quot;menu&quot;: true,</span>
  521. <span style="color: #e6db74"> &quot;element&quot;: [</span>
  522. <span style="color: #e6db74"> {</span>
  523. <span style="color: #e6db74"> &quot;name&quot;: &quot;cap&quot;,</span>
  524. <span style="color: #e6db74"> &quot;type&quot;: &quot;ACText&quot;,</span>
  525. <span style="color: #e6db74"> &quot;value&quot;: &quot;This is a custom web page.&quot;</span>
  526. <span style="color: #e6db74"> }</span>
  527. <span style="color: #e6db74"> ]</span>
  528. <span style="color: #e6db74">}</span>
  529. <span style="color: #e6db74">)&quot;</span><span style="color: #f8f8f2">;</span>
  530. <span style="color: #66d9ef">void</span> <span style="color: #a6e22e">setup</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
  531. <span style="color: #75715e">// The Web page handler located to /hello</span>
  532. <span style="background-color: #49483e"> <span style="color: #f8f8f2">server.on(</span><span style="color: #e6db74">&quot;/hello&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">[](){</span>
  533. </span> <span style="color: #f8f8f2">server.send(</span><span style="color: #ae81ff">200</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;text/html&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">String(F(</span>
  534. <span style="color: #e6db74">&quot;&lt;html&gt;&quot;</span>
  535. <span style="color: #e6db74">&quot;&lt;head&gt;&lt;meta name=&#39;viewport&#39; content=&#39;width=device-width,initial-scale=1.0&#39;&gt;&lt;/head&gt;&quot;</span>
  536. <span style="color: #e6db74">&quot;&lt;body&gt;&lt;h2&gt;Hello, world&lt;/h2&gt;&lt;/body&gt;&quot;</span>
  537. <span style="color: #e6db74">&quot;&lt;/html&gt;&quot;</span>
  538. <span style="color: #f8f8f2">)));</span>
  539. <span style="color: #f8f8f2">});</span>
  540. <span style="background-color: #49483e"> <span style="color: #f8f8f2">portal.append(</span><span style="color: #e6db74">&quot;/hello&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;HELLO&quot;</span><span style="color: #f8f8f2">);</span> <span style="color: #75715e">// Adds an item as HELLO into the menu</span>
  541. </span> <span style="color: #f8f8f2">portal.load(FPSTR(PAGE));</span> <span style="color: #75715e">// Load AutoConnectAux custom web page</span>
  542. <span style="color: #f8f8f2">portal.begin();</span>
  543. <span style="color: #f8f8f2">}</span>
  544. <span style="color: #66d9ef">void</span> <span style="color: #a6e22e">loop</span><span style="color: #f8f8f2">()</span> <span style="color: #f8f8f2">{</span>
  545. <span style="color: #f8f8f2">portal.handleClient();</span>
  546. <span style="color: #f8f8f2">}</span>
  547. </code></pre></div>
  548. <p><span style="display:block;margin-left:auto;margin-right:auto;width:284px;height:462px;border:1px solid lightgrey;"><img data-gifffer="images/addmenu.gif" data-gifffer-height="460" data-gifffer-width="282" /></span></p>
  549. <p>The <a href="api.html#append">AutoConnect::append</a> function also has the third parameter that directly specifies the request handler. It has similar efficacy to calling the append and <code>ESP8266WebSever::on</code> at once. <sup id="fnref:4"><a class="footnote-ref" href="#fn:4">1</a></sup></p>
  550. <div class="highlight" style="background: #272822"><pre style="line-height: 125%; margin: 0;"><span></span><code><span style="color: #f8f8f2">portal.append(</span><span style="color: #e6db74">&quot;/hello&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;HELLO&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">[](){</span>
  551. <span style="color: #f8f8f2">server.send(</span><span style="color: #ae81ff">200</span><span style="color: #f8f8f2">,</span> <span style="color: #e6db74">&quot;text/html&quot;</span><span style="color: #f8f8f2">,</span> <span style="color: #f8f8f2">String(F(</span>
  552. <span style="color: #e6db74">&quot;&lt;html&gt;&quot;</span>
  553. <span style="color: #e6db74">&quot;&lt;head&gt;&lt;meta name=&#39;viewport&#39; content=&#39;width=device-width,initial-scale=1.0&#39;&gt;&lt;/head&gt;&quot;</span>
  554. <span style="color: #e6db74">&quot;&lt;body&gt;&lt;h2&gt;Hello, world&lt;/h2&gt;&lt;/body&gt;&quot;</span>
  555. <span style="color: #e6db74">&quot;&lt;/html&gt;&quot;</span>
  556. <span style="color: #f8f8f2">)));</span>
  557. <span style="color: #f8f8f2">});</span>
  558. </code></pre></div>
  559. <p>For more details, see section <a href="menuize.html">Attach the menus</a> of Examples page.</p>
  560. <div class="admonition note">
  561. <p class="admonition-title">An instance of ESP8266WebServer/WebServer is needed</p>
  562. <p>When calling the append function with request handler parameters, an instance of the WebServer as the registration destination must exist.<br />
  563. AutoConnect can instantiate and host a WebServer internally, but in that case, the point in time to call the <a href="api.html#append">AutoConnect::append</a> function with a request handler parameter must be after <a href="api.html#begin">AutoConnect::begin</a>.</p>
  564. </div>
  565. <script>
  566. window.onload = function() {
  567. Gifffer();
  568. };
  569. </script>
  570. <div class="footnote">
  571. <hr />
  572. <ol>
  573. <li id="fn:4">
  574. <p>However, the pages registered this way remain legacy. Therefore, the AutoConnect menu bar is not appeared.&#160;<a class="footnote-backref" href="#fnref:4" title="Jump back to footnote 1 in the text">&#8617;</a></p>
  575. </li>
  576. </ol>
  577. </div>
  578. </article>
  579. </div>
  580. </div>
  581. </main>
  582. <footer class="md-footer">
  583. <div class="md-footer-nav">
  584. <nav class="md-footer-nav__inner md-grid" aria-label="Footer">
  585. <a href="adcredential.html" class="md-footer-nav__link md-footer-nav__link--prev" rel="prev">
  586. <div class="md-footer-nav__button md-icon">
  587. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
  588. </div>
  589. <div class="md-footer-nav__title">
  590. <div class="md-ellipsis">
  591. <span class="md-footer-nav__direction">
  592. Previous
  593. </span>
  594. Credential accesses
  595. </div>
  596. </div>
  597. </a>
  598. <a href="adothers.html" class="md-footer-nav__link md-footer-nav__link--next" rel="next">
  599. <div class="md-footer-nav__title">
  600. <div class="md-ellipsis">
  601. <span class="md-footer-nav__direction">
  602. Next
  603. </span>
  604. Other operation settings and controls
  605. </div>
  606. </div>
  607. <div class="md-footer-nav__button md-icon">
  608. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg>
  609. </div>
  610. </a>
  611. </nav>
  612. </div>
  613. <div class="md-footer-meta md-typeset">
  614. <div class="md-footer-meta__inner md-grid">
  615. <div class="md-footer-copyright">
  616. <div class="md-footer-copyright__highlight">
  617. Copyright &copy; 2018-2020 Hieromon Ikasamo
  618. </div>
  619. Made with
  620. <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
  621. Material for MkDocs
  622. </a>
  623. </div>
  624. <div class="md-footer-social">
  625. <a href="https://github.com/Hieromon" target="_blank" rel="noopener" title="github.com" class="md-footer-social__link">
  626. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/></svg>
  627. </a>
  628. <a href="https://twitter.com/hieromon" target="_blank" rel="noopener" title="twitter.com" class="md-footer-social__link">
  629. <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg>
  630. </a>
  631. </div>
  632. </div>
  633. </div>
  634. </footer>
  635. </div>
  636. <script src="assets/javascripts/vendor.fd16492e.min.js"></script>
  637. <script src="assets/javascripts/bundle.7836ba4d.min.js"></script><script id="__lang" type="application/json">{"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}</script>
  638. <script>
  639. app = initialize({
  640. base: ".",
  641. features: [],
  642. search: Object.assign({
  643. worker: "assets/javascripts/worker/search.4ac00218.min.js"
  644. }, typeof search !== "undefined" && search)
  645. })
  646. </script>
  647. <script src="js/gifffer.min.js"></script>
  648. </body>
  649. </html>