1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 2010 Carlos Garnacho <carlosg@gnome.org>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
25 #include <gdk-pixbuf/gdk-pixbuf.h>
26 #include <cairo-gobject.h>
28 #include "gtkcssproviderprivate.h"
30 #include "gtkcssstringfuncsprivate.h"
31 #include "gtksymboliccolor.h"
32 #include "gtkstyleprovider.h"
33 #include "gtkstylecontextprivate.h"
34 #include "gtkbindings.h"
35 #include "gtkmarshalers.h"
36 #include "gtkprivate.h"
40 * SECTION:gtkcssprovider
41 * @Short_description: CSS-like styling for widgets
42 * @Title: GtkCssProvider
43 * @See_also: #GtkStyleContext, #GtkStyleProvider
45 * GtkCssProvider is an object implementing the #GtkStyleProvider interface.
46 * It is able to parse <ulink url="http://www.w3.org/TR/CSS2">CSS</ulink>-like
47 * input in order to style widgets.
49 * <refsect2 id="gtkcssprovider-files">
50 * <title>Default files</title>
52 * An application can cause GTK+ to parse a specific CSS style sheet by
53 * calling gtk_css_provider_load_from_file() and adding the provider with
54 * gtk_style_context_add_provider() or gtk_style_context_add_provider_for_screen().
55 * In addition, certain files will be read when GTK+ is initialized. First,
56 * the file <filename><envar>$XDG_CONFIG_HOME</envar>/gtk-3.0/gtk.css</filename>
57 * is loaded if it exists. Then, GTK+ tries to load
58 * <filename><envar>$HOME</envar>/.themes/<replaceable>theme-name</replaceable>/gtk-3.0/gtk.css</filename>,
60 * <filename><replaceable>datadir</replaceable>/share/themes/<replaceable>theme-name</replaceable>/gtk-3.0/gtk.css</filename>,
61 * where <replaceable>theme-name</replaceable> is the name of the current theme
62 * (see the #GtkSettings:gtk-theme-name setting) and <replaceable>datadir</replaceable>
63 * is the prefix configured when GTK+ was compiled, unless overridden by the
64 * <envar>GTK_DATA_PREFIX</envar> environment variable.
67 * <refsect2 id="gtkcssprovider-stylesheets">
68 * <title>Style sheets</title>
70 * The basic structure of the style sheets understood by this provider is
71 * a series of statements, which are either rule sets or '@-rules', separated
75 * A rule set consists of a selector and a declaration block, which is
76 * a series of declarations enclosed in curly braces ({ and }). The
77 * declarations are separated by semicolons (;). Multiple selectors can
78 * share the same declaration block, by putting all the separators in
79 * front of the block, separated by commas.
81 * <example><title>A rule set with two selectors</title>
82 * <programlisting language="text">
83 * GtkButton, GtkEntry {
90 * <refsect2 id="gtkcssprovider-selectors">
91 * <title>Selectors</title>
93 * Selectors work very similar to the way they do in CSS, with widget class
94 * names taking the role of element names, and widget names taking the role
95 * of IDs. When used in a selector, widget names must be prefixed with a
96 * '#' character. The '*' character represents the so-called universal
97 * selector, which matches any widget.
100 * To express more complicated situations, selectors can be combined in
103 * <listitem><para>To require that a widget satisfies several conditions,
104 * combine several selectors into one by concatenating them. E.g.
105 * <literal>GtkButton#button1</literal> matches a GtkButton widget
106 * with the name button1.</para></listitem>
107 * <listitem><para>To only match a widget when it occurs inside some other
108 * widget, write the two selectors after each other, separated by whitespace.
109 * E.g. <literal>GtkToolBar GtkButton</literal> matches GtkButton widgets
110 * that occur inside a GtkToolBar.</para></listitem>
111 * <listitem><para>In the previous example, the GtkButton is matched even
112 * if it occurs deeply nested inside the toolbar. To restrict the match
113 * to direct children of the parent widget, insert a '>' character between
114 * the two selectors. E.g. <literal>GtkNotebook > GtkLabel</literal> matches
115 * GtkLabel widgets that are direct children of a GtkNotebook.</para></listitem>
119 * <title>Widget classes and names in selectors</title>
120 * <programlisting language="text">
121 * /* Theme labels that are descendants of a window */
122 * GtkWindow GtkLabel {
123 * background-color: #898989
126 * /* Theme notebooks, and anything that's within these */
128 * background-color: #a939f0
131 * /* Theme combo boxes, and entries that
132 * are direct children of a notebook */
134 * GtkNotebook > GtkEntry {
136 * background-color: #1209a2
139 * /* Theme any widget within a GtkBin */
144 * /* Theme a label named title-label */
145 * GtkLabel#title-label {
149 * /* Theme any widget named main-entry */
151 * background-color: #f0a810
156 * Widgets may also define style classes, which can be used for matching.
157 * When used in a selector, style classes must be prefixed with a '.'
161 * Refer to the documentation of individual widgets to learn which
162 * style classes they define and see <xref linkend="gtkstylecontext-classes"/>
163 * for a list of all style classes used by GTK+ widgets.
166 * Note that there is some ambiguity in the selector syntax when it comes
167 * to differentiation widget class names from regions. GTK+ currently treats
168 * a string as a widget class name if it contains any uppercase characters
169 * (which should work for more widgets with names like GtkLabel).
172 * <title>Style classes in selectors</title>
173 * <programlisting language="text">
174 * /* Theme all widgets defining the class entry */
176 * color: #39f1f9;
179 * /* Theme spinbuttons' entry */
180 * GtkSpinButton.entry {
186 * In complicated widgets like e.g. a GtkNotebook, it may be desirable
187 * to style different parts of the widget differently. To make this
188 * possible, container widgets may define regions, whose names
189 * may be used for matching in selectors.
192 * Some containers allow to further differentiate between regions by
193 * applying so-called pseudo-classes to the region. For example, the
194 * tab region in GtkNotebook allows to single out the first or last
195 * tab by using the :first-child or :last-child pseudo-class.
196 * When used in selectors, pseudo-classes must be prefixed with a
200 * Refer to the documentation of individual widgets to learn which
201 * regions and pseudo-classes they define and see
202 * <xref linkend="gtkstylecontext-classes"/> for a list of all regions
203 * used by GTK+ widgets.
206 * <title>Regions in selectors</title>
207 * <programlisting language="text">
208 * /* Theme any label within a notebook */
209 * GtkNotebook GtkLabel {
210 * color: #f90192;
213 * /* Theme labels within notebook tabs */
214 * GtkNotebook tab GtkLabel {
215 * color: #703910;
218 * /* Theme labels in the any first notebook
219 * tab, both selectors are equivalent */
220 * GtkNotebook tab:nth-child(first) GtkLabel,
221 * GtkNotebook tab:first-child GtkLabel {
222 * color: #89d012;
227 * Another use of pseudo-classes is to match widgets depending on their
228 * state. This is conceptually similar to the :hover, :active or :focus
229 * pseudo-classes in CSS. The available pseudo-classes for widget states
230 * are :active, :prelight (or :hover), :insensitive, :selected, :focused
234 * <title>Styling specific widget states</title>
235 * <programlisting language="text">
236 * /* Theme active (pressed) buttons */
238 * background-color: #0274d9;
241 * /* Theme buttons with the mouse pointer on it,
242 * both are equivalent */
244 * GtkButton:prelight {
245 * background-color: #3085a9;
248 * /* Theme insensitive widgets, both are equivalent */
251 * background-color: #320a91;
254 * /* Theme selection colors in entries */
255 * GtkEntry:selected {
256 * background-color: #56f9a0;
259 * /* Theme focused labels */
261 * background-color: #b4940f;
264 * /* Theme inconsistent checkbuttons */
265 * GtkCheckButton:inconsistent {
266 * background-color: #20395a;
271 * Widget state pseudoclasses may only apply to the last element
275 * To determine the effective style for a widget, all the matching rule
276 * sets are merged. As in CSS, rules apply by specificity, so the rules
277 * whose selectors more closely match a widget path will take precedence
281 * <refsect2 id="gtkcssprovider-rules">
282 * <title>@ Rules</title>
284 * GTK+'s CSS supports the @import rule, in order to load another
285 * CSS style sheet in addition to the currently parsed one.
288 * <title>Using the @import rule</title>
289 * <programlisting language="text">
290 * @import url ("path/to/common.css");
293 * <para id="css-binding-set">
294 * In order to extend key bindings affecting different widgets, GTK+
295 * supports the @binding-set rule to parse a set of bind/unbind
296 * directives, see #GtkBindingSet for the supported syntax. Note that
297 * the binding sets defined in this way must be associated with rule sets
298 * by setting the gtk-key-bindings style property.
301 * Customized key bindings are typically defined in a separate
302 * <filename>gtk-keys.css</filename> CSS file and GTK+ loads this file
303 * according to the current key theme, which is defined by the
304 * #GtkSettings:gtk-key-theme-name setting.
307 * <title>Using the @binding rule</title>
308 * <programlisting language="text">
309 * @binding-set binding-set1 {
310 * bind "<alt>Left" { "move-cursor" (visual-positions, -3, 0) };
314 * @binding-set binding-set2 {
315 * bind "<alt>Right" { "move-cursor" (visual-positions, 3, 0) };
316 * bind "<alt>KP_space" { "delete-from-cursor" (whitespace, 1)
317 * "insert-at-cursor" (" ") };
321 * gtk-key-bindings: binding-set1, binding-set2;
326 * GTK+ also supports an additional @define-color rule, in order
327 * to define a color name which may be used instead of color numeric
328 * representations. Also see the #GtkSettings:gtk-color-scheme setting
329 * for a way to override the values of these named colors.
332 * <title>Defining colors</title>
333 * <programlisting language="text">
334 * @define-color bg_color #f9a039;
337 * background-color: @bg_color;
342 * <refsect2 id="gtkcssprovider-symbolic-colors">
343 * <title>Symbolic colors</title>
345 * Besides being able to define color names, the CSS parser is also able
346 * to read different color expressions, which can also be nested, providing
347 * a rich language to define colors which are derived from a set of base
351 * <title>Using symbolic colors</title>
352 * <programlisting language="text">
353 * @define-color entry-color shade (@bg_color, 0.7);
356 * background-color: @entry-color;
360 * background-color: mix (@entry-color,
361 * shade (#fff, 0.5),
367 * The various ways to express colors in GTK+ CSS are:
373 * <entry>Syntax</entry>
374 * <entry>Explanation</entry>
375 * <entry>Examples</entry>
380 * <entry>rgb(@r, @g, @b)</entry>
381 * <entry>An opaque color; @r, @g, @b can be either integers between
382 * 0 and 255 or percentages</entry>
383 * <entry><literallayout>rgb(128, 10, 54)
384 * rgb(20%, 30%, 0%)</literallayout></entry>
387 * <entry>rgba(@r, @g, @b, @a)</entry>
388 * <entry>A translucent color; @r, @g, @b are as in the previous row,
389 * @a is a floating point number between 0 and 1</entry>
390 * <entry><literallayout>rgba(255, 255, 0, 0.5)</literallayout></entry>
393 * <entry>#@xxyyzz</entry>
394 * <entry>An opaque color; @xx, @yy, @zz are hexadecimal numbers
395 * specifying @r, @g, @b variants with between 1 and 4
396 * hexadecimal digits per component are allowed</entry>
397 * <entry><literallayout>#ff12ab
398 * #f0c</literallayout></entry>
401 * <entry>@name</entry>
402 * <entry>Reference to a color that has been defined with
403 * @define-color
405 * <entry>@bg_color</entry>
408 * <entry>mix(@color1, @color2, @f)</entry>
409 * <entry>A linear combination of @color1 and @color2. @f is a
410 * floating point number between 0 and 1.</entry>
411 * <entry><literallayout>mix(#ff1e0a, @bg_color, 0.8)</literallayout></entry>
414 * <entry>shade(@color, @f)</entry>
415 * <entry>A lighter or darker variant of @color. @f is a
416 * floating point number.
418 * <entry>shade(@fg_color, 0.5)</entry>
421 * <entry>lighter(@color)</entry>
422 * <entry>A lighter variant of @color</entry>
425 * <entry>darker(@color)</entry>
426 * <entry>A darker variant of @color</entry>
432 * <refsect2 id="gtkcssprovider-gradients">
433 * <title>Gradients</title>
435 * Linear or radial Gradients can be used as background images.
438 * A linear gradient along the line from (@start_x, @start_y) to
439 * (@end_x, @end_y) is specified using the syntax
440 * <literallayout>-gtk-gradient (linear,
441 * @start_x @start_y, @end_x @end_y,
442 * color-stop (@position, @color),
443 * ...)</literallayout>
444 * where @start_x and @end_x can be either a floating point number between
445 * 0 and 1 or one of the special values 'left', 'right' or 'center', @start_y
446 * and @end_y can be either a floating point number between 0 and 1 or one
447 * of the special values 'top', 'bottom' or 'center', @position is a floating
448 * point number between 0 and 1 and @color is a color expression (see above).
449 * The color-stop can be repeated multiple times to add more than one color
450 * stop. 'from (@color)' and 'to (@color)' can be used as abbreviations for
451 * color stops with position 0 and 1, respectively.
454 * <title>A linear gradient</title>
455 * <inlinegraphic fileref="gradient1.png" format="PNG"/>
456 * <para>This gradient was specified with
457 * <literallayout>-gtk-gradient (linear,
458 * left top, right bottom,
459 * from(@yellow), to(@blue))</literallayout></para>
462 * <title>Another linear gradient</title>
463 * <inlinegraphic fileref="gradient2.png" format="PNG"/>
464 * <para>This gradient was specified with
465 * <literallayout>-gtk-gradient (linear,
467 * color-stop(0, @yellow),
468 * color-stop(0.2, @blue),
469 * color-stop(1, #0f0))</literallayout></para>
472 * A radial gradient along the two circles defined by (@start_x, @start_y,
473 * @start_radius) and (@end_x, @end_y, @end_radius) is specified using the
475 * <literallayout>-gtk-gradient (radial,
476 * @start_x @start_y, @start_radius,
477 * @end_x @end_y, @end_radius,
478 * color-stop (@position, @color),
479 * ...)</literallayout>
480 * where @start_radius and @end_radius are floating point numbers and
481 * the other parameters are as before.
484 * <title>A radial gradient</title>
485 * <inlinegraphic fileref="gradient3.png" format="PNG"/>
486 * <para>This gradient was specified with
487 * <literallayout>-gtk-gradient (radial,
490 * from(@yellow), to(@green))</literallayout></para>
493 * <title>Another radial gradient</title>
494 * <inlinegraphic fileref="gradient4.png" format="PNG"/>
495 * <para>This gradient was specified with
496 * <literallayout>-gtk-gradient (radial,
499 * color-stop (0, #f00),
500 * color-stop (0.1, #a0f),
501 * color-stop (0.2, @yellow),
502 * color-stop (1, @green))</literallayout></para>
505 * <refsect2 id="gtkcssprovider-slices">
506 * <title>Border images</title>
508 * Images can be used in 'slices' for the purpose of creating scalable
511 * <inlinegraphic fileref="slices.png" format="PNG"/>
513 * The syntax for specifying border images of this kind is:
514 * <literallayout>url(@path) @top @right @bottom @left [repeat|stretch]? [repeat|stretch]?</literallayout>
515 * The sizes of the 'cut off' portions are specified
516 * with the @top, @right, @bottom and @left parameters.
517 * The 'middle' sections can be repeated or stretched to create
518 * the desired effect, by adding the 'repeat' or 'stretch' options after
519 * the dimensions. If two options are specified, the first one affects
520 * the horizontal behaviour and the second one the vertical behaviour.
521 * If only one option is specified, it affects both.
524 * <title>A border image</title>
525 * <inlinegraphic fileref="border1.png" format="PNG"/>
526 * <para>This border image was specified with
527 * <literallayout>url("gradient1.png") 10 10 10 10</literallayout>
531 * <title>A repeating border image</title>
532 * <inlinegraphic fileref="border2.png" format="PNG"/>
533 * <para>This border image was specified with
534 * <literallayout>url("gradient1.png") 10 10 10 10 repeat</literallayout>
538 * <title>A stretched border image</title>
539 * <inlinegraphic fileref="border3.png" format="PNG"/>
540 * <para>This border image was specified with
541 * <literallayout>url("gradient1.png") 10 10 10 10 stretch</literallayout>
545 * <refsect2 id="gtkcssprovider-transitions">
546 * <para>Styles can specify transitions that will be used to create a gradual
547 * change in the appearance when a widget state changes. The following
548 * syntax is used to specify transitions:
549 * <literallayout>@duration [s|ms] [linear|ease|ease-in|ease-out|ease-in-out] [loop]?</literallayout>
550 * The @duration is the amount of time that the animation will take for
551 * a complete cycle from start to end. If the loop option is given, the
552 * animation will be repated until the state changes again.
553 * The option after the duration determines the transition function from a
554 * small set of predefined functions.
555 * <figure><title>Linear transition</title>
556 * <graphic fileref="linear.png" format="PNG"/>
558 * <figure><title>Ease transition</title>
559 * <graphic fileref="ease.png" format="PNG"/>
561 * <figure><title>Ease-in-out transition</title>
562 * <graphic fileref="ease-in-out.png" format="PNG"/>
564 * <figure><title>Ease-in transition</title>
565 * <graphic fileref="ease-in.png" format="PNG"/>
567 * <figure><title>Ease-out transition</title>
568 * <graphic fileref="ease-out.png" format="PNG"/>
572 * <refsect2 id="gtkcssprovider-properties">
573 * <title>Supported properties</title>
575 * Properties are the part that differ the most to common CSS,
576 * not all properties are supported (some are planned to be
577 * supported eventually, some others are meaningless or don't
578 * map intuitively in a widget based environment).
581 * There is also a difference in shorthand properties, for
582 * example in common CSS it is fine to define a font through
583 * the different @font-family, @font-style, @font-size
584 * properties, meanwhile in GTK+'s CSS only the canonical
585 * @font property is supported.
588 * The currently supported properties are:
594 * <entry>Property name</entry>
595 * <entry>Syntax</entry>
596 * <entry>Maps to</entry>
597 * <entry>Examples</entry>
602 * <entry>engine</entry>
603 * <entry>engine-name</entry>
604 * <entry>#GtkThemingEngine</entry>
605 * <entry>engine: clearlooks;
606 * engine: none; /* use the default (i.e. builtin) engine) */ </entry>
609 * <entry>background-color</entry>
610 * <entry morerows="2">color (see above)</entry>
611 * <entry morerows="2">#GdkRGBA</entry>
612 * <entry morerows="2"><literallayout>background-color: #fff;
613 * color: &color1;
614 * background-color: shade (&color1, 0.5);
615 * color: mix (&color1, #f0f, 0.8);</literallayout>
619 * <entry>color</entry>
622 * <entry>border-color</entry>
625 * <entry>font</entry>
626 * <entry>@family [@style] [@size]</entry>
627 * <entry>#PangoFontDescription</entry>
628 * <entry>font: Sans 15;</entry>
631 * <entry>margin</entry>
632 * <entry morerows="1"><literallayout>@width
633 * @vertical_width @horizontal_width
634 * @top_width @horizontal_width @bottom_width
635 * @top_width @right_width @bottom_width @left_width</literallayout>
637 * <entry morerows="1">#GtkBorder</entry>
638 * <entry morerows="1"><literallayout>margin: 5;
641 * margin: 5 10 3 5;</literallayout>
645 * <entry>padding</entry>
648 * <entry>background-image</entry>
649 * <entry><literallayout>gradient (see above) or
650 * url(@path)</literallayout></entry>
651 * <entry>#cairo_pattern_t</entry>
652 * <entry><literallayout>-gtk-gradient (linear,
653 * left top, right top,
654 * from (#fff), to (#000));
655 * -gtk-gradient (linear, 0.0 0.5, 0.5 1.0,
657 * color-stop (0.5, #f00),
659 * -gtk-gradient (radial,
660 * center center, 0.2,
661 * center center, 0.8,
662 * color-stop (0.0, #fff),
663 * color-stop (1.0, #000));
664 * url ('background.png');</literallayout>
668 * <entry>border-width</entry>
669 * <entry>integer</entry>
670 * <entry>#gint</entry>
671 * <entry>border-width: 5;</entry>
674 * <entry>border-radius</entry>
675 * <entry>integer</entry>
676 * <entry>#gint</entry>
677 * <entry>border-radius: 5;</entry>
680 * <entry>border-style</entry>
681 * <entry>[none|solid|inset|outset]</entry>
682 * <entry>#GtkBorderStyle</entry>
683 * <entry>border-style: solid;</entry>
686 * <entry>border-image</entry>
687 * <entry><literallayout>border image (see above)</literallayout></entry>
688 * <entry>internal use only</entry>
689 * <entry><literallayout>border-image: url("/path/to/image.png") 3 4 3 4 stretch;
690 * border-image: url("/path/to/image.png") 3 4 4 3 repeat stretch;</literallayout>
694 * <entry>transition</entry>
695 * <entry>transition (see above)</entry>
696 * <entry>internal use only</entry>
697 * <entry><literallayout>transition: 150ms ease-in-out;
698 * transition: 1s linear loop;</literallayout>
702 * <entry>gtk-key-bindings</entry>
703 * <entry>binding set name list</entry>
704 * <entry>internal use only</entry>
705 * <entry><literallayout>gtk-bindings: binding1, binding2, ...;</literallayout>
712 * GtkThemingEngines can register their own, engine-specific style properties
713 * with the function gtk_theming_engine_register_property(). These properties
714 * can be set in CSS like other properties, using a name of the form
715 * <literallayout>-<replaceable>namespace</replaceable>-<replaceable>name</replaceable></literallayout>, where <replaceable>namespace</replaceable> is typically
716 * the name of the theming engine, and <replaceable>name</replaceable> is the
717 * name of the property. Style properties that have been registered by widgets
718 * using gtk_widget_class_install_style_property() can also be set in this
719 * way, using the widget class name for <replaceable>namespace</replaceable>.
722 * <title>Using engine-specific style properties</title>
725 * engine: clearlooks;
727 * -GtkPaned-handle-size: 6;
728 * -clearlooks-colorize-scrollbar: false;
735 typedef struct SelectorElement SelectorElement;
736 typedef struct SelectorPath SelectorPath;
737 typedef struct SelectorStyleInfo SelectorStyleInfo;
738 typedef struct _GtkCssScannerPrivate GtkCssScannerPrivate;
739 typedef enum SelectorElementType SelectorElementType;
740 typedef enum CombinatorType CombinatorType;
741 typedef enum ParserScope ParserScope;
742 typedef enum ParserSymbol ParserSymbol;
744 enum SelectorElementType {
753 enum CombinatorType {
754 COMBINATOR_DESCENDANT, /* No direct relation needed */
755 COMBINATOR_CHILD /* Direct child */
758 struct SelectorElement
760 SelectorElementType elem_type;
761 CombinatorType combinator;
771 GtkRegionFlags flags;
783 struct SelectorStyleInfo
789 struct _GtkCssScannerPrivate
792 GSList *cur_selectors;
793 GHashTable *cur_properties;
796 struct _GtkCssProviderPrivate
800 GHashTable *symbolic_colors;
802 GPtrArray *selectors_info;
804 /* Current parser state */
817 /* Extend GtkStateType, since these
818 * values are also used as symbols
821 /* Scope: pseudo-class */
822 SYMBOL_NTH_CHILD = GTK_STATE_FOCUSED + 1,
827 /* Scope: nth-child */
828 SYMBOL_NTH_CHILD_EVEN,
829 SYMBOL_NTH_CHILD_ODD,
830 SYMBOL_NTH_CHILD_FIRST,
831 SYMBOL_NTH_CHILD_LAST
839 static guint css_provider_signals[LAST_SIGNAL] = { 0 };
841 static void gtk_css_provider_finalize (GObject *object);
842 static void gtk_css_style_provider_iface_init (GtkStyleProviderIface *iface);
844 static void scanner_apply_scope (GScanner *scanner,
846 static void css_provider_reset_parser (GtkCssProvider *css_provider);
847 static gboolean gtk_css_provider_load_from_path_internal (GtkCssProvider *css_provider,
851 static void gtk_css_provider_take_error (GtkCssProvider *provider,
856 gtk_css_provider_error_quark (void)
858 return g_quark_from_static_string ("gtk-css-provider-error-quark");
861 G_DEFINE_TYPE_EXTENDED (GtkCssProvider, gtk_css_provider, G_TYPE_OBJECT, 0,
862 G_IMPLEMENT_INTERFACE (GTK_TYPE_STYLE_PROVIDER,
863 gtk_css_style_provider_iface_init));
866 gtk_css_provider_parsing_error (GtkCssProvider *provider,
870 const GError * error)
872 GtkCssProviderPrivate *priv = provider->priv;
876 priv->error = g_error_copy (error);
877 g_prefix_error (&priv->error, "%s:%u:%u: ", path ? path : "<unknown>", line, position);
882 gtk_css_provider_class_init (GtkCssProviderClass *klass)
884 GObjectClass *object_class = G_OBJECT_CLASS (klass);
887 * GtkCssProvider::parsing-error:
888 * @provider: the provider that had a parsing error
889 * @path: path to the parsed file or %NULL if the file cannot be
890 * identified or the data was not loaded from a file
891 * @line: line in the file or data or 0 if unknown
892 * @position: offset into the current line or 0 if unknown or the
893 * whole line is affected
894 * @error: The parsing error
896 * Signals that a parsing error occured. the @path, @line and @position
897 * describe the actual location of the error as accurately as possible.
899 * Parsing errors are never fatal, so the parsing will resume after
900 * the error. Errors may however cause parts of the given
901 * data or even all of it to not be parsed at all. So it is a useful idea
902 * to check that the parsing succeeds by connecting to this signal.
904 * Note that this signal may be emitted at any time as the css provider
905 * may opt to defer parsing parts or all of the input to a later time
906 * than when a loading function was called.
908 css_provider_signals[PARSING_ERROR] =
909 g_signal_new (I_("parsing-error"),
910 G_TYPE_FROM_CLASS (object_class),
912 G_STRUCT_OFFSET (GtkCssProviderClass, parsing_error),
914 _gtk_marshal_VOID__STRING_UINT_UINT_BOXED,
916 G_TYPE_STRING, G_TYPE_UINT, G_TYPE_UINT, G_TYPE_ERROR);
918 object_class->finalize = gtk_css_provider_finalize;
920 klass->parsing_error = gtk_css_provider_parsing_error;
922 g_type_class_add_private (object_class, sizeof (GtkCssProviderPrivate));
925 static SelectorPath *
926 selector_path_new (void)
930 path = g_slice_new0 (SelectorPath);
936 static SelectorPath *
937 selector_path_ref (SelectorPath *path)
944 selector_path_unref (SelectorPath *path)
948 if (path->ref_count > 0)
951 while (path->elements)
953 g_slice_free (SelectorElement, path->elements->data);
954 path->elements = g_slist_delete_link (path->elements, path->elements);
957 g_slice_free (SelectorPath, path);
961 selector_path_prepend_type (SelectorPath *path,
962 const gchar *type_name)
964 SelectorElement *elem;
967 elem = g_slice_new (SelectorElement);
968 elem->combinator = COMBINATOR_DESCENDANT;
969 type = g_type_from_name (type_name);
971 if (type == G_TYPE_INVALID)
973 elem->elem_type = SELECTOR_TYPE_NAME;
974 elem->name = g_quark_from_string (type_name);
978 elem->elem_type = SELECTOR_GTYPE;
982 path->elements = g_slist_prepend (path->elements, elem);
986 selector_path_prepend_glob (SelectorPath *path)
988 SelectorElement *elem;
990 elem = g_slice_new (SelectorElement);
991 elem->elem_type = SELECTOR_GLOB;
992 elem->combinator = COMBINATOR_DESCENDANT;
994 path->elements = g_slist_prepend (path->elements, elem);
998 selector_path_prepend_region (SelectorPath *path,
1000 GtkRegionFlags flags)
1002 SelectorElement *elem;
1004 elem = g_slice_new (SelectorElement);
1005 elem->combinator = COMBINATOR_DESCENDANT;
1006 elem->elem_type = SELECTOR_REGION;
1008 elem->region.name = g_quark_from_string (name);
1009 elem->region.flags = flags;
1011 path->elements = g_slist_prepend (path->elements, elem);
1015 selector_path_prepend_name (SelectorPath *path,
1018 SelectorElement *elem;
1020 elem = g_slice_new (SelectorElement);
1021 elem->combinator = COMBINATOR_DESCENDANT;
1022 elem->elem_type = SELECTOR_NAME;
1024 elem->name = g_quark_from_string (name);
1026 path->elements = g_slist_prepend (path->elements, elem);
1030 selector_path_prepend_class (SelectorPath *path,
1033 SelectorElement *elem;
1035 elem = g_slice_new (SelectorElement);
1036 elem->combinator = COMBINATOR_DESCENDANT;
1037 elem->elem_type = SELECTOR_CLASS;
1039 elem->name = g_quark_from_string (name);
1041 path->elements = g_slist_prepend (path->elements, elem);
1045 selector_path_prepend_combinator (SelectorPath *path,
1046 CombinatorType combinator)
1048 SelectorElement *elem;
1050 g_assert (path->elements != NULL);
1052 /* It is actually stored in the last element */
1053 elem = path->elements->data;
1054 elem->combinator = combinator;
1058 selector_path_depth (SelectorPath *path)
1060 return g_slist_length (path->elements);
1063 static SelectorStyleInfo *
1064 selector_style_info_new (SelectorPath *path)
1066 SelectorStyleInfo *info;
1068 info = g_slice_new0 (SelectorStyleInfo);
1069 info->path = selector_path_ref (path);
1075 selector_style_info_free (SelectorStyleInfo *info)
1078 g_hash_table_unref (info->style);
1081 selector_path_unref (info->path);
1083 g_slice_free (SelectorStyleInfo, info);
1087 selector_style_info_set_style (SelectorStyleInfo *info,
1091 g_hash_table_unref (info->style);
1094 info->style = g_hash_table_ref (style);
1100 property_value_free (GValue *value)
1102 if (G_IS_VALUE (value))
1103 g_value_unset (value);
1105 g_slice_free (GValue, value);
1109 gtk_css_scanner_reset (GScanner *scanner)
1111 GtkCssScannerPrivate *priv = scanner->user_data;
1113 g_slist_free (priv->state);
1116 g_slist_foreach (priv->cur_selectors, (GFunc) selector_path_unref, NULL);
1117 g_slist_free (priv->cur_selectors);
1118 priv->cur_selectors = NULL;
1120 if (priv->cur_properties)
1121 g_hash_table_unref (priv->cur_properties);
1123 priv->cur_properties = g_hash_table_new_full (g_str_hash,
1125 (GDestroyNotify) g_free,
1126 (GDestroyNotify) property_value_free);
1128 scanner_apply_scope (scanner, SCOPE_SELECTOR);
1132 gtk_css_scanner_destroy (GScanner *scanner)
1134 GtkCssScannerPrivate *priv = scanner->user_data;
1136 gtk_css_scanner_reset (scanner);
1138 g_hash_table_destroy (priv->cur_properties);
1139 g_slice_free (GtkCssScannerPrivate, priv);
1141 g_scanner_destroy (scanner);
1145 gtk_css_provider_create_scanner (GtkCssProvider *provider)
1147 GtkCssScannerPrivate *priv;
1150 scanner = g_scanner_new (NULL);
1152 priv = scanner->user_data = g_slice_new0 (GtkCssScannerPrivate);
1154 priv->cur_properties = g_hash_table_new_full (g_str_hash,
1156 (GDestroyNotify) g_free,
1157 (GDestroyNotify) property_value_free);
1159 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "active", GUINT_TO_POINTER (GTK_STATE_ACTIVE));
1160 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "prelight", GUINT_TO_POINTER (GTK_STATE_PRELIGHT));
1161 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "hover", GUINT_TO_POINTER (GTK_STATE_PRELIGHT));
1162 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "selected", GUINT_TO_POINTER (GTK_STATE_SELECTED));
1163 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "insensitive", GUINT_TO_POINTER (GTK_STATE_INSENSITIVE));
1164 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "inconsistent", GUINT_TO_POINTER (GTK_STATE_INCONSISTENT));
1165 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "focused", GUINT_TO_POINTER (GTK_STATE_FOCUSED));
1166 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "focus", GUINT_TO_POINTER (GTK_STATE_FOCUSED));
1168 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "nth-child", GUINT_TO_POINTER (SYMBOL_NTH_CHILD));
1169 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "first-child", GUINT_TO_POINTER (SYMBOL_FIRST_CHILD));
1170 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "last-child", GUINT_TO_POINTER (SYMBOL_LAST_CHILD));
1171 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "sorted", GUINT_TO_POINTER (SYMBOL_SORTED_CHILD));
1173 g_scanner_scope_add_symbol (scanner, SCOPE_NTH_CHILD, "even", GUINT_TO_POINTER (SYMBOL_NTH_CHILD_EVEN));
1174 g_scanner_scope_add_symbol (scanner, SCOPE_NTH_CHILD, "odd", GUINT_TO_POINTER (SYMBOL_NTH_CHILD_ODD));
1175 g_scanner_scope_add_symbol (scanner, SCOPE_NTH_CHILD, "first", GUINT_TO_POINTER (SYMBOL_NTH_CHILD_FIRST));
1176 g_scanner_scope_add_symbol (scanner, SCOPE_NTH_CHILD, "last", GUINT_TO_POINTER (SYMBOL_NTH_CHILD_LAST));
1178 scanner_apply_scope (scanner, SCOPE_SELECTOR);
1184 gtk_css_provider_init (GtkCssProvider *css_provider)
1186 GtkCssProviderPrivate *priv;
1188 priv = css_provider->priv = G_TYPE_INSTANCE_GET_PRIVATE (css_provider,
1189 GTK_TYPE_CSS_PROVIDER,
1190 GtkCssProviderPrivate);
1192 priv->selectors_info = g_ptr_array_new_with_free_func ((GDestroyNotify) selector_style_info_free);
1193 priv->scanner = gtk_css_provider_create_scanner (css_provider);
1195 priv->symbolic_colors = g_hash_table_new_full (g_str_hash, g_str_equal,
1196 (GDestroyNotify) g_free,
1197 (GDestroyNotify) gtk_symbolic_color_unref);
1200 typedef struct ComparePathData ComparePathData;
1202 struct ComparePathData
1210 compare_selector_element (GtkWidgetPath *path,
1212 SelectorElement *elem,
1217 if (elem->elem_type == SELECTOR_TYPE_NAME)
1219 const gchar *type_name;
1220 GType resolved_type;
1222 /* Resolve the type name */
1223 type_name = g_quark_to_string (elem->name);
1224 resolved_type = g_type_from_name (type_name);
1226 if (resolved_type == G_TYPE_INVALID)
1228 /* Type couldn't be resolved, so the selector
1229 * clearly doesn't affect the given widget path
1234 elem->elem_type = SELECTOR_GTYPE;
1235 elem->type = resolved_type;
1238 if (elem->elem_type == SELECTOR_GTYPE)
1242 type = gtk_widget_path_iter_get_object_type (path, index);
1244 if (!g_type_is_a (type, elem->type))
1247 if (type == elem->type)
1251 guint diff = g_type_depth (type) - g_type_depth (elem->type);
1253 if (G_UNLIKELY (diff > 0xE))
1255 g_warning ("Hierarchy is higher than expected.");
1259 *score = 0XF - diff;
1264 else if (elem->elem_type == SELECTOR_REGION)
1266 GtkRegionFlags flags;
1268 if (!gtk_widget_path_iter_has_qregion (path, index,
1273 if (elem->region.flags != 0 &&
1274 (flags & elem->region.flags) == 0)
1280 else if (elem->elem_type == SELECTOR_GLOB)
1282 /* Treat as lowest matching type */
1286 else if (elem->elem_type == SELECTOR_NAME)
1288 if (!gtk_widget_path_iter_has_qname (path, index, elem->name))
1294 else if (elem->elem_type == SELECTOR_CLASS)
1296 if (!gtk_widget_path_iter_has_qclass (path, index, elem->name))
1307 compare_selector (GtkWidgetPath *path,
1308 SelectorPath *selector)
1310 GSList *elements = selector->elements;
1311 gboolean match = TRUE, first = TRUE, first_match = FALSE;
1315 i = gtk_widget_path_length (path) - 1;
1317 while (elements && match && i >= 0)
1319 SelectorElement *elem;
1322 elem = elements->data;
1324 match = compare_selector_element (path, i, elem, &elem_score);
1329 /* Only move on to the next index if there is no match
1330 * with the current element (whether to continue or not
1331 * handled right after in the combinator check), or a
1332 * GType or glob has just been matched.
1334 * Region and widget names do not trigger this because
1335 * the next element in the selector path could also be
1336 * related to the same index.
1339 (elem->elem_type == SELECTOR_GTYPE ||
1340 elem->elem_type == SELECTOR_GLOB))
1344 elem->elem_type != SELECTOR_TYPE_NAME &&
1345 elem->combinator == COMBINATOR_DESCENDANT)
1347 /* With descendant combinators there may
1348 * be intermediate chidren in the hierarchy
1353 elements = elements->next;
1357 /* Only 4 bits are actually used */
1359 score |= elem_score;
1365 /* If there are pending selector
1366 * elements to compare, it's not
1374 else if (first_match)
1376 /* Assign more weight to these selectors
1377 * that matched right from the first element.
1385 typedef struct StylePriorityInfo StylePriorityInfo;
1387 struct StylePriorityInfo
1391 GtkStateFlags state;
1395 css_provider_get_selectors (GtkCssProvider *css_provider,
1396 GtkWidgetPath *path)
1398 GtkCssProviderPrivate *priv;
1399 GArray *priority_info;
1402 priv = css_provider->priv;
1403 priority_info = g_array_new (FALSE, FALSE, sizeof (StylePriorityInfo));
1405 for (i = 0; i < priv->selectors_info->len; i++)
1407 SelectorStyleInfo *info;
1408 StylePriorityInfo new;
1409 gboolean added = FALSE;
1412 info = g_ptr_array_index (priv->selectors_info, i);
1413 score = compare_selector (path, info->path);
1419 new.style = info->style;
1420 new.state = info->path->state;
1422 for (j = 0; j < priority_info->len; j++)
1424 StylePriorityInfo *cur;
1426 cur = &g_array_index (priority_info, StylePriorityInfo, j);
1428 if (cur->score > new.score)
1430 g_array_insert_val (priority_info, j, new);
1437 g_array_append_val (priority_info, new);
1440 return priority_info;
1444 css_provider_dump_symbolic_colors (GtkCssProvider *css_provider,
1445 GtkStyleProperties *props)
1447 GtkCssProviderPrivate *priv;
1448 GHashTableIter iter;
1449 gpointer key, value;
1451 priv = css_provider->priv;
1452 g_hash_table_iter_init (&iter, priv->symbolic_colors);
1454 while (g_hash_table_iter_next (&iter, &key, &value))
1457 GtkSymbolicColor *color;
1462 gtk_style_properties_map_color (props, name, color);
1466 static GtkStyleProperties *
1467 gtk_css_provider_get_style (GtkStyleProvider *provider,
1468 GtkWidgetPath *path)
1470 GtkCssProvider *css_provider;
1471 GtkStyleProperties *props;
1472 GArray *priority_info;
1475 css_provider = GTK_CSS_PROVIDER (provider);
1476 props = gtk_style_properties_new ();
1478 css_provider_dump_symbolic_colors (css_provider, props);
1479 priority_info = css_provider_get_selectors (css_provider, path);
1481 for (i = 0; i < priority_info->len; i++)
1483 StylePriorityInfo *info;
1484 GHashTableIter iter;
1485 gpointer key, value;
1487 info = &g_array_index (priority_info, StylePriorityInfo, i);
1488 g_hash_table_iter_init (&iter, info->style);
1490 while (g_hash_table_iter_next (&iter, &key, &value))
1494 /* Properties starting with '-' may be both widget style properties
1495 * or custom properties from the theming engine, so check whether
1496 * the type is registered or not.
1498 if (prop[0] == '-' &&
1499 !gtk_style_properties_lookup_property (prop, NULL, NULL))
1502 gtk_style_properties_set_property (props, key, info->state, value);
1506 g_array_free (priority_info, TRUE);
1512 gtk_css_provider_get_style_property (GtkStyleProvider *provider,
1513 GtkWidgetPath *path,
1514 GtkStateFlags state,
1518 GArray *priority_info;
1519 gboolean found = FALSE;
1523 prop_name = g_strdup_printf ("-%s-%s",
1524 g_type_name (pspec->owner_type),
1527 priority_info = css_provider_get_selectors (GTK_CSS_PROVIDER (provider), path);
1529 for (i = priority_info->len - 1; i >= 0; i--)
1531 StylePriorityInfo *info;
1534 info = &g_array_index (priority_info, StylePriorityInfo, i);
1535 val = g_hash_table_lookup (info->style, prop_name);
1538 (info->state == 0 ||
1539 info->state == state ||
1540 ((info->state & state) != 0 &&
1541 (info->state & ~(state)) == 0)))
1543 GError *error = NULL;
1545 found = _gtk_css_value_from_string (value,
1547 g_value_get_string (val),
1553 gtk_css_provider_take_error (GTK_CSS_PROVIDER (provider), NULL, error);
1557 g_array_free (priority_info, TRUE);
1564 gtk_css_style_provider_iface_init (GtkStyleProviderIface *iface)
1566 iface->get_style = gtk_css_provider_get_style;
1567 iface->get_style_property = gtk_css_provider_get_style_property;
1571 gtk_css_provider_finalize (GObject *object)
1573 GtkCssProvider *css_provider;
1574 GtkCssProviderPrivate *priv;
1576 css_provider = GTK_CSS_PROVIDER (object);
1577 priv = css_provider->priv;
1579 css_provider_reset_parser (css_provider);
1581 gtk_css_scanner_destroy (priv->scanner);
1583 g_ptr_array_free (priv->selectors_info, TRUE);
1585 if (priv->symbolic_colors)
1586 g_hash_table_destroy (priv->symbolic_colors);
1588 G_OBJECT_CLASS (gtk_css_provider_parent_class)->finalize (object);
1592 * gtk_css_provider_new:
1594 * Returns a newly created #GtkCssProvider.
1596 * Returns: A new #GtkCssProvider
1599 gtk_css_provider_new (void)
1601 return g_object_new (GTK_TYPE_CSS_PROVIDER, NULL);
1605 gtk_css_provider_take_error (GtkCssProvider *provider,
1609 const char *filename;
1610 guint line, position;
1614 filename = scanner->input_name;
1615 line = scanner->line;
1616 position = scanner->position;
1625 g_signal_emit (provider, css_provider_signals[PARSING_ERROR], 0,
1626 filename, line, position, error);
1628 g_error_free (error);
1632 gtk_css_provider_error_literal (GtkCssProvider *provider,
1636 const char *message)
1638 gtk_css_provider_take_error (provider,
1640 g_error_new_literal (domain, code, message));
1644 gtk_css_provider_error (GtkCssProvider *provider,
1649 ...) G_GNUC_PRINTF (5, 6);
1651 gtk_css_provider_error (GtkCssProvider *provider,
1661 va_start (args, format);
1662 error = g_error_new_valist (domain, code, format, args);
1665 gtk_css_provider_take_error (provider, scanner, error);
1669 gtk_css_provider_invalid_token (GtkCssProvider *provider,
1671 const char *expected)
1673 gtk_css_provider_error (provider,
1675 GTK_CSS_PROVIDER_ERROR,
1676 GTK_CSS_PROVIDER_ERROR_SYNTAX,
1677 "expected a valid %s", expected);
1681 scanner_apply_scope (GScanner *scanner,
1684 g_scanner_set_scope (scanner, scope);
1686 if (scope == SCOPE_VALUE)
1688 scanner->config->cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "@#-_";
1689 scanner->config->cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "@#-_ +(),.%\t\n'/\"";
1690 scanner->config->scan_identifier_1char = TRUE;
1692 else if (scope == SCOPE_BINDING_SET)
1694 scanner->config->cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "@#-_";
1695 scanner->config->cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "@#-_ +(){}<>,.%\t\n'/\"";
1696 scanner->config->scan_identifier_1char = TRUE;
1698 else if (scope == SCOPE_SELECTOR)
1700 scanner->config->cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z "*@";
1701 scanner->config->cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "-_#.";
1702 scanner->config->scan_identifier_1char = TRUE;
1704 else if (scope == SCOPE_PSEUDO_CLASS ||
1705 scope == SCOPE_NTH_CHILD ||
1706 scope == SCOPE_DECLARATION)
1708 scanner->config->cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z "-_";
1709 scanner->config->cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "-_";
1710 scanner->config->scan_identifier_1char = FALSE;
1713 g_assert_not_reached ();
1715 scanner->config->scan_float = FALSE;
1716 scanner->config->cpair_comment_single = NULL;
1720 gtk_css_scanner_push_scope (GScanner *scanner,
1723 GtkCssScannerPrivate *priv;
1725 priv = scanner->user_data;
1726 priv->state = g_slist_prepend (priv->state, GUINT_TO_POINTER (scope));
1728 scanner_apply_scope (scanner, scope);
1732 gtk_css_scanner_pop_scope (GScanner *scanner)
1734 GtkCssScannerPrivate *priv;
1735 ParserScope scope = SCOPE_SELECTOR;
1737 priv = scanner->user_data;
1741 g_warning ("Push/pop calls to parser scope aren't paired");
1742 scanner_apply_scope (scanner, SCOPE_SELECTOR);
1746 priv->state = g_slist_delete_link (priv->state, priv->state);
1748 /* Fetch new scope */
1750 scope = GPOINTER_TO_INT (priv->state->data);
1752 scanner_apply_scope (scanner, scope);
1756 css_provider_reset_parser (GtkCssProvider *css_provider)
1758 GtkCssProviderPrivate *priv;
1760 priv = css_provider->priv;
1762 gtk_css_scanner_reset (priv->scanner);
1765 g_error_free (priv->error);
1770 css_provider_commit (GtkCssProvider *css_provider,
1773 GtkCssScannerPrivate *scanner_priv;
1774 GtkCssProviderPrivate *priv;
1777 priv = css_provider->priv;
1778 scanner_priv = scanner->user_data;
1780 l = scanner_priv->cur_selectors;
1782 if (g_hash_table_size (scanner_priv->cur_properties) == 0)
1787 SelectorPath *path = l->data;
1788 SelectorStyleInfo *info;
1790 info = selector_style_info_new (path);
1791 selector_style_info_set_style (info, scanner_priv->cur_properties);
1793 g_ptr_array_add (priv->selectors_info, info);
1799 parse_nth_child (GtkCssProvider *css_provider,
1801 GtkRegionFlags *flags)
1803 ParserSymbol symbol;
1805 g_scanner_get_next_token (scanner);
1807 if (scanner->token != G_TOKEN_SYMBOL)
1808 return G_TOKEN_SYMBOL;
1810 symbol = GPOINTER_TO_INT (scanner->value.v_symbol);
1812 if (symbol == SYMBOL_NTH_CHILD)
1814 g_scanner_get_next_token (scanner);
1816 if (scanner->token != G_TOKEN_LEFT_PAREN)
1817 return G_TOKEN_LEFT_PAREN;
1819 gtk_css_scanner_push_scope (scanner, SCOPE_NTH_CHILD);
1820 g_scanner_get_next_token (scanner);
1822 if (scanner->token != G_TOKEN_SYMBOL)
1823 return G_TOKEN_SYMBOL;
1825 symbol = GPOINTER_TO_INT (scanner->value.v_symbol);
1829 case SYMBOL_NTH_CHILD_EVEN:
1830 *flags = GTK_REGION_EVEN;
1832 case SYMBOL_NTH_CHILD_ODD:
1833 *flags = GTK_REGION_ODD;
1835 case SYMBOL_NTH_CHILD_FIRST:
1836 *flags = GTK_REGION_FIRST;
1838 case SYMBOL_NTH_CHILD_LAST:
1839 *flags = GTK_REGION_LAST;
1845 g_scanner_get_next_token (scanner);
1847 if (scanner->token != G_TOKEN_RIGHT_PAREN)
1848 return G_TOKEN_RIGHT_PAREN;
1850 gtk_css_scanner_pop_scope (scanner);
1852 else if (symbol == SYMBOL_FIRST_CHILD)
1853 *flags = GTK_REGION_FIRST;
1854 else if (symbol == SYMBOL_LAST_CHILD)
1855 *flags = GTK_REGION_LAST;
1856 else if (symbol == SYMBOL_SORTED_CHILD)
1857 *flags = GTK_REGION_SORTED;
1861 return G_TOKEN_SYMBOL;
1864 return G_TOKEN_NONE;
1868 parse_pseudo_class (GtkCssProvider *css_provider,
1870 SelectorPath *selector)
1874 g_scanner_get_next_token (scanner);
1876 if (scanner->token != G_TOKEN_SYMBOL)
1877 return G_TOKEN_SYMBOL;
1879 state = GPOINTER_TO_INT (scanner->value.v_symbol);
1883 case GTK_STATE_ACTIVE:
1884 selector->state |= GTK_STATE_FLAG_ACTIVE;
1886 case GTK_STATE_PRELIGHT:
1887 selector->state |= GTK_STATE_FLAG_PRELIGHT;
1889 case GTK_STATE_SELECTED:
1890 selector->state |= GTK_STATE_FLAG_SELECTED;
1892 case GTK_STATE_INSENSITIVE:
1893 selector->state |= GTK_STATE_FLAG_INSENSITIVE;
1895 case GTK_STATE_INCONSISTENT:
1896 selector->state |= GTK_STATE_FLAG_INCONSISTENT;
1898 case GTK_STATE_FOCUSED:
1899 selector->state |= GTK_STATE_FLAG_FOCUSED;
1902 return G_TOKEN_SYMBOL;
1905 return G_TOKEN_NONE;
1908 /* Parses a number of concatenated classes */
1910 parse_classes (SelectorPath *path,
1915 if ((pos = strchr (str, '.')) != NULL)
1917 /* Leave the last class to the call after the loop */
1921 selector_path_prepend_class (path, str);
1924 pos = strchr (str, '.');
1928 selector_path_prepend_class (path, str);
1932 is_widget_class_name (const gchar *str)
1934 /* Do a pretty lax check here, not all
1935 * widget class names contain only CamelCase
1936 * (gtkmm widgets don't), but at least part of
1937 * the name will be CamelCase, so check for
1938 * the first uppercase char
1942 if (g_ascii_isupper (*str))
1952 parse_selector (GtkCssProvider *css_provider,
1954 SelectorPath **selector_out)
1958 path = selector_path_new ();
1959 *selector_out = path;
1961 if (scanner->token != ':' &&
1962 scanner->token != '#' &&
1963 scanner->token != '.' &&
1964 scanner->token != G_TOKEN_IDENTIFIER)
1965 return G_TOKEN_IDENTIFIER;
1967 while (scanner->token == '#' ||
1968 scanner->token == '.' ||
1969 scanner->token == G_TOKEN_IDENTIFIER)
1971 if (scanner->token == '#' ||
1972 scanner->token == '.')
1977 is_class = (scanner->token == '.');
1979 g_scanner_get_next_token (scanner);
1981 if (scanner->token != G_TOKEN_IDENTIFIER)
1982 return G_TOKEN_IDENTIFIER;
1984 selector_path_prepend_glob (path);
1985 selector_path_prepend_combinator (path, COMBINATOR_CHILD);
1988 parse_classes (path, scanner->value.v_identifier);
1991 if ((pos = strchr (scanner->value.v_identifier, '.')) != NULL)
1994 selector_path_prepend_name (path, scanner->value.v_identifier);
1996 /* Parse any remaining classes */
1998 parse_classes (path, pos + 1);
2001 else if (is_widget_class_name (scanner->value.v_identifier))
2005 if ((pos = strchr (scanner->value.v_identifier, '#')) != NULL ||
2006 (pos = strchr (scanner->value.v_identifier, '.')) != NULL)
2008 gchar *type_name, *name;
2011 is_class = (*pos == '.');
2013 /* Widget type and name/class put together */
2016 type_name = scanner->value.v_identifier;
2018 selector_path_prepend_type (path, type_name);
2020 /* This is only so there is a direct relationship
2021 * between widget type and its name.
2023 selector_path_prepend_combinator (path, COMBINATOR_CHILD);
2026 parse_classes (path, name);
2029 if ((pos = strchr (name, '.')) != NULL)
2032 selector_path_prepend_name (path, name);
2034 /* Parse any remaining classes */
2036 parse_classes (path, pos + 1);
2040 selector_path_prepend_type (path, scanner->value.v_identifier);
2042 else if (_gtk_style_context_check_region_name (scanner->value.v_identifier))
2044 GtkRegionFlags flags = 0;
2047 region_name = g_strdup (scanner->value.v_identifier);
2049 if (g_scanner_peek_next_token (scanner) == ':')
2051 ParserSymbol symbol;
2053 g_scanner_get_next_token (scanner);
2054 gtk_css_scanner_push_scope (scanner, SCOPE_PSEUDO_CLASS);
2056 /* Check for the next token being nth-child, parse in that
2057 * case, and fallback into common state parsing if not.
2059 if (g_scanner_peek_next_token (scanner) != G_TOKEN_SYMBOL)
2060 return G_TOKEN_SYMBOL;
2062 symbol = GPOINTER_TO_INT (scanner->next_value.v_symbol);
2064 if (symbol == SYMBOL_FIRST_CHILD ||
2065 symbol == SYMBOL_LAST_CHILD ||
2066 symbol == SYMBOL_NTH_CHILD ||
2067 symbol == SYMBOL_SORTED_CHILD)
2071 if ((token = parse_nth_child (css_provider, scanner, &flags)) != G_TOKEN_NONE)
2074 gtk_css_scanner_pop_scope (scanner);
2078 gtk_css_scanner_pop_scope (scanner);
2079 selector_path_prepend_region (path, region_name, 0);
2080 g_free (region_name);
2085 selector_path_prepend_region (path, region_name, flags);
2086 g_free (region_name);
2088 else if (scanner->value.v_identifier[0] == '*')
2089 selector_path_prepend_glob (path);
2091 return G_TOKEN_IDENTIFIER;
2093 g_scanner_get_next_token (scanner);
2095 if (scanner->token == '>')
2097 selector_path_prepend_combinator (path, COMBINATOR_CHILD);
2098 g_scanner_get_next_token (scanner);
2102 if (scanner->token == ':')
2104 /* Add glob selector if path is empty */
2105 if (selector_path_depth (path) == 0)
2106 selector_path_prepend_glob (path);
2108 gtk_css_scanner_push_scope (scanner, SCOPE_PSEUDO_CLASS);
2110 while (scanner->token == ':')
2114 if ((token = parse_pseudo_class (css_provider, scanner, path)) != G_TOKEN_NONE)
2117 g_scanner_get_next_token (scanner);
2120 gtk_css_scanner_pop_scope (scanner);
2123 return G_TOKEN_NONE;
2127 resolve_binding_sets (const gchar *value_str,
2131 gchar **bindings, **str;
2133 bindings = g_strsplit (value_str, ",", -1);
2134 array = g_ptr_array_new ();
2136 for (str = bindings; *str; str++)
2138 GtkBindingSet *binding_set;
2140 binding_set = gtk_binding_set_find (g_strstrip (*str));
2145 g_ptr_array_add (array, binding_set);
2148 g_value_take_boxed (value, array);
2149 g_strfreev (bindings);
2153 parse_rule (GtkCssProvider *css_provider,
2156 GtkCssScannerPrivate *priv;
2157 GTokenType expected_token;
2158 SelectorPath *selector;
2160 priv = scanner->user_data;
2162 gtk_css_scanner_push_scope (scanner, SCOPE_SELECTOR);
2164 /* Handle directives */
2165 if (scanner->token == G_TOKEN_IDENTIFIER &&
2166 scanner->value.v_identifier[0] == '@')
2170 directive = &scanner->value.v_identifier[1];
2172 if (strcmp (directive, "define-color") == 0)
2174 GtkSymbolicColor *color;
2175 gchar *color_name, *color_str;
2176 GError *error = NULL;
2178 /* Directive is a color mapping */
2179 g_scanner_get_next_token (scanner);
2181 if (scanner->token != G_TOKEN_IDENTIFIER)
2183 gtk_css_provider_invalid_token (css_provider, scanner, "Color name");
2184 return G_TOKEN_IDENTIFIER;
2187 color_name = g_strdup (scanner->value.v_identifier);
2188 gtk_css_scanner_push_scope (scanner, SCOPE_VALUE);
2189 g_scanner_get_next_token (scanner);
2191 if (scanner->token != G_TOKEN_IDENTIFIER)
2193 gtk_css_provider_invalid_token (css_provider, scanner, "Color definition");
2194 return G_TOKEN_IDENTIFIER;
2197 color_str = g_strstrip (scanner->value.v_identifier);
2198 color = _gtk_css_parse_symbolic_color (color_str, &error);
2201 gtk_css_provider_take_error (css_provider, scanner, error);
2202 return G_TOKEN_IDENTIFIER;
2205 g_hash_table_insert (css_provider->priv->symbolic_colors, color_name, color);
2207 gtk_css_scanner_pop_scope (scanner);
2208 g_scanner_get_next_token (scanner);
2210 if (scanner->token != ';')
2213 return G_TOKEN_NONE;
2215 else if (strcmp (directive, "import") == 0)
2217 GScanner *new_scanner;
2220 GFile *base, *actual;
2222 GError *error = NULL;
2224 gtk_css_scanner_push_scope (scanner, SCOPE_VALUE);
2225 g_scanner_get_next_token (scanner);
2227 if (scanner->token == G_TOKEN_IDENTIFIER &&
2228 g_str_has_prefix (scanner->value.v_identifier, "url"))
2229 path = g_strstrip (scanner->value.v_identifier);
2230 else if (scanner->token == G_TOKEN_STRING)
2231 path = g_strstrip (scanner->value.v_string);
2234 gtk_css_provider_invalid_token (css_provider, scanner, "File URL");
2235 return G_TOKEN_IDENTIFIER;
2238 if (scanner->input_name)
2239 dirname = g_path_get_dirname (scanner->input_name);
2241 dirname = g_get_current_dir ();
2243 base = g_file_new_for_path (dirname);
2246 actual = _gtk_css_parse_url (base, path, NULL, &error);
2247 g_object_unref (base);
2251 gtk_css_provider_take_error (css_provider, scanner, error);
2252 return G_TOKEN_IDENTIFIER;
2255 gtk_css_scanner_pop_scope (scanner);
2256 g_scanner_get_next_token (scanner);
2258 if (scanner->token != ';')
2260 g_object_unref (actual);
2264 path = g_file_get_path (actual);
2265 g_object_unref (actual);
2267 new_scanner = gtk_css_provider_create_scanner (css_provider);
2268 css_provider->priv->scanner = new_scanner;
2270 /* FIXME: Avoid recursive importing */
2271 loaded = gtk_css_provider_load_from_path_internal (css_provider, path,
2274 /* Restore previous state */
2275 css_provider_reset_parser (css_provider);
2276 gtk_css_scanner_destroy (new_scanner);
2277 css_provider->priv->scanner = scanner;
2282 return G_TOKEN_IDENTIFIER;
2284 return G_TOKEN_NONE;
2286 else if (strcmp (directive, "binding-set") == 0)
2288 GtkBindingSet *binding_set;
2289 gchar *binding_set_name;
2291 g_scanner_get_next_token (scanner);
2293 if (scanner->token != G_TOKEN_IDENTIFIER)
2295 gtk_css_provider_invalid_token (css_provider, scanner, "Binding name");
2296 return G_TOKEN_IDENTIFIER;
2299 binding_set_name = scanner->value.v_identifier;
2300 binding_set = gtk_binding_set_find (binding_set_name);
2304 binding_set = gtk_binding_set_new (binding_set_name);
2305 binding_set->parsed = TRUE;
2308 g_scanner_get_next_token (scanner);
2310 if (scanner->token != G_TOKEN_LEFT_CURLY)
2311 return G_TOKEN_LEFT_CURLY;
2313 gtk_css_scanner_push_scope (scanner, SCOPE_BINDING_SET);
2314 g_scanner_get_next_token (scanner);
2320 if (scanner->token != G_TOKEN_IDENTIFIER)
2322 gtk_css_provider_invalid_token (css_provider, scanner, "Binding definition");
2323 return G_TOKEN_IDENTIFIER;
2326 ret = gtk_binding_entry_add_signal_from_string (binding_set,
2327 scanner->value.v_identifier);
2328 if (ret != G_TOKEN_NONE)
2330 gtk_css_provider_invalid_token (css_provider, scanner, "Binding definition");
2334 g_scanner_get_next_token (scanner);
2336 if (scanner->token != ';')
2339 g_scanner_get_next_token (scanner);
2341 while (scanner->token != G_TOKEN_RIGHT_CURLY);
2343 gtk_css_scanner_pop_scope (scanner);
2344 g_scanner_get_next_token (scanner);
2346 return G_TOKEN_NONE;
2350 gtk_css_provider_invalid_token (css_provider, scanner, "Directive");
2351 return G_TOKEN_IDENTIFIER;
2355 expected_token = parse_selector (css_provider, scanner, &selector);
2357 if (expected_token != G_TOKEN_NONE)
2359 selector_path_unref (selector);
2360 gtk_css_provider_invalid_token (css_provider, scanner, "Selector");
2361 return expected_token;
2364 priv->cur_selectors = g_slist_prepend (priv->cur_selectors, selector);
2366 while (scanner->token == ',')
2368 g_scanner_get_next_token (scanner);
2370 expected_token = parse_selector (css_provider, scanner, &selector);
2372 if (expected_token != G_TOKEN_NONE)
2374 selector_path_unref (selector);
2375 gtk_css_provider_invalid_token (css_provider, scanner, "Selector");
2376 return expected_token;
2379 priv->cur_selectors = g_slist_prepend (priv->cur_selectors, selector);
2382 gtk_css_scanner_pop_scope (scanner);
2384 if (scanner->token != G_TOKEN_LEFT_CURLY)
2385 return G_TOKEN_LEFT_CURLY;
2387 /* Declarations parsing */
2388 gtk_css_scanner_push_scope (scanner, SCOPE_DECLARATION);
2390 g_scanner_get_next_token (scanner);
2392 while (scanner->token != G_TOKEN_RIGHT_CURLY &&
2393 !g_scanner_eof (scanner))
2395 gchar *value_str = NULL;
2396 GtkStylePropertyParser parse_func = NULL;
2397 GParamSpec *pspec = NULL;;
2400 if (scanner->token == ';')
2402 g_scanner_get_next_token (scanner);
2406 if (scanner->token != G_TOKEN_IDENTIFIER)
2408 gtk_css_provider_error_literal (css_provider,
2410 GTK_CSS_PROVIDER_ERROR,
2411 GTK_CSS_PROVIDER_ERROR_PROPERTY_NAME,
2412 "Expected a valid property name");
2413 goto find_end_of_declaration;
2416 prop = g_strdup (scanner->value.v_identifier);
2418 if (!gtk_style_properties_lookup_property (prop, &parse_func, &pspec) &&
2421 gtk_css_provider_error (css_provider,
2423 GTK_CSS_PROVIDER_ERROR,
2424 GTK_CSS_PROVIDER_ERROR_PROPERTY_NAME,
2425 "'%s' is not a valid property name",
2428 goto find_end_of_declaration;
2431 g_scanner_get_next_token (scanner);
2433 if (scanner->token != ':')
2436 gtk_css_provider_invalid_token (css_provider, scanner, "':'");
2437 goto find_end_of_declaration;
2440 gtk_css_scanner_push_scope (scanner, SCOPE_VALUE);
2441 g_scanner_get_next_token (scanner);
2443 if (scanner->token != G_TOKEN_IDENTIFIER)
2446 /* the error value here is hacky. But strings should be used for
2447 * strings really, so a string is not a syntax error but a broken
2448 * value for everything that we support. */
2449 gtk_css_provider_error (css_provider,
2451 GTK_CSS_PROVIDER_ERROR,
2452 scanner->token == G_TOKEN_STRING ? GTK_CSS_PROVIDER_ERROR_PROPERTY_VALUE
2453 : GTK_CSS_PROVIDER_ERROR_SYNTAX,
2454 "Not a property value");
2455 gtk_css_scanner_pop_scope (scanner);
2456 goto find_end_of_declaration;
2459 value_str = scanner->value.v_identifier;
2460 g_strchomp (value_str);
2462 gtk_css_scanner_pop_scope (scanner);
2463 g_scanner_peek_next_token (scanner);
2465 if (scanner->next_token != ';' &&
2466 scanner->next_token != G_TOKEN_RIGHT_CURLY &&
2467 scanner->next_token != G_TOKEN_EOF)
2469 gtk_css_provider_invalid_token (css_provider, scanner, "';'");
2471 goto find_end_of_declaration;
2478 val = g_slice_new0 (GValue);
2479 g_value_init (val, pspec->value_type);
2481 if (strcmp (value_str, "none") == 0)
2483 /* Insert the default value, so it has an opportunity
2484 * to override other style providers when merged
2486 g_param_value_set_default (pspec, val);
2487 g_hash_table_insert (priv->cur_properties, prop, val);
2489 else if (strcmp (prop, "gtk-key-bindings") == 0)
2491 /* Private property holding the binding sets */
2492 resolve_binding_sets (value_str, val);
2493 g_hash_table_insert (priv->cur_properties, prop, val);
2495 else if (pspec->value_type == G_TYPE_STRING)
2497 g_value_set_string (val, value_str);
2498 g_hash_table_insert (priv->cur_properties, prop, val);
2500 else if (parse_func)
2502 GError *error = NULL;
2504 if ((*parse_func) (value_str, val, &error))
2505 g_hash_table_insert (priv->cur_properties, prop, val);
2507 gtk_css_provider_take_error (css_provider, scanner, error);
2511 GError *error = NULL;
2516 if (scanner->input_name)
2517 dirname = g_path_get_dirname (scanner->input_name);
2519 dirname = g_get_current_dir ();
2521 base = g_file_new_for_path (dirname);
2524 success = _gtk_css_value_from_string (val,
2529 g_object_unref (base);
2533 g_hash_table_insert (priv->cur_properties, prop, val);
2537 g_value_unset (val);
2538 g_slice_free (GValue, val);
2541 gtk_css_provider_take_error (css_provider, scanner, error);
2545 else if (prop[0] == '-')
2549 val = g_slice_new0 (GValue);
2550 g_value_init (val, G_TYPE_STRING);
2551 g_value_set_string (val, value_str);
2553 g_hash_table_insert (priv->cur_properties, prop, val);
2558 g_scanner_get_next_token (scanner);
2560 if (g_scanner_eof (scanner))
2562 gtk_css_provider_invalid_token (css_provider, scanner, "}");
2566 find_end_of_declaration:
2567 while (scanner->token != ';' &&
2568 scanner->token != G_TOKEN_RIGHT_CURLY &&
2569 !g_scanner_eof (scanner))
2570 g_scanner_get_next_token (scanner);
2573 gtk_css_scanner_pop_scope (scanner);
2575 return G_TOKEN_NONE;
2579 gtk_css_provider_reset (GtkCssProvider *css_provider)
2581 GtkCssProviderPrivate *priv;
2583 priv = css_provider->priv;
2585 if (priv->selectors_info->len > 0)
2586 g_ptr_array_remove_range (priv->selectors_info, 0, priv->selectors_info->len);
2591 parse_stylesheet (GtkCssProvider *css_provider,
2595 GtkCssProviderPrivate *priv;
2600 priv = css_provider->priv;
2601 g_scanner_get_next_token (scanner);
2603 while (!g_scanner_eof (scanner))
2605 GTokenType expected_token;
2607 css_provider_reset_parser (css_provider);
2608 expected_token = parse_rule (css_provider, scanner);
2610 if (expected_token != G_TOKEN_NONE)
2612 /* If a GError was passed in, propagate the error and bail out,
2613 * else report a warning and keep going
2619 g_propagate_error (error, priv->error);
2621 g_set_error_literal (error,
2622 GTK_CSS_PROVIDER_ERROR,
2623 GTK_CSS_PROVIDER_ERROR_FAILED,
2624 "Error parsing stylesheet");
2629 g_clear_error (&priv->error);
2633 css_provider_reset_parser (css_provider);
2635 while (!g_scanner_eof (scanner) &&
2636 scanner->token != G_TOKEN_RIGHT_CURLY)
2637 g_scanner_get_next_token (scanner);
2640 css_provider_commit (css_provider, scanner);
2642 g_scanner_get_next_token (scanner);
2649 * gtk_css_provider_load_from_data:
2650 * @css_provider: a #GtkCssProvider
2651 * @data: CSS data loaded in memory
2652 * @length: the length of @data in bytes, or -1 for NUL terminated strings
2653 * @error: (out) (allow-none): return location for a #GError, or %NULL
2655 * Loads @data into @css_provider, making it clear any previously loaded
2658 * Returns: %TRUE if the data could be loaded.
2661 gtk_css_provider_load_from_data (GtkCssProvider *css_provider,
2666 GtkCssProviderPrivate *priv;
2668 g_return_val_if_fail (GTK_IS_CSS_PROVIDER (css_provider), FALSE);
2669 g_return_val_if_fail (data != NULL, FALSE);
2671 priv = css_provider->priv;
2674 length = strlen (data);
2676 gtk_css_provider_reset (css_provider);
2678 priv->scanner->input_name = NULL;
2679 g_scanner_input_text (priv->scanner, data, (guint) length);
2681 return parse_stylesheet (css_provider, priv->scanner, error);
2685 * gtk_css_provider_load_from_file:
2686 * @css_provider: a #GtkCssProvider
2687 * @file: #GFile pointing to a file to load
2688 * @error: (out) (allow-none): return location for a #GError, or %NULL
2690 * Loads the data contained in @file into @css_provider, making it
2691 * clear any previously loaded information.
2693 * Returns: %TRUE if the data could be loaded.
2696 gtk_css_provider_load_from_file (GtkCssProvider *css_provider,
2700 GtkCssProviderPrivate *priv;
2701 GError *internal_error = NULL;
2707 g_return_val_if_fail (GTK_IS_CSS_PROVIDER (css_provider), FALSE);
2708 g_return_val_if_fail (G_IS_FILE (file), FALSE);
2710 priv = css_provider->priv;
2712 if (!g_file_load_contents (file, NULL,
2714 NULL, &internal_error))
2716 g_propagate_error (error, internal_error);
2720 gtk_css_provider_reset (css_provider);
2722 path = g_file_get_path (file);
2723 priv->scanner->input_name = path;
2724 g_scanner_input_text (priv->scanner, data, (guint) length);
2726 ret = parse_stylesheet (css_provider, priv->scanner, error);
2729 priv->scanner->input_name = NULL;
2736 gtk_css_provider_load_from_path_internal (GtkCssProvider *css_provider,
2741 GtkCssProviderPrivate *priv;
2742 GError *internal_error = NULL;
2743 GMappedFile *mapped_file;
2748 priv = css_provider->priv;
2750 mapped_file = g_mapped_file_new (path, FALSE, &internal_error);
2754 g_propagate_error (error, internal_error);
2758 length = g_mapped_file_get_length (mapped_file);
2759 data = g_mapped_file_get_contents (mapped_file);
2765 gtk_css_provider_reset (css_provider);
2767 priv->scanner->input_name = path;
2768 g_scanner_input_text (priv->scanner, data, (guint) length);
2770 ret = parse_stylesheet (css_provider, priv->scanner, error);
2772 priv->scanner->input_name = NULL;
2774 g_mapped_file_unref (mapped_file);
2780 * gtk_css_provider_load_from_path:
2781 * @css_provider: a #GtkCssProvider
2782 * @path: the path of a filename to load, in the GLib filename encoding
2783 * @error: (out) (allow-none): return location for a #GError, or %NULL
2785 * Loads the data contained in @path into @css_provider, making it clear
2786 * any previously loaded information.
2788 * Returns: %TRUE if the data could be loaded.
2791 gtk_css_provider_load_from_path (GtkCssProvider *css_provider,
2795 g_return_val_if_fail (GTK_IS_CSS_PROVIDER (css_provider), FALSE);
2796 g_return_val_if_fail (path != NULL, FALSE);
2798 return gtk_css_provider_load_from_path_internal (css_provider, path,
2803 * gtk_css_provider_get_default:
2805 * Returns the provider containing the style settings used as a
2806 * fallback for all widgets.
2808 * Returns: (transfer none): The provider used for fallback styling.
2809 * This memory is owned by GTK+, and you must not free it.
2812 gtk_css_provider_get_default (void)
2814 static GtkCssProvider *provider;
2816 if (G_UNLIKELY (!provider))
2819 "@define-color fg_color #000; \n"
2820 "@define-color bg_color #dcdad5; \n"
2821 "@define-color text_color #000; \n"
2822 "@define-color base_color #fff; \n"
2823 "@define-color selected_bg_color #4b6983; \n"
2824 "@define-color selected_fg_color #fff; \n"
2825 "@define-color tooltip_bg_color #eee1b3; \n"
2826 "@define-color tooltip_fg_color #000; \n"
2827 "@define-color placeholder_text_color #808080; \n"
2829 "@define-color info_fg_color rgb (181, 171, 156);\n"
2830 "@define-color info_bg_color rgb (252, 252, 189);\n"
2831 "@define-color warning_fg_color rgb (173, 120, 41);\n"
2832 "@define-color warning_bg_color rgb (250, 173, 61);\n"
2833 "@define-color question_fg_color rgb (97, 122, 214);\n"
2834 "@define-color question_bg_color rgb (138, 173, 212);\n"
2835 "@define-color error_fg_color rgb (166, 38, 38);\n"
2836 "@define-color error_bg_color rgb (237, 54, 54);\n"
2839 " background-color: @bg_color;\n"
2840 " color: @fg_color;\n"
2841 " border-color: shade (@bg_color, 0.6);\n"
2843 " border-width: 0;\n"
2847 " background-color: shade (@bg_color, 1.05);\n"
2848 " color: shade (@fg_color, 1.3);\n"
2852 " background-color: @selected_bg_color;\n"
2853 " color: @selected_fg_color;\n"
2856 ".expander, GtkTreeView.view.expander {\n"
2860 ".expander:prelight,\n"
2861 "GtkTreeView.view.expander:selected:prelight {\n"
2862 " color: @text_color;\n"
2865 ".expander:active {\n"
2866 " transition: 200ms linear;\n"
2870 " border-color: shade (@bg_color, 0.7);\n"
2871 " background-color: shade (@bg_color, 0.9);\n"
2872 " color: shade (@bg_color, 0.7);\n"
2876 " border-width: 0;\n"
2877 " border-radius: 0;\n"
2878 " background-color: @base_color;\n"
2879 " color: @text_color;\n"
2881 ".view:selected {\n"
2882 " background-color: shade (@bg_color, 0.9);\n"
2883 " color: @fg_color;\n"
2886 ".view:selected:focused {\n"
2887 " background-color: @selected_bg_color;\n"
2888 " color: @selected_fg_color;\n"
2891 ".view column:sorted row,\n"
2892 ".view column:sorted row:prelight {\n"
2893 " background-color: shade (@bg_color, 0.85);\n"
2896 ".view column:sorted row:nth-child(odd),\n"
2897 ".view column:sorted row:nth-child(odd):prelight {\n"
2898 " background-color: shade (@bg_color, 0.8);\n"
2902 ".view row:prelight {\n"
2903 " background-color: @base_color;\n"
2904 " color: @text_color;\n"
2907 ".view row:nth-child(odd),\n"
2908 ".view row:nth-child(odd):prelight {\n"
2909 " background-color: shade (@base_color, 0.93); \n"
2912 ".view row:selected:focused {\n"
2913 " background-color: @selected_bg_color;\n"
2916 ".view row:selected {\n"
2917 " background-color: darker (@bg_color);\n"
2918 " color: @selected_fg_color;\n"
2921 ".view.cell.trough,\n"
2922 ".view.cell.trough:hover,\n"
2923 ".view.cell.trough:selected,\n"
2924 ".view.cell.trough:selected:focused {\n"
2925 " background-color: @bg_color;\n"
2926 " color: @fg_color;\n"
2929 ".view.cell.progressbar,\n"
2930 ".view.cell.progressbar:hover,\n"
2931 ".view.cell.progressbar:selected,\n"
2932 ".view.cell.progressbar:selected:focused {\n"
2933 " background-color: @selected_bg_color;\n"
2934 " color: @selected_fg_color;\n"
2938 " background-color: alpha (@fg_color, 0.25);\n"
2939 " border-color: @fg_color;\n"
2940 " border-style: solid;\n"
2941 " border-width: 1;\n"
2945 " background-color: @tooltip_bg_color; \n"
2946 " color: @tooltip_fg_color; \n"
2947 " border-color: @tooltip_fg_color; \n"
2948 " border-width: 1;\n"
2949 " border-style: solid;\n"
2954 " border-style: outset; \n"
2955 " border-width: 2; \n"
2958 ".button:active {\n"
2959 " background-color: shade (@bg_color, 0.7);\n"
2960 " border-style: inset; \n"
2963 ".button:prelight,\n"
2964 ".slider:prelight {\n"
2965 " background-color: @selected_bg_color;\n"
2966 " color: @selected_fg_color;\n"
2967 " border-color: shade (@selected_bg_color, 0.7);\n"
2971 " background-color: darker (@bg_color);\n"
2972 " border-style: inset;\n"
2973 " border-width: 1;\n"
2978 " border-style: inset;\n"
2979 " border-width: 2;\n"
2980 " background-color: @base_color;\n"
2981 " color: @text_color;\n"
2984 ".entry:insensitive {\n"
2985 " background-color: shade (@base_color, 0.9);\n"
2986 " color: shade (@base_color, 0.7);\n"
2989 " background-color: #c4c2bd;\n"
2994 ".entry.progressbar, \n"
2995 ".cell.progressbar {\n"
2996 " background-color: @selected_bg_color;\n"
2997 " border-color: shade (@selected_bg_color, 0.7);\n"
2998 " color: @selected_fg_color;\n"
2999 " border-style: outset;\n"
3000 " border-width: 1;\n"
3003 "GtkCheckButton:hover,\n"
3004 "GtkCheckButton:selected,\n"
3005 "GtkRadioButton:hover,\n"
3006 "GtkRadioButton:selected {\n"
3007 " background-color: shade (@bg_color, 1.05);\n"
3011 ".cell.check, .cell.radio,\n"
3012 ".cell.check:hover, .cell.radio:hover {\n"
3013 " border-style: solid;\n"
3014 " border-width: 1;\n"
3015 " background-color: @base_color;\n"
3016 " border-color: @fg_color;\n"
3019 ".check:active, .radio:active,\n"
3020 ".check:hover, .radio:hover {\n"
3021 " background-color: @base_color;\n"
3022 " border-color: @fg_color;\n"
3023 " color: @text_color;\n"
3026 ".check:selected, .radio:selected {\n"
3027 " background-color: darker (@bg_color);\n"
3028 " color: @selected_fg_color;\n"
3029 " border-color: @selected_fg_color;\n"
3032 ".check:selected:focused, .radio:selected:focused {\n"
3033 " background-color: @selected_bg_color;\n"
3036 ".menu.check, .menu.radio {\n"
3037 " color: @fg_color;\n"
3038 " border-style: none;\n"
3039 " border-width: 0;\n"
3043 " border-style: outset;\n"
3044 " border-width: 1;\n"
3048 " border-style: inset;\n"
3049 " border-width: 2;\n"
3053 " border-style: outset;\n"
3054 " border-width: 1;\n"
3058 " border-style: inset;\n"
3059 " border-width: 1;\n"
3062 "GtkScrolledWindow.frame {\n"
3069 " border-style: outset;\n"
3070 " border-width: 1;\n"
3075 ".menu.check:hover,\n"
3076 ".menu.radio:hover {\n"
3077 " background-color: @selected_bg_color;\n"
3078 " color: @selected_fg_color;\n"
3081 "GtkSpinButton.button {\n"
3082 " border-width: 1;\n"
3085 ".scale.slider:hover,\n"
3086 "GtkSpinButton.button:hover {\n"
3087 " background-color: shade (@bg_color, 1.05);\n"
3088 " border-color: shade (@bg_color, 0.8);\n"
3091 "GtkSwitch.trough:active {\n"
3092 " background-color: @selected_bg_color;\n"
3093 " color: @selected_fg_color;\n"
3096 "GtkToggleButton.button:inconsistent {\n"
3097 " border-style: outset;\n"
3098 " border-width: 1px;\n"
3099 " background-color: shade (@bg_color, 0.9);\n"
3100 " border-color: shade (@bg_color, 0.7);\n"
3103 "GtkLabel:selected {\n"
3104 " background-color: shade (@bg_color, 0.9);\n"
3107 "GtkLabel:selected:focused {\n"
3108 " background-color: @selected_bg_color;\n"
3111 ".spinner:active {\n"
3112 " transition: 750ms linear loop;\n"
3116 " background-color: @info_bg_color;\n"
3117 " color: @info_fg_color;\n"
3121 " background-color: @warning_bg_color;\n"
3122 " color: @warning_fg_color;\n"
3126 " background-color: @question_bg_color;\n"
3127 " color: @question_fg_color;\n"
3131 " background-color: @error_bg_color;\n"
3132 " color: @error_fg_color;\n"
3136 " background-color: @selected_bg_color;\n"
3137 " color: @selected_fg_color;\n"
3140 ".light-area-focus {\n"
3144 ".dark-area-focus {\n"
3147 "GtkCalendar.view {\n"
3148 " border-width: 1;\n"
3149 " border-style: inset;\n"
3153 "GtkCalendar.view:inconsistent {\n"
3154 " color: darker (@bg_color);\n"
3157 "GtkCalendar.header {\n"
3158 " background-color: @bg_color;\n"
3159 " border-style: outset;\n"
3160 " border-width: 2;\n"
3163 "GtkCalendar.highlight {\n"
3164 " border-width: 0;\n"
3167 "GtkCalendar.button {\n"
3168 " background-color: @bg_color;\n"
3171 "GtkCalendar.button:hover {\n"
3172 " background-color: lighter (@bg_color);\n"
3173 " color: @fg_color;\n"
3177 " border-width: 0;\n"
3182 provider = gtk_css_provider_new ();
3183 if (!gtk_css_provider_load_from_data (provider, str, -1, NULL))
3185 g_error ("Failed to load the internal default CSS.");
3193 _gtk_css_provider_get_theme_dir (void)
3198 var = g_getenv ("GTK_DATA_PREFIX");
3201 path = g_build_filename (var, "share", "themes", NULL);
3203 path = g_build_filename (GTK_DATA_PREFIX, "share", "themes", NULL);
3209 * gtk_css_provider_get_named:
3210 * @name: A theme name
3211 * @variant: (allow-none): variant to load, for example, "dark", or
3212 * %NULL for the default
3214 * Loads a theme from the usual theme paths
3216 * Returns: (transfer none): a #GtkCssProvider with the theme loaded.
3217 * This memory is owned by GTK+, and you must not free it.
3220 gtk_css_provider_get_named (const gchar *name,
3221 const gchar *variant)
3223 static GHashTable *themes = NULL;
3224 GtkCssProvider *provider;
3227 if (G_UNLIKELY (!themes))
3228 themes = g_hash_table_new (g_str_hash, g_str_equal);
3230 if (variant == NULL)
3231 key = (gchar *)name;
3233 key = g_strconcat (name, "-", variant, NULL);
3235 provider = g_hash_table_lookup (themes, key);
3239 const gchar *home_dir;
3240 gchar *subpath, *path = NULL;
3243 subpath = g_strdup_printf ("gtk-3.0" G_DIR_SEPARATOR_S "gtk-%s.css", variant);
3245 subpath = g_strdup ("gtk-3.0" G_DIR_SEPARATOR_S "gtk.css");
3247 /* First look in the users home directory
3249 home_dir = g_get_home_dir ();
3252 path = g_build_filename (home_dir, ".themes", name, subpath, NULL);
3254 if (!g_file_test (path, G_FILE_TEST_EXISTS))
3265 theme_dir = _gtk_css_provider_get_theme_dir ();
3266 path = g_build_filename (theme_dir, name, subpath, NULL);
3269 if (!g_file_test (path, G_FILE_TEST_EXISTS))
3282 provider = gtk_css_provider_new ();
3284 if (!gtk_css_provider_load_from_path (provider, path, &error))
3286 g_warning ("Could not load named theme \"%s\": %s", name, error->message);
3287 g_error_free (error);
3289 g_object_unref (provider);
3293 g_hash_table_insert (themes, g_strdup (key), provider);
3306 selector_path_print (const SelectorPath *path,
3309 GSList *walk, *reverse;
3311 reverse = g_slist_copy (path->elements);
3312 reverse = g_slist_reverse (reverse);
3314 for (walk = reverse; walk; walk = walk->next)
3316 SelectorElement *elem = walk->data;
3318 switch (elem->elem_type)
3320 case SELECTOR_TYPE_NAME:
3322 g_string_append (str, g_quark_to_string (elem->name));
3324 case SELECTOR_GTYPE:
3325 g_string_append (str, g_type_name (elem->type));
3327 case SELECTOR_REGION:
3328 g_string_append (str, g_quark_to_string (elem->region.name));
3329 if (elem->region.flags)
3331 char * flag_names[] = {
3340 for (i = 0; i < G_N_ELEMENTS (flag_names); i++)
3342 if (elem->region.flags & (1 << i))
3344 g_string_append_c (str, ':');
3345 g_string_append (str, flag_names[i]);
3350 case SELECTOR_CLASS:
3351 g_string_append_c (str, '.');
3352 g_string_append (str, g_quark_to_string (elem->name));
3355 if (walk->next == NULL ||
3356 elem->combinator != COMBINATOR_CHILD ||
3357 ((SelectorElement *) walk->next->data)->elem_type != SELECTOR_CLASS)
3358 g_string_append (str, "*");
3361 g_assert_not_reached ();
3366 switch (elem->combinator)
3368 case COMBINATOR_DESCENDANT:
3369 if (elem->elem_type != SELECTOR_CLASS ||
3370 ((SelectorElement *) walk->next->data)->elem_type != SELECTOR_CLASS)
3371 g_string_append_c (str, ' ');
3373 case COMBINATOR_CHILD:
3374 if (((SelectorElement *) walk->next->data)->elem_type != SELECTOR_CLASS)
3375 g_string_append (str, " > ");
3378 g_assert_not_reached ();
3386 char * state_names[] = {
3396 for (i = 0; i < G_N_ELEMENTS (state_names); i++)
3398 if (path->state & (1 << i))
3400 g_string_append_c (str, ':');
3401 g_string_append (str, state_names[i]);
3406 g_slist_free (reverse);
3410 selector_style_info_print (const SelectorStyleInfo *info,
3416 selector_path_print (info->path, str);
3418 g_string_append (str, " {\n");
3420 keys = g_hash_table_get_keys (info->style);
3421 /* so the output is identical for identical selector styles */
3422 keys = g_list_sort (keys, (GCompareFunc) strcmp);
3424 for (walk = keys; walk; walk = walk->next)
3426 const char *name = walk->data;
3427 const GValue *value = g_hash_table_lookup (info->style, (gpointer) name);
3429 g_string_append (str, " ");
3430 g_string_append (str, name);
3431 g_string_append (str, ": ");
3432 s = _gtk_css_value_to_string (value);
3433 g_string_append (str, s);
3435 g_string_append (str, ";\n");
3440 g_string_append (str, "}\n");
3444 gtk_css_provider_print_colors (GHashTable *colors,
3450 keys = g_hash_table_get_keys (colors);
3451 /* so the output is identical for identical styles */
3452 keys = g_list_sort (keys, (GCompareFunc) strcmp);
3454 for (walk = keys; walk; walk = walk->next)
3456 const char *name = walk->data;
3457 GtkSymbolicColor *symbolic = g_hash_table_lookup (colors, (gpointer) name);
3459 g_string_append (str, "@define-color ");
3460 g_string_append (str, name);
3461 g_string_append (str, " ");
3462 s = gtk_symbolic_color_to_string (symbolic);
3463 g_string_append (str, s);
3465 g_string_append (str, ";\n");
3472 * gtk_css_provider_to_string:
3473 * @provider: the provider to write to a string
3475 * Convertes the @provider into a string representation in CSS
3478 * Using gtk_css_provider_load_from_data() with the return value
3479 * from this function on a new provider created with
3480 * gtk_css_provider_new() will basicallu create a duplicate of
3483 * Returns: a new string representing the @provider.
3486 gtk_css_provider_to_string (GtkCssProvider *provider)
3488 GtkCssProviderPrivate *priv;
3492 g_return_val_if_fail (GTK_IS_CSS_PROVIDER (provider), NULL);
3494 priv = provider->priv;
3496 str = g_string_new ("");
3498 gtk_css_provider_print_colors (priv->symbolic_colors, str);
3500 for (i = 0; i < priv->selectors_info->len; i++)
3503 g_string_append (str, "\n");
3504 selector_style_info_print (g_ptr_array_index (priv->selectors_info, i),
3508 return g_string_free (str, FALSE);