package css

  1. Overview
  2. Docs

Module Css.CSource

Computing values.

Mapping properties to values

Sourcemodule Computed : sig ... end

A Computed.t maps a 'a property to a value of type 'a, if any.

Sourceval opt : t -> 'a P.prop -> 'a option

opt t p returns the computed value of p in t, if any.

Sourceval get : t -> 'a P.prop -> 'a

opt t p returns the computed value of p in t if present or else returns the initial value of p.

Sourceval add : t -> 'a P.prop -> 'a -> t

add t p v adds binding from p to v in t.

Sourceval filter_inherited : t -> t

filter_inherited t returns bindings of t where the property is inherited.

Sourceval empty : t
Sourceval pp : Format.formatter -> t -> unit
Sourceval to_string : t -> string
Sourceval comp_global : parent:t -> 'a P.prop -> T.global_kw -> 'a

comp_global ~parent p v returns value of p according to global value v, i.e. it returns the initial value of p, of the value of p in parent.

Sourceval get_p : parent:t -> t -> 'a P.prop -> 'a

get_p ~parent t p returns value of p in t. If p is not mapped in t and p is not inherited, returns initial value of p. If p is inherited, returns its value in parent. If p is not mapped in parent, returns initial value of p.

Computing functions

Sourceval mk_value_parser : (T.ctx -> 'a Angstrom.t) -> T.ctx -> start:T.pos -> 'a P.value Angstrom.t
Sourceval or_var : (module P.Prop_space) -> (T.ctx -> 'a Angstrom.t) -> ((module P.Prop_space) -> root:'b -> parent:'c -> t -> 'a -> 'd) -> root:'b -> parent:'c -> t -> 'd -> [< `V of 'a | `Var of string * string option ] -> [> `V of 'd ]
Sourceval to_px : T.number -> T.abs_length_unit -> float
Sourceval px_of_font_size_kw : (T.font_size -> float) ref
Sourceval color : 'a -> root:'b -> parent:t -> 'c -> T.color -> T.color
Sourceval accent_color : 'a -> root:'b -> parent:t -> 'c -> [< `Auto | `Current_color | `Named_color of string | `Rgba of float * float * float * float | `System_color of T.system_color | `Transparent ] -> T.accent_color
Sourceval length_of_font_size : t -> float -> [> `em | `ex | `rem ] -> float option
Sourceval length : 'a -> root:t -> parent:'b -> t -> (T.number * ([> `In | `cm | `em | `ex | `mm | `pc | `pt | `px | `q | `rem ] as 'c)) -> T.number * 'c
Sourceval font_size : 'a -> root:t -> parent:t -> 'b -> T.font_size -> T.font_size

Computes font_size in px when possible from absolute size or size relative to parent.

Sourceval font_weight : 'a -> root:'b -> parent:t -> 'c -> T.font_weight -> T.font_weight
Sourceval size : 'a -> root:t -> parent:'b -> t -> ([> `Length of T.number * [> `In | `cm | `em | `ex | `mm | `pc | `pt | `px | `q | `rem ] ] as 'c) -> 'c
Sourceval line_height : 'a -> root:t -> parent:'b -> t -> [< T.line_height ] -> [> T.line_height ]
Sourceval word_spacing : 'a -> root:t -> parent:'b -> t -> [< T.word_spacing ] -> [> T.word_spacing ]
Sourceval mandatory_value : string -> [< `V of 'a | `Var of string * 'b ] -> 'a
Sourceval border_spacing : (module P.Prop_space) -> root:t -> parent:'a -> t -> ([< `V of T.number * T.length_unit | `Var of string * string option ] * [< `V of T.number * T.length_unit | `Var of string * string option ]) -> [> `V of T.length ] * [> `V of T.length ]
Sourceval border_width_of_kw : (T.border_width_kw -> float) ref
Sourceval border_width : 'a -> root:t -> parent:'b -> t -> ([> `Length of T.number * [> `In | `cm | `em | `ex | `mm | `pc | `pt | `px | `q | `rem ] | `Medium | `Thick | `Thin ] as 'c) -> 'c
Sourceval font_family_of_generic : (T.font_family_generic_kw -> string) ref
Sourceval font_family_ : 'a -> root:'b -> parent:'c -> 'd -> [< T.font_family_ ] -> [> T.font_family_ ]
Sourceval font_family : 'a -> root:'b -> parent:'c -> 'd -> [< T.font_family_ ] list -> [> T.font_family_ ] list
Sourceval max_size : 'a -> root:t -> parent:'b -> t -> ([> `Length of T.number * [> `In | `cm | `em | `ex | `mm | `pc | `pt | `px | `q | `rem ] ] as 'c) -> 'c
Sourceval margin : 'a -> root:t -> parent:'b -> t -> ([> `Length of T.number * [> `In | `cm | `em | `ex | `mm | `pc | `pt | `px | `q | `rem ] ] as 'c) -> 'c
Sourceval padding : 'a -> root:t -> parent:'b -> t -> ([> `Length of T.number * [> `In | `cm | `em | `ex | `mm | `pc | `pt | `px | `q | `rem ] ] as 'c) -> 'c
Sourceval vertical_align : 'a -> root:t -> parent:'b -> t -> ([> `Length of T.number * [> `In | `cm | `em | `ex | `mm | `pc | `pt | `px | `q | `rem ] ] as 'c) -> 'c

Associating computation functions to properties

Sourcetype binding =
  1. | B : 'a P.prop * ((module P.Prop_space) -> root:t -> parent:t -> t -> 'a P.value -> t) -> binding
Sourceval comp : ((module P.Prop_space) -> root:'a -> parent:t -> t -> 'b -> 'b) -> 'b P.prop -> (module P.Prop_space) -> root:'a -> parent:t -> t -> 'b P.value -> Computed.binding P.M.t

comp f p props ~root ~parent t v computes value of property p from its parsed value v, in the context of root and parent maps. f is applied on:

  • the result of recursive expansion if v is a variable,
  • the result of comp_global if v is a global keyword,
  • else v.

The resulting computed value is then added to t for property p.

Sourceval map : 'a -> root:'b -> parent:'c -> 'd -> 'e -> 'e

map props ~root ~parent t v returns v, without any computation. This is the default computation for several properties.

Sourceval register_prop_fun : 'a P.prop -> ((module P.Prop_space) -> root:t -> parent:t -> t -> 'a -> 'a) -> unit

register_prop_fun p f registers f as computation function for values of property p. This can be used to override or specify the computation function of a property.

Computing from declarations

Sourceval compute_decl : (module P.Prop_space) -> root:t -> parent:t -> t -> P.binding -> Computed.binding P.M.t
Sourceval compute_decls : (module P.Prop_space) -> root:t -> parent:t -> t -> P.binding list -> t

compute_decls props ~root ~parent t decls performs computations of the given declarations decls in the environment of root computed values, parent computed values and current computed values t.