callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Improve CSS docs a bit

Browse Source 
Among other things, explain the relationship of background-color
and background-image.
This commit is contained in:
Matthias Clasen
2016-05-23 19:25:41 -04:00
parent 46b51e36b4
commit 30c3d6af56
1 changed files with 15 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/reference/gtk/css-properties.xml
View File

@ -41,12 +41,13 @@ We use <literallayout> for syntax productions, and each line is put in a <code>
<para> <para>
GTK+ supports CSS properties and shorthands as far as they can be applied GTK+ supports CSS properties and shorthands as far as they can be applied
in the context of widgets, and only adds its own properties only when needed. in the context of widgets, and adds its own properties only when needed.
All GTK+-specific properties have a -gtk prefix. All GTK+-specific properties have a -gtk prefix.
</para> </para>
<para> <para>
All properties support the following keywords: inherit, initial, unset. All properties support the following keywords: inherit, initial, unset, with
the same meaning as in <ulink url="https://www.w3.org/TR/css3-cascade/#defaulting-keywords">CSS</ulink>.
</para> </para>
<para> <para>
@ -104,16 +105,16 @@ We use <literallayout> for syntax productions, and each line is put in a <code>
follows: follows:
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>4 values:</term><listitem>top right bottom left</listitem> <term>4 values: </term><listitem>top right bottom left</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>3 values:</term><listitem>top horizontal left</listitem> <term>3 values: </term><listitem>top horizontal left</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>2 values:</term><listitem>vertical horizontal</listitem> <term>2 values: </term><listitem>vertical horizontal</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>1 value:</term><listitem>all</listitem> <term>1 value: </term><listitem>all</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
@ -1028,6 +1029,10 @@ We use <literallayout> for syntax productions, and each line is put in a <code>
</tgroup> </tgroup>
</table> </table>
<para>
GTK+ uses the CSS outline properties to render the 'focus rectangle'.
</para>
<table pgwide="1"> <table pgwide="1">
<title>Background properties</title> <title>Background properties</title>
<tgroup cols="7"> <tgroup cols="7">
@ -1142,6 +1147,10 @@ We use <literallayout> for syntax productions, and each line is put in a <code>
<code>〈box shadow〉 = inset? &amp;&amp; 〈length〉{2,4}? &amp;&amp; 〈color〉?</code> <code>〈box shadow〉 = inset? &amp;&amp; 〈length〉{2,4}? &amp;&amp; 〈color〉?</code>
</literallayout> </literallayout>
<para>
As in CSS, the background color is rendered underneath all the background image layers, so it will only be visible if
background images are absent or have transparency.
</para>
<table pgwide="1"> <table pgwide="1">
<title>Transition properties</title> <title>Transition properties</title>