| Copyright | (c) Ivan Lazar Miljenovic |
|---|---|
| License | 3-Clause BSD-style |
| Maintainer | Ivan.Miljenovic@gmail.com |
| Safe Haskell | Safe-Inferred |
| Language | Haskell2010 |
Data.GraphViz.Attributes.HTML
Description
This module is written to be imported qualified. It defines the syntax for HTML-like values for use in Graphviz. Please note that these values are not really HTML, but the term "HTML" is used throughout as it is less cumbersome than "HTML-like". To be able to use this, the version of Graphviz must be at least 1.10. For more information, please see: http://graphviz.org/doc/info/shapes.html#html
The actual definition of the syntax specifies that these types must
be valid XML syntax. As such, this assumed when printing and parsing,
though the correct escape/descaping for ", &, < and > are
automatically done when printing and parsing.
Differences from how Graphviz treats HTML-like values:
- Graphviz only specifies the above-listed characters must be
escaped; however, internally it also escapes
-,'and multiple sequences of spaces. This library attempts to match this behaviour. Please let me know if this behaviour (especially about escaping multiple spaces) is unwanted. - When parsing escaped HTML characters, numeric escapes are converted to the corresponding character as are the various characters listed above; all other escaped characters (apart from those listed above) are silently ignored and removed from the input (since technically these must be valid XML, which doesn't recognise as many named escape characters as does HTML).
- All whitespace read in is kept (even if Graphviz would ignore multiple whitespace characters); when printing them, however, they are replaced with non-breaking spaces. As such, if multiple literal whitespace characters are used in a sequence, then the result of parsing and then printing some Dot code will not be the same as the initial Dot code. Furthermore, all whitespace characters are printed as spaces.
- It is assumed that all parsed
&values are the beginning of an XML escape sequence (which must finish with a;character). - There should be no pre-escaped characters in values; when
printing, the
&will get escaped without considering if that is an escaped character.
- data Label
- type Text = [TextItem]
- data TextItem
- data Format
- = Italics
- | Bold
- | Underline
- | Subscript
- | Superscript
- data Table = HTable {}
- data Row
- = Cells [Cell]
- | HorizontalRule
- data Cell
- newtype Img = Img Attributes
- type Attributes = [Attribute]
- data Attribute
- = Align Align
- | BAlign Align
- | BGColor Color
- | Border Word8
- | CellBorder Word8
- | CellPadding Word8
- | CellSpacing Word8
- | Color Color
- | ColSpan Word16
- | Face Text
- | FixedSize Bool
- | Height Word16
- | HRef Text
- | ID Text
- | PointSize Double
- | Port PortName
- | RowSpan Word16
- | Scale Scale
- | Src FilePath
- | Target Text
- | Title Text
- | VAlign VAlign
- | Width Word16
- data Align
- data VAlign
- data Scale
Documentation
Represents a textual component of an HTML-like label. It is
assumed that a Text list is non-empty. It is preferable
to "group" Str values together rather than have
individual ones. Note that when printing, the individual values
are concatenated together without spaces, and when parsing
anything that isn't a tag is assumed to be a Str: that is,
something like "<BR/> <BR/>" is parsed as:
[Newline [], Str " ", Newline []]
Textual items in HTML-like labels.
Constructors
| Italics | |
| Bold | |
| Underline | |
| Subscript | |
| Superscript |
A table in HTML-like labels. Tables are optionally wrapped in
overall FONT tags.
Constructors
| HTable | |
Fields
| |
Constructors
| Cells [Cell] | |
| HorizontalRule | Should be between |
Cells either recursively contain another Label or else a
path to an image file.
Constructors
| LabelCell Attributes Label | |
| ImgCell Attributes Img | |
| VerticalRule | Should be between |
The path to an image; accepted Attributes are Scale and Src.
Constructors
| Img Attributes |
type Attributes = [Attribute] Source
The various HTML-like label-specific attributes being used.
Note that not all Attribute values are valid everywhere:
see the comments for each one on where it is valid.
Constructors
| Align Align | |
| BAlign Align | Valid for: |
| BGColor Color | Valid for: |
| Border Word8 | Valid for: |
| CellBorder Word8 | Valid for: |
| CellPadding Word8 | |
| CellSpacing Word8 | |
| Color Color | |
| ColSpan Word16 | Valid for: |
| Face Text | Valid for: |
| FixedSize Bool | |
| Height Word16 | |
| HRef Text | |
| ID Text | |
| PointSize Double | Valid for: |
| Port PortName | |
| RowSpan Word16 | Valid for: |
| Scale Scale | Valid for: |
| Src FilePath | Valid for: |
| Target Text | |
| Title Text | |
| VAlign VAlign | |
| Width Word16 |
Specifies horizontal placement. When an object is allocated more space than required, this value determines where the extra space is placed left and right of the object.
Specifies vertical placement. When an object is allocated more space than required, this value determines where the extra space is placed above and below the object.
Specifies how an image will use any extra space available in its
cell. If undefined, the image inherits the value of the
ImageScale attribute.
Constructors
| NaturalSize | Default value. |
| ScaleUniformly | |
| ExpandWidth | |
| ExpandHeight | |
| ExpandBoth |