@elementor/editor-editing-panel 1.30.0 → 1.31.0

package/src/components/style-sections/position-section/offset-field.tsx

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import { SizeControl } from '@elementor/editor-controls';
+import { Grid } from '@elementor/ui';
+import { __ } from '@wordpress/i18n';
+
+import { StylesField } from '../../../controls-registry/styles-field';
+import { ControlLabel } from '../../control-label';
+
+export const OffsetField = () => {
+	return (
+		<StylesField bind="scroll-margin-top">
+			<Grid container gap={ 2 } alignItems="center" flexWrap="nowrap">
+				<Grid item xs={ 6 }>
+					<ControlLabel>{ __( 'Anchor offset', 'elementor' ) }</ControlLabel>
+				</Grid>
+				<Grid item xs={ 6 }>
+					<SizeControl units={ [ 'px', 'em', 'rem', 'vw', 'vh' ] } />
+				</Grid>
+			</Grid>
+		</StylesField>
+	);
+};

package/src/components/style-sections/position-section/position-section.tsx

@@ -5,8 +5,10 @@ import { useSessionStorage } from '@elementor/session';
 import { useStyle } from '../../../contexts/style-context';
 import { useStylesField } from '../../../hooks/use-styles-field';
 import { useStylesFields } from '../../../hooks/use-styles-fields';
+import { PanelDivider } from '../../panel-divider';
 import { SectionContent } from '../../section-content';
 import { DimensionsField } from './dimensions-field';
+import { OffsetField } from './offset-field';
 import { PositionField } from './position-field';
 import { ZIndexField } from './z-index-field';
 
@@ -66,6 +68,8 @@ export const PositionSection = () => {
 					<ZIndexField />
 				</>
 			) : null }
+			<PanelDivider />
+			<OffsetField />
 		</SectionContent>
 	);
 };

package/src/components/style-tab.tsx

@@ -4,11 +4,12 @@ import { CLASSES_PROP_KEY } from '@elementor/editor-props';
 import { useActiveBreakpoint } from '@elementor/editor-responsive';
 import { type StyleDefinitionID, type StyleDefinitionState } from '@elementor/editor-styles';
 import { SessionStorageProvider } from '@elementor/session';
-import { Divider } from '@elementor/ui';
+import { Divider, Stack } from '@elementor/ui';
 import { __ } from '@wordpress/i18n';
 
 import { ClassesPropProvider } from '../contexts/classes-prop-context';
 import { useElement } from '../contexts/element-context';
+import { useScrollDirection } from '../contexts/scroll-context';
 import { StyleProvider } from '../contexts/style-context';
 import { StyleInheritanceProvider } from '../contexts/styles-inheritance-context';
 import { useActiveStyleDefId } from '../hooks/use-active-style-def-id';
@@ -24,6 +25,16 @@ import { SizeSection } from './style-sections/size-section/size-section';
 import { SpacingSection } from './style-sections/spacing-section/spacing-section';
 import { TypographySection } from './style-sections/typography-section/typography-section';
 
+const TABS_HEADER_HEIGHT = '37px';
+
+export const stickyHeaderStyles = {
+	position: 'sticky',
+	zIndex: 1,
+	opacity: 1,
+	backgroundColor: 'background.default',
+	transition: 'top 300ms ease',
+};
+
 export const StyleTab = () => {
 	const currentClassesProp = useCurrentClassesProp();
 	const [ activeStyleDefId, setActiveStyleDefId ] = useActiveStyleDefId( currentClassesProp );
@@ -43,8 +54,10 @@ export const StyleTab = () => {
 			>
 				<SessionStorageProvider prefix={ activeStyleDefId ?? '' }>
 					<StyleInheritanceProvider>
-						<CssClassSelector />
-						<Divider />
+						<ClassesHeader>
+							<CssClassSelector />
+							<Divider />
+						</ClassesHeader>
 						<SectionsList>
 							<Section title={ __( 'Layout', 'elementor' ) }>
 								<LayoutSection />
@@ -78,6 +91,16 @@ export const StyleTab = () => {
 	);
 };
 
+function ClassesHeader( { children }: { children: React.ReactNode } ) {
+	const scrollDirection = useScrollDirection();
+
+	return (
+		<Stack sx={ { ...stickyHeaderStyles, top: scrollDirection === 'up' ? TABS_HEADER_HEIGHT : 0 } }>
+			{ children }
+		</Stack>
+	);
+}
+
 function useCurrentClassesProp(): string {
 	const { elementType } = useElement();
 

package/src/contexts/scroll-context.tsx

@@ -0,0 +1,60 @@
+import * as React from 'react';
+import { createContext, type ReactNode, useContext, useEffect, useRef, useState } from 'react';
+import { styled } from '@elementor/ui';
+
+type ScrollDirection = 'up' | 'down';
+
+type ScrollContextValue = {
+	direction: ScrollDirection;
+};
+
+const ScrollContext = createContext< ScrollContextValue | undefined >( undefined );
+
+const ScrollPanel = styled( 'div' )`
+	height: 100%;
+	overflow-y: auto;
+`;
+
+const DEFAULT_SCROLL_DIRECTION: ScrollDirection = 'up';
+
+export function ScrollProvider( { children }: { children: ReactNode } ) {
+	const [ direction, setDirection ] = useState< ScrollDirection >( DEFAULT_SCROLL_DIRECTION );
+	const ref = useRef< HTMLDivElement >( null );
+	const scrollPos = useRef< number >( 0 );
+
+	useEffect( () => {
+		const scrollElement = ref.current;
+
+		if ( ! scrollElement ) {
+			return;
+		}
+
+		const handleScroll = () => {
+			const { scrollTop } = scrollElement;
+
+			if ( scrollTop > scrollPos.current ) {
+				setDirection( 'down' );
+			} else if ( scrollTop < scrollPos.current ) {
+				setDirection( 'up' );
+			}
+
+			scrollPos.current = scrollTop;
+		};
+
+		scrollElement.addEventListener( 'scroll', handleScroll );
+
+		return () => {
+			scrollElement.removeEventListener( 'scroll', handleScroll );
+		};
+	} );
+
+	return (
+		<ScrollContext.Provider value={ { direction } }>
+			<ScrollPanel ref={ ref }>{ children }</ScrollPanel>
+		</ScrollContext.Provider>
+	);
+}
+
+export function useScrollDirection() {
+	return useContext( ScrollContext )?.direction ?? DEFAULT_SCROLL_DIRECTION;
+}

package/src/index.ts

@@ -3,6 +3,7 @@ export type { PopoverActionProps } from './popover-action';
 export { registerControlReplacement } from './control-replacement';
 export { injectIntoClassSelectorActions } from './components/css-classes/css-class-selector';
 export { usePanelActions, usePanelStatus } from './panel';
+export { type ValidationResult, type ValidationEvent } from './components/creatable-autocomplete';
 export { controlActionsMenu } from './controls-actions';
 
 export { init } from './init';

package/src/components/multi-combobox.tsx

@@ -1,165 +0,0 @@
-import * as React from 'react';
-import { useState } from 'react';
-import { Autocomplete, type AutocompleteProps, createFilterOptions, TextField, type Theme } from '@elementor/ui';
-
-export type Option = {
-	label: string;
-	value: string | null;
-	fixed?: boolean;
-	group?: string;
-	key?: string;
-};
-
-export type Action< TOption extends Option > = {
-	label: ( value: string ) => string;
-	apply: ( value: string ) => void | Promise< void >;
-	condition: ( options: TOption[], value: string ) => boolean;
-	group?: string;
-};
-
-type ActionAsOption< TOption extends Option > = TOption & {
-	apply: Action< TOption >[ 'apply' ];
-	condition: Action< TOption >[ 'condition' ];
-};
-
-type Props< TOption extends Option > = Omit<
-	AutocompleteProps< TOption, true, true, true >,
-	'renderInput' | 'onSelect'
-> & {
-	actions?: Action< TOption >[];
-	selected: TOption[];
-	options: TOption[];
-	onSelect?: ( value: TOption[] ) => void;
-	placeholder?: string;
-};
-
-export function MultiCombobox< TOption extends Option >( {
-	actions = [],
-	selected,
-	options,
-	onSelect,
-	placeholder,
-	...props
-}: Props< TOption > ) {
-	const filter = useFilterOptions< TOption >();
-	const { run, loading } = useActionRunner< TOption >();
-
-	return (
-		<Autocomplete
-			{ ...props }
-			freeSolo
-			multiple
-			clearOnBlur
-			selectOnFocus
-			disableClearable
-			handleHomeEndKeys
-			disabled={ loading }
-			value={ selected }
-			options={ options }
-			renderInput={ ( params ) => (
-				<TextField
-					{ ...params }
-					placeholder={ placeholder }
-					sx={ ( theme: Theme ) => ( {
-						'.MuiAutocomplete-inputRoot.MuiInputBase-adornedStart': {
-							paddingLeft: theme.spacing( 0.25 ),
-							paddingRight: theme.spacing( 0.25 ),
-						},
-					} ) }
-				/>
-			) }
-			onChange={ ( _, selectedOrInputValue, reason ) => {
-				const inputValue = selectedOrInputValue.find( ( option ) => typeof option === 'string' );
-				const optionsAndActions = selectedOrInputValue.filter( ( option ) => typeof option !== 'string' );
-
-				// Handles user input when Enter is pressed
-				if ( reason === 'createOption' ) {
-					const [ firstAction ] = filterActions( actions, { options, inputValue: inputValue ?? '' } );
-
-					if ( firstAction?.value ) {
-						return run( firstAction.apply, firstAction.value );
-					}
-				}
-
-				// Handles the user's action selection when triggered.
-				const action = optionsAndActions.find( ( value ) => isAction( value ) );
-
-				if ( reason === 'selectOption' && action?.value ) {
-					return run( action.apply, action.value );
-				}
-
-				// Every other case, we update the selected values.
-				const fixedValues = options.filter( ( option ) => !! option.fixed );
-
-				onSelect?.( [ ...new Set( [ ...optionsAndActions, ...fixedValues ] ) ] );
-			} }
-			getOptionLabel={ ( option ) => ( typeof option === 'string' ? option : option.label ) }
-			getOptionKey={ ( option ) => {
-				if ( typeof option === 'string' ) {
-					return option;
-				}
-
-				return option.key ?? option.value ?? option.label;
-			} }
-			filterOptions={ ( optionList, params ) => {
-				const selectedValues = selected.map( ( option ) => option.value );
-
-				return [
-					...filterActions( actions, { options: optionList, inputValue: params.inputValue } ),
-					...filter(
-						optionList.filter( ( option ) => ! selectedValues.includes( option.value ) ),
-						params
-					),
-				];
-			} }
-			groupBy={ ( option ) => option.group ?? '' }
-			renderOption={ ( optionProps, { label, group } ) => (
-				<li { ...optionProps } style={ { display: 'block', textOverflow: 'ellipsis' } } data-group={ group }>
-					{ label }
-				</li>
-			) }
-		/>
-	);
-}
-
-function useFilterOptions< TOption extends Option >() {
-	return useState( () => createFilterOptions< TOption >() )[ 0 ];
-}
-
-function useActionRunner< TOption extends Option >() {
-	const [ loading, setLoading ] = useState( false );
-
-	const run = async ( apply: Action< TOption >[ 'apply' ], value: string ) => {
-		setLoading( true );
-
-		try {
-			await apply( value );
-		} catch {
-			// TODO: Do something with the error.
-		}
-
-		setLoading( false );
-	};
-
-	return { run, loading };
-}
-
-function filterActions< TOption extends Option >(
-	actions: Action< TOption >[],
-	{ options, inputValue }: { options: TOption[]; inputValue: string }
-) {
-	return actions
-		.filter( ( action ) => action.condition( options, inputValue ) )
-		.map( ( action, index ) => ( {
-			label: action.label( inputValue ),
-			value: inputValue,
-			group: action.group,
-			apply: action.apply,
-			condition: action.condition,
-			key: index.toString(),
-		} ) ) as ActionAsOption< TOption >[];
-}
-
-function isAction< TOption extends Option >( option: TOption ): option is ActionAsOption< TOption > {
-	return 'apply' in option && 'condition' in option;
-}