Stylist

Documentation

cssPriorityAgent :: StyleSheet s => s -> s

Set the priority for a CSS stylesheet being parsed.

cssPriorityUser :: StyleSheet s => s -> s

Set the priority for a CSS stylesheet being parsed.

cssPriorityAuthor :: StyleSheet s => s -> s

Set the priority for a CSS stylesheet being parsed.

class PropertyParser a where

Defines how to parse CSS properties into an output "style" format.

Minimal complete definition

temp, longhand

Methods

temp :: a

Default styles.

inherit :: a -> a

Creates a style inherited from a parent style.

priority :: a -> [Text]

shorthand :: a -> Text -> [Token] -> [(Text, [Token])]

Expand a shorthand property into longhand properties.

longhand :: a -> a -> Text -> [Token] -> Maybe a

Mutates self to store the given CSS property, if it's syntax is valid. longhand parent self name value

getVars :: a -> Props

Retrieve stored variables, optional.

setVars :: Props -> a -> a

Save variable values, optional.

pseudoEl :: a -> Text -> (a -> Maybe a -> a) -> a

Mutates self to store the given pseudoelement styles, passing a callback so you can alter the parent & (for interactive pseudoclasses) base styles.

Instances

PropertyParser TrivialPropertyParser

Defined in Stylist

Methods

temp :: TrivialPropertyParser

inherit :: TrivialPropertyParser -> TrivialPropertyParser

priority :: TrivialPropertyParser -> [Text]

shorthand :: TrivialPropertyParser -> Text -> [Token] -> [(Text, [Token])]

longhand :: TrivialPropertyParser -> TrivialPropertyParser -> Text -> [Token] -> Maybe TrivialPropertyParser

getVars :: TrivialPropertyParser -> Props

setVars :: Props -> TrivialPropertyParser -> TrivialPropertyParser

pseudoEl :: TrivialPropertyParser -> Text -> (TrivialPropertyParser -> Maybe TrivialPropertyParser -> TrivialPropertyParser) -> TrivialPropertyParser

data TrivialPropertyParser

Gathers properties as a key'd list. Works well with lookup.

Constructors

TrivialPropertyParser [(String, [Token])]

Instances

Eq TrivialPropertyParser

Defined in Stylist

Methods

(==) :: TrivialPropertyParser -> TrivialPropertyParser -> Bool

(/=) :: TrivialPropertyParser -> TrivialPropertyParser -> Bool

Show TrivialPropertyParser

Defined in Stylist

Methods

showsPrec :: Int -> TrivialPropertyParser -> ShowS

show :: TrivialPropertyParser -> String

showList :: [TrivialPropertyParser] -> ShowS

PropertyParser TrivialPropertyParser

Defined in Stylist

Methods

temp :: TrivialPropertyParser

inherit :: TrivialPropertyParser -> TrivialPropertyParser

priority :: TrivialPropertyParser -> [Text]

shorthand :: TrivialPropertyParser -> Text -> [Token] -> [(Text, [Token])]

longhand :: TrivialPropertyParser -> TrivialPropertyParser -> Text -> [Token] -> Maybe TrivialPropertyParser

getVars :: TrivialPropertyParser -> Props

setVars :: Props -> TrivialPropertyParser -> TrivialPropertyParser

pseudoEl :: TrivialPropertyParser -> Text -> (TrivialPropertyParser -> Maybe TrivialPropertyParser -> TrivialPropertyParser) -> TrivialPropertyParser

class StyleSheet s where

Describes how to store, and to some extent parse, CSS stylesheets. These methods are used to construct the results from parse, etc.

Minimal complete definition

addRule

Methods

setPriority :: Int -> s -> s

Sets the stylesheet priority (useragent vs user vs author), optional. Favor setPriorities for richer API.

setPriorities :: [Int] -> s -> s

Sets the multi-layered stylesheet priority (for the sake of @layer rules), optional.

addRule :: s -> StyleRule -> s

Stores a parsed selector+properties rule.

addAtRule :: s -> Text -> [Token] -> (s, [Token])

Stores and parses an identified at-rule.

Instances

StyleSheet ()

In case an indirect caller doesn't actually want to use Haskell Stylist.

Defined in Stylist.Parse

Methods

setPriority :: Int -> () -> ()

setPriorities :: [Int] -> () -> ()

addRule :: () -> StyleRule -> ()

addAtRule :: () -> Text -> [Token] -> ((), [Token])

StyleSheet TrivialStyleSheet

Defined in Stylist.Parse

Methods

setPriority :: Int -> TrivialStyleSheet -> TrivialStyleSheet

setPriorities :: [Int] -> TrivialStyleSheet -> TrivialStyleSheet

addRule :: TrivialStyleSheet -> StyleRule -> TrivialStyleSheet

addAtRule :: TrivialStyleSheet -> Text -> [Token] -> (TrivialStyleSheet, [Token])

data TrivialStyleSheet

Gathers StyleRules into a list, mainly for testing.

Constructors

TrivialStyleSheet [StyleRule]

Instances

Eq TrivialStyleSheet

Defined in Stylist.Parse

Methods

(==) :: TrivialStyleSheet -> TrivialStyleSheet -> Bool

(/=) :: TrivialStyleSheet -> TrivialStyleSheet -> Bool

Show TrivialStyleSheet

Defined in Stylist.Parse

Methods

showsPrec :: Int -> TrivialStyleSheet -> ShowS

show :: TrivialStyleSheet -> String

showList :: [TrivialStyleSheet] -> ShowS

StyleSheet TrivialStyleSheet

Defined in Stylist.Parse

Methods

setPriority :: Int -> TrivialStyleSheet -> TrivialStyleSheet

setPriorities :: [Int] -> TrivialStyleSheet -> TrivialStyleSheet

addRule :: TrivialStyleSheet -> StyleRule -> TrivialStyleSheet

addAtRule :: TrivialStyleSheet -> Text -> [Token] -> (TrivialStyleSheet, [Token])

type Props = [(Text, [Token])]

"key: value;" entries to be parsed into an output type.

data Element

An inversely-linked tree of elements, to apply CSS selectors to.

Constructors

ElementNode

Fields

• parent :: Maybe Element

  The element's parent in the tree.

• previous :: Maybe Element

  The element's previous sibling in the tree.

• name :: Text

  The element's name.

• namespace :: Text

  The element's namespace.

• attributes :: [Attribute]

  The element's attributes, in sorted order.

data Attribute

A key-value attribute.

Constructors

Attribute Text Text String

Instances

Eq Attribute

Defined in Stylist

Methods

(==) :: Attribute -> Attribute -> Bool

(/=) :: Attribute -> Attribute -> Bool

Ord Attribute

Defined in Stylist

Methods

compare :: Attribute -> Attribute -> Ordering

(<) :: Attribute -> Attribute -> Bool

(<=) :: Attribute -> Attribute -> Bool

(>) :: Attribute -> Attribute -> Bool

(>=) :: Attribute -> Attribute -> Bool

max :: Attribute -> Attribute -> Attribute

min :: Attribute -> Attribute -> Attribute

elementPath :: Element -> [Int]

Computes the child indices to traverse to reach the given element.

compileAttrTest :: PropertyTest -> String -> Bool

Converts a property text into a callback testing against a string.

matched :: t -> Bool

returns True regardless of value.

attrTest :: Maybe Text -> Text -> PropertyTest -> Element -> Bool

Test whether the element matches a parsed property test, for the given attribute.

hasWord :: String -> String -> Bool

Tests the given word is in the whitespace-seperated value.

hasLang :: [Char] -> [Char] -> Bool

Tests whether the attribute holds the expected value or a sub-locale.

parseUnorderedShorthand :: PropertyParser a => a -> [Text] -> [Token] -> [(Text, [Token])]

Utility for parsing shorthand attributes which don't care in which order the subproperties are specified. Each property must parse only a single function or token.

parseUnorderedShorthand' :: PropertyParser a => a -> [Text] -> [[Token]] -> [(Text, [Token])]

Variant of parseUnorderedShorthand taking pre-split list.

parseOperands :: [Token] -> [[Token]]

Splits a token list so each function is it's own list. Other tokens are split into their own singletons.