- ',
+ $container_attributes
+ );
+ }
+
+ if ( ! $is_list_item && $is_list_open ) {
+ $is_list_open = false;
+ $inner_blocks_html .= '
+
+
',
+ esc_attr( $modal_unique_id ),
+ $inner_blocks_html,
+ $toggle_aria_label_open,
+ $toggle_aria_label_close,
+ esc_attr( implode( ' ', $responsive_container_classes ) ),
+ esc_attr( implode( ' ', $open_button_classes ) ),
+ esc_attr( safecss_filter_attr( $colors['overlay_inline_styles'] ) ),
+ $toggle_button_content,
+ $toggle_close_button_content,
+ $open_button_directives,
+ $responsive_container_directives,
+ $responsive_dialog_directives,
+ $close_button_directives
+ );
+ }
+
+ /**
+ * Get the wrapper attributes
+ *
+ * @param array $attributes The block attributes.
+ * @param WP_Block_List $inner_blocks A list of inner blocks.
+ * @param string $nav_menu_name The name of the navigation menu.
+ * @return string Returns the navigation block markup.
+ */
+ private static function get_nav_wrapper_attributes( $attributes, $inner_blocks, $nav_menu_name ) {
+ $should_load_view_script = static::should_load_view_script( $attributes, $inner_blocks );
+ $is_responsive_menu = static::is_responsive( $attributes );
+ $style = static::get_styles( $attributes );
+ $class = static::get_classes( $attributes );
+ $wrapper_attributes = get_block_wrapper_attributes(
+ array(
+ 'class' => $class,
+ 'style' => $style,
+ 'aria-label' => $nav_menu_name,
+ )
+ );
+
+ if ( $is_responsive_menu ) {
+ $nav_element_directives = static::get_nav_element_directives( $should_load_view_script );
+ $wrapper_attributes .= ' ' . $nav_element_directives;
+ }
+
+ return $wrapper_attributes;
+ }
+
+ /**
+ * Get the nav element directives
+ *
+ * @param bool $should_load_view_script Whether or not the view script should be loaded.
+ * @return string the directives for the navigation element.
+ */
+ private static function get_nav_element_directives( $should_load_view_script ) {
+ if ( ! $should_load_view_script ) {
+ return '';
+ }
+ // When adding to this array be mindful of security concerns.
+ $nav_element_context = wp_json_encode(
+ array(
+ 'core' => array(
+ 'navigation' => array(
+ 'overlayOpenedBy' => array(),
+ 'type' => 'overlay',
+ 'roleAttribute' => '',
+ 'ariaLabel' => __( 'Menu' ),
+ ),
+ ),
+ ),
+ JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_AMP
+ );
+ return '
+ data-wp-interactive
+ data-wp-context=\'' . $nav_element_context . '\'
+ ';
+ }
+
+ /**
+ * Handle view script loading.
+ *
+ * @param array $attributes The block attributes.
+ * @param WP_Block $block The parsed block.
+ * @param WP_Block_List $inner_blocks The list of inner blocks.
+ */
+ private static function handle_view_script_loading( $attributes, $block, $inner_blocks ) {
+ $should_load_view_script = static::should_load_view_script( $attributes, $inner_blocks );
+
+ $view_js_file = 'wp-block-navigation-view';
+
+ // If the script already exists, there is no point in removing it from viewScript.
+ if ( ! wp_script_is( $view_js_file ) ) {
+ $script_handles = $block->block_type->view_script_handles;
+
+ // If the script is not needed, and it is still in the `view_script_handles`, remove it.
+ if ( ! $should_load_view_script && in_array( $view_js_file, $script_handles, true ) ) {
+ $block->block_type->view_script_handles = array_diff( $script_handles, array( $view_js_file ) );
+ }
+ // If the script is needed, but it was previously removed, add it again.
+ if ( $should_load_view_script && ! in_array( $view_js_file, $script_handles, true ) ) {
+ $block->block_type->view_script_handles = array_merge( $script_handles, array( $view_js_file ) );
+ }
+ }
+ }
+
+ /**
+ * Returns the markup for the navigation block.
+ *
+ * @param array $attributes The block attributes.
+ * @param WP_Block_List $inner_blocks The list of inner blocks.
+ * @return string Returns the navigation wrapper markup.
+ */
+ private static function get_wrapper_markup( $attributes, $inner_blocks ) {
+ $inner_blocks_html = static::get_inner_blocks_html( $attributes, $inner_blocks );
+ if ( static::is_responsive( $attributes ) ) {
+ return static::get_responsive_container_markup( $attributes, $inner_blocks, $inner_blocks_html );
+ }
+ return $inner_blocks_html;
+ }
+
+ /**
+ * Renders the navigation block.
+ *
+ * @param array $attributes The block attributes.
+ * @param string $content The saved content.
+ * @param WP_Block $block The parsed block.
+ * @return string Returns the navigation block markup.
+ */
+ public static function render( $attributes, $content, $block ) {
+ static $seen_menu_names = array();
+
+ $nav_menu_name = static::get_navigation_name( $attributes, $seen_menu_names );
+
+ /**
+ * Deprecated:
+ * The rgbTextColor and rgbBackgroundColor attributes
+ * have been deprecated in favor of
+ * customTextColor and customBackgroundColor ones.
+ * Move the values from old attrs to the new ones.
+ */
+ if ( isset( $attributes['rgbTextColor'] ) && empty( $attributes['textColor'] ) ) {
+ $attributes['customTextColor'] = $attributes['rgbTextColor'];
+ }
+
+ if ( isset( $attributes['rgbBackgroundColor'] ) && empty( $attributes['backgroundColor'] ) ) {
+ $attributes['customBackgroundColor'] = $attributes['rgbBackgroundColor'];
+ }
+
+ unset( $attributes['rgbTextColor'], $attributes['rgbBackgroundColor'] );
+
+ $inner_blocks = static::get_inner_blocks( $attributes, $block );
+ // Prevent navigation blocks referencing themselves from rendering.
+ if ( block_core_navigation_block_contains_core_navigation( $inner_blocks ) ) {
+ return '';
+ }
+
+ // If the menu name has been used previously then append an ID
+ // to the name to ensure uniqueness across a given post.
+ if ( isset( $seen_menu_names[ $nav_menu_name ] ) && $seen_menu_names[ $nav_menu_name ] > 1 ) {
+ $count = $seen_menu_names[ $nav_menu_name ];
+ $nav_menu_name = $nav_menu_name . ' ' . ( $count );
+ }
+
+ $wrapper_attributes = static::get_nav_wrapper_attributes( $attributes, $inner_blocks, $nav_menu_name );
+
+ static::handle_view_script_loading( $attributes, $block, $inner_blocks );
+
+ return sprintf(
+ '',
+ $wrapper_attributes,
+ static::get_wrapper_markup( $attributes, $inner_blocks )
+ );
+ }
+}
From a9f307bf4f9a111b82b31062a4c3a8c34a1b881a Mon Sep 17 00:00:00 2001
From: scruffian - ',
- $container_attributes
- );
- }
-
- if ( ! $is_list_item && $is_list_open ) {
- $is_list_open = false;
- $inner_blocks_html .= '
-
-
',
- esc_attr( $modal_unique_id ),
- $inner_blocks_html,
- $toggle_aria_label_open,
- $toggle_aria_label_close,
- esc_attr( implode( ' ', $responsive_container_classes ) ),
- esc_attr( implode( ' ', $open_button_classes ) ),
- esc_attr( safecss_filter_attr( $colors['overlay_inline_styles'] ) ),
- $toggle_button_content,
- $toggle_close_button_content,
- $open_button_directives,
- $responsive_container_directives,
- $responsive_dialog_directives,
- $close_button_directives
- );
- }
-
- /**
- * Get the wrapper attributes
- *
- * @param array $attributes The block attributes.
- * @param WP_Block_List $inner_blocks A list of inner blocks.
- * @param string $nav_menu_name The name of the navigation menu.
- * @return string Returns the navigation block markup.
- */
- private static function get_nav_wrapper_attributes( $attributes, $inner_blocks, $nav_menu_name ) {
- $should_load_view_script = static::should_load_view_script( $attributes, $inner_blocks );
- $is_responsive_menu = static::is_responsive( $attributes );
- $style = static::get_styles( $attributes );
- $class = static::get_classes( $attributes );
- $wrapper_attributes = get_block_wrapper_attributes(
- array(
- 'class' => $class,
- 'style' => $style,
- 'aria-label' => $nav_menu_name,
- )
- );
-
- if ( $is_responsive_menu ) {
- $nav_element_directives = static::get_nav_element_directives( $should_load_view_script );
- $wrapper_attributes .= ' ' . $nav_element_directives;
- }
-
- return $wrapper_attributes;
- }
-
- /**
- * Get the nav element directives
- *
- * @param bool $should_load_view_script Whether or not the view script should be loaded.
- * @return string the directives for the navigation element.
- */
- private static function get_nav_element_directives( $should_load_view_script ) {
- if ( ! $should_load_view_script ) {
- return '';
- }
- // When adding to this array be mindful of security concerns.
- $nav_element_context = wp_json_encode(
- array(
- 'core' => array(
- 'navigation' => array(
- 'overlayOpenedBy' => array(),
- 'type' => 'overlay',
- 'roleAttribute' => '',
- 'ariaLabel' => __( 'Menu' ),
- ),
- ),
- ),
- JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_AMP
- );
- return '
- data-wp-interactive
- data-wp-context=\'' . $nav_element_context . '\'
- ';
- }
-
- /**
- * Handle view script loading.
- *
- * @param array $attributes The block attributes.
- * @param WP_Block $block The parsed block.
- * @param WP_Block_List $inner_blocks The list of inner blocks.
- */
- private static function handle_view_script_loading( $attributes, $block, $inner_blocks ) {
- $should_load_view_script = static::should_load_view_script( $attributes, $inner_blocks );
-
- $view_js_file = 'wp-block-navigation-view';
-
- // If the script already exists, there is no point in removing it from viewScript.
- if ( ! wp_script_is( $view_js_file ) ) {
- $script_handles = $block->block_type->view_script_handles;
-
- // If the script is not needed, and it is still in the `view_script_handles`, remove it.
- if ( ! $should_load_view_script && in_array( $view_js_file, $script_handles, true ) ) {
- $block->block_type->view_script_handles = array_diff( $script_handles, array( $view_js_file ) );
- }
- // If the script is needed, but it was previously removed, add it again.
- if ( $should_load_view_script && ! in_array( $view_js_file, $script_handles, true ) ) {
- $block->block_type->view_script_handles = array_merge( $script_handles, array( $view_js_file ) );
- }
- }
- }
-
- /**
- * Returns the markup for the navigation block.
- *
- * @param array $attributes The block attributes.
- * @param WP_Block_List $inner_blocks The list of inner blocks.
- * @return string Returns the navigation wrapper markup.
- */
- private static function get_wrapper_markup( $attributes, $inner_blocks ) {
- $inner_blocks_html = static::get_inner_blocks_html( $attributes, $inner_blocks );
- if ( static::is_responsive( $attributes ) ) {
- return static::get_responsive_container_markup( $attributes, $inner_blocks, $inner_blocks_html );
- }
- return $inner_blocks_html;
- }
-
- /**
- * Renders the navigation block.
- *
- * @param array $attributes The block attributes.
- * @param string $content The saved content.
- * @param WP_Block $block The parsed block.
- * @return string Returns the navigation block markup.
- */
- public static function render( $attributes, $content, $block ) {
- static $seen_menu_names = array();
-
- $nav_menu_name = static::get_navigation_name( $attributes, $seen_menu_names );
-
- /**
- * Deprecated:
- * The rgbTextColor and rgbBackgroundColor attributes
- * have been deprecated in favor of
- * customTextColor and customBackgroundColor ones.
- * Move the values from old attrs to the new ones.
- */
- if ( isset( $attributes['rgbTextColor'] ) && empty( $attributes['textColor'] ) ) {
- $attributes['customTextColor'] = $attributes['rgbTextColor'];
- }
-
- if ( isset( $attributes['rgbBackgroundColor'] ) && empty( $attributes['backgroundColor'] ) ) {
- $attributes['customBackgroundColor'] = $attributes['rgbBackgroundColor'];
- }
-
- unset( $attributes['rgbTextColor'], $attributes['rgbBackgroundColor'] );
-
- $inner_blocks = static::get_inner_blocks( $attributes, $block );
- // Prevent navigation blocks referencing themselves from rendering.
- if ( block_core_navigation_block_contains_core_navigation( $inner_blocks ) ) {
- return '';
- }
-
- // If the menu name has been used previously then append an ID
- // to the name to ensure uniqueness across a given post.
- if ( isset( $seen_menu_names[ $nav_menu_name ] ) && $seen_menu_names[ $nav_menu_name ] > 1 ) {
- $count = $seen_menu_names[ $nav_menu_name ];
- $nav_menu_name = $nav_menu_name . ' ' . ( $count );
- }
-
- $wrapper_attributes = static::get_nav_wrapper_attributes( $attributes, $inner_blocks, $nav_menu_name );
-
- static::handle_view_script_loading( $attributes, $block, $inner_blocks );
-
- return sprintf(
- '',
- $wrapper_attributes,
- static::get_wrapper_markup( $attributes, $inner_blocks )
- );
- }
-}
From e94446acb3071db0b5321e29def411ea58be3043 Mon Sep 17 00:00:00 2001
From: George Mamadashvili Selected tab: Tab 2
Selected tab: Tab 3
+
+ This tabpanel has its focusable prop set to
+ false, so it won't get a tab stop.
+
+ Instead, the [Tab] key will move focus to the first
+ focusable element within the panel.
+
+ { __( 'Custom Views' ) }
+
+ Example: ![]()
This is a test>
';
$tags = new WP_HTML_Tag_Processor( $markup );
- gutenberg_interactivity_process_directives( $tags, 'foo-', $directives );
+ gutenberg_interactivity_process_rendered_html( $tags, 'foo-', $directives );
}
public function test_directives_with_double_hyphen_processed_correctly() {
$test_helper = $this->createMock( Helper_Class::class );
$test_helper->expects( $this->atLeastOnce() )
- ->method( 'process_foo_test' );
+ ->method( 'process_foo_test' );
$directives = array(
'foo-test' => array( $test_helper, 'process_foo_test' ),
@@ -74,10 +74,76 @@ public function test_directives_with_double_hyphen_processed_correctly() {
$markup = '';
$tags = new WP_HTML_Tag_Processor( $markup );
- gutenberg_interactivity_process_directives( $tags, 'foo-', $directives );
+ gutenberg_interactivity_process_rendered_html( $tags, 'foo-', $directives );
+ }
+
+ public function test_interactivity_process_directives_in_root_blocks() {
+ $pattern_content =
+ '' .
+ 'Here is a nested div
Pattern Content Block 1
' . + '' . + '' . + 'Pattern Content Block 2
' . + ''; + register_block_pattern( + 'core/interactivity-pattern', + array( + 'title' => 'Interactivity Pattern', + 'content' => $pattern_content, + ) + ); + + $providers = $this->data_only_root_blocks_are_processed(); + foreach ( $providers as $provider ) { + do_blocks( $provider['page_content'] ); + $this->assertSame( $provider['root_blocks'], count( WP_Directive_Processor::$root_blocks ) ); + + } + } + + /** + * Data provider . + * + * @return array + **/ + public function data_only_root_blocks_are_processed() { + + return array( + array( + 'root_blocks' => 2, + 'page_content' => + '' . + '+ ' . + '' . + '' . + '' . + 'The XYZ Doohickey Company was founded in 1971, and has been providing' . + 'quality doohickeys to the public ever since. Located in Gotham City, XYZ employs' . + 'over 2,000 people and does all kinds of awesome things for the Gotham community.
' . + ' +
+ ' . + '' . + '', + ), + array( + 'root_blocks' => 2, + 'page_content' => + '' . + 'The XYZ Doohickey Company was founded in 1971, and has been providing' . + 'quality doohickeys to the public ever since. Located in Gotham City, XYZ employs' . + 'over 2,000 people and does all kinds of awesome things for the Gotham community.
' . + ' +
Welcome to WordPress. This is your first post. Edit or delete it, then start writing!
' . + '' . + '', + ), + ); } } + /** * Tests for the gutenberg_interactivity_evaluate_reference function. * From 08f0b7aebae8efe47f5d5b97ca02d952482eae96 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9?= <583546+oandregal@users.noreply.github.com> Date: Wed, 8 Nov 2023 13:56:37 +0100 Subject: [PATCH 32/34] DataViews: document actions (#55959) --- .../edit-site/src/components/dataviews/README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/packages/edit-site/src/components/dataviews/README.md b/packages/edit-site/src/components/dataviews/README.md index 64cae92d4e874c..7a5abc8ad485da 100644 --- a/packages/edit-site/src/components/dataviews/README.md +++ b/packages/edit-site/src/components/dataviews/README.md @@ -171,3 +171,15 @@ Example: - `render`: function that renders the field. - `elements`: the set of valid values for the field's value. - `filters`: what filter operators are available for the user to use over this field. Only `in` available at the moment. + +## Actions + +Array of operations that can be performed upon each record. Each action is an object with the following properties: + +- `id`: string, required. Unique identifier of the action. For example, `move-to-trash`. +- `label`: string, required. User facing description of the action. For example, `Move to Trash`. +- `isPrimary`: boolean, optional. Whether the action should be listed inline (primary) or in hidden in the more actions menu (secondary). +- `icon`: icon to show for primary actions. It's required for a primary action, otherwise the action would be considered secondary. +- `isEligible`: function, optional. Whether the action can be performed for a given record. If not present, the action is considered to be eligible for all items. It takes the given record as input. +- `isDestructive`: boolean, optional. Whether the action can delete data, in which case the UI would communicate it via red color. +- `perform`: function, required. Function that takes the record as input and performs the required action. From a522e392cfe9271d7e09878abc4278ed4c398a00 Mon Sep 17 00:00:00 2001 From: flootr