Elm Natural UI
Underdesigned, go-with-the-flow UI elements for Elm.
Getting started
elm-package install peterszerzo/elm-natural-ui
Render your first natural button:
module Simplest exposing (..)
import NaturalUi as N
main =
N.button
[ N.label "Click me"
, N.warning
]
Natural UI's views work similar to elm-lang/html
ones, with custom props that encode shared styling and behavioral patterns shared between components. Here are a few more examples:
- theming:
N.warning
,N.error
- additional UI elements:
N.help "Some text for a help tooltip"
,N.label "Label for your form field"
- inlets for raw HTML stuff:
N.children
,N.htmlAttrs
,N.inputHtmlAttrs
Not all of these props are available for all components, and some more comprehensive documentation is in order here. In the meantime, you need to look at individual implementations to see what is supported. And keep those issues coming!
Complex components
Components like ListEditor
and SmartTable
handle sortability, autocomplete and a bunch of other things, all while maintaining a separation between input data they operate and change, and purely UI-related internal state such as popup openness or sort order. Natural UI
does something similar to elm-sortable-table:
module Simple exposing (..)
import Html exposing (Html, div, beginnerProgram)
import NaturalUi as N
import NaturalUi.ListEditor as ListEditor
type alias Model =
{ list : List String
, editorState : ListEditor.State
}
model : Model
model =
{ list = [ "A", "list", "to", "be", "edited" ]
, editorState = ListEditor.init
}
type Msg
= ListEditorMsg ListEditor.State ListEditor.Data
update : Msg -> Model -> Model
update msg model =
case msg of
ListEditorMsg state data ->
{ model | list = data, editorState = state }
view : Model -> Html Msg
view model =
N.listEditor
[ N.data model.list
, N.state model.editorState
, N.toMsg ListEditorMsg
]
main : Program Never Model Msg
main =
beginnerProgram
{ model = model
, update = update
, view = view
}
The API remains largely the same as before, it's just that now, custom type definitions and data structures are in place to accommodate custom components. Natural UI
encourages strong separation between data
and state
, the former of which is dead simple and exposed (listeditor edits a list of strings, and that's that), the latter precise and fully encapsulated.
Roadmap
- flush out high-level API, per elm-sortable-table
- flush out API in detail
-
upgrade to
elm-css@13
(currently on@9
, with union type class names and stylesheet generation) - better docs and guides