-- | Parses CSS selectors
-- See `parseSelectors`
module Stylist.Parse.Selector(
Selector(..), SimpleSelector(..), PropertyTest(..), PropertyFunc(..),
parseSelectors
) where
import Data.CSS.Syntax.Tokens
import Stylist.Parse.Util
import Data.Text.Internal (Text(..))
-- | A CSS "selector" indicating which elements should be effected by CSS.
data Selector = Element [SimpleSelector] -- ^ Selects a single element.
| Child Selector [SimpleSelector] -- ^ Represents "a > b" operator.
| Descendant Selector [SimpleSelector] -- ^ Represents "a b" operator.
| Adjacent Selector [SimpleSelector] -- ^ Represents "a + b" operator.
| Sibling Selector [SimpleSelector] -- ^ Represents "a ~ b" operator.
deriving (Show, Eq)
-- | An individual test comprising a CSS stylesheet.
data SimpleSelector = Tag Text -- ^ Matches a tagname, e.g. "a"
| Namespace Text
| Id Text -- ^ Matches the "id" attribute, e.g. "#header"
| Class Text -- ^ Matches the "class" attribute, e.g. ".ad"
| Property (Maybe Text) Text PropertyTest -- ^ Matches a specified property
| Psuedoclass Text [Token] -- ^ Matches psuedoclasses provided by the caller (via a nameless property).
deriving (Show, Eq)
-- | How should a property be matched.
data PropertyTest = Exists -- ^ Matches whether an attribute actually exists, e.g. "[title]"
| Equals Text -- ^ Matches whether the attribute is exactly equal to the value, e.g. "="
| Suffix Text -- ^ Matches whether attribute ends with the given value, e.g. "$="
| Prefix Text -- ^ Matches whether attribute starts with the given value, e.g. "^="
| Substring Text -- ^ Matches whether the attribute contains the given value, e.g. "*="
| Include Text -- ^ Is one of the whitespace-seperated values the one specified? e.g. "~="
| Dash Text -- ^ Matches whitespace seperated values, or their "-"-seperated prefixes. e.g. "|="
| Callback PropertyFunc -- ^ Calls the given function to test this property.
deriving (Show, Eq)
-- | Caller-specified functions to extend property selection.
-- Has incorrect Show/Eq implementations so this rare exception doesn't break things.
data PropertyFunc = PropertyFunc (String -> Bool)
instance Show PropertyFunc where
show _ = "xx"
instance Eq PropertyFunc where
_ == _ = False
-- | Parses a CSS selector.
parseSelectors :: Parser [Selector]
parseSelectors tokens = concatP (:) parseCompound parseSelectorsTail $ skipSpace tokens
parseSelectorsTail :: Parser [Selector]
parseSelectorsTail (Comma:tokens) = parseSelectors tokens
parseSelectorsTail tokens = ([], tokens)
parseCompound :: Parser Selector
parseCompound tokens = parseCombinators (Element selector) tokens'
where (selector, tokens') = parseSelector tokens
parseSelector' :: SimpleSelector -> Parser [SimpleSelector]
parseSelector' op tokens = (op:selector, tokens')
where (selector, tokens') = parseSelector tokens
parseSelector :: Parser [SimpleSelector]
parseSelector (Ident ns:Delim '|':tokens) = parseSelector' (Namespace ns) tokens
parseSelector (Delim '*':tokens) = parseSelector tokens
parseSelector (Ident tag:tokens) = parseSelector' (Tag tag) tokens
parseSelector (Hash _ i:tokens) = parseSelector' (Id i) tokens
parseSelector (Delim '.':Ident class_:tokens) = parseSelector' (Class class_) tokens
parseSelector (LeftSquareBracket:Ident ns:Delim '|':Ident prop:tokens) =
concatP appendPropertySel parsePropertySel parseSelector tokens
where appendPropertySel test selector = Property (Just ns) prop test : selector
parseSelector (LeftSquareBracket:Ident prop:tokens) =
concatP appendPropertySel parsePropertySel parseSelector tokens
where appendPropertySel test selector = Property Nothing prop test : selector
parseSelector (Colon:Ident p:ts) = parseSelector' (Psuedoclass p []) ts
parseSelector (Colon:Function fn:tokens) =
concatP appendPseudo scanBlock parseSelector tokens
where appendPseudo args selector = Psuedoclass fn args : selector
parseSelector tokens = ([], tokens)
parseCombinators' :: Selector -> Parser Selector
parseCombinators' selector tokens = parseCombinators selector' tokens'
where (selector', tokens') = parseCombinator selector tokens
parseCombinators :: Selector -> Parser Selector
parseCombinators selector (Whitespace:tokens) = parseCombinators' selector tokens
parseCombinators selector tokens@(Delim _:_) = parseCombinators' selector tokens
parseCombinators selector tokens = (selector, tokens)
parseCombinator' :: (Selector -> [SimpleSelector] -> Selector)
-> Selector -> Parser Selector
parseCombinator' cb selector tokens = (cb selector selector', tokens')
where (selector', tokens') = parseSelector $ skipSpace tokens
parseCombinator :: Selector -> [Token] -> (Selector, [Token])
parseCombinator selector (Whitespace:tokens) = parseCombinator selector tokens
parseCombinator selector (Delim '>':tokens) = parseCombinator' Child selector tokens
parseCombinator selector (Delim '~':tokens) = parseCombinator' Sibling selector tokens
parseCombinator selector (Delim '+':tokens) = parseCombinator' Adjacent selector tokens
-- Take special care to avoid adding a trailing Descendant when not needed.
parseCombinator selector tokens@(LeftCurlyBracket:_) = (selector, tokens)
parseCombinator selector tokens@(RightCurlyBracket:_) = (selector, tokens)
parseCombinator selector tokens@(RightSquareBracket:_) = (selector, tokens)
parseCombinator selector tokens@(Comma:_) = (selector, tokens)
parseCombinator selector tokens@(RightParen:_) = (selector, tokens)
parseCombinator selector [] = (selector, [])
parseCombinator selector tokens = parseCombinator' Descendant selector tokens
parsePropertySel :: Parser PropertyTest
parsePropertySel (RightSquareBracket:tokens) = (Exists, tokens)
parsePropertySel (Delim '=':tokens) = parsePropertyVal (Equals) tokens
parsePropertySel (SuffixMatch:tokens) = parsePropertyVal (Suffix) tokens
parsePropertySel (PrefixMatch:tokens) = parsePropertyVal (Prefix) tokens
parsePropertySel (SubstringMatch:tokens) = parsePropertyVal (Substring) tokens
parsePropertySel (IncludeMatch:tokens) = parsePropertyVal (Include) tokens
parsePropertySel (DashMatch:tokens) = parsePropertyVal (Dash) tokens
parsePropertySel tokens = (Exists, skipBlock tokens)
parsePropertyVal :: (Text -> PropertyTest) -> Parser PropertyTest
parsePropertyVal wrapper (Ident val:RightSquareBracket:tokens) = (wrapper val, tokens)
parsePropertyVal wrapper (String val:RightSquareBracket:tokens) = (wrapper val, tokens)
parsePropertyVal _ tokens = (Exists, skipBlock tokens)