Revision [516]
This is an old revision of ColorActionInfo made by DarTar on 2008-01-30 03:59:08.
Color/ Colour Action Documentation
This is the documentation page for the Color / Colour action(s).Once the planned 'autodoc' feature for actions is "live", this page will contain the automatically-generated documentation by just including an action; for now, I've just manually created the text.
Documentation
Short description
Renders a string as colored text.Parameters
name | type | required? | default | description |
---|---|---|---|---|
text | string | mandatory | - | the text you want to display colored |
c | string | optional | - | color name or hex-value for the text |
bg | string | optional | - |
since 1.1.6.2
(html) color name or hex-value for the background |
fg | string | optional | - |
since 1.1.6.2
alias for 'c', introduced to fit with 'bg' |
hex | string | optional | - | alias for 'c', kept for backwards-compatibility; |
Long description
With {{color}} action (or its alias {{colour}}) you can specify text color using either one of HTML defined names or a hex value (with the former one taking priority). An optional background color can also be specified. Note that you must specify a text and either use "fg", "c" or "hex" for the color.Usage:
{{color [text="This is my text"] [c="red"]}}
Examples:
{{color c="green" text="This is a test."}}This is a test.
If you want to use hex values:
{{color hex="#DD0000" text="This is another test."}}
This is another test.
Alternatively, you can specify a foreground and background color using the fg and bg parameters (they accept both named and hex values):
{{color fg="#FF0000" bg="#000000" text="This is colored text on colored background"}}
This is colored text on colored background
{{color fg="yellow" bg="black" text="This is colored text on colored background"}}
This is colored text on colored background
Release Notes
- Versions 1.1.6.1 and below had support for parameters text, c and hex only, and no check were performed about these values.
- Since version 1.1.6.2 two new parameters bg and fg have been introduced, and the colors are checked for validity. RGB syntax, Hex syntax and a wide range of color names are supported.
- Since 1.1.6.4 support for a number of invalid colornames, such as antiquewhite, lightgreen, ... has been discontinued. Although these colornames are supported by almost every known browser, they do not validate against the CSS specification. Currently supported colornames are: aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white and yellow.
Authors
- Nils Lindenberg (modifications)
- Mahefa Randimbisoa (modification - RGB syntax)
CategoryEN