.github | ||
docs | ||
example | ||
src | ||
.gitignore | ||
docs.json | ||
elm.json | ||
LICENSE | ||
README.md |
Elm-Ui-Widgets
This package contains independent widgets (no components) written for Elm-Ui. These widgets have no dependencies to other parts of this package. So you can just use as much as you need.
It also supports custom themes and has a material design theme already ready to use.
Examples of all widgets can be found here.
Concept
Summary
- Each widget comes with a Widget Type and a Style Type. The Widget Type is an abstract representation of the widget and the Style Type has all styling attributes.
- Widget Types can be used as building Blocks for more complicated Widgets (Button -> Select Buttons -> Menu -> Layout)
Example
Let's look at the button widget.
button: ButtonStyle msg
->
{ text : String
, icon : Element Never
, onPress : Maybe msg
}
-> Element msg
In comparison to Elm-Ui's button, we see that List (Attribute msg)
has changed into a Style Type.
type alias ButtonStyle msg =
{ container : List (Attribute msg)
, labelRow : List (Attribute msg)
, ifDisabled : List (Attribute msg)
, ifActive : List (Attribute msg)
}
For actually displaying the button we have a few different implementations:
{-| Button with only an icon and no text -}
iconButton :
ButtonStyle msg
->
{ text : String --for screen readers
, icon : Element Never
, onPress : Maybe msg
}
-> Element msg
{-| Button with a text but no icon -}
textButton :
ButtonStyle msg
->
{ textButton
| text : String
, onPress : Maybe msg
}
-> Element msg
{-| Button with both icon and text -}
button :
ButtonStyle msg
->
{ text : String
, icon : Element Never
, onPress : Maybe msg
}
-> Element msg
We also have a Widget Type
for the button:
type alias Button msg =
{ text : String
, icon : Element Never
, onPress : Maybe msg
}
We can use it to build more complex widgets, for example a select button:
type alias Select msg =
{ selected : Maybe Int
, options :
List
{ text : String
, icon : Element Never
}
, onSelect : Int -> Maybe msg
}
select :
Select msg
-> List ( Bool, Button msg )
selectButton :
ButtonStyle msg
-> ( Bool, Button msg )
-> Element msg
Reusable Views vs. Components
In Elm we like to use reusable views instead of components. At first this packages had a few components, but they where so complicated to use in comparison, so they got slowly turned into reusable views one by one.
Most could be reduced even further into view functions: reusable views without a model.
Currently we have only three reusable views: Widget.Layout
, Widget.ScrollingNav
and Widget.Snackbar
.
Alternatives
For comparison, here are some alternative packages for creating UIs:
- Using Elm-Ui
- lucamug/style-framework - Full customization requires the cloning of the package.
- jxxcarlson/elm-widget - Uses a Builder pattern. Has some redefined customizations.
- QiTASC/hatchinq - Similar Arroach but still in experimental phase
- Using Elm/Html
- nathanjohnson320/elm-ui-components - Uses the elm/html way of styling.
- NoRedInk/noredink-ui - Similar Approach but no customization options.
- peterszerzo/elm-natural-ui - Uses custom Attributes with some customization.
- Ui Frameworks
- aforemny/material-components-web-elm - Wrapper of Material design using custom elements.
- afidegnum/elm-tailwind - Wrapper of Tailwind by including the tailwind stylesheet.
- surprisetalk/elm-bulma - Wrapper for Bulma by including the bulma stylesheet.
- rundis/elm-bootstrap - Wrapper for Bootstrap by including the bootstrap stylesheet.
- supermacro/elm-antd - Implementation of Ant Design in Elm
Motivation
After looking at the current packages that implement various reusable views (and components) I noticed two things:
- There are (nearly) no widgets for Elm-Ui, and that's a problem because while going from
Element
toHtml
is easy, the opposite is not always possible (as a lot of styling in Elm-Ui would not be adapted to theHtml
element.) - There is collection of widgets, all in one place. A lot of components get reimplemented over and over again. It's hard to keep track of what package is currently the best.
This package tries to solve both of these problems.
Changelog
- Version 2.0.0 - Complete rewrite of the package. Now including a material design implementation.