Repository navigation
Expand file tree
/
Copy pathicons.php
More file actions
216 lines (197 loc) · 6.19 KB
/
Copy pathicons.php
File metadata and controls
216 lines (197 loc) · 6.19 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
<?php
/**
* Icons API: Icon registration and rendering helper functions.
*
* @package WordPress
* @subpackage Icons
* @since 7.1.0
*/
/**
* Registers a new icon collection.
*
* @since 7.1.0
*
* @param string $slug Icon collection slug.
* @param array $args {
* Arguments for registering an icon collection.
*
* @type string $label Required. A human-readable label for the icon collection.
* @type string $description Optional. A human-readable description for the icon collection.
* }
* @return bool True if the icon collection was registered successfully, else false.
*/
function wp_register_icon_collection( $slug, $args ) {
return WP_Icon_Collections_Registry::get_instance()->register( $slug, $args );
}
/**
* Unregisters an icon collection.
*
* @since 7.1.0
*
* @param string $slug Icon collection slug.
* @return bool True if the icon collection was unregistered successfully, else false.
*/
function wp_unregister_icon_collection( $slug ) {
return WP_Icon_Collections_Registry::get_instance()->unregister( $slug );
}
/**
* Registers a new icon.
*
* @since 7.1.0
*
* @param string $icon_name Namespaced icon name in the form "collection/icon-name"
* (e.g. "my-plugin/arrow-left"). The "core" collection is
* reserved for WordPress core icons; third-party code should
* register icons under its own collection rather than the
* "core" collection.
* @param array $args {
* List of properties for the icon.
*
* @type string $label Required. A human-readable label for the icon.
* @type string $content Optional. SVG markup for the icon.
* If not provided, the content will be retrieved from the `file_path` if set.
* If both `content` and `file_path` are not set, the icon will not be registered.
* @type string $file_path Optional. The full path to the file containing the icon content.
* }
* @return bool True if the icon was registered successfully, else false.
*/
function wp_register_icon( $icon_name, $args ) {
return WP_Icons_Registry::get_instance()->register( $icon_name, $args );
}
/**
* Unregisters an icon.
*
* @since 7.1.0
*
* @param string $icon_name Namespaced icon name in the form "collection/icon-name"
* (e.g. "core/arrow-left").
* @return bool True if the icon was unregistered successfully, else false.
*/
function wp_unregister_icon( $icon_name ) {
return WP_Icons_Registry::get_instance()->unregister( $icon_name );
}
/**
* Registers the default icon collections.
*
* @since 7.1.0
* @access private
*/
function _wp_register_default_icon_collections() {
wp_register_icon_collection(
'core',
array(
'label' => __( 'WordPress' ),
'description' => __( 'Default icon collection.' ),
)
);
}
/**
* Registers the default core icons from the manifest.
*
* @since 7.1.0
* @access private
*/
function _wp_register_default_icons() {
$icons_directory = ABSPATH . WPINC . '/images/icon-library/';
$manifest_path = ABSPATH . WPINC . '/assets/icon-library-manifest.php';
if ( ! is_readable( $manifest_path ) ) {
wp_trigger_error(
__FUNCTION__,
__( 'Core icon collection manifest is missing or unreadable.' )
);
return;
}
$collection = include $manifest_path;
if ( empty( $collection ) ) {
wp_trigger_error(
__FUNCTION__,
__( 'Core icon collection manifest is empty or invalid.' )
);
return;
}
foreach ( $collection as $icon_name => $icon_data ) {
if (
empty( $icon_data['filePath'] )
|| ! is_string( $icon_data['filePath'] )
) {
_doing_it_wrong(
__FUNCTION__,
__( 'Core icon collection manifest must provide a valid "filePath" for each icon.' ),
'7.0.0'
);
return;
}
wp_register_icon(
'core/' . $icon_name,
array(
'label' => $icon_data['label'],
'file_path' => $icons_directory . $icon_data['filePath'],
)
);
}
}
/**
* Returns the SVG markup for a registered icon.
*
* @since 7.1.0
*
* @param string $name The namespaced icon name (e.g. 'core/plus',
* 'core/arrow-down', 'my-plugin/custom-icon').
* @param array $args {
* Optional. Arguments for the icon. Default empty array.
*
* @type int|null $size Width and height in pixels. Pass null to leave the
* SVG's intrinsic dimensions untouched. Default 24.
* @type string $class Additional CSS class names. Multiple classes may be
* provided as a space-separated string. Default empty string.
* @type string $label Accessible label. If provided, the SVG gets
* role="img" and aria-label. If omitted, the SVG
* gets aria-hidden="true" and focusable="false".
* Default empty string.
* }
* @return string SVG markup for the icon, or empty string if not found.
*/
function wp_get_icon( $name, $args = array() ) {
$icon = WP_Icons_Registry::get_instance()->get_registered_icon( $name );
if ( is_null( $icon ) ) {
return '';
}
$svg = $icon['content'];
if ( empty( $svg ) ) {
return '';
}
$args = wp_parse_args(
$args,
array(
'size' => 24,
'class' => '',
'label' => '',
)
);
$processor = new WP_HTML_Tag_Processor( $svg );
if ( ! $processor->next_tag( 'svg' ) ) {
return '';
}
if ( is_numeric( $args['size'] ) ) {
$size = absint( $args['size'] );
$processor->set_attribute( 'width', (string) $size );
$processor->set_attribute( 'height', (string) $size );
}
if ( ! empty( $args['class'] ) ) {
foreach ( preg_split( '/\s+/', $args['class'], -1, PREG_SPLIT_NO_EMPTY ) as $class_name ) {
$processor->add_class( $class_name );
}
}
if ( ! empty( $args['label'] ) ) {
$processor->set_attribute( 'role', 'img' );
$processor->set_attribute( 'aria-label', $args['label'] );
$processor->remove_attribute( 'aria-hidden' );
$processor->remove_attribute( 'focusable' );
} else {
$processor->set_attribute( 'aria-hidden', 'true' );
$processor->set_attribute( 'focusable', 'false' );
$processor->remove_attribute( 'role' );
$processor->remove_attribute( 'aria-label' );
}
return $processor->get_updated_html();
}