2017-11-02 03:03:24 +01:00
|
|
|
= Faces
|
2016-02-03 18:15:35 +01:00
|
|
|
|
2017-11-02 03:03:24 +01:00
|
|
|
== Declaration
|
2016-02-03 18:15:35 +01:00
|
|
|
|
2016-02-10 22:03:49 +01:00
|
|
|
A 'face' refers how the specified text is displayed, it has a foreground
|
|
|
|
|
color, a background color, and some attributes. The value of a face has the
|
|
|
|
|
following format:
|
2016-02-03 18:15:35 +01:00
|
|
|
|
|
|
|
|
--------------------------------
|
|
|
|
|
fg_color[,bg_color][+attributes]
|
|
|
|
|
--------------------------------
|
|
|
|
|
|
|
|
|
|
'fg_color', 'bg_color'::
|
|
|
|
|
a color whose value can be expressed in the following formats:
|
|
|
|
|
*black*, *red*, *green*, *yellow*, *blue*, *magenta*, *cyan*, *white*:::
|
|
|
|
|
a named color
|
|
|
|
|
*default*:::
|
|
|
|
|
keep the existing color
|
|
|
|
|
*rgb:RRGGBB*:::
|
|
|
|
|
hexadecimal value
|
|
|
|
|
|
|
|
|
|
'attributes'::
|
|
|
|
|
string whose individual letters set an attribute:
|
|
|
|
|
*u*:::
|
|
|
|
|
underline
|
|
|
|
|
*r*:::
|
|
|
|
|
reverse
|
|
|
|
|
*b*:::
|
|
|
|
|
bold
|
|
|
|
|
*B*:::
|
|
|
|
|
blink
|
|
|
|
|
*d*:::
|
|
|
|
|
dim
|
|
|
|
|
*i*:::
|
|
|
|
|
italic
|
|
|
|
|
*e*:::
|
2016-02-10 22:03:49 +01:00
|
|
|
exclusive, override previous faces instead of merging
|
|
|
|
|
with them
|
2016-02-03 18:15:35 +01:00
|
|
|
|
2017-11-02 03:03:24 +01:00
|
|
|
== Builtin faces
|
|
|
|
|
|
2016-04-08 18:00:24 +02:00
|
|
|
The following default faces are used by color schemes to highlight certain
|
2016-02-10 22:03:49 +01:00
|
|
|
areas of the user interface:
|
2016-02-02 20:15:12 +01:00
|
|
|
|
2016-02-03 18:15:35 +01:00
|
|
|
*Default*::
|
|
|
|
|
default colors
|
|
|
|
|
|
|
|
|
|
*PrimarySelection*::
|
|
|
|
|
main selection face for every selected character except the cursor
|
|
|
|
|
|
|
|
|
|
*SecondarySelection*::
|
|
|
|
|
secondary selection face for every selected character except the cursor
|
|
|
|
|
|
|
|
|
|
*PrimaryCursor*::
|
|
|
|
|
cursor of the primary selection
|
|
|
|
|
|
|
|
|
|
*SecondaryCursor*::
|
|
|
|
|
cursor of the secondary selection
|
|
|
|
|
|
|
|
|
|
*LineNumbers*::
|
|
|
|
|
face used by the number_lines highlighter
|
|
|
|
|
|
2016-12-16 04:49:14 +01:00
|
|
|
*LineNumberCursor*::
|
2016-02-03 18:15:35 +01:00
|
|
|
face used to highlight the line number of the main selection
|
|
|
|
|
|
2017-05-11 19:38:27 +02:00
|
|
|
*LineNumbersWrapped*::
|
2017-05-01 22:26:50 +02:00
|
|
|
face used to highlight the line number of wrapped lines
|
|
|
|
|
|
2016-02-03 18:15:35 +01:00
|
|
|
*MenuForeground*::
|
|
|
|
|
face for the selected element in menus
|
|
|
|
|
|
|
|
|
|
*MenuBackground*::
|
|
|
|
|
face for the not selected elements in menus
|
|
|
|
|
|
2016-12-16 04:49:14 +01:00
|
|
|
*MenuInfo*::
|
|
|
|
|
face for additional information for elements in menus
|
|
|
|
|
|
2016-02-03 18:15:35 +01:00
|
|
|
*Information*::
|
|
|
|
|
face for the informations windows and information messages
|
|
|
|
|
|
|
|
|
|
*Error*::
|
|
|
|
|
face of error messages
|
|
|
|
|
|
|
|
|
|
*StatusLine*::
|
|
|
|
|
face used for the status line
|
|
|
|
|
|
2016-12-16 04:49:14 +01:00
|
|
|
*StatusLineMode*::
|
|
|
|
|
face used for the current mode except the normal mode
|
|
|
|
|
|
|
|
|
|
*StatusLineInfo*::
|
|
|
|
|
face used for special information
|
|
|
|
|
|
|
|
|
|
*StatusLineValue*::
|
|
|
|
|
face used for special values (numeric prefixes, registers, etc.)
|
|
|
|
|
|
2016-02-03 18:15:35 +01:00
|
|
|
*StatusCursor*::
|
|
|
|
|
face used for the status line cursor
|
|
|
|
|
|
|
|
|
|
*Prompt*::
|
|
|
|
|
face used prompt displayed on the status line
|
|
|
|
|
|
|
|
|
|
*MatchingChar*::
|
|
|
|
|
face used by the show_matching highlighter
|
|
|
|
|
|
2016-02-17 14:55:19 +01:00
|
|
|
*BufferPadding*::
|
|
|
|
|
face applied on the characters that follow the last line of a buffer
|
2016-12-16 04:49:14 +01:00
|
|
|
|
|
|
|
|
*Whitespace*::
|
|
|
|
|
face used by the show_whitespaces highlighter
|
