feat(badge):initial implementation

This commit is contained in:
Håkon Rossebø 2016-03-19 18:23:47 +01:00
parent b26567c2c3
commit ef7d2a9916
3 changed files with 157 additions and 18 deletions

View file

@ -1,11 +1,18 @@
module Demo.Badges where
-- import Material.Badge exposing (..)
import Material.Icon as Icon
import Material.Badge as Badge
import Html exposing (..)
import Html.Attributes exposing (..)
view : List Html
view =
[
h1 [][text "Badges"]
h1 [][text "Badges"],
Icon.viewWithOptions "add" Icon.S18 [] { badgeInfo = Just (Badge.viewDefault "16")},
Icon.viewWithOptions "add" Icon.S18 [] { badgeInfo = Just (Badge.view { overlap = False, noBackground = False} "99")},
Icon.viewWithOptions "add" Icon.S18 [] { badgeInfo = Just (Badge.view { overlap = False, noBackground = True} "4")},
Icon.view "add" Icon.S18 [],
Icon.i "add"
]

87
src/Material/Badge.elm Normal file
View file

@ -0,0 +1,87 @@
module Material.Badge
( Options
, view
, viewDefault
, BadgeInfo
) where
{-| From the [Material Design Lite documentation](http://www.getmdl.io/components/#badges-section):
The Material Design Lite (MDL) badge component is an onscreen notification element. A badge consists of a small circle, typically containing a number or other characters, that appears in proximity to another object. A badge can be both a notifier that there are additional items associated with an object and an indicator of how many items there are.
You can use a badge to unobtrusively draw the user's attention to items they might not otherwise notice, or to emphasize that items may need their attention. For example:
A "New messages" notification might be followed by a badge containing the number of unread messages.
A "You have unpurchased items in your shopping cart" reminder might include a badge showing the number of items in the cart.
A "Join the discussion!" button might have an accompanying badge indicating the number of users currently participating in the discussion.
A badge is almost always positioned near a link so that the user has a convenient way to access the additional information indicated by the badge. However, depending on the intent, the badge itself may or may not be part of the link.
Badges are a new feature in user interfaces, and provide users with a visual clue to help them discover additional relevant content. Their design and use is therefore an important factor in the overall user experience.
@docs viewDefault, view, BadgeInfo, Options
-}
import Html exposing (Attribute)
import Html.Attributes exposing (attribute)
{-| Internal Type used by other elements. Not sure if this should be documented.
-}
type alias BadgeInfo =
{ classes : String
, dataBadge : Attribute
}
{-| Options for Badge
ovelap: Bool to set css class - mdl-badge--overlap. Make the badge overlap with its container
noBackground: Bool to set css class - mdl-badge--no-background. Applies open-circle effect to badge
-}
type alias Options =
{ overlap : Bool
, noBackground : Bool
}
defaultOptions : Options
defaultOptions =
{
overlap = True
, noBackground = False
}
{-| View function for Badge
First parameter will set Badge options. See Options for more info.
Last parameter will set a value to data-badge="value". Assigns string value to badge
import Material.Badge as Badge
badgeInfo : Badge.BadgeInfo
badgeInfo = Badge.view { overlap = False, noBackground = False} "3"
-}
view : Options -> String -> BadgeInfo
view options databadge =
let classes =
[
{css = " mdl-badge", show = True}
, {css = " mdl-badge--no-background", show = options.noBackground}
, {css = " mdl-badge--overlap", show = options.overlap}
]
|> List.filter .show
|> List.map .css
|> List.foldl (++) ""
in
{ classes = " mdl-badge" ++ classes, dataBadge = attribute "data-badge" databadge}
{-| Create BadgeInfo with default values
Parameter will set a value to data-badge="value". Assigns string value to badge
import Material.Badge as Badge
badgeInfo : Badge.BadgeInfo
badgeInfo = Badge.viewDefault "3"
-}
viewDefault : String -> BadgeInfo
viewDefault databadge = view defaultOptions databadge

View file

@ -1,5 +1,6 @@
module Material.Icon
( Size(..)
, viewWithOptions
, view
, i
) where
@ -15,13 +16,12 @@ This implementation assumes that you have
or an equivalent means of loading the icons in your HTML header.
@docs i, Size, view
@docs i, Size, viewWithOptions, view
-}
import Html exposing (i, text, Html, Attribute)
import Html.Attributes exposing (class)
import Html.Attributes exposing (class, attribute)
import Material.Badge as Badge
{-| Size of an icon. Constructors indicate their pixel size, i.e.,
`S18` is 18px. The constructor `S` gives you the default size, 24px.
@ -29,6 +29,60 @@ import Html.Attributes exposing (class)
type Size
= S18 | S24 | S36 | S48 | S
{-| Options
See Badge on how to create a badge.
-}
type alias Options =
{
badgeInfo : Maybe Badge.BadgeInfo
}
defaultOptions : Options
defaultOptions =
{
badgeInfo = Nothing
}
{-| View function for icons. Supply the
[Material Icons Library](https://design.google.com/icons/) name as
the first argument (replace spaces with underscores); and the size of the icon
as the second. Do not use this function to produce clickable icons; use
icon buttons in Material.Button for that.
I.e., to produce a 48px
["trending flat"](https://design.google.com/icons/#ic_trending_flat) icon with
no attributes:
See Badge for info on how to create a badge for options.
import Material.Icon as Icon
icon : Html
icon = Icon.viewWithOptions "trending_flat" Icon.S48 [] { badgeInfo = Just (Badge.viewDefault "16")
This function will override any `class` set in `List Attribute`.
-}
viewWithOptions : String -> Size -> List Attribute -> Options-> Html
viewWithOptions name size attrs options =
let
sz =
case size of
S18 -> " md-18"
S24 -> " md-24"
S36 -> " md-36"
S48 -> " md-48"
S -> ""
appAttrs =
case options.badgeInfo of
Just badgeInfo -> List.append attrs [badgeInfo.dataBadge]
Nothing -> attrs
optionClasses =
case options.badgeInfo of
Just badgeInfo -> badgeInfo.classes
Nothing -> ""
in
Html.i (class ("material-icons" ++ sz ++ optionClasses ) :: appAttrs) [text name]
{-| View function for icons. Supply the
[Material Icons Library](https://design.google.com/icons/) name as
@ -47,18 +101,9 @@ no attributes:
This function will override any `class` set in `List Attribute`.
-}
view : String -> Size -> List Attribute -> Html
view name size attrs =
let
sz =
case size of
S18 -> " md-18"
S24 -> " md-24"
S36 -> " md-36"
S48 -> " md-48"
S -> ""
in
Html.i (class ("material-icons" ++ sz) :: attrs) [text name]
view name size attrs = viewWithOptions name size attrs defaultOptions
{-| Render a default-sized icon with no behaviour. The