@wordpress/block-library 9.28.0 → 9.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/block-library",
-	"version": "9.28.0",
+	"version": "9.29.0",
 	"description": "Block library for the WordPress editor.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -27,6 +27,7 @@
 	"react-native": "src/index",
 	"wpScript": true,
 	"wpScriptModuleExports": {
+		"./accordion/view": "./build-module/accordion/view.js",
 		"./file/view": "./build-module/file/view.js",
 		"./form/view": "./build-module/form/view.js",
 		"./image/view": "./build-module/image/view.js",
@@ -41,39 +42,39 @@
 	],
 	"dependencies": {
 		"@babel/runtime": "7.25.7",
-		"@wordpress/a11y": "^4.28.0",
-		"@wordpress/api-fetch": "^7.28.0",
-		"@wordpress/autop": "^4.28.0",
-		"@wordpress/blob": "^4.28.0",
-		"@wordpress/block-editor": "^15.1.0",
-		"@wordpress/blocks": "^15.1.0",
-		"@wordpress/components": "^30.1.0",
-		"@wordpress/compose": "^7.28.0",
-		"@wordpress/core-data": "^7.28.0",
-		"@wordpress/data": "^10.28.0",
-		"@wordpress/date": "^5.28.0",
-		"@wordpress/deprecated": "^4.28.0",
-		"@wordpress/dom": "^4.28.0",
-		"@wordpress/element": "^6.28.0",
-		"@wordpress/escape-html": "^3.28.0",
-		"@wordpress/hooks": "^4.28.0",
-		"@wordpress/html-entities": "^4.28.0",
-		"@wordpress/i18n": "^6.1.0",
-		"@wordpress/icons": "^10.28.0",
-		"@wordpress/interactivity": "^6.28.0",
-		"@wordpress/interactivity-router": "^2.28.0",
-		"@wordpress/keyboard-shortcuts": "^5.28.0",
-		"@wordpress/keycodes": "^4.28.0",
-		"@wordpress/notices": "^5.28.0",
-		"@wordpress/patterns": "^2.28.0",
-		"@wordpress/primitives": "^4.28.0",
-		"@wordpress/private-apis": "^1.28.0",
-		"@wordpress/reusable-blocks": "^5.28.0",
-		"@wordpress/rich-text": "^7.28.0",
-		"@wordpress/server-side-render": "^6.4.0",
-		"@wordpress/url": "^4.28.0",
-		"@wordpress/viewport": "^6.28.0",
-		"@wordpress/wordcount": "^4.28.0",
+		"@wordpress/a11y": "^4.29.0",
+		"@wordpress/api-fetch": "^7.29.0",
+		"@wordpress/autop": "^4.29.0",
+		"@wordpress/blob": "^4.29.0",
+		"@wordpress/block-editor": "^15.2.0",
+		"@wordpress/blocks": "^15.2.0",
+		"@wordpress/components": "^30.2.0",
+		"@wordpress/compose": "^7.29.0",
+		"@wordpress/core-data": "^7.29.0",
+		"@wordpress/data": "^10.29.0",
+		"@wordpress/date": "^5.29.0",
+		"@wordpress/deprecated": "^4.29.0",
+		"@wordpress/dom": "^4.29.0",
+		"@wordpress/element": "^6.29.0",
+		"@wordpress/escape-html": "^3.29.0",
+		"@wordpress/hooks": "^4.29.0",
+		"@wordpress/html-entities": "^4.29.0",
+		"@wordpress/i18n": "^6.2.0",
+		"@wordpress/icons": "^10.29.0",
+		"@wordpress/interactivity": "^6.29.0",
+		"@wordpress/interactivity-router": "^2.29.0",
+		"@wordpress/keyboard-shortcuts": "^5.29.0",
+		"@wordpress/keycodes": "^4.29.0",
+		"@wordpress/notices": "^5.29.0",
+		"@wordpress/patterns": "^2.29.0",
+		"@wordpress/primitives": "^4.29.0",
+		"@wordpress/private-apis": "^1.29.0",
+		"@wordpress/reusable-blocks": "^5.29.0",
+		"@wordpress/rich-text": "^7.29.0",
+		"@wordpress/server-side-render": "^6.5.0",
+		"@wordpress/url": "^4.29.0",
+		"@wordpress/viewport": "^6.29.0",
+		"@wordpress/wordcount": "^4.29.0",
 		"change-case": "^4.1.2",
 		"clsx": "^2.1.1",
 		"colord": "^2.7.0",
@@ -91,5 +92,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "28cc2098f5ee28f89096b638533796538f495f72"
+	"gitHead": "445ede01e8abc8e49a1101b21a3651adbe852120"
 }

package/src/accordion/block.json

@@ -0,0 +1,69 @@
+{
+	"$schema": "https://schemas.wp.org/trunk/block.json",
+	"apiVersion": 3,
+	"name": "core/accordion",
+	"title": "Accordion",
+	"category": "design",
+	"description": "Displays a group of accordion headers and associated expandable content.",
+	"example": {},
+	"__experimental": true,
+	"supports": {
+		"html": false,
+		"align": [ "wide", "full" ],
+		"background": {
+			"backgroundImage": true,
+			"backgroundSize": true,
+			"__experimentalDefaultControls": {
+				"backgroundImage": true
+			}
+		},
+		"color": {
+			"background": true,
+			"gradient": true
+		},
+		"__experimentalBorder": {
+			"color": true,
+			"radius": true,
+			"style": true,
+			"width": true,
+			"__experimentalDefaultControls": {
+				"color": true,
+				"radius": true,
+				"style": true,
+				"width": true
+			}
+		},
+		"spacing": {
+			"padding": true,
+			"margin": [ "top", "bottom" ],
+			"blockGap": true
+		},
+		"shadow": true,
+		"layout": true,
+		"interactivity": true
+	},
+	"attributes": {
+		"iconPosition": {
+			"type": "string",
+			"default": "right"
+		},
+		"showIcon": {
+			"type": "boolean",
+			"default": true
+		},
+		"autoclose": {
+			"type": "boolean",
+			"default": false
+		},
+		"allowedBlocks": {
+			"type": "array"
+		}
+	},
+	"providesContext": {
+		"core/accordion-icon-position": "iconPosition",
+		"core/accordion-show-icon": "showIcon"
+	},
+	"allowedBlocks": [ "core/accordion-content" ],
+	"textdomain": "default",
+	"style": "wp-block-accordion"
+}

package/src/accordion/edit.js

@@ -0,0 +1,133 @@
+/**
+ * WordPress dependencies
+ */
+import {
+	useBlockProps,
+	useInnerBlocksProps,
+	InspectorControls,
+} from '@wordpress/block-editor';
+import { __ } from '@wordpress/i18n';
+import {
+	ToggleControl,
+	__experimentalToggleGroupControl as ToggleGroupControl,
+	__experimentalToggleGroupControlOption as ToggleGroupControlOption,
+	__experimentalToolsPanel as ToolsPanel,
+	__experimentalToolsPanelItem as ToolsPanelItem,
+} from '@wordpress/components';
+
+/**
+ * Internal dependencies
+ */
+import { useToolsPanelDropdownMenuProps } from '../utils/hooks';
+
+const ACCORDION_BLOCK_NAME = 'core/accordion-content';
+const ACCORDION_BLOCK = {
+	name: ACCORDION_BLOCK_NAME,
+};
+
+export default function Edit( {
+	attributes: { autoclose, iconPosition, showIcon },
+	setAttributes,
+} ) {
+	const blockProps = useBlockProps();
+	const dropdownMenuProps = useToolsPanelDropdownMenuProps();
+
+	const innerBlocksProps = useInnerBlocksProps( blockProps, {
+		template: [ [ ACCORDION_BLOCK_NAME ], [ ACCORDION_BLOCK_NAME ] ],
+		defaultBlock: ACCORDION_BLOCK,
+		directInsert: true,
+		templateInsertUpdatesSelection: true,
+	} );
+
+	return (
+		<>
+			<InspectorControls key="setting">
+				<ToolsPanel
+					label={ __( 'Settings' ) }
+					resetAll={ () => {
+						setAttributes( {
+							autoclose: false,
+							showIcon: true,
+							iconPosition: 'right',
+						} );
+					} }
+					dropdownMenuProps={ dropdownMenuProps }
+				>
+					<ToolsPanelItem
+						label={ __( 'Auto-close' ) }
+						isShownByDefault
+						hasValue={ () => !! autoclose }
+						onDeselect={ () =>
+							setAttributes( { autoclose: false } )
+						}
+					>
+						<ToggleControl
+							isBlock
+							__nextHasNoMarginBottom
+							label={ __( 'Auto-close' ) }
+							onChange={ ( value ) => {
+								setAttributes( {
+									autoclose: value,
+								} );
+							} }
+							checked={ autoclose }
+							help={ __(
+								'Automatically close accordions when a new one is opened.'
+							) }
+						/>
+					</ToolsPanelItem>
+					<ToolsPanelItem
+						label={ __( 'Show icon' ) }
+						isShownByDefault
+						hasValue={ () => ! showIcon }
+						onDeselect={ () => setAttributes( { showIcon: true } ) }
+					>
+						<ToggleControl
+							isBlock
+							__nextHasNoMarginBottom
+							label={ __( 'Show icon' ) }
+							onChange={ ( value ) => {
+								setAttributes( {
+									showIcon: value,
+								} );
+							} }
+							checked={ showIcon }
+							help={ __(
+								'Display a plus icon next to the accordion header.'
+							) }
+						/>
+					</ToolsPanelItem>
+					<ToolsPanelItem
+						label={ __( 'Icon Position' ) }
+						isShownByDefault
+						hasValue={ () => iconPosition !== 'right' }
+						onDeselect={ () =>
+							setAttributes( { iconPosition: 'right' } )
+						}
+					>
+						<ToggleGroupControl
+							__nextHasNoMarginBottom
+							__next40pxDefaultSize
+							isBlock
+							label={ __( 'Icon Position' ) }
+							value={ iconPosition }
+							onChange={ ( value ) => {
+								setAttributes( { iconPosition: value } );
+							} }
+						>
+							<ToggleGroupControlOption
+								label={ __( 'Left' ) }
+								value="left"
+							/>
+							<ToggleGroupControlOption
+								label={ __( 'Right' ) }
+								value="right"
+							/>
+						</ToggleGroupControl>
+					</ToolsPanelItem>
+				</ToolsPanel>
+			</InspectorControls>
+			<div { ...innerBlocksProps } />
+		</>
+	);
+}

package/src/accordion/icon.js

@@ -0,0 +1,23 @@
+/**
+ * WordPress dependencies
+ */
+import { SVG, Path } from '@wordpress/primitives';
+
+export default (
+	<SVG xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+		<Path
+			fillRule="evenodd"
+			clipRule="evenodd"
+			d="M19.5 9.25L9.5 9.25L9.5 7.75L19.5 7.75L19.5 9.25Z"
+			fill="currentColor"
+		/>
+		<Path d="M4.5 6L8.5 8.5L4.5 11L4.5 6Z" fill="currentColor" />
+		<Path
+			fillRule="evenodd"
+			clipRule="evenodd"
+			d="M19.5 16.25L9.5 16.25L9.5 14.75L19.5 14.75L19.5 16.25Z"
+			fill="currentColor"
+		/>
+		<Path d="M4.5 13L8.5 15.5L4.5 18L4.5 13Z" fill="currentColor" />
+	</SVG>
+);

package/src/accordion/index.js

@@ -0,0 +1,21 @@
+/**
+ * Internal dependencies
+ */
+import edit from './edit';
+import save from './save';
+import metadata from './block.json';
+import initBlock from '../utils/init-block';
+import icon from './icon';
+
+const { name } = metadata;
+
+export { metadata, name };
+
+export const settings = {
+	icon,
+	example: {},
+	edit,
+	save,
+};
+
+export const init = () => initBlock( { name, metadata, settings } );

package/src/accordion/index.php

@@ -0,0 +1,61 @@
+<?php
+/**
+ * Server-side rendering of the `core/accordion` block.
+ *
+ * @package WordPress
+ * @since 6.6.0
+ *
+ * @param array $attributes The block attributes.
+ * @param string $content The block content.
+ *
+ * @return string Returns the updated markup.
+ */
+function render_block_core_accordion( $attributes, $content ) {
+	if ( ! $content ) {
+		return $content;
+	}
+
+	$suffix = wp_scripts_get_suffix();
+	if ( defined( 'IS_GUTENBERG_PLUGIN' ) && IS_GUTENBERG_PLUGIN ) {
+		$module_url = gutenberg_url( '/build-module/block-library/accordion/view.min.js' );
+	}
+
+	wp_register_script_module(
+		'@wordpress/block-library/accordion',
+		isset( $module_url ) ? $module_url : includes_url( "blocks/accordion/view{$suffix}.js" ),
+		array( '@wordpress/interactivity' ),
+		defined( 'GUTENBERG_VERSION' ) ? GUTENBERG_VERSION : get_bloginfo( 'version' )
+	);
+
+	wp_enqueue_script_module( '@wordpress/block-library/accordion' );
+
+	$p             = new WP_HTML_Tag_Processor( $content );
+	$autoclose     = $attributes['autoclose'] ? 'true' : 'false';
+	$icon          = $attributes['icon'] ?? 'plus';
+	$icon_position = $attributes['iconPosition'] ?? 'right';
+
+	if ( $p->next_tag( array( 'class_name' => 'wp-block-accordion' ) ) ) {
+		$p->set_attribute( 'data-wp-interactive', 'core/accordion' );
+		$p->set_attribute( 'data-wp-context', '{ "autoclose": ' . $autoclose . ', "isOpen": [], "icon": "' . $icon . '", "iconPosition": "' . $icon_position . '" }' );
+
+		// Only modify content if directives have been set.
+		$content = $p->get_updated_html();
+	}
+
+	return $content;
+}
+
+/**
+ * Registers the `core/accordion` block on server.
+ *
+ * @since 6.6.0
+ */
+function register_block_core_accordion() {
+	register_block_type_from_metadata(
+		__DIR__ . '/accordion',
+		array(
+			'render_callback' => 'render_block_core_accordion',
+		)
+	);
+}
+add_action( 'init', 'register_block_core_accordion' );

package/src/accordion/init.js

@@ -0,0 +1,6 @@
+/**
+ * Internal dependencies
+ */
+import { init } from './';
+
+export default init();

package/src/accordion/save.js

@@ -0,0 +1,23 @@
+/**
+ * External dependencies
+ */
+import clsx from 'clsx';
+/**
+ * WordPress dependencies
+ */
+import { useBlockProps, useInnerBlocksProps } from '@wordpress/block-editor';
+
+export default function save( { attributes } ) {
+	const { iconPosition } = attributes;
+	const blockProps = useBlockProps.save();
+	const className = clsx(
+		{
+			'icon-position-left': iconPosition === 'left',
+		},
+		blockProps.className
+	);
+
+	return (
+		<div { ...useInnerBlocksProps.save( { ...blockProps, className } ) } />
+	);
+}

package/src/accordion/style.scss

@@ -0,0 +1,91 @@
+.wp-block-accordion-content {
+	display: grid;
+	grid-template-rows: max-content 0fr;
+}
+
+.wp-block-accordion-content.is-open {
+	grid-template-rows: max-content 1fr;
+}
+
+.accordion-content__heading {
+	margin-block-start: 0;
+	margin-block-end: 0;
+}
+
+.accordion-content__toggle {
+	font-family: inherit;
+	font-size: inherit;
+	font-weight: inherit;
+	line-height: inherit;
+	letter-spacing: inherit;
+	text-transform: inherit;
+	text-decoration: inherit;
+	word-spacing: inherit;
+	background: none;
+	border: none;
+	color: inherit;
+	padding: var(--wp--preset--spacing--20, 1em) 0;
+	cursor: pointer;
+	outline: none;
+	display: flex;
+	align-items: center;
+	text-align: inherit;
+	position: relative;
+	width: 100%;
+}
+
+.accordion-content__toggle > span {
+	width: 100%;
+}
+
+.is-layout-flow > .wp-block-accordion-panel,
+.wp-block-accordion-panel {
+	overflow: hidden;
+	margin: 0;
+}
+
+.accordion-panel__wrapper {
+	padding-bottom: var(--wp--preset--spacing--20, 1em);
+}
+
+/* No icon block style */
+.is-style-no-icon .accordion-content__toggle-icon {
+	background-color: unset;
+}
+
+.wp-block-accordion-header.icon-position-left .accordion-content__toggle {
+	/* stylelint-disable-next-line declaration-property-value-allowed-list -- This should be refactored to not use the row-reverse value. */
+	flex-direction: row-reverse;
+}
+
+/* RTL language support */
+[dir="rtl"] .wp-block-accordion-header:not(.icon-position-left) .accordion-content__toggle {
+	/* stylelint-disable-next-line declaration-property-value-allowed-list -- Automatically adjust icon position for RTL languages. */
+	flex-direction: row-reverse;
+}
+
+[dir="rtl"] .wp-block-accordion-header.icon-position-left .accordion-content__toggle {
+	flex-direction: row;
+}
+
+.accordion-content__toggle:focus-visible {
+	outline: 2px solid -webkit-focus-ring-color;
+	outline-offset: 2px;
+}
+
+/* Add transitions only for users who do not prefer reduced motion */
+@media (prefers-reduced-motion: no-preference) {
+	.wp-block-accordion-content .accordion-content__toggle-icon {
+		transition: transform 0.2s ease-in-out;
+	}
+
+	.wp-block-accordion-content {
+		transition: grid-template-rows 0.3s ease-out;
+	}
+}
+
+.is-open {
+	.accordion-content__toggle-icon.has-icon-plus {
+		transform: rotate(45deg);
+	}
+}

package/src/accordion/view.js

@@ -0,0 +1,38 @@
+/**
+ * WordPress dependencies
+ */
+import { store, getContext } from '@wordpress/interactivity';
+
+const { state } = store( 'core/accordion', {
+	state: {
+		get isOpen() {
+			const { isOpen, id } = getContext();
+			return isOpen.includes( id );
+		},
+	},
+	actions: {
+		toggle: () => {
+			const context = getContext();
+			const { id, autoclose } = context;
+
+			if ( autoclose ) {
+				context.isOpen = state.isOpen ? [] : [ id ];
+			} else if ( state.isOpen ) {
+				context.isOpen = context.isOpen.filter(
+					( item ) => item !== id
+				);
+			} else {
+				context.isOpen.push( id );
+			}
+		},
+	},
+	callbacks: {
+		initIsOpen: () => {
+			const context = getContext();
+			const { id, openByDefault } = context;
+			if ( openByDefault ) {
+				context.isOpen.push( id );
+			}
+		},
+	},
+} );

package/src/accordion-content/block.json

@@ -0,0 +1,45 @@
+{
+	"$schema": "https://schemas.wp.org/trunk/block.json",
+	"apiVersion": 3,
+	"name": "core/accordion-content",
+	"version": "0.1.0",
+	"title": "Accordion Content",
+	"category": "design",
+	"description": "Displays a section of content in an accordion, including a header and expandable content.",
+	"example": {},
+	"__experimental": true,
+	"parent": [ "core/accordion" ],
+	"allowedBlocks": [ "core/accordion-header", "core/accordion-panel" ],
+	"supports": {
+		"align": [ "wide", "full" ],
+		"color": {
+			"background": true,
+			"gradient": true
+		},
+		"interactivity": true,
+		"spacing": {
+			"margin": [ "top", "bottom" ],
+			"blockGap": true
+		},
+		"__experimentalBorder": {
+			"color": true,
+			"radius": true,
+			"style": true,
+			"width": true,
+			"__experimentalDefaultControls": {
+				"color": true,
+				"radius": true,
+				"style": true,
+				"width": true
+			}
+		},
+		"shadow": true
+	},
+	"attributes": {
+		"openByDefault": {
+			"type": "boolean",
+			"default": false
+		}
+	},
+	"textdomain": "default"
+}