elm-semantic-dom: Syntactic sugar for cooking with Elm VirtualDom
Why?
- The code you use to generate your Elm program's view doesn't need to look like HTML or SVG markup.
- The functions in elm-lang/html and elm-lang/svg are just wrappers for
VirtualDomfunctions. - There's no reason why you shouldn't build abstractions for view components
directly on top of
VirtualDom— it gives you more flexibility. - Because
VirtualDomis intended for advanced use and customization, it's a bare-bones package without helpers that would make it's functionality easier to manipulate. - So: I created a set of helper functions for working with
VirtualDomand put them all in one package with semantically structured modules. - The package is intended as an infrastructure for building higher level
abstractions on top of
VirtualDom, without the need to importHtmlorSvg. - All functions in this package are designed to be used in the "pipeline" style, where data flows through a series of functions in an easily readable way, from top to bottom and left to right.
- Functions are also written to avoid unused arguments, with additional "custom" functions available for rarely-used cases.
- Unfortunately, the module naming scheme I chose conflicts with elm-lang/dom (I couldn't come up with an acceptable alternative), but I am working on a separate package that will wrap elm-lang/dom in order to avoid the conflict when there is a need to manage DOM effects.
- Constructive suggestions are welcome!
Package Reference
| Module | Types | Constructors | Modifiers | Rendering | Queries |
|---|---|---|---|---|---|
| Dom | Node Property Element |
||||
| Dom.Program | Setup | setup | onLoad update updateWithCmds subscribe subscribeWithParams |
run runWithFlags customWithFlags |
|
| Dom.Node | leaf textWrapper container |
||||
| Dom.Element | leaf textWrapper container wrapNodes |
withClasses addClass removeClass withAttributes addAttribute withText appendText prependText withChildren appendChild prependChild withChildNodes setNamespace |
toNode | hasChildren hasText hasClass |
|
| Dom.Property | bool string int float |
||||
| Dom.Attribute | string int float namespaced |
||||
| Dom.Event | action capture submit custom customWithOptions |
||||
| Dom.Style | toProperty | ||||
| Dom.Keyed | container node |
||||
| Dom.Lazy | container | toNode eval |
|||
| Dom.Svg | leaf textWrapper container element wrapNodes |
||||
| Dom.Text | node |
