styling.html

styling

Vimperator 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 Vimperator elements can be styled with the :highlight command, for convenience.

E185 :colo :colorscheme

:colo[rscheme] {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

:hi[ghlight][!] [-append] {group} [[{selector}] {css}]

Highlight {group} with {css}. 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 Vimperator 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 Vimperator'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 <Enter>
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

:hi[ghlight] clear [{group} [{selector}]]

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

:sty :style

:sty[le][!] [-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. 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

:dels[tyle] [-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)