Styling the GUI and web pages

&liberator.appname; allows you to style both the browser and any web pages you view. All styling is specified via CSS. Although you may style any user interface element via the :style command, most &liberator.appname; elements can be styled with the :highlight command, for convenience.

E185 :colo :colorscheme :colorscheme name

Load a color scheme. name is found by searching the runtimepath for the first file matching colors/name.vimp.

The ColorScheme autocommand is triggered after the color scheme has been sourced.

:hi :highlight :highlight! -append group [[selector] css]

Highlight group with css. css is one or more comma separated CSS declarations (E.g. color: blue; background-color: red). Normally, css is checked for valid syntax before it's applied. Once you're certain it's valid, ! can be used to skip the check to speed up &liberator.appname; startup. selector can be any valid CSS selector, such as :hover, and, if provided, will restrict the match to matching elements.

Valid groups are:

Bell
&liberator.appname;'s visual bell
Boolean
A JavaScript Boolean object
CmdLine
The command line
CmdOutput
CompDesc
The description column of the completion list
CompGroup
CompIcon
The favicon of a completion row
CompItem
A row of completion list
CompItem[selected]
A selected row of completion list
CompLess
The indicator shown when completions may be scrolled up
CompLess::after
The character of indicator shown when completions may be scrolled up
CompMore
The indicator shown when completions may be scrolled down
CompMore::after
The character of indicator shown when completions may be scrolled down
CompMsg
CompResult
The result column of the completion list
CompTitle
Completion row titles
ErrorMsg
Error messages
Filter
The matching text in a completion list
FrameIndicator
The indicator shown when a new frame is selected
Function
A JavaScript Function object
Gradient
GradientLeft
GradientRight
Hint
A hint indicator. See :help hints
HintActive
The hint element of link which will be followed by
HintElem
The hintable element
HintImage
The indicator which floats above hinted images
Indicator
InfoMsg
Information messages
Keyword
A bookmark keyword for a URL
LineNr
The line number of an error
Message
ModeMsg
The mode indicator in the command line
MoreMsg
The indicator that there is more text to view
NonText
Normal
Normal text in the command line
Null
A JavaScript Null object
Number
A JavaScript Number object
Object
A JavaScript Object
Preview
Question
A prompt for a decision
Search
Highlighted search results in a web page
StatusLine
The status bar
StatusLineBroken
The status bar for a broken web page
StatusLineSecure
The status bar for a secure web page
StatusLineExtended
The status bar for a secure web page with an Extended Validation(EV) certificate
String
A JavaScript String object
TabClose
The close button of a browser tab
TabIcon
The icon of a browser tab
TabIconNumber
The number of a browser tab, over its icon
TabNumber
The number of a browser tab, next to its icon
TabText
The text of a browser tab
Tag
A bookmark tag for a URL
Title
The title of a listing, including :pageinfo, :jumps
URL
A URL
WarningMsg
A warning message

Every invocation completely replaces the styling of any previous invocation, unless -append (short option: -a) is provided, in which case css is appended to its current value. If css is not provided, any styles matching group are listed, or all styles if no group provided.

:highlight-clear :highlight clear group selector

Reset the highlighting for group to its default value. If group is not given, reset all highlighting groups.

:sty :style :style! -name=name -append filter [css]

Add CSS styles to the browser or to web pages. filter is a comma separated list of URLs to match. URLs ending with * are matched as prefixes, URLs not containing any : or / characters are matched as domains. css is a full CSS rule set (e.g., body { color: blue; }).

If name (short option: -n) is provided, any existing style with the same name is overridden, and the style may later be deleted using name. If -append (short option: -a) is provided along with -name, css and filter are appended to its current value.

If css isn't provided, matching styles are listed.

 :dels :delstyle :delstyle [-name=name] [-index=index] [filter] [css]

Delete any matching styles. If filter is provided, only matching elements of the filter are disabled. For instance, a filter mozilla.org, given a style for www.google.com,mozilla.org, will result in a style for www.google.com. The available options are:

  • -name: The name provided to :style (short option: -n)
  • -index: For unnamed styles, the index listed by :style (short option: -i)
 :styleenable :stylee :styenable :stye :styledisable -name=name -index=index filter css

Enable any matching styles. Arguments are the same as for :delstyle.

 :styledisable :styled :stydisable :styd :styleenable -name=name -index=index filter css

Disable any matching styles. Arguments are the same as for :delstyle.

 :styletoggle :stylet :stytoggle :styt :styletoggle -name=name -index=index filter css

Toggle any matching styles. Arguments are the same as for :delstyle.