mirror of
https://github.com/warmcat/libwebsockets.git
synced 2025-03-30 00:00:16 +01:00
63d2f844db
Introduce a very lightweight html5 + css2.1+ stateful stream parser, along the same lines as the lws json and cbor ones. This is interesting primarily because of just how low-resource it is for modest css + html, it uses an lwsac to hold the entirity of the css in memory at once but the html is parsed in chunks without any need to keep previous chunks around (chunks may be as small as 1 byte). A user callback receives element entry and exit callbacks with payload and all attributes parsed out, CSS related to the active element stack is parsed to provide a list of active css attributes, which takes heap for the duration of the parsing. In effect this provides rich information about the html and css state to the callback, which has the job of producing the layout in a user-defined way. As such, there is no DOM in memory at one time, there is only a stack of active elements like <html><body><div>xxx with their associated attributes (like class). So as it is, it does not support DOM modification such as JS changing elements after parsing, although elements with interesting IDs could be kept around by the callback. There is a corresponding tiny and relatively flat heap usage regardless of html size. Default CSS is specified as recommended in the CSS 2.1 standard. Inline <style></style> elements are supported, but not pre-html5 style= in element attributes, since these are incompatible with strict CSP. What the attributes should mean on your system, eg, font-size, font-family etc is left for the user callback to decide, along with how to lay out the items using the CSS attributes, and render them. Fixed point 32.32 constants are used (fraction expressed at parts in 100M) instead of floating point. If you have presentation needs, even on a constrained display on a constrained microcontroller, this makes it feasible to use standardized markup and styling instead of roll your own. |
||
|---|---|---|
| .. | ||
| core | ||
| core-net | ||
| cose | ||
| drivers | ||
| event-libs | ||
| jose | ||
| misc | ||
| plat | ||
| roles | ||
| secure-streams | ||
| system | ||
| tls | ||
| CMakeLists.txt | ||
| README.md | ||
Library sources layout
Code that goes in the libwebsockets library itself lives down ./lib
| Path | Sources |
|---|---|
| lib/core | Core lws code related to generic fd and wsi servicing and management |
| lib/core-net | Core lws code that applies only if networking enabled |
| lib/event-libs | Code containing optional event-lib specific adaptations |
| lib/jose | JOSE / JWS / JWK / JWE implementations |
| lib/misc | Code for various mostly optional miscellaneous features |
| lib/plat | Platform-specific adaptation code |
| lib/roles | Code for specific optional wsi roles, eg, http/1, h2, ws, raw, etc |
| lib/system | Code for system-level features, eg, dhcpclient |
| lib/tls | Code supporting the various TLS libraries |