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;
814 /* Extend GtkStateType, since these
815 * values are also used as symbols
818 /* Scope: pseudo-class */
819 SYMBOL_NTH_CHILD = GTK_STATE_FOCUSED + 1,
824 /* Scope: nth-child */
825 SYMBOL_NTH_CHILD_EVEN,
826 SYMBOL_NTH_CHILD_ODD,
827 SYMBOL_NTH_CHILD_FIRST,
828 SYMBOL_NTH_CHILD_LAST
836 static guint css_provider_signals[LAST_SIGNAL] = { 0 };
838 static void gtk_css_provider_finalize (GObject *object);
839 static void gtk_css_style_provider_iface_init (GtkStyleProviderIface *iface);
841 static void scanner_apply_scope (GScanner *scanner,
843 static gboolean gtk_css_provider_load_from_path_internal (GtkCssProvider *css_provider,
847 static void gtk_css_provider_take_error (GtkCssProvider *provider,
852 gtk_css_provider_error_quark (void)
854 return g_quark_from_static_string ("gtk-css-provider-error-quark");
857 G_DEFINE_TYPE_EXTENDED (GtkCssProvider, gtk_css_provider, G_TYPE_OBJECT, 0,
858 G_IMPLEMENT_INTERFACE (GTK_TYPE_STYLE_PROVIDER,
859 gtk_css_style_provider_iface_init));
862 gtk_css_provider_parsing_error (GtkCssProvider *provider,
866 const GError * error)
868 /* Only emit a warning when we have no error handlers. This is our
869 * default handlers. And in this case erroneous CSS files are a bug
870 * and should be fixed.
871 * Note that these warnings can also be triggered by a broken theme
872 * that people installed from some weird location on the internets.
874 if (!g_signal_has_handler_pending (provider,
875 css_provider_signals[PARSING_ERROR],
879 g_warning ("Theme parsing error: %s:%u:%u: %s", path ? path : "<unknown>", line, position, error->message);
884 gtk_css_provider_class_init (GtkCssProviderClass *klass)
886 GObjectClass *object_class = G_OBJECT_CLASS (klass);
889 * GtkCssProvider::parsing-error:
890 * @provider: the provider that had a parsing error
891 * @path: path to the parsed file or %NULL if the file cannot be
892 * identified or the data was not loaded from a file
893 * @line: line in the file or data or 0 if unknown
894 * @position: offset into the current line or 0 if unknown or the
895 * whole line is affected
896 * @error: The parsing error
898 * Signals that a parsing error occured. the @path, @line and @position
899 * describe the actual location of the error as accurately as possible.
901 * Parsing errors are never fatal, so the parsing will resume after
902 * the error. Errors may however cause parts of the given
903 * data or even all of it to not be parsed at all. So it is a useful idea
904 * to check that the parsing succeeds by connecting to this signal.
906 * Note that this signal may be emitted at any time as the css provider
907 * may opt to defer parsing parts or all of the input to a later time
908 * than when a loading function was called.
910 css_provider_signals[PARSING_ERROR] =
911 g_signal_new (I_("parsing-error"),
912 G_TYPE_FROM_CLASS (object_class),
914 G_STRUCT_OFFSET (GtkCssProviderClass, parsing_error),
916 _gtk_marshal_VOID__STRING_UINT_UINT_BOXED,
918 G_TYPE_STRING, G_TYPE_UINT, G_TYPE_UINT, G_TYPE_ERROR);
920 object_class->finalize = gtk_css_provider_finalize;
922 klass->parsing_error = gtk_css_provider_parsing_error;
924 g_type_class_add_private (object_class, sizeof (GtkCssProviderPrivate));
927 static SelectorPath *
928 selector_path_new (void)
932 path = g_slice_new0 (SelectorPath);
938 static SelectorPath *
939 selector_path_ref (SelectorPath *path)
946 selector_path_unref (SelectorPath *path)
950 if (path->ref_count > 0)
953 while (path->elements)
955 g_slice_free (SelectorElement, path->elements->data);
956 path->elements = g_slist_delete_link (path->elements, path->elements);
959 g_slice_free (SelectorPath, path);
963 selector_path_prepend_type (SelectorPath *path,
964 const gchar *type_name)
966 SelectorElement *elem;
969 elem = g_slice_new (SelectorElement);
970 elem->combinator = COMBINATOR_DESCENDANT;
971 type = g_type_from_name (type_name);
973 if (type == G_TYPE_INVALID)
975 elem->elem_type = SELECTOR_TYPE_NAME;
976 elem->name = g_quark_from_string (type_name);
980 elem->elem_type = SELECTOR_GTYPE;
984 path->elements = g_slist_prepend (path->elements, elem);
988 selector_path_prepend_glob (SelectorPath *path)
990 SelectorElement *elem;
992 elem = g_slice_new (SelectorElement);
993 elem->elem_type = SELECTOR_GLOB;
994 elem->combinator = COMBINATOR_DESCENDANT;
996 path->elements = g_slist_prepend (path->elements, elem);
1000 selector_path_prepend_region (SelectorPath *path,
1002 GtkRegionFlags flags)
1004 SelectorElement *elem;
1006 elem = g_slice_new (SelectorElement);
1007 elem->combinator = COMBINATOR_DESCENDANT;
1008 elem->elem_type = SELECTOR_REGION;
1010 elem->region.name = g_quark_from_string (name);
1011 elem->region.flags = flags;
1013 path->elements = g_slist_prepend (path->elements, elem);
1017 selector_path_prepend_name (SelectorPath *path,
1020 SelectorElement *elem;
1022 elem = g_slice_new (SelectorElement);
1023 elem->combinator = COMBINATOR_DESCENDANT;
1024 elem->elem_type = SELECTOR_NAME;
1026 elem->name = g_quark_from_string (name);
1028 path->elements = g_slist_prepend (path->elements, elem);
1032 selector_path_prepend_class (SelectorPath *path,
1035 SelectorElement *elem;
1037 elem = g_slice_new (SelectorElement);
1038 elem->combinator = COMBINATOR_DESCENDANT;
1039 elem->elem_type = SELECTOR_CLASS;
1041 elem->name = g_quark_from_string (name);
1043 path->elements = g_slist_prepend (path->elements, elem);
1047 selector_path_prepend_combinator (SelectorPath *path,
1048 CombinatorType combinator)
1050 SelectorElement *elem;
1052 g_assert (path->elements != NULL);
1054 /* It is actually stored in the last element */
1055 elem = path->elements->data;
1056 elem->combinator = combinator;
1060 selector_path_depth (SelectorPath *path)
1062 return g_slist_length (path->elements);
1065 static SelectorStyleInfo *
1066 selector_style_info_new (SelectorPath *path)
1068 SelectorStyleInfo *info;
1070 info = g_slice_new0 (SelectorStyleInfo);
1071 info->path = selector_path_ref (path);
1077 selector_style_info_free (SelectorStyleInfo *info)
1080 g_hash_table_unref (info->style);
1083 selector_path_unref (info->path);
1085 g_slice_free (SelectorStyleInfo, info);
1089 selector_style_info_set_style (SelectorStyleInfo *info,
1093 g_hash_table_unref (info->style);
1096 info->style = g_hash_table_ref (style);
1102 property_value_free (GValue *value)
1104 if (G_IS_VALUE (value))
1105 g_value_unset (value);
1107 g_slice_free (GValue, value);
1111 gtk_css_scanner_reset (GScanner *scanner)
1113 GtkCssScannerPrivate *priv = scanner->user_data;
1115 g_slist_free (priv->state);
1118 g_slist_foreach (priv->cur_selectors, (GFunc) selector_path_unref, NULL);
1119 g_slist_free (priv->cur_selectors);
1120 priv->cur_selectors = NULL;
1122 if (priv->cur_properties)
1123 g_hash_table_unref (priv->cur_properties);
1125 priv->cur_properties = g_hash_table_new_full (g_str_hash,
1127 (GDestroyNotify) g_free,
1128 (GDestroyNotify) property_value_free);
1130 scanner_apply_scope (scanner, SCOPE_SELECTOR);
1134 gtk_css_scanner_destroy (GScanner *scanner)
1136 GtkCssScannerPrivate *priv = scanner->user_data;
1138 gtk_css_scanner_reset (scanner);
1140 g_hash_table_destroy (priv->cur_properties);
1141 g_slice_free (GtkCssScannerPrivate, priv);
1143 g_scanner_destroy (scanner);
1147 gtk_css_scanner_new (void)
1149 GtkCssScannerPrivate *priv;
1152 scanner = g_scanner_new (NULL);
1154 priv = scanner->user_data = g_slice_new0 (GtkCssScannerPrivate);
1156 priv->cur_properties = g_hash_table_new_full (g_str_hash,
1158 (GDestroyNotify) g_free,
1159 (GDestroyNotify) property_value_free);
1161 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "active", GUINT_TO_POINTER (GTK_STATE_ACTIVE));
1162 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "prelight", GUINT_TO_POINTER (GTK_STATE_PRELIGHT));
1163 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "hover", GUINT_TO_POINTER (GTK_STATE_PRELIGHT));
1164 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "selected", GUINT_TO_POINTER (GTK_STATE_SELECTED));
1165 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "insensitive", GUINT_TO_POINTER (GTK_STATE_INSENSITIVE));
1166 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "inconsistent", GUINT_TO_POINTER (GTK_STATE_INCONSISTENT));
1167 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "focused", GUINT_TO_POINTER (GTK_STATE_FOCUSED));
1168 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "focus", GUINT_TO_POINTER (GTK_STATE_FOCUSED));
1170 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "nth-child", GUINT_TO_POINTER (SYMBOL_NTH_CHILD));
1171 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "first-child", GUINT_TO_POINTER (SYMBOL_FIRST_CHILD));
1172 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "last-child", GUINT_TO_POINTER (SYMBOL_LAST_CHILD));
1173 g_scanner_scope_add_symbol (scanner, SCOPE_PSEUDO_CLASS, "sorted", GUINT_TO_POINTER (SYMBOL_SORTED_CHILD));
1175 g_scanner_scope_add_symbol (scanner, SCOPE_NTH_CHILD, "even", GUINT_TO_POINTER (SYMBOL_NTH_CHILD_EVEN));
1176 g_scanner_scope_add_symbol (scanner, SCOPE_NTH_CHILD, "odd", GUINT_TO_POINTER (SYMBOL_NTH_CHILD_ODD));
1177 g_scanner_scope_add_symbol (scanner, SCOPE_NTH_CHILD, "first", GUINT_TO_POINTER (SYMBOL_NTH_CHILD_FIRST));
1178 g_scanner_scope_add_symbol (scanner, SCOPE_NTH_CHILD, "last", GUINT_TO_POINTER (SYMBOL_NTH_CHILD_LAST));
1180 scanner_apply_scope (scanner, SCOPE_SELECTOR);
1186 gtk_css_provider_init (GtkCssProvider *css_provider)
1188 GtkCssProviderPrivate *priv;
1190 priv = css_provider->priv = G_TYPE_INSTANCE_GET_PRIVATE (css_provider,
1191 GTK_TYPE_CSS_PROVIDER,
1192 GtkCssProviderPrivate);
1194 priv->selectors_info = g_ptr_array_new_with_free_func ((GDestroyNotify) selector_style_info_free);
1196 priv->symbolic_colors = g_hash_table_new_full (g_str_hash, g_str_equal,
1197 (GDestroyNotify) g_free,
1198 (GDestroyNotify) gtk_symbolic_color_unref);
1201 typedef struct ComparePathData ComparePathData;
1203 struct ComparePathData
1211 compare_selector_element (GtkWidgetPath *path,
1213 SelectorElement *elem,
1218 if (elem->elem_type == SELECTOR_TYPE_NAME)
1220 const gchar *type_name;
1221 GType resolved_type;
1223 /* Resolve the type name */
1224 type_name = g_quark_to_string (elem->name);
1225 resolved_type = g_type_from_name (type_name);
1227 if (resolved_type == G_TYPE_INVALID)
1229 /* Type couldn't be resolved, so the selector
1230 * clearly doesn't affect the given widget path
1235 elem->elem_type = SELECTOR_GTYPE;
1236 elem->type = resolved_type;
1239 if (elem->elem_type == SELECTOR_GTYPE)
1243 type = gtk_widget_path_iter_get_object_type (path, index);
1245 if (!g_type_is_a (type, elem->type))
1248 if (type == elem->type)
1252 guint diff = g_type_depth (type) - g_type_depth (elem->type);
1254 if (G_UNLIKELY (diff > 0xE))
1256 g_warning ("Hierarchy is higher than expected.");
1260 *score = 0XF - diff;
1265 else if (elem->elem_type == SELECTOR_REGION)
1267 GtkRegionFlags flags;
1269 if (!gtk_widget_path_iter_has_qregion (path, index,
1274 if (elem->region.flags != 0 &&
1275 (flags & elem->region.flags) == 0)
1281 else if (elem->elem_type == SELECTOR_GLOB)
1283 /* Treat as lowest matching type */
1287 else if (elem->elem_type == SELECTOR_NAME)
1289 if (!gtk_widget_path_iter_has_qname (path, index, elem->name))
1295 else if (elem->elem_type == SELECTOR_CLASS)
1297 if (!gtk_widget_path_iter_has_qclass (path, index, elem->name))
1308 compare_selector (GtkWidgetPath *path,
1309 SelectorPath *selector)
1311 GSList *elements = selector->elements;
1312 gboolean match = TRUE, first = TRUE, first_match = FALSE;
1316 i = gtk_widget_path_length (path) - 1;
1318 while (elements && match && i >= 0)
1320 SelectorElement *elem;
1323 elem = elements->data;
1325 match = compare_selector_element (path, i, elem, &elem_score);
1330 /* Only move on to the next index if there is no match
1331 * with the current element (whether to continue or not
1332 * handled right after in the combinator check), or a
1333 * GType or glob has just been matched.
1335 * Region and widget names do not trigger this because
1336 * the next element in the selector path could also be
1337 * related to the same index.
1340 (elem->elem_type == SELECTOR_GTYPE ||
1341 elem->elem_type == SELECTOR_GLOB))
1345 elem->elem_type != SELECTOR_TYPE_NAME &&
1346 elem->combinator == COMBINATOR_DESCENDANT)
1348 /* With descendant combinators there may
1349 * be intermediate chidren in the hierarchy
1354 elements = elements->next;
1358 /* Only 4 bits are actually used */
1360 score |= elem_score;
1366 /* If there are pending selector
1367 * elements to compare, it's not
1375 else if (first_match)
1377 /* Assign more weight to these selectors
1378 * that matched right from the first element.
1386 typedef struct StylePriorityInfo StylePriorityInfo;
1388 struct StylePriorityInfo
1392 GtkStateFlags state;
1396 css_provider_get_selectors (GtkCssProvider *css_provider,
1397 GtkWidgetPath *path)
1399 GtkCssProviderPrivate *priv;
1400 GArray *priority_info;
1403 priv = css_provider->priv;
1404 priority_info = g_array_new (FALSE, FALSE, sizeof (StylePriorityInfo));
1406 for (i = 0; i < priv->selectors_info->len; i++)
1408 SelectorStyleInfo *info;
1409 StylePriorityInfo new;
1410 gboolean added = FALSE;
1413 info = g_ptr_array_index (priv->selectors_info, i);
1414 score = compare_selector (path, info->path);
1420 new.style = info->style;
1421 new.state = info->path->state;
1423 for (j = 0; j < priority_info->len; j++)
1425 StylePriorityInfo *cur;
1427 cur = &g_array_index (priority_info, StylePriorityInfo, j);
1429 if (cur->score > new.score)
1431 g_array_insert_val (priority_info, j, new);
1438 g_array_append_val (priority_info, new);
1441 return priority_info;
1445 css_provider_dump_symbolic_colors (GtkCssProvider *css_provider,
1446 GtkStyleProperties *props)
1448 GtkCssProviderPrivate *priv;
1449 GHashTableIter iter;
1450 gpointer key, value;
1452 priv = css_provider->priv;
1453 g_hash_table_iter_init (&iter, priv->symbolic_colors);
1455 while (g_hash_table_iter_next (&iter, &key, &value))
1458 GtkSymbolicColor *color;
1463 gtk_style_properties_map_color (props, name, color);
1467 static GtkStyleProperties *
1468 gtk_css_provider_get_style (GtkStyleProvider *provider,
1469 GtkWidgetPath *path)
1471 GtkCssProvider *css_provider;
1472 GtkStyleProperties *props;
1473 GArray *priority_info;
1476 css_provider = GTK_CSS_PROVIDER (provider);
1477 props = gtk_style_properties_new ();
1479 css_provider_dump_symbolic_colors (css_provider, props);
1480 priority_info = css_provider_get_selectors (css_provider, path);
1482 for (i = 0; i < priority_info->len; i++)
1484 StylePriorityInfo *info;
1485 GHashTableIter iter;
1486 gpointer key, value;
1488 info = &g_array_index (priority_info, StylePriorityInfo, i);
1489 g_hash_table_iter_init (&iter, info->style);
1491 while (g_hash_table_iter_next (&iter, &key, &value))
1495 /* Properties starting with '-' may be both widget style properties
1496 * or custom properties from the theming engine, so check whether
1497 * the type is registered or not.
1499 if (prop[0] == '-' &&
1500 !gtk_style_properties_lookup_property (prop, NULL, NULL))
1503 gtk_style_properties_set_property (props, key, info->state, value);
1507 g_array_free (priority_info, TRUE);
1513 gtk_css_provider_get_style_property (GtkStyleProvider *provider,
1514 GtkWidgetPath *path,
1515 GtkStateFlags state,
1519 GArray *priority_info;
1520 gboolean found = FALSE;
1524 prop_name = g_strdup_printf ("-%s-%s",
1525 g_type_name (pspec->owner_type),
1528 priority_info = css_provider_get_selectors (GTK_CSS_PROVIDER (provider), path);
1530 for (i = priority_info->len - 1; i >= 0; i--)
1532 StylePriorityInfo *info;
1535 info = &g_array_index (priority_info, StylePriorityInfo, i);
1536 val = g_hash_table_lookup (info->style, prop_name);
1539 (info->state == 0 ||
1540 info->state == state ||
1541 ((info->state & state) != 0 &&
1542 (info->state & ~(state)) == 0)))
1544 GError *error = NULL;
1546 found = _gtk_css_value_from_string (value,
1548 g_value_get_string (val),
1554 gtk_css_provider_take_error (GTK_CSS_PROVIDER (provider), NULL, error);
1558 g_array_free (priority_info, TRUE);
1565 gtk_css_style_provider_iface_init (GtkStyleProviderIface *iface)
1567 iface->get_style = gtk_css_provider_get_style;
1568 iface->get_style_property = gtk_css_provider_get_style_property;
1572 gtk_css_provider_finalize (GObject *object)
1574 GtkCssProvider *css_provider;
1575 GtkCssProviderPrivate *priv;
1577 css_provider = GTK_CSS_PROVIDER (object);
1578 priv = css_provider->priv;
1580 g_ptr_array_free (priv->selectors_info, TRUE);
1582 if (priv->symbolic_colors)
1583 g_hash_table_destroy (priv->symbolic_colors);
1585 G_OBJECT_CLASS (gtk_css_provider_parent_class)->finalize (object);
1589 * gtk_css_provider_new:
1591 * Returns a newly created #GtkCssProvider.
1593 * Returns: A new #GtkCssProvider
1596 gtk_css_provider_new (void)
1598 return g_object_new (GTK_TYPE_CSS_PROVIDER, NULL);
1602 gtk_css_provider_take_error (GtkCssProvider *provider,
1606 const char *filename;
1607 guint line, position;
1611 filename = scanner->input_name;
1612 line = scanner->line;
1613 position = scanner->position;
1622 g_signal_emit (provider, css_provider_signals[PARSING_ERROR], 0,
1623 filename, line, position, error);
1625 g_error_free (error);
1629 gtk_css_provider_error_literal (GtkCssProvider *provider,
1633 const char *message)
1635 gtk_css_provider_take_error (provider,
1637 g_error_new_literal (domain, code, message));
1641 gtk_css_provider_error (GtkCssProvider *provider,
1646 ...) G_GNUC_PRINTF (5, 6);
1648 gtk_css_provider_error (GtkCssProvider *provider,
1658 va_start (args, format);
1659 error = g_error_new_valist (domain, code, format, args);
1662 gtk_css_provider_take_error (provider, scanner, error);
1666 gtk_css_provider_invalid_token (GtkCssProvider *provider,
1668 const char *expected)
1670 gtk_css_provider_error (provider,
1672 GTK_CSS_PROVIDER_ERROR,
1673 GTK_CSS_PROVIDER_ERROR_SYNTAX,
1674 "expected a valid %s", expected);
1678 scanner_apply_scope (GScanner *scanner,
1681 g_scanner_set_scope (scanner, scope);
1683 if (scope == SCOPE_VALUE)
1685 scanner->config->cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "@#-_";
1686 scanner->config->cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "@#-_ +(),.%\t\n'/\"";
1687 scanner->config->scan_identifier_1char = TRUE;
1689 else if (scope == SCOPE_BINDING_SET)
1691 scanner->config->cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "@#-_";
1692 scanner->config->cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "@#-_ +(){}<>,.%\t\n'/\"";
1693 scanner->config->scan_identifier_1char = TRUE;
1695 else if (scope == SCOPE_SELECTOR)
1697 scanner->config->cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z "*@";
1698 scanner->config->cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "-_#.";
1699 scanner->config->scan_identifier_1char = TRUE;
1701 else if (scope == SCOPE_PSEUDO_CLASS ||
1702 scope == SCOPE_NTH_CHILD ||
1703 scope == SCOPE_DECLARATION)
1705 scanner->config->cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z "-_";
1706 scanner->config->cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z G_CSET_DIGITS "-_";
1707 scanner->config->scan_identifier_1char = FALSE;
1710 g_assert_not_reached ();
1712 scanner->config->scan_float = FALSE;
1713 scanner->config->cpair_comment_single = NULL;
1717 gtk_css_scanner_push_scope (GScanner *scanner,
1720 GtkCssScannerPrivate *priv;
1722 priv = scanner->user_data;
1723 priv->state = g_slist_prepend (priv->state, GUINT_TO_POINTER (scope));
1725 scanner_apply_scope (scanner, scope);
1729 gtk_css_scanner_pop_scope (GScanner *scanner)
1731 GtkCssScannerPrivate *priv;
1732 ParserScope scope = SCOPE_SELECTOR;
1734 priv = scanner->user_data;
1738 g_warning ("Push/pop calls to parser scope aren't paired");
1739 scanner_apply_scope (scanner, SCOPE_SELECTOR);
1743 priv->state = g_slist_delete_link (priv->state, priv->state);
1745 /* Fetch new scope */
1747 scope = GPOINTER_TO_INT (priv->state->data);
1749 scanner_apply_scope (scanner, scope);
1753 css_provider_commit (GtkCssProvider *css_provider,
1756 GtkCssScannerPrivate *scanner_priv;
1757 GtkCssProviderPrivate *priv;
1760 priv = css_provider->priv;
1761 scanner_priv = scanner->user_data;
1763 l = scanner_priv->cur_selectors;
1765 if (g_hash_table_size (scanner_priv->cur_properties) == 0)
1770 SelectorPath *path = l->data;
1771 SelectorStyleInfo *info;
1773 info = selector_style_info_new (path);
1774 selector_style_info_set_style (info, scanner_priv->cur_properties);
1776 g_ptr_array_add (priv->selectors_info, info);
1782 parse_nth_child (GtkCssProvider *css_provider,
1784 GtkRegionFlags *flags)
1786 ParserSymbol symbol;
1788 g_scanner_get_next_token (scanner);
1790 if (scanner->token != G_TOKEN_SYMBOL)
1791 return G_TOKEN_SYMBOL;
1793 symbol = GPOINTER_TO_INT (scanner->value.v_symbol);
1795 if (symbol == SYMBOL_NTH_CHILD)
1797 g_scanner_get_next_token (scanner);
1799 if (scanner->token != G_TOKEN_LEFT_PAREN)
1800 return G_TOKEN_LEFT_PAREN;
1802 gtk_css_scanner_push_scope (scanner, SCOPE_NTH_CHILD);
1803 g_scanner_get_next_token (scanner);
1805 if (scanner->token != G_TOKEN_SYMBOL)
1806 return G_TOKEN_SYMBOL;
1808 symbol = GPOINTER_TO_INT (scanner->value.v_symbol);
1812 case SYMBOL_NTH_CHILD_EVEN:
1813 *flags = GTK_REGION_EVEN;
1815 case SYMBOL_NTH_CHILD_ODD:
1816 *flags = GTK_REGION_ODD;
1818 case SYMBOL_NTH_CHILD_FIRST:
1819 *flags = GTK_REGION_FIRST;
1821 case SYMBOL_NTH_CHILD_LAST:
1822 *flags = GTK_REGION_LAST;
1828 g_scanner_get_next_token (scanner);
1830 if (scanner->token != G_TOKEN_RIGHT_PAREN)
1831 return G_TOKEN_RIGHT_PAREN;
1833 gtk_css_scanner_pop_scope (scanner);
1835 else if (symbol == SYMBOL_FIRST_CHILD)
1836 *flags = GTK_REGION_FIRST;
1837 else if (symbol == SYMBOL_LAST_CHILD)
1838 *flags = GTK_REGION_LAST;
1839 else if (symbol == SYMBOL_SORTED_CHILD)
1840 *flags = GTK_REGION_SORTED;
1844 return G_TOKEN_SYMBOL;
1847 return G_TOKEN_NONE;
1851 parse_pseudo_class (GtkCssProvider *css_provider,
1853 SelectorPath *selector)
1857 g_scanner_get_next_token (scanner);
1859 if (scanner->token != G_TOKEN_SYMBOL)
1860 return G_TOKEN_SYMBOL;
1862 state = GPOINTER_TO_INT (scanner->value.v_symbol);
1866 case GTK_STATE_ACTIVE:
1867 selector->state |= GTK_STATE_FLAG_ACTIVE;
1869 case GTK_STATE_PRELIGHT:
1870 selector->state |= GTK_STATE_FLAG_PRELIGHT;
1872 case GTK_STATE_SELECTED:
1873 selector->state |= GTK_STATE_FLAG_SELECTED;
1875 case GTK_STATE_INSENSITIVE:
1876 selector->state |= GTK_STATE_FLAG_INSENSITIVE;
1878 case GTK_STATE_INCONSISTENT:
1879 selector->state |= GTK_STATE_FLAG_INCONSISTENT;
1881 case GTK_STATE_FOCUSED:
1882 selector->state |= GTK_STATE_FLAG_FOCUSED;
1885 return G_TOKEN_SYMBOL;
1888 return G_TOKEN_NONE;
1891 /* Parses a number of concatenated classes */
1893 parse_classes (SelectorPath *path,
1898 if ((pos = strchr (str, '.')) != NULL)
1900 /* Leave the last class to the call after the loop */
1904 selector_path_prepend_class (path, str);
1907 pos = strchr (str, '.');
1911 selector_path_prepend_class (path, str);
1915 is_widget_class_name (const gchar *str)
1917 /* Do a pretty lax check here, not all
1918 * widget class names contain only CamelCase
1919 * (gtkmm widgets don't), but at least part of
1920 * the name will be CamelCase, so check for
1921 * the first uppercase char
1925 if (g_ascii_isupper (*str))
1935 parse_selector (GtkCssProvider *css_provider,
1937 SelectorPath **selector_out)
1941 path = selector_path_new ();
1942 *selector_out = path;
1944 if (scanner->token != ':' &&
1945 scanner->token != '#' &&
1946 scanner->token != '.' &&
1947 scanner->token != G_TOKEN_IDENTIFIER)
1948 return G_TOKEN_IDENTIFIER;
1950 while (scanner->token == '#' ||
1951 scanner->token == '.' ||
1952 scanner->token == G_TOKEN_IDENTIFIER)
1954 if (scanner->token == '#' ||
1955 scanner->token == '.')
1960 is_class = (scanner->token == '.');
1962 g_scanner_get_next_token (scanner);
1964 if (scanner->token != G_TOKEN_IDENTIFIER)
1965 return G_TOKEN_IDENTIFIER;
1967 selector_path_prepend_glob (path);
1968 selector_path_prepend_combinator (path, COMBINATOR_CHILD);
1971 parse_classes (path, scanner->value.v_identifier);
1974 if ((pos = strchr (scanner->value.v_identifier, '.')) != NULL)
1977 selector_path_prepend_name (path, scanner->value.v_identifier);
1979 /* Parse any remaining classes */
1981 parse_classes (path, pos + 1);
1984 else if (is_widget_class_name (scanner->value.v_identifier))
1988 if ((pos = strchr (scanner->value.v_identifier, '#')) != NULL ||
1989 (pos = strchr (scanner->value.v_identifier, '.')) != NULL)
1991 gchar *type_name, *name;
1994 is_class = (*pos == '.');
1996 /* Widget type and name/class put together */
1999 type_name = scanner->value.v_identifier;
2001 selector_path_prepend_type (path, type_name);
2003 /* This is only so there is a direct relationship
2004 * between widget type and its name.
2006 selector_path_prepend_combinator (path, COMBINATOR_CHILD);
2009 parse_classes (path, name);
2012 if ((pos = strchr (name, '.')) != NULL)
2015 selector_path_prepend_name (path, name);
2017 /* Parse any remaining classes */
2019 parse_classes (path, pos + 1);
2023 selector_path_prepend_type (path, scanner->value.v_identifier);
2025 else if (_gtk_style_context_check_region_name (scanner->value.v_identifier))
2027 GtkRegionFlags flags = 0;
2030 region_name = g_strdup (scanner->value.v_identifier);
2032 if (g_scanner_peek_next_token (scanner) == ':')
2034 ParserSymbol symbol;
2036 g_scanner_get_next_token (scanner);
2037 gtk_css_scanner_push_scope (scanner, SCOPE_PSEUDO_CLASS);
2039 /* Check for the next token being nth-child, parse in that
2040 * case, and fallback into common state parsing if not.
2042 if (g_scanner_peek_next_token (scanner) != G_TOKEN_SYMBOL)
2043 return G_TOKEN_SYMBOL;
2045 symbol = GPOINTER_TO_INT (scanner->next_value.v_symbol);
2047 if (symbol == SYMBOL_FIRST_CHILD ||
2048 symbol == SYMBOL_LAST_CHILD ||
2049 symbol == SYMBOL_NTH_CHILD ||
2050 symbol == SYMBOL_SORTED_CHILD)
2054 if ((token = parse_nth_child (css_provider, scanner, &flags)) != G_TOKEN_NONE)
2057 gtk_css_scanner_pop_scope (scanner);
2061 gtk_css_scanner_pop_scope (scanner);
2062 selector_path_prepend_region (path, region_name, 0);
2063 g_free (region_name);
2068 selector_path_prepend_region (path, region_name, flags);
2069 g_free (region_name);
2071 else if (scanner->value.v_identifier[0] == '*')
2072 selector_path_prepend_glob (path);
2074 return G_TOKEN_IDENTIFIER;
2076 g_scanner_get_next_token (scanner);
2078 if (scanner->token == '>')
2080 selector_path_prepend_combinator (path, COMBINATOR_CHILD);
2081 g_scanner_get_next_token (scanner);
2085 if (scanner->token == ':')
2087 /* Add glob selector if path is empty */
2088 if (selector_path_depth (path) == 0)
2089 selector_path_prepend_glob (path);
2091 gtk_css_scanner_push_scope (scanner, SCOPE_PSEUDO_CLASS);
2093 while (scanner->token == ':')
2097 if ((token = parse_pseudo_class (css_provider, scanner, path)) != G_TOKEN_NONE)
2100 g_scanner_get_next_token (scanner);
2103 gtk_css_scanner_pop_scope (scanner);
2106 return G_TOKEN_NONE;
2110 resolve_binding_sets (const gchar *value_str,
2114 gchar **bindings, **str;
2116 bindings = g_strsplit (value_str, ",", -1);
2117 array = g_ptr_array_new ();
2119 for (str = bindings; *str; str++)
2121 GtkBindingSet *binding_set;
2123 binding_set = gtk_binding_set_find (g_strstrip (*str));
2128 g_ptr_array_add (array, binding_set);
2131 g_value_take_boxed (value, array);
2132 g_strfreev (bindings);
2136 parse_rule (GtkCssProvider *css_provider,
2139 GtkCssScannerPrivate *priv;
2140 GTokenType expected_token;
2141 SelectorPath *selector;
2143 priv = scanner->user_data;
2145 gtk_css_scanner_push_scope (scanner, SCOPE_SELECTOR);
2147 /* Handle directives */
2148 if (scanner->token == G_TOKEN_IDENTIFIER &&
2149 scanner->value.v_identifier[0] == '@')
2153 directive = &scanner->value.v_identifier[1];
2155 if (strcmp (directive, "define-color") == 0)
2157 GtkSymbolicColor *color;
2158 gchar *color_name, *color_str;
2159 GError *error = NULL;
2161 /* Directive is a color mapping */
2162 g_scanner_get_next_token (scanner);
2164 if (scanner->token != G_TOKEN_IDENTIFIER)
2166 gtk_css_provider_invalid_token (css_provider, scanner, "Color name");
2167 return G_TOKEN_IDENTIFIER;
2170 color_name = g_strdup (scanner->value.v_identifier);
2171 gtk_css_scanner_push_scope (scanner, SCOPE_VALUE);
2172 g_scanner_get_next_token (scanner);
2174 if (scanner->token != G_TOKEN_IDENTIFIER)
2176 gtk_css_provider_invalid_token (css_provider, scanner, "Color definition");
2177 return G_TOKEN_IDENTIFIER;
2180 color_str = g_strstrip (scanner->value.v_identifier);
2181 color = _gtk_css_parse_symbolic_color (color_str, &error);
2184 gtk_css_provider_take_error (css_provider, scanner, error);
2185 return G_TOKEN_IDENTIFIER;
2188 g_hash_table_insert (css_provider->priv->symbolic_colors, color_name, color);
2190 gtk_css_scanner_pop_scope (scanner);
2191 g_scanner_get_next_token (scanner);
2193 if (scanner->token != ';')
2196 return G_TOKEN_NONE;
2198 else if (strcmp (directive, "import") == 0)
2202 GFile *base, *actual;
2204 GError *error = NULL;
2206 gtk_css_scanner_push_scope (scanner, SCOPE_VALUE);
2207 g_scanner_get_next_token (scanner);
2209 if (scanner->token == G_TOKEN_IDENTIFIER &&
2210 g_str_has_prefix (scanner->value.v_identifier, "url"))
2211 path = g_strstrip (scanner->value.v_identifier);
2212 else if (scanner->token == G_TOKEN_STRING)
2213 path = g_strstrip (scanner->value.v_string);
2216 gtk_css_provider_invalid_token (css_provider, scanner, "File URL");
2217 return G_TOKEN_IDENTIFIER;
2220 if (scanner->input_name)
2221 dirname = g_path_get_dirname (scanner->input_name);
2223 dirname = g_get_current_dir ();
2225 base = g_file_new_for_path (dirname);
2228 actual = _gtk_css_parse_url (base, path, NULL, &error);
2229 g_object_unref (base);
2233 gtk_css_provider_take_error (css_provider, scanner, error);
2234 return G_TOKEN_IDENTIFIER;
2237 gtk_css_scanner_pop_scope (scanner);
2238 g_scanner_get_next_token (scanner);
2240 if (scanner->token != ';')
2242 g_object_unref (actual);
2246 path = g_file_get_path (actual);
2247 g_object_unref (actual);
2249 /* FIXME: Avoid recursive importing */
2250 loaded = gtk_css_provider_load_from_path_internal (css_provider, path,
2253 /* Restore previous state */
2257 return G_TOKEN_IDENTIFIER;
2259 return G_TOKEN_NONE;
2261 else if (strcmp (directive, "binding-set") == 0)
2263 GtkBindingSet *binding_set;
2264 gchar *binding_set_name;
2266 g_scanner_get_next_token (scanner);
2268 if (scanner->token != G_TOKEN_IDENTIFIER)
2270 gtk_css_provider_invalid_token (css_provider, scanner, "Binding name");
2271 return G_TOKEN_IDENTIFIER;
2274 binding_set_name = scanner->value.v_identifier;
2275 binding_set = gtk_binding_set_find (binding_set_name);
2279 binding_set = gtk_binding_set_new (binding_set_name);
2280 binding_set->parsed = TRUE;
2283 g_scanner_get_next_token (scanner);
2285 if (scanner->token != G_TOKEN_LEFT_CURLY)
2286 return G_TOKEN_LEFT_CURLY;
2288 gtk_css_scanner_push_scope (scanner, SCOPE_BINDING_SET);
2289 g_scanner_get_next_token (scanner);
2295 if (scanner->token != G_TOKEN_IDENTIFIER)
2297 gtk_css_provider_invalid_token (css_provider, scanner, "Binding definition");
2298 return G_TOKEN_IDENTIFIER;
2301 ret = gtk_binding_entry_add_signal_from_string (binding_set,
2302 scanner->value.v_identifier);
2303 if (ret != G_TOKEN_NONE)
2305 gtk_css_provider_invalid_token (css_provider, scanner, "Binding definition");
2309 g_scanner_get_next_token (scanner);
2311 if (scanner->token != ';')
2314 g_scanner_get_next_token (scanner);
2316 while (scanner->token != G_TOKEN_RIGHT_CURLY);
2318 gtk_css_scanner_pop_scope (scanner);
2319 g_scanner_get_next_token (scanner);
2321 return G_TOKEN_NONE;
2325 gtk_css_provider_invalid_token (css_provider, scanner, "Directive");
2326 return G_TOKEN_IDENTIFIER;
2330 expected_token = parse_selector (css_provider, scanner, &selector);
2332 if (expected_token != G_TOKEN_NONE)
2334 selector_path_unref (selector);
2335 gtk_css_provider_invalid_token (css_provider, scanner, "Selector");
2336 return expected_token;
2339 priv->cur_selectors = g_slist_prepend (priv->cur_selectors, selector);
2341 while (scanner->token == ',')
2343 g_scanner_get_next_token (scanner);
2345 expected_token = parse_selector (css_provider, scanner, &selector);
2347 if (expected_token != G_TOKEN_NONE)
2349 selector_path_unref (selector);
2350 gtk_css_provider_invalid_token (css_provider, scanner, "Selector");
2351 return expected_token;
2354 priv->cur_selectors = g_slist_prepend (priv->cur_selectors, selector);
2357 gtk_css_scanner_pop_scope (scanner);
2359 if (scanner->token != G_TOKEN_LEFT_CURLY)
2360 return G_TOKEN_LEFT_CURLY;
2362 /* Declarations parsing */
2363 gtk_css_scanner_push_scope (scanner, SCOPE_DECLARATION);
2365 g_scanner_get_next_token (scanner);
2367 while (scanner->token != G_TOKEN_RIGHT_CURLY &&
2368 !g_scanner_eof (scanner))
2370 gchar *value_str = NULL;
2371 GtkStylePropertyParser parse_func = NULL;
2372 GParamSpec *pspec = NULL;;
2375 if (scanner->token == ';')
2377 g_scanner_get_next_token (scanner);
2381 if (scanner->token != G_TOKEN_IDENTIFIER)
2383 gtk_css_provider_error_literal (css_provider,
2385 GTK_CSS_PROVIDER_ERROR,
2386 GTK_CSS_PROVIDER_ERROR_PROPERTY_NAME,
2387 "Expected a valid property name");
2388 goto find_end_of_declaration;
2391 prop = g_strdup (scanner->value.v_identifier);
2393 if (!gtk_style_properties_lookup_property (prop, &parse_func, &pspec) &&
2396 gtk_css_provider_error (css_provider,
2398 GTK_CSS_PROVIDER_ERROR,
2399 GTK_CSS_PROVIDER_ERROR_PROPERTY_NAME,
2400 "'%s' is not a valid property name",
2403 goto find_end_of_declaration;
2406 g_scanner_get_next_token (scanner);
2408 if (scanner->token != ':')
2411 gtk_css_provider_invalid_token (css_provider, scanner, "':'");
2412 goto find_end_of_declaration;
2415 gtk_css_scanner_push_scope (scanner, SCOPE_VALUE);
2416 g_scanner_get_next_token (scanner);
2418 if (scanner->token != G_TOKEN_IDENTIFIER)
2421 /* the error value here is hacky. But strings should be used for
2422 * strings really, so a string is not a syntax error but a broken
2423 * value for everything that we support. */
2424 gtk_css_provider_error (css_provider,
2426 GTK_CSS_PROVIDER_ERROR,
2427 scanner->token == G_TOKEN_STRING ? GTK_CSS_PROVIDER_ERROR_PROPERTY_VALUE
2428 : GTK_CSS_PROVIDER_ERROR_SYNTAX,
2429 "Not a property value");
2430 gtk_css_scanner_pop_scope (scanner);
2431 goto find_end_of_declaration;
2434 value_str = scanner->value.v_identifier;
2435 g_strchomp (value_str);
2437 gtk_css_scanner_pop_scope (scanner);
2438 g_scanner_peek_next_token (scanner);
2440 if (scanner->next_token != ';' &&
2441 scanner->next_token != G_TOKEN_RIGHT_CURLY &&
2442 scanner->next_token != G_TOKEN_EOF)
2444 gtk_css_provider_invalid_token (css_provider, scanner, "';'");
2446 goto find_end_of_declaration;
2453 val = g_slice_new0 (GValue);
2454 g_value_init (val, pspec->value_type);
2456 if (strcmp (value_str, "none") == 0)
2458 /* Insert the default value, so it has an opportunity
2459 * to override other style providers when merged
2461 g_param_value_set_default (pspec, val);
2462 g_hash_table_insert (priv->cur_properties, prop, val);
2464 else if (strcmp (prop, "gtk-key-bindings") == 0)
2466 /* Private property holding the binding sets */
2467 resolve_binding_sets (value_str, val);
2468 g_hash_table_insert (priv->cur_properties, prop, val);
2470 else if (pspec->value_type == G_TYPE_STRING)
2472 g_value_set_string (val, value_str);
2473 g_hash_table_insert (priv->cur_properties, prop, val);
2475 else if (parse_func)
2477 GError *error = NULL;
2479 if ((*parse_func) (value_str, val, &error))
2480 g_hash_table_insert (priv->cur_properties, prop, val);
2482 gtk_css_provider_take_error (css_provider, scanner, error);
2486 GError *error = NULL;
2491 if (scanner->input_name)
2492 dirname = g_path_get_dirname (scanner->input_name);
2494 dirname = g_get_current_dir ();
2496 base = g_file_new_for_path (dirname);
2499 success = _gtk_css_value_from_string (val,
2504 g_object_unref (base);
2508 g_hash_table_insert (priv->cur_properties, prop, val);
2512 g_value_unset (val);
2513 g_slice_free (GValue, val);
2516 gtk_css_provider_take_error (css_provider, scanner, error);
2520 else if (prop[0] == '-')
2524 val = g_slice_new0 (GValue);
2525 g_value_init (val, G_TYPE_STRING);
2526 g_value_set_string (val, value_str);
2528 g_hash_table_insert (priv->cur_properties, prop, val);
2533 g_scanner_get_next_token (scanner);
2535 if (g_scanner_eof (scanner))
2537 gtk_css_provider_invalid_token (css_provider, scanner, "}");
2541 find_end_of_declaration:
2542 while (scanner->token != ';' &&
2543 scanner->token != G_TOKEN_RIGHT_CURLY &&
2544 !g_scanner_eof (scanner))
2545 g_scanner_get_next_token (scanner);
2548 gtk_css_scanner_pop_scope (scanner);
2550 return G_TOKEN_NONE;
2554 gtk_css_provider_reset (GtkCssProvider *css_provider)
2556 GtkCssProviderPrivate *priv;
2558 priv = css_provider->priv;
2560 if (priv->selectors_info->len > 0)
2561 g_ptr_array_remove_range (priv->selectors_info, 0, priv->selectors_info->len);
2565 gtk_css_provider_propagate_error (GtkCssProvider *provider,
2569 const GError *error,
2570 GError **propagate_to)
2572 /* we already set an error. And we'd like to keep the first one */
2576 *propagate_to = g_error_copy (error);
2577 g_prefix_error (propagate_to, "%s:%u:%u: ", path ? path : "<unknown>", line, position);
2581 parse_stylesheet (GtkCssProvider *css_provider,
2585 gulong error_handler;
2588 error_handler = g_signal_connect (css_provider,
2590 G_CALLBACK (gtk_css_provider_propagate_error),
2593 error_handler = 0; /* silence gcc */
2595 g_scanner_get_next_token (scanner);
2597 while (!g_scanner_eof (scanner))
2599 GTokenType expected_token;
2601 expected_token = parse_rule (css_provider, scanner);
2603 if (expected_token != G_TOKEN_NONE)
2605 while (!g_scanner_eof (scanner) &&
2606 scanner->token != G_TOKEN_RIGHT_CURLY)
2607 g_scanner_get_next_token (scanner);
2610 css_provider_commit (css_provider, scanner);
2612 g_scanner_get_next_token (scanner);
2614 gtk_css_scanner_reset (scanner);
2619 g_signal_handler_disconnect (css_provider, error_handler);
2623 /* We clear all contents from the provider for backwards compat reasons */
2624 gtk_css_provider_reset (css_provider);
2633 * gtk_css_provider_load_from_data:
2634 * @css_provider: a #GtkCssProvider
2635 * @data: CSS data loaded in memory
2636 * @length: the length of @data in bytes, or -1 for NUL terminated strings
2637 * @error: (out) (allow-none): return location for a #GError, or %NULL
2639 * Loads @data into @css_provider, making it clear any previously loaded
2642 * Returns: %TRUE if the data could be loaded.
2645 gtk_css_provider_load_from_data (GtkCssProvider *css_provider,
2653 g_return_val_if_fail (GTK_IS_CSS_PROVIDER (css_provider), FALSE);
2654 g_return_val_if_fail (data != NULL, FALSE);
2657 length = strlen (data);
2659 gtk_css_provider_reset (css_provider);
2661 scanner = gtk_css_scanner_new ();
2663 scanner->input_name = NULL;
2664 g_scanner_input_text (scanner, data, (guint) length);
2666 result = parse_stylesheet (css_provider, scanner, error);
2668 gtk_css_scanner_destroy (scanner);
2674 * gtk_css_provider_load_from_file:
2675 * @css_provider: a #GtkCssProvider
2676 * @file: #GFile pointing to a file to load
2677 * @error: (out) (allow-none): return location for a #GError, or %NULL
2679 * Loads the data contained in @file into @css_provider, making it
2680 * clear any previously loaded information.
2682 * Returns: %TRUE if the data could be loaded.
2685 gtk_css_provider_load_from_file (GtkCssProvider *css_provider,
2689 GError *internal_error = NULL;
2696 g_return_val_if_fail (GTK_IS_CSS_PROVIDER (css_provider), FALSE);
2697 g_return_val_if_fail (G_IS_FILE (file), FALSE);
2699 if (!g_file_load_contents (file, NULL,
2701 NULL, &internal_error))
2703 g_propagate_error (error, internal_error);
2707 gtk_css_provider_reset (css_provider);
2709 scanner = gtk_css_scanner_new ();
2711 path = g_file_get_path (file);
2712 scanner->input_name = path;
2713 g_scanner_input_text (scanner, data, (guint) length);
2715 ret = parse_stylesheet (css_provider, scanner, error);
2719 gtk_css_scanner_destroy (scanner);
2725 gtk_css_provider_load_from_path_internal (GtkCssProvider *css_provider,
2730 GtkCssProviderPrivate *priv;
2731 GError *internal_error = NULL;
2732 GMappedFile *mapped_file;
2738 priv = css_provider->priv;
2740 mapped_file = g_mapped_file_new (path, FALSE, &internal_error);
2744 g_propagate_error (error, internal_error);
2748 length = g_mapped_file_get_length (mapped_file);
2749 data = g_mapped_file_get_contents (mapped_file);
2755 gtk_css_provider_reset (css_provider);
2757 scanner = gtk_css_scanner_new ();
2758 scanner->input_name = path;
2759 g_scanner_input_text (scanner, data, (guint) length);
2761 ret = parse_stylesheet (css_provider, scanner, error);
2763 gtk_css_scanner_destroy (scanner);
2765 g_mapped_file_unref (mapped_file);
2771 * gtk_css_provider_load_from_path:
2772 * @css_provider: a #GtkCssProvider
2773 * @path: the path of a filename to load, in the GLib filename encoding
2774 * @error: (out) (allow-none): return location for a #GError, or %NULL
2776 * Loads the data contained in @path into @css_provider, making it clear
2777 * any previously loaded information.
2779 * Returns: %TRUE if the data could be loaded.
2782 gtk_css_provider_load_from_path (GtkCssProvider *css_provider,
2786 g_return_val_if_fail (GTK_IS_CSS_PROVIDER (css_provider), FALSE);
2787 g_return_val_if_fail (path != NULL, FALSE);
2789 return gtk_css_provider_load_from_path_internal (css_provider, path,
2794 * gtk_css_provider_get_default:
2796 * Returns the provider containing the style settings used as a
2797 * fallback for all widgets.
2799 * Returns: (transfer none): The provider used for fallback styling.
2800 * This memory is owned by GTK+, and you must not free it.
2803 gtk_css_provider_get_default (void)
2805 static GtkCssProvider *provider;
2807 if (G_UNLIKELY (!provider))
2810 "@define-color fg_color #000; \n"
2811 "@define-color bg_color #dcdad5; \n"
2812 "@define-color text_color #000; \n"
2813 "@define-color base_color #fff; \n"
2814 "@define-color selected_bg_color #4b6983; \n"
2815 "@define-color selected_fg_color #fff; \n"
2816 "@define-color tooltip_bg_color #eee1b3; \n"
2817 "@define-color tooltip_fg_color #000; \n"
2818 "@define-color placeholder_text_color #808080; \n"
2820 "@define-color info_fg_color rgb (181, 171, 156);\n"
2821 "@define-color info_bg_color rgb (252, 252, 189);\n"
2822 "@define-color warning_fg_color rgb (173, 120, 41);\n"
2823 "@define-color warning_bg_color rgb (250, 173, 61);\n"
2824 "@define-color question_fg_color rgb (97, 122, 214);\n"
2825 "@define-color question_bg_color rgb (138, 173, 212);\n"
2826 "@define-color error_fg_color rgb (166, 38, 38);\n"
2827 "@define-color error_bg_color rgb (237, 54, 54);\n"
2830 " background-color: @bg_color;\n"
2831 " color: @fg_color;\n"
2832 " border-color: shade (@bg_color, 0.6);\n"
2834 " border-width: 0;\n"
2838 " background-color: shade (@bg_color, 1.05);\n"
2839 " color: shade (@fg_color, 1.3);\n"
2843 " background-color: @selected_bg_color;\n"
2844 " color: @selected_fg_color;\n"
2847 ".expander, GtkTreeView.view.expander {\n"
2851 ".expander:prelight,\n"
2852 "GtkTreeView.view.expander:selected:prelight {\n"
2853 " color: @text_color;\n"
2856 ".expander:active {\n"
2857 " transition: 200ms linear;\n"
2861 " border-color: shade (@bg_color, 0.7);\n"
2862 " background-color: shade (@bg_color, 0.9);\n"
2863 " color: shade (@bg_color, 0.7);\n"
2867 " border-width: 0;\n"
2868 " border-radius: 0;\n"
2869 " background-color: @base_color;\n"
2870 " color: @text_color;\n"
2872 ".view:selected {\n"
2873 " background-color: shade (@bg_color, 0.9);\n"
2874 " color: @fg_color;\n"
2877 ".view:selected:focused {\n"
2878 " background-color: @selected_bg_color;\n"
2879 " color: @selected_fg_color;\n"
2882 ".view column:sorted row,\n"
2883 ".view column:sorted row:prelight {\n"
2884 " background-color: shade (@bg_color, 0.85);\n"
2887 ".view column:sorted row:nth-child(odd),\n"
2888 ".view column:sorted row:nth-child(odd):prelight {\n"
2889 " background-color: shade (@bg_color, 0.8);\n"
2893 ".view row:prelight {\n"
2894 " background-color: @base_color;\n"
2895 " color: @text_color;\n"
2898 ".view row:nth-child(odd),\n"
2899 ".view row:nth-child(odd):prelight {\n"
2900 " background-color: shade (@base_color, 0.93); \n"
2903 ".view row:selected:focused {\n"
2904 " background-color: @selected_bg_color;\n"
2907 ".view row:selected {\n"
2908 " background-color: darker (@bg_color);\n"
2909 " color: @selected_fg_color;\n"
2912 ".view.cell.trough,\n"
2913 ".view.cell.trough:hover,\n"
2914 ".view.cell.trough:selected,\n"
2915 ".view.cell.trough:selected:focused {\n"
2916 " background-color: @bg_color;\n"
2917 " color: @fg_color;\n"
2920 ".view.cell.progressbar,\n"
2921 ".view.cell.progressbar:hover,\n"
2922 ".view.cell.progressbar:selected,\n"
2923 ".view.cell.progressbar:selected:focused {\n"
2924 " background-color: @selected_bg_color;\n"
2925 " color: @selected_fg_color;\n"
2929 " background-color: alpha (@fg_color, 0.25);\n"
2930 " border-color: @fg_color;\n"
2931 " border-style: solid;\n"
2932 " border-width: 1;\n"
2936 " background-color: @tooltip_bg_color; \n"
2937 " color: @tooltip_fg_color; \n"
2938 " border-color: @tooltip_fg_color; \n"
2939 " border-width: 1;\n"
2940 " border-style: solid;\n"
2945 " border-style: outset; \n"
2946 " border-width: 2; \n"
2949 ".button:active {\n"
2950 " background-color: shade (@bg_color, 0.7);\n"
2951 " border-style: inset; \n"
2954 ".button:prelight,\n"
2955 ".slider:prelight {\n"
2956 " background-color: @selected_bg_color;\n"
2957 " color: @selected_fg_color;\n"
2958 " border-color: shade (@selected_bg_color, 0.7);\n"
2962 " background-color: darker (@bg_color);\n"
2963 " border-style: inset;\n"
2964 " border-width: 1;\n"
2969 " border-style: inset;\n"
2970 " border-width: 2;\n"
2971 " background-color: @base_color;\n"
2972 " color: @text_color;\n"
2975 ".entry:insensitive {\n"
2976 " background-color: shade (@base_color, 0.9);\n"
2977 " color: shade (@base_color, 0.7);\n"
2980 " background-color: #c4c2bd;\n"
2985 ".entry.progressbar, \n"
2986 ".cell.progressbar {\n"
2987 " background-color: @selected_bg_color;\n"
2988 " border-color: shade (@selected_bg_color, 0.7);\n"
2989 " color: @selected_fg_color;\n"
2990 " border-style: outset;\n"
2991 " border-width: 1;\n"
2994 "GtkCheckButton:hover,\n"
2995 "GtkCheckButton:selected,\n"
2996 "GtkRadioButton:hover,\n"
2997 "GtkRadioButton:selected {\n"
2998 " background-color: shade (@bg_color, 1.05);\n"
3002 ".cell.check, .cell.radio,\n"
3003 ".cell.check:hover, .cell.radio:hover {\n"
3004 " border-style: solid;\n"
3005 " border-width: 1;\n"
3006 " background-color: @base_color;\n"
3007 " border-color: @fg_color;\n"
3010 ".check:active, .radio:active,\n"
3011 ".check:hover, .radio:hover {\n"
3012 " background-color: @base_color;\n"
3013 " border-color: @fg_color;\n"
3014 " color: @text_color;\n"
3017 ".check:selected, .radio:selected {\n"
3018 " background-color: darker (@bg_color);\n"
3019 " color: @selected_fg_color;\n"
3020 " border-color: @selected_fg_color;\n"
3023 ".check:selected:focused, .radio:selected:focused {\n"
3024 " background-color: @selected_bg_color;\n"
3027 ".menu.check, .menu.radio {\n"
3028 " color: @fg_color;\n"
3029 " border-style: none;\n"
3030 " border-width: 0;\n"
3034 " border-style: outset;\n"
3035 " border-width: 1;\n"
3039 " border-style: inset;\n"
3040 " border-width: 2;\n"
3044 " border-style: outset;\n"
3045 " border-width: 1;\n"
3049 " border-style: inset;\n"
3050 " border-width: 1;\n"
3053 "GtkScrolledWindow.frame {\n"
3060 " border-style: outset;\n"
3061 " border-width: 1;\n"
3066 ".menu.check:hover,\n"
3067 ".menu.radio:hover {\n"
3068 " background-color: @selected_bg_color;\n"
3069 " color: @selected_fg_color;\n"
3072 "GtkSpinButton.button {\n"
3073 " border-width: 1;\n"
3076 ".scale.slider:hover,\n"
3077 "GtkSpinButton.button:hover {\n"
3078 " background-color: shade (@bg_color, 1.05);\n"
3079 " border-color: shade (@bg_color, 0.8);\n"
3082 "GtkSwitch.trough:active {\n"
3083 " background-color: @selected_bg_color;\n"
3084 " color: @selected_fg_color;\n"
3087 "GtkToggleButton.button:inconsistent {\n"
3088 " border-style: outset;\n"
3089 " border-width: 1px;\n"
3090 " background-color: shade (@bg_color, 0.9);\n"
3091 " border-color: shade (@bg_color, 0.7);\n"
3094 "GtkLabel:selected {\n"
3095 " background-color: shade (@bg_color, 0.9);\n"
3098 "GtkLabel:selected:focused {\n"
3099 " background-color: @selected_bg_color;\n"
3102 ".spinner:active {\n"
3103 " transition: 750ms linear loop;\n"
3107 " background-color: @info_bg_color;\n"
3108 " color: @info_fg_color;\n"
3112 " background-color: @warning_bg_color;\n"
3113 " color: @warning_fg_color;\n"
3117 " background-color: @question_bg_color;\n"
3118 " color: @question_fg_color;\n"
3122 " background-color: @error_bg_color;\n"
3123 " color: @error_fg_color;\n"
3127 " background-color: @selected_bg_color;\n"
3128 " color: @selected_fg_color;\n"
3131 ".light-area-focus {\n"
3135 ".dark-area-focus {\n"
3138 "GtkCalendar.view {\n"
3139 " border-width: 1;\n"
3140 " border-style: inset;\n"
3144 "GtkCalendar.view:inconsistent {\n"
3145 " color: darker (@bg_color);\n"
3148 "GtkCalendar.header {\n"
3149 " background-color: @bg_color;\n"
3150 " border-style: outset;\n"
3151 " border-width: 2;\n"
3154 "GtkCalendar.highlight {\n"
3155 " border-width: 0;\n"
3158 "GtkCalendar.button {\n"
3159 " background-color: @bg_color;\n"
3162 "GtkCalendar.button:hover {\n"
3163 " background-color: lighter (@bg_color);\n"
3164 " color: @fg_color;\n"
3168 " border-width: 0;\n"
3173 provider = gtk_css_provider_new ();
3174 if (!gtk_css_provider_load_from_data (provider, str, -1, NULL))
3176 g_error ("Failed to load the internal default CSS.");
3184 _gtk_css_provider_get_theme_dir (void)
3189 var = g_getenv ("GTK_DATA_PREFIX");
3192 path = g_build_filename (var, "share", "themes", NULL);
3194 path = g_build_filename (GTK_DATA_PREFIX, "share", "themes", NULL);
3200 * gtk_css_provider_get_named:
3201 * @name: A theme name
3202 * @variant: (allow-none): variant to load, for example, "dark", or
3203 * %NULL for the default
3205 * Loads a theme from the usual theme paths
3207 * Returns: (transfer none): a #GtkCssProvider with the theme loaded.
3208 * This memory is owned by GTK+, and you must not free it.
3211 gtk_css_provider_get_named (const gchar *name,
3212 const gchar *variant)
3214 static GHashTable *themes = NULL;
3215 GtkCssProvider *provider;
3218 if (G_UNLIKELY (!themes))
3219 themes = g_hash_table_new (g_str_hash, g_str_equal);
3221 if (variant == NULL)
3222 key = (gchar *)name;
3224 key = g_strconcat (name, "-", variant, NULL);
3226 provider = g_hash_table_lookup (themes, key);
3230 const gchar *home_dir;
3231 gchar *subpath, *path = NULL;
3234 subpath = g_strdup_printf ("gtk-3.0" G_DIR_SEPARATOR_S "gtk-%s.css", variant);
3236 subpath = g_strdup ("gtk-3.0" G_DIR_SEPARATOR_S "gtk.css");
3238 /* First look in the users home directory
3240 home_dir = g_get_home_dir ();
3243 path = g_build_filename (home_dir, ".themes", name, subpath, NULL);
3245 if (!g_file_test (path, G_FILE_TEST_EXISTS))
3256 theme_dir = _gtk_css_provider_get_theme_dir ();
3257 path = g_build_filename (theme_dir, name, subpath, NULL);
3260 if (!g_file_test (path, G_FILE_TEST_EXISTS))
3273 provider = gtk_css_provider_new ();
3275 if (!gtk_css_provider_load_from_path (provider, path, &error))
3277 g_warning ("Could not load named theme \"%s\": %s", name, error->message);
3278 g_error_free (error);
3280 g_object_unref (provider);
3284 g_hash_table_insert (themes, g_strdup (key), provider);
3297 selector_path_print (const SelectorPath *path,
3300 GSList *walk, *reverse;
3302 reverse = g_slist_copy (path->elements);
3303 reverse = g_slist_reverse (reverse);
3305 for (walk = reverse; walk; walk = walk->next)
3307 SelectorElement *elem = walk->data;
3309 switch (elem->elem_type)
3311 case SELECTOR_TYPE_NAME:
3313 g_string_append (str, g_quark_to_string (elem->name));
3315 case SELECTOR_GTYPE:
3316 g_string_append (str, g_type_name (elem->type));
3318 case SELECTOR_REGION:
3319 g_string_append (str, g_quark_to_string (elem->region.name));
3320 if (elem->region.flags)
3322 char * flag_names[] = {
3331 for (i = 0; i < G_N_ELEMENTS (flag_names); i++)
3333 if (elem->region.flags & (1 << i))
3335 g_string_append_c (str, ':');
3336 g_string_append (str, flag_names[i]);
3341 case SELECTOR_CLASS:
3342 g_string_append_c (str, '.');
3343 g_string_append (str, g_quark_to_string (elem->name));
3346 if (walk->next == NULL ||
3347 elem->combinator != COMBINATOR_CHILD ||
3348 ((SelectorElement *) walk->next->data)->elem_type != SELECTOR_CLASS)
3349 g_string_append (str, "*");
3352 g_assert_not_reached ();
3357 switch (elem->combinator)
3359 case COMBINATOR_DESCENDANT:
3360 if (elem->elem_type != SELECTOR_CLASS ||
3361 ((SelectorElement *) walk->next->data)->elem_type != SELECTOR_CLASS)
3362 g_string_append_c (str, ' ');
3364 case COMBINATOR_CHILD:
3365 if (((SelectorElement *) walk->next->data)->elem_type != SELECTOR_CLASS)
3366 g_string_append (str, " > ");
3369 g_assert_not_reached ();
3377 char * state_names[] = {
3387 for (i = 0; i < G_N_ELEMENTS (state_names); i++)
3389 if (path->state & (1 << i))
3391 g_string_append_c (str, ':');
3392 g_string_append (str, state_names[i]);
3397 g_slist_free (reverse);
3401 selector_style_info_print (const SelectorStyleInfo *info,
3407 selector_path_print (info->path, str);
3409 g_string_append (str, " {\n");
3411 keys = g_hash_table_get_keys (info->style);
3412 /* so the output is identical for identical selector styles */
3413 keys = g_list_sort (keys, (GCompareFunc) strcmp);
3415 for (walk = keys; walk; walk = walk->next)
3417 const char *name = walk->data;
3418 const GValue *value = g_hash_table_lookup (info->style, (gpointer) name);
3420 g_string_append (str, " ");
3421 g_string_append (str, name);
3422 g_string_append (str, ": ");
3423 s = _gtk_css_value_to_string (value);
3424 g_string_append (str, s);
3426 g_string_append (str, ";\n");
3431 g_string_append (str, "}\n");
3435 gtk_css_provider_print_colors (GHashTable *colors,
3441 keys = g_hash_table_get_keys (colors);
3442 /* so the output is identical for identical styles */
3443 keys = g_list_sort (keys, (GCompareFunc) strcmp);
3445 for (walk = keys; walk; walk = walk->next)
3447 const char *name = walk->data;
3448 GtkSymbolicColor *symbolic = g_hash_table_lookup (colors, (gpointer) name);
3450 g_string_append (str, "@define-color ");
3451 g_string_append (str, name);
3452 g_string_append (str, " ");
3453 s = gtk_symbolic_color_to_string (symbolic);
3454 g_string_append (str, s);
3456 g_string_append (str, ";\n");
3463 * gtk_css_provider_to_string:
3464 * @provider: the provider to write to a string
3466 * Convertes the @provider into a string representation in CSS
3469 * Using gtk_css_provider_load_from_data() with the return value
3470 * from this function on a new provider created with
3471 * gtk_css_provider_new() will basicallu create a duplicate of
3474 * Returns: a new string representing the @provider.
3477 gtk_css_provider_to_string (GtkCssProvider *provider)
3479 GtkCssProviderPrivate *priv;
3483 g_return_val_if_fail (GTK_IS_CSS_PROVIDER (provider), NULL);
3485 priv = provider->priv;
3487 str = g_string_new ("");
3489 gtk_css_provider_print_colors (priv->symbolic_colors, str);
3491 for (i = 0; i < priv->selectors_info->len; i++)
3494 g_string_append (str, "\n");
3495 selector_style_info_print (g_ptr_array_index (priv->selectors_info, i),
3499 return g_string_free (str, FALSE);