18
|
1 |
<?php |
|
2 |
/** |
|
3 |
* Spacing block support flag. |
|
4 |
* |
|
5 |
* @package WordPress |
|
6 |
* @since 5.8.0 |
|
7 |
*/ |
|
8 |
|
|
9 |
/** |
|
10 |
* Registers the style block attribute for block types that support it. |
|
11 |
* |
|
12 |
* @since 5.8.0 |
|
13 |
* @access private |
|
14 |
* |
|
15 |
* @param WP_Block_Type $block_type Block Type. |
|
16 |
*/ |
|
17 |
function wp_register_spacing_support( $block_type ) { |
|
18 |
$has_spacing_support = block_has_support( $block_type, array( 'spacing' ), false ); |
|
19 |
|
|
20 |
// Setup attributes and styles within that if needed. |
|
21 |
if ( ! $block_type->attributes ) { |
|
22 |
$block_type->attributes = array(); |
|
23 |
} |
|
24 |
|
|
25 |
if ( $has_spacing_support && ! array_key_exists( 'style', $block_type->attributes ) ) { |
|
26 |
$block_type->attributes['style'] = array( |
|
27 |
'type' => 'object', |
|
28 |
); |
|
29 |
} |
|
30 |
} |
|
31 |
|
|
32 |
/** |
|
33 |
* Add CSS classes for block spacing to the incoming attributes array. |
|
34 |
* This will be applied to the block markup in the front-end. |
|
35 |
* |
|
36 |
* @since 5.8.0 |
|
37 |
* @access private |
|
38 |
* |
|
39 |
* @param WP_Block_Type $block_type Block Type. |
|
40 |
* @param array $block_attributes Block attributes. |
|
41 |
* |
|
42 |
* @return array Block spacing CSS classes and inline styles. |
|
43 |
*/ |
|
44 |
function wp_apply_spacing_support( $block_type, $block_attributes ) { |
|
45 |
$has_padding_support = wp_has_spacing_feature_support( $block_type, 'padding' ); |
|
46 |
$has_margin_support = wp_has_spacing_feature_support( $block_type, 'margin' ); |
|
47 |
$styles = array(); |
|
48 |
|
|
49 |
if ( $has_padding_support ) { |
|
50 |
$padding_value = _wp_array_get( $block_attributes, array( 'style', 'spacing', 'padding' ), null ); |
|
51 |
if ( null !== $padding_value ) { |
|
52 |
foreach ( $padding_value as $key => $value ) { |
|
53 |
$styles[] = sprintf( 'padding-%s: %s;', $key, $value ); |
|
54 |
} |
|
55 |
} |
|
56 |
} |
|
57 |
|
|
58 |
if ( $has_margin_support ) { |
|
59 |
$margin_value = _wp_array_get( $block_attributes, array( 'style', 'spacing', 'margin' ), null ); |
|
60 |
if ( null !== $margin_value ) { |
|
61 |
foreach ( $margin_value as $key => $value ) { |
|
62 |
$styles[] = sprintf( 'margin-%s: %s;', $key, $value ); |
|
63 |
} |
|
64 |
} |
|
65 |
} |
|
66 |
|
|
67 |
return empty( $styles ) ? array() : array( 'style' => implode( ' ', $styles ) ); |
|
68 |
} |
|
69 |
|
|
70 |
/** |
|
71 |
* Checks whether the current block type supports the spacing feature requested. |
|
72 |
* |
|
73 |
* @since 5.8.0 |
|
74 |
* @access private |
|
75 |
* |
|
76 |
* @param WP_Block_Type $block_type Block type to check for support. |
|
77 |
* @param string $feature Name of the feature to check support for. |
|
78 |
* @param mixed $default Fallback value for feature support, defaults to false. |
|
79 |
* |
|
80 |
* @return boolean Whether or not the feature is supported. |
|
81 |
*/ |
|
82 |
function wp_has_spacing_feature_support( $block_type, $feature, $default = false ) { |
|
83 |
// Check if the specific feature has been opted into individually |
|
84 |
// via nested flag under `spacing`. |
|
85 |
return block_has_support( $block_type, array( 'spacing', $feature ), $default ); |
|
86 |
} |
|
87 |
|
|
88 |
// Register the block support. |
|
89 |
WP_Block_Supports::get_instance()->register( |
|
90 |
'spacing', |
|
91 |
array( |
|
92 |
'register_attribute' => 'wp_register_spacing_support', |
|
93 |
'apply' => 'wp_apply_spacing_support', |
|
94 |
) |
|
95 |
); |