| Both sides previous revision Previous revision Next revision | Previous revision |
| syntax:styles [2015/02/22 23:59] – [Containers] admin | syntax:styles [2018/01/10 20:43] (current) – external edit 127.0.0.1 |
|---|
| </code> | </code> |
| |
| This node described styles that used as for colorizing of the text as for some UI element as editor indicator margin for example. Inheritable from parent. | This node described styles that used as for colorizing of the text as for some UI element as editor indicator margin for example. Inheritable from the parent. |
| |
| ====== Style ====== | ====== Style ====== |
| |
| ==== abstract ==== | ==== abstract ==== |
| If attribute is set, style would not be visible in user settings. Can be used, for example, if you only want to define visibility range for some another style, and do not want to syntax highlight it. | If the attribute is set, the style would not be visible in user settings. Can be used, for example, if you only want to define visibility range for some another style, and do not want to syntax highlight it. |
| |
| Value: //true|false//\\ | Value: //true|false//\\ |
| |
| ==== extend ==== | ==== extend ==== |
| Technical attribute, which tells HE that parent style should not be overridden but only extended by some properties. Default is false. If extended = true, then style with same id should exist in some parent syntax. In UI you would see that style still belongs to parent syntax. If you have defined style with same name as already defined in some parent, and don't use extend=true then on UI as the owner of style would be current syntax, and all changes would be applied to it, but not to parent. | Technical attribute, which tells HE that parent style should not be overridden but only extended by some properties. The default is false. If extended = true, then style with the same id should exist in some parent syntax. In UI you would see that style still belongs to parent syntax. If you have defined style with the same name as already defined in some parent, and don't use extend=true then on UI as the owner of the style would be current syntax, and all changes would be applied to it, but not to parent. |
| |
| Value: //true|false//\\ | Value: //true|false//\\ |
| |
| ==== override ==== | ==== override ==== |
| Technical attribute, mostly same as extend, but only resets inherited keywords, blocks and words. Default = false. Can be used if you want to completely overwrite definitions for style from parent schema. | Technical attribute, mostly same as extend, but only resets inherited keywords, blocks, and words. Default = false. Can be used if you want to completely overwrite definitions for style from parent schema. |
| |
| Value: //true|false//\\ | Value: //true|false//\\ |
| |
| ==== inherit ==== | ==== inherit ==== |
| Technical attribute, which tells to copy information from other style to this one. Copied are keywords, blocks, settings, but not containers. This is a better way than duplicate keyword sets. Example can be found in css_spec.xml (inherit="html:elements") | Technical attribute, which tells to copy information from another style to this one. Copied are keywords, blocks, settings, but not containers. This is a better way than duplicate keyword sets. An example can be found in css_spec.xml (inherit="html:elements") |
| |
| Value: //any id of existing style with/without syntax prefix//\\ | Value: //any id of existing style with/without syntax prefix//\\ |
| |
| ==== clr/bkclr ==== | ==== clr/bkclr ==== |
| Text (clr) or background (bkclr) color of the style. As color you can use as explicit value in RGB or RGBA (with alpha) format. Like %%#%%FFAAFF (RGB, no transparency) or %%#%%FFFFFFFF (RGBA, transparent, last FF is value of color transparency 0 - opaque, FF - 100% transparent). Transparency of color is used, when you have one style on top of another; for example current line style on top of search results on top of .... You can also use System color. It can be specify as this $0500 (Windows Text color, opaque), where first 05 is value system (correspond to Windows system color constants) color and second 00 is transparency. Because there is no list of the system color yet published, better to use configuration dialog for selecting. And most preferable way is to use Palette colors. Then value of clr or bkclr should correspond to some named color from current color scheme (can be found in HE data\colors, for example, color_default.xml ). In case of using palette colors you can be sure that you would not get black on black, if somebody would select color scheme with black background for document... | Text (clr) or background (bkclr) color of the style. As for color, you can use as an explicit value in RGB or RGBA (with alpha) format. Like %%#%%FFAAFF (RGB, no transparency) or %%#%%FFFFFFFF (RGBA, transparent, last FF is value of color transparency 0 - opaque, FF - 100% transparent). Transparency of color is used, when you have one style on top of another; for example current line style on top of search results on top of ... You can also use System color. It can be specified as this $0500 (Windows Text color, opaque), where first 05 is value system (correspond to Windows system color constants) color and second 00 is transparency. Because there is no list of the system color yet published, better to use configuration dialog for selecting. And a preferable way is to use Palette colors. Then the value of clr or bkclr should correspond to some named color from current color scheme (can be found in HE data\colors, for example, color_default.xml ). In the case of using palette colors, you can be sure that you would not get black on black if somebody would select color scheme with a black background for document... |
| |
| Value: //RGB|RGBA|Palette color|System color//\\ | Value: //RGB|RGBA|Palette color|System color//\\ |