Styling the GUI and web pages
Contents
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.
: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[ghlight][!] [-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 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 <Return>
|
- 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.
:hi[ghlight] clear [{group} [{selector}]]
Reset the highlighting for {group} to its default value. If
{group} is not given, reset all highlighting groups.
: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. {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[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)
:styled[isable] [-name={name}] [-index={index}] {filter} {css}
Enable any matching styles. Arguments are the same as for :delstyle.
:stylee[nable] [-name={name}] [-index={index}] {filter} {css}
Disable any matching styles. Arguments are the same as for :delstyle.
:stylet[oggle] [-name={name}] [-index={index}] {filter} {css}
Toggle any matching styles. Arguments are the same as for :delstyle.