1 <?xml version="1.0" encoding="UTF-8"?>
2 <?xml-stylesheet type="text/xsl" href="dactyl://content/help.xsl"?>
4 <!DOCTYPE document SYSTEM "dactyl://content/dtd">
8 title="&dactyl.appName; Styling"
10 xmlns:html="&xmlns.html;">
12 <h1 tag="styling">Styling the GUI and web pages</h1>
16 &dactyl.appName; allows you to apply custom CSS styling to the web pages
17 you view as well as to the browser itself. Although it is possible to
18 style any user interface element via the <ex>:style</ex> command, most
19 &dactyl.appName; elements can be styled more easily by means of the
20 more specialized <ex>:highlight</ex> command.
24 <tags>E185 :colo :colorscheme</tags>
25 <spec>:colo<oa>rscheme</oa> <a>name</a></spec>
28 Load a color scheme. <a>name</a> is found by searching the <o>runtimepath</o> for the
29 first file matching <tt>colors/<a>name</a>.&dactyl.fileExt;</tt>.
33 The ColorScheme autocommand is triggered after the color scheme has been
40 <tags>:hi :highlight</tags>
41 <spec>:hi<oa>ghlight</oa><oa>!</oa> <a>group</a><oa>selector</oa></spec>
42 <spec>:hi<oa>ghlight</oa><oa>!</oa> <oa>-append</oa> <oa>-link=<a>group</a>,…</oa> <a>group</a><oa>selector</oa> <oa>css</oa></spec>
45 Highlight <a>group</a> with <oa>css</oa>. <oa>css</oa> is one or more
46 semicolon-separated CSS declarations (E.g. <em>color: blue;
47 background-color: red</em>). <oa>selector</oa>, if provided, may
48 be any valid CSS selector (such as <em>:hover</em> or
49 <em>[href]</em>), and will restrict the highlighting to matching
54 If <em>-link</em> (short name <em>-l</em>) is supplied, the value of
55 each of the listed groups is prepended to the style of this group.
58 <p>Valid groups include:</p>
61 <dt>Bell</dt> <dd>&dactyl.appName;'s visual bell</dd>
62 <dt>Boolean</dt> <dd>A JavaScript Boolean object</dd>
63 <dt>CmdLine</dt> <dd>The command line</dd>
64 <dt>CmdOutput</dt> <dd>The output of commands executed by <ex>:run</ex></dd>
65 <dt>CompDesc</dt> <dd>The description column of the completion list</dd>
66 <dt>CompGroup</dt> <dd>The top-level container for a group of completion results</dd>
67 <dt>CompIcon</dt> <dd>The favicon of a completion row</dd>
68 <dt>CompItem</dt> <dd>A row of completion list</dd>
69 <dt>CompItem[selected]</dt><dd>A selected row of completion list</dd>
70 <dt>CompLess::after</dt> <dd>The character of indicator shown when completions may be scrolled up</dd>
71 <dt>CompLess</dt> <dd>The indicator shown when completions may be scrolled up</dd>
72 <dt>CompMore::after</dt> <dd>The character of indicator shown when completions may be scrolled down</dd>
73 <dt>CompMore</dt> <dd>The indicator shown when completions may be scrolled down</dd>
74 <dt>CompMsg</dt> <dd>The message which may appear at the top of a group of completion results</dd>
75 <dt>CompResult</dt> <dd>The result column of the completion list</dd>
76 <dt>CompTitle</dt> <dd>Completion row titles</dd>
77 <dt>CompTitleSep</dt> <dd>The element which separates the completion title from its results</dd>
78 <dt>Disabled</dt> <dd>Text indicating disabled status, such as of an extension or style group</dd>
79 <dt>Enabled</dt> <dd>Text indicating enabled status, such as of an extension or style group</dd>
80 <dt>ErrorMsg</dt> <dd>Error messages</dd>
81 <dt>Filter</dt> <dd>The matching text in a completion list</dd>
82 <dt>FrameIndicator</dt> <dd>The indicator shown when a new frame is selected</dd>
83 <dt>Function</dt> <dd>A JavaScript Function object</dd>
84 <dt>Hint</dt> <dd>A hint indicator. See <ex>:help hints</ex></dd>
85 <dt>HintActive</dt> <dd>The hint element of link which will be followed by <k name="CR"/></dd>
86 <dt>HintElem</dt> <dd>The hintable element</dd>
87 <dt>HintImage</dt> <dd>The indicator which floats above hinted images</dd>
88 <dt>Indicator</dt> <dd>The <em>#</em> and <em>%</em> in the <ex>:buffers</ex> list</dd>
89 <dt>InfoMsg</dt> <dd>Information messages</dd>
90 <dt>Key</dt> <dd>Generally a keyword used in syntax highlighting.</dd>
91 <dt>Keyword</dt> <dd>A bookmark keyword for a URL</dd>
92 <dt>LineNr</dt> <dd>The line number of an error</dd>
93 <dt>Message</dt> <dd>A message as displayed in <ex>:messages</ex></dd>
94 <dt>ModeMsg</dt> <dd>The mode indicator in the command line</dd>
95 <dt>MoreMsg</dt> <dd>The indicator that there is more text to view</dd>
96 <dt>NonText</dt> <dd>The <em>~</em> indicators which mark blank lines in the completion list</dd>
97 <dt>Normal</dt> <dd>Normal text in the command line</dd>
98 <dt>Null</dt> <dd>A JavaScript Null object</dd>
99 <dt>Number</dt> <dd>A JavaScript Number object</dd>
100 <dt>Object</dt> <dd>A JavaScript Object</dd>
101 <dt>Preview</dt> <dd>The completion preview displayed in the &tag.command-line;</dd>
102 <dt>Question</dt> <dd>A prompt for a decision</dd>
103 <dt>StatusLine</dt> <dd>The status bar</dd>
104 <dt>StatusLineNormal</dt> <dd>The status bar for an ordinary web page</dd>
105 <dt>StatusLineBroken</dt> <dd>The status bar for a broken web page</dd>
106 <dt>StatusLineExtended</dt><dd>The status bar for a secure web page with an Extended Validation (EV) certificate</dd>
107 <dt>StatusLineSecure</dt> <dd>The status bar for a secure web page</dd>
108 <dt>String</dt> <dd>A JavaScript String object</dd>
109 <dt>TabClose</dt> <dd>The close button of a browser tab</dd>
110 <dt>TabIcon</dt> <dd>The icon of a browser tab</dd>
111 <dt>TabIconNumber</dt> <dd>The number of a browser tab, over its icon</dd>
112 <dt>TabNumber</dt> <dd>The number of a browser tab, next to its icon</dd>
113 <dt>TabText</dt> <dd>The text of a browser tab</dd>
114 <dt>Tag</dt> <dd>A bookmark tag for a URL</dd>
115 <dt>Title</dt> <dd>The title of a listing, including <ex>:pageinfo</ex>, <ex>:jumps</ex></dd>
116 <dt>URL</dt> <dd>A URL</dd>
117 <dt>WarningMsg</dt> <dd>A warning message</dd>
121 The help system also has a comprehensive set of styling groups
122 which are not explained here, but many of which are described
123 along with <t>writing-docs</t>.
127 Every invocation completely replaces the styling of any previous
128 invocation, unless <em>-append</em> (short name <em>-a</em>) is
129 provided, in which case <a>css</a> is appended to its current
130 value. If <a>css</a> is not provided, any styles beginning with
131 <a>group</a> are listed.
137 <tags>:highlight-clear</tags>
138 <spec>:hi<oa>ghlight</oa> clear <oa>group</oa></spec>
141 Reset the highlighting for <oa>group</oa> to its default value. If
142 <oa>group</oa> is not given, reset all highlighting groups.
148 <tags>:sty :style</tags>
149 <spec>:sty<oa>le</oa> <oa>-name=<a>name</a></oa> <oa>-append</oa> <a>filter</a> <oa>css</oa></spec>
152 Add CSS styles to the browser or to web pages. <a>filter</a> is a
153 comma-separated list of <t>site-filters</t> for which the style will
154 apply. Regular expression filters may not be used and the <tt>!</tt>
155 character may not be used to invert the sense of the match.
156 <oa>css</oa> is a full CSS rule set (e.g., <tt>body { color: blue; }</tt>).
159 <p>The following options are available:</p>
162 <dd>If provided along with <em>-name</em>, <oa>css</oa> and
163 <a>filter</a> are appended to its current value. (short name <em>-a</em>)</dd>
166 <dd>If provided, the style is installed as an Agent sheet, which
167 applies to contents user interface widgets as well as normal
168 elements. (short name <em>-A</em>)</dd>
170 <dt>-group=<a>group</a></dt>
171 <dd>The <t>group</t> to which to add this style. Please note that
172 this grouping is for semantic and cleanup purposes only. No
173 additional site filtering is applied.</dd>
175 <dt>-name=<a>name</a></dt>
176 <dd>If provided, any existing style with the same name is
177 overridden, and the style may later be deleted using
178 <a>name</a>. (short name <em>-n</em>)</dd>
182 <p>If <oa>css</oa> isn't provided, matching styles are listed.</p>
187 <tags>:dels :delstyle</tags>
189 <spec>:dels<oa>tyle</oa><oa>!</oa> <oa>-name=<a>name</a></oa> <oa>-index=<a>index</a></oa> <oa>filter</oa> <oa>css</oa></spec>
192 Delete any matching styles. With <oa>!</oa>, delete all styles.
193 If <oa>filter</oa> is provided, only matching elements of the
194 filter are disabled. For instance, when run with a filter
195 <str delim="">mozilla.org</str>, an existing style with a filter
196 <str delim="">www.google.com,mozilla.org</str>, will result in a style for
197 <str delim="">www.google.com</str>.
200 <p>The available options are:</p>
203 <dt>-name</dt> <dd>The name provided to <ex>:style</ex> (short name <em>-n</em>)</dd>
204 <dt>-index</dt> <dd>For unnamed styles, the index listed by <ex>:style</ex>
205 (short name <em>-i</em>)</dd>
211 <tags>:styleenable :stylee</tags>
212 <tags>:styenable :stye</tags>
214 <spec>:styled<oa>isable</oa><oa>!</oa> <oa>-name=<a>name</a></oa> <oa>-index=<a>index</a></oa> <oa>filter</oa> <oa>css</oa></spec>
216 <p>Enable any matching styles. With <oa>!</oa>, enable all styles. Arguments are the same as for <ex>:delstyle</ex></p>
221 <tags>:styledisable :styled</tags>
222 <tags>:stydisable :styd</tags>
224 <spec>:stylee<oa>nable</oa><oa>!</oa> <oa>-name=<a>name</a></oa> <oa>-index=<a>index</a></oa> <oa>filter</oa> <oa>css</oa></spec>
226 <p>Disable any matching styles. With <oa>!</oa>, disable all styles. Arguments are the same as for <ex>:delstyle</ex></p>
231 <tags>:styletoggle :stylet</tags>
232 <tags>:stytoggle :styt</tags>
234 <spec>:stylet<oa>oggle</oa><oa>!</oa> <oa>-name=<a>name</a></oa> <oa>-index=<a>index</a></oa> <oa>filter</oa> <oa>css</oa></spec>
236 <p>Toggle any matching styles. With <oa>!</oa>, toggle all styles. Arguments are the same as for <ex>:delstyle</ex></p>
242 <!-- vim:se sts=4 sw=4 et: -->