Wordpress 2.9.2-scripts
[autoinstalls/wordpress.git] / wp-includes / functions.wp-styles.php
1 <?php
2 /**
3  * BackPress styles procedural API.
4  *
5  * @package BackPress
6  * @since r79
7  */
8
9 /**
10  * Display styles that are in the queue or part of $handles.
11  *
12  * @since r79
13  * @uses do_action() Calls 'wp_print_styles' hook.
14  * @global object $wp_styles The WP_Styles object for printing styles.
15  *
16  * @param array $handles (optional) Styles to be printed.  (void) prints queue, (string) prints that style, (array of strings) prints those styles.
17  * @return bool True on success, false on failure.
18  */
19 function wp_print_styles( $handles = false ) {
20         do_action( 'wp_print_styles' );
21         if ( '' === $handles ) // for wp_head
22                 $handles = false;
23
24         global $wp_styles;
25         if ( !is_a($wp_styles, 'WP_Styles') ) {
26                 if ( !$handles )
27                         return array(); // No need to instantiate if nothing's there.
28                 else
29                         $wp_styles = new WP_Styles();
30         }
31
32         return $wp_styles->do_items( $handles );
33 }
34
35 /**
36  * Register CSS style file.
37  *
38  * @since r79
39  * @see WP_Styles::add() For parameter and additional information.
40  */
41 function wp_register_style( $handle, $src, $deps = array(), $ver = false, $media = 'all' ) {
42         global $wp_styles;
43         if ( !is_a($wp_styles, 'WP_Styles') )
44                 $wp_styles = new WP_Styles();
45
46         $wp_styles->add( $handle, $src, $deps, $ver, $media );
47 }
48
49 /**
50  * Remove a registered CSS file.
51  *
52  * @since r79
53  * @see WP_Styles::remove() For parameter and additional information.
54  */
55 function wp_deregister_style( $handle ) {
56         global $wp_styles;
57         if ( !is_a($wp_styles, 'WP_Styles') )
58                 $wp_styles = new WP_Styles();
59
60         $wp_styles->remove( $handle );
61 }
62
63 /**
64  * Enqueue a CSS style file.
65  *
66  * @since r79
67  * @see WP_Styles::add(), WP_Styles::enqueue()
68  */
69 function wp_enqueue_style( $handle, $src = false, $deps = array(), $ver = false, $media = false ) {
70         global $wp_styles;
71         if ( !is_a($wp_styles, 'WP_Styles') )
72                 $wp_styles = new WP_Styles();
73
74         if ( $src ) {
75                 $_handle = explode('?', $handle);
76                 $wp_styles->add( $_handle[0], $src, $deps, $ver, $media );
77         }
78         $wp_styles->enqueue( $handle );
79 }
80
81 /**
82  * Check whether style has been added to WordPress Styles.
83  *
84  * The values for list defaults to 'queue', which is the same as enqueue for
85  * styles.
86  *
87  * @since WP unknown; BP unknown
88  *
89  * @param string $handle Handle used to add style.
90  * @param string $list Optional, defaults to 'queue'. Others values are 'registered', 'queue', 'done', 'to_do'
91  * @return bool
92  */
93 function wp_style_is( $handle, $list = 'queue' ) {
94         global $wp_styles;
95         if ( !is_a($wp_styles, 'WP_Styles') )
96                 $wp_styles = new WP_Styles();
97
98         $query = $wp_styles->query( $handle, $list );
99
100         if ( is_object( $query ) )
101                 return true;
102
103         return $query;
104 }