Summery Summery
Finds a style handle for the block metadata field. It detects when a path to file was provided and registers the style under automatically generated handle name. It returns unprocessed style handle otherwise.
Syntax Syntax
Parameters Parameters
- $metadata
-
(Required) Block metadata.
- $field_name
-
(Required) Field name to pick from metadata.
Return Return
(string|boolean) Style handle provided directly or created through style's registration, or false on failure.
Source Source
File: wp-includes/blocks.php
function register_block_style_handle( $metadata, $field_name ) {
if ( empty( $metadata[ $field_name ] ) ) {
return false;
}
$style_handle = $metadata[ $field_name ];
$style_path = remove_block_asset_path_prefix( $metadata[ $field_name ] );
if ( $style_handle === $style_path ) {
return $style_handle;
}
$style_handle = generate_block_asset_handle( $metadata['name'], $field_name );
$block_dir = dirname( $metadata['file'] );
$result = wp_register_style(
$style_handle,
plugins_url( $style_path, $metadata['file'] ),
array(),
filemtime( realpath( "$block_dir/$style_path" ) )
);
return $result ? $style_handle : false;
}
Advertisement
Changelog Changelog
| Version | Description |
|---|---|
| 5.5.0 | Introduced. |