21. icon

icon(name|url, foreground, background, tool_tip)

Inserts a built-in image in generated content.

name

One of name or url is required.

The name of the icon must be one of the following identifiers: circle, cog, collapsed-right, convert, delete, diamond, disc, expanded-down, external-link-small, file2, filled-square, half-disc-separator, hatch1, hatch2, hatch3, hatch4, hatch5, hatch6, hollow-diamond, image, image-small, insert-after, insert-before, insert, invisible, key, left-half-disc, left-link, left, left-target, line-break, link, minus, no-image, no-image-small, plus, pop-down, pop-left, pop-right, pop-se, pop-up, replace, right-arrow, right-half-disc, right-link, right, right-target, square.

url

One of name or url is required. Specifies the location of an icon.

foreground

This optional parameter allows to colorize a bitonal image. It specifies the foreground color of the icon.

Tip

Specify something which is not a valid color (e.g. number 0) if you want to force the stylesheet engine to use the current foreground color.

background

This optional parameter allows to colorize a bitonal image. It specifies the background color of the icon.

Tip

Specify something which is not a valid color (e.g. number 0) if you want to force the stylesheet engine to use the current background color.

tool_tip

Optional. Specifies a tool tip text of the icon. Default: no tool tip.

Examples:

icon(file2)

icon(pop-right, red)

/* Not useful -url(images/anchor.png) suffices- but works. */
icon(url(images/anchor.png))

icon(url(images/anchor.png), 0)

icon(pop-down, transparent, #80000)

icon(insert, 0, transparent, "Insert...")