@elementor/editor-variables 0.12.0 → 0.14.0

package/src/components/color-variable-edit.tsx

@@ -0,0 +1,117 @@
+import * as React from 'react';
+import { useRef, useState } from 'react';
+import { PopoverHeader } from '@elementor/editor-ui';
+import { ArrowLeftIcon, BrushIcon } from '@elementor/icons';
+import {
+	Button,
+	CardActions,
+	Divider,
+	FormLabel,
+	Grid,
+	IconButton,
+	Stack,
+	TextField,
+	UnstableColorField,
+} from '@elementor/ui';
+import { __ } from '@wordpress/i18n';
+
+import { updateVariable, useVariable } from '../hooks/use-prop-variables';
+
+const SIZE = 'tiny';
+
+type Props = {
+	editId: string;
+	onClose: () => void;
+	onGoBack?: () => void;
+	onSubmit?: () => void;
+};
+
+export const ColorVariableEdit = ( { onClose, onGoBack, onSubmit, editId }: Props ) => {
+	const variable = useVariable( editId );
+
+	if ( ! variable ) {
+		throw new Error( `Global color variable not found` );
+	}
+
+	const anchorRef = useRef< HTMLDivElement >( null );
+
+	const [ color, setColor ] = useState( variable.value );
+	const [ label, setLabel ] = useState( variable.label );
+
+	const handleUpdate = () => {
+		updateVariable( editId, {
+			value: color,
+			label,
+		} ).then( () => {
+			onSubmit?.();
+		} );
+	};
+
+	const noValueChanged = () => color === variable.value && label === variable.label;
+	const hasEmptyValue = () => '' === color.trim() || '' === label.trim();
+	const isSaveDisabled = () => noValueChanged() || hasEmptyValue();
+
+	return (
+		<>
+			<PopoverHeader
+				title={ __( 'Edit variable', 'elementor' ) }
+				onClose={ onClose }
+				icon={
+					<>
+						{ onGoBack && (
+							<IconButton size={ SIZE } aria-label={ __( 'Go Back', 'elementor' ) } onClick={ onGoBack }>
+								<ArrowLeftIcon fontSize={ SIZE } />
+							</IconButton>
+						) }
+						<BrushIcon fontSize={ SIZE } />
+					</>
+				}
+			/>
+
+			<Divider />
+
+			<Stack p={ 1.5 } gap={ 1.5 }>
+				<Grid container gap={ 0.75 } alignItems="center">
+					<Grid item xs={ 12 }>
+						<FormLabel size="small">{ __( 'Name', 'elementor' ) }</FormLabel>
+					</Grid>
+					<Grid item xs={ 12 }>
+						<TextField
+							size="tiny"
+							fullWidth
+							value={ label }
+							onChange={ ( e: React.ChangeEvent< HTMLInputElement > ) => setLabel( e.target.value ) }
+						/>
+					</Grid>
+				</Grid>
+
+				<Grid container gap={ 0.75 } alignItems="center">
+					<Grid item xs={ 12 }>
+						<FormLabel size="small">{ __( 'Value', 'elementor' ) }</FormLabel>
+					</Grid>
+					<Grid item xs={ 12 }>
+						<UnstableColorField
+							size="tiny"
+							fullWidth
+							value={ color }
+							onChange={ setColor }
+							slotProps={ {
+								colorPicker: {
+									anchorEl: anchorRef.current,
+									anchorOrigin: { vertical: 'top', horizontal: 'right' },
+									transformOrigin: { vertical: 'top', horizontal: -10 },
+								},
+							} }
+						/>
+					</Grid>
+				</Grid>
+			</Stack>
+
+			<CardActions>
+				<Button size="small" variant="contained" disabled={ isSaveDisabled() } onClick={ handleUpdate }>
+					{ __( 'Save', 'elementor' ) }
+				</Button>
+			</CardActions>
+		</>
+	);
+};

package/src/components/color-variables-selection.tsx

@@ -1,71 +1,117 @@
 import * as React from 'react';
-import { Fragment } from 'react';
+import { useState } from 'react';
 import { useBoundProp } from '@elementor/editor-controls';
-import { EditIcon } from '@elementor/icons';
-import { Box, Divider, ListItemIcon, ListItemText, MenuList } from '@elementor/ui';
+import { PopoverHeader, PopoverMenuList, PopoverSearch, type VirtualizedItem } from '@elementor/editor-ui';
+import { ColorFilterIcon, PlusIcon, SettingsIcon } from '@elementor/icons';
+import { Divider, IconButton } from '@elementor/ui';
+import { __ } from '@wordpress/i18n';
 
-import { usePropVariables } from '../hooks/use-prop-variables';
+import { useFilteredVariables } from '../hooks/use-prop-variables';
 import { colorVariablePropTypeUtil } from '../prop-types/color-variable-prop-type';
-import { type VariableKey } from '../types';
-import { ColorIndicator } from './color-indicator';
-import { StyledMenuItem } from './styled-menu-item';
+import { type ExtendedVirtualizedItem } from '../types';
+import { ColorIndicator } from './ui/color-indicator';
+import { MenuItemContent } from './ui/menu-item-content';
+import { NoSearchResults } from './ui/no-search-results';
+import { NoVariables } from './ui/no-variables';
+import { VariablesStyledMenuList } from './ui/styled-menu-list';
+
+const SIZE = 'tiny';
 
 type Props = {
-	onSelect?: () => void;
+	closePopover: () => void;
+	onAdd?: () => void;
+	onEdit?: ( key: string ) => void;
+	onSettings?: () => void;
 };
 
-export const ColorVariablesSelection = ( { onSelect }: Props ) => {
+export const ColorVariablesSelection = ( { closePopover, onAdd, onEdit, onSettings }: Props ) => {
 	const { value: variable, setValue: setVariable } = useBoundProp( colorVariablePropTypeUtil );
+	const [ searchValue, setSearchValue ] = useState( '' );
 
-	const variables = usePropVariables( colorVariablePropTypeUtil.key );
+	const {
+		list: variables,
+		hasMatches: hasSearchResults,
+		isSourceNotEmpty: hasVariables,
+	} = useFilteredVariables( searchValue, colorVariablePropTypeUtil.key );
 
-	const handleSetColorVariable = ( key: VariableKey ) => {
+	const handleSetColorVariable = ( key: string ) => {
 		setVariable( key );
+		closePopover();
+	};
+
+	const actions = [];
+
+	if ( onAdd ) {
+		actions.push(
+			<IconButton key="add" size={ SIZE } onClick={ onAdd }>
+				<PlusIcon fontSize={ SIZE } />
+			</IconButton>
+		);
+	}
 
-		onSelect?.();
+	if ( onSettings ) {
+		actions.push(
+			<IconButton key="settings" size={ SIZE } onClick={ onSettings }>
+				<SettingsIcon fontSize={ SIZE } />
+			</IconButton>
+		);
+	}
+
+	const items: ExtendedVirtualizedItem[] = variables.map( ( { value, label, key } ) => ( {
+		type: 'item' as const,
+		value: key,
+		label,
+		icon: <ColorIndicator size="inherit" component="span" value={ value } />,
+		secondaryText: value,
+		onEdit: () => onEdit?.( key ),
+	} ) );
+
+	const handleSearch = ( search: string ) => {
+		setSearchValue( search );
+	};
+
+	const handleClearSearch = () => {
+		setSearchValue( '' );
 	};
 
 	return (
-		<Fragment>
+		<>
+			<PopoverHeader
+				title={ __( 'Variables', 'elementor' ) }
+				icon={ <ColorFilterIcon fontSize={ SIZE } /> }
+				onClose={ closePopover }
+				actions={ actions }
+			/>
+
+			{ hasVariables && (
+				<PopoverSearch
+					value={ searchValue }
+					onSearch={ handleSearch }
+					placeholder={ __( 'Search', 'elementor' ) }
+				/>
+			) }
+
 			<Divider />
-			<Box sx={ { overflowY: 'auto', height: 260, width: 220 } }>
-				<MenuList role="listbox" tabIndex={ 0 }>
-					{ variables.map( ( { value, label, key } ) => (
-						<StyledMenuItem
-							key={ key }
-							onClick={ () => handleSetColorVariable( key ) }
-							selected={ key === variable }
-						>
-							<ListItemIcon>
-								<ColorIndicator size="inherit" component="span" value={ value } />
-							</ListItemIcon>
-							<ListItemText
-								primary={ label }
-								secondary={ value }
-								primaryTypographyProps={ {
-									variant: 'body2',
-									color: 'text.secondary',
-									style: {
-										lineHeight: 2,
-										display: 'inline-block',
-										overflow: 'hidden',
-										textOverflow: 'ellipsis',
-										whiteSpace: 'nowrap',
-										maxWidth: '81px',
-									},
-								} }
-								secondaryTypographyProps={ {
-									variant: 'caption',
-									color: 'text.tertiary',
-									style: { marginTop: '1px', lineHeight: '1' },
-								} }
-								sx={ { display: 'flex', alignItems: 'center', gap: 1 } }
-							/>
-							<EditIcon color="action" fontSize="inherit" sx={ { mx: 1, opacity: '0' } } />
-						</StyledMenuItem>
-					) ) }
-				</MenuList>
-			</Box>
-		</Fragment>
+
+			{ hasVariables && hasSearchResults && (
+				<PopoverMenuList< 'item', string >
+					items={ items }
+					onSelect={ handleSetColorVariable }
+					onClose={ () => {} }
+					selectedValue={ variable }
+					data-testid="color-variables-list"
+					menuListTemplate={ VariablesStyledMenuList }
+					menuItemContentTemplate={ ( item: VirtualizedItem< 'item', string > ) => (
+						<MenuItemContent item={ item } />
+					) }
+				/>
+			) }
+
+			{ ! hasSearchResults && hasVariables && (
+				<NoSearchResults searchValue={ searchValue } onClear={ handleClearSearch } />
+			) }
+
+			{ ! hasVariables && <NoVariables icon={ <ColorFilterIcon fontSize="large" /> } onAdd={ onAdd } /> }
+		</>
 	);
 };

package/src/components/font-variable-creation.tsx

@@ -0,0 +1,143 @@
+import * as React from 'react';
+import { useRef, useState } from 'react';
+import { FontFamilySelector, useBoundProp } from '@elementor/editor-controls';
+import { useFontFamilies } from '@elementor/editor-editing-panel';
+import { PopoverHeader } from '@elementor/editor-ui';
+import { ArrowLeftIcon, ChevronDownIcon, TextIcon } from '@elementor/icons';
+import {
+	bindPopover,
+	bindTrigger,
+	Button,
+	CardActions,
+	Divider,
+	FormLabel,
+	Grid,
+	IconButton,
+	Popover,
+	Stack,
+	TextField,
+	UnstableTag,
+	usePopupState,
+} from '@elementor/ui';
+import { __ } from '@wordpress/i18n';
+
+import { createVariable } from '../hooks/use-prop-variables';
+import { fontVariablePropTypeUtil } from '../prop-types/font-variable-prop-type';
+
+const SIZE = 'tiny';
+
+type Props = {
+	onGoBack?: () => void;
+	onClose: () => void;
+};
+
+export const FontVariableCreation = ( { onClose, onGoBack }: Props ) => {
+	const fontFamilies = useFontFamilies();
+	const { setValue: setVariable } = useBoundProp( fontVariablePropTypeUtil );
+
+	const [ fontFamily, setFontFamily ] = useState( '' );
+	const [ label, setLabel ] = useState( '' );
+
+	const anchorRef = useRef< HTMLDivElement >( null );
+	const fontPopoverState = usePopupState( { variant: 'popover' } );
+
+	const resetFields = () => {
+		setFontFamily( '' );
+		setLabel( '' );
+	};
+
+	const closePopover = () => {
+		resetFields();
+		onClose();
+	};
+
+	const handleCreate = () => {
+		createVariable( {
+			value: fontFamily,
+			label,
+			type: fontVariablePropTypeUtil.key,
+		} ).then( ( key ) => {
+			setVariable( key );
+			closePopover();
+		} );
+	};
+
+	const isFormInvalid = () => {
+		return ! fontFamily?.trim() || ! label?.trim();
+	};
+
+	return (
+		<>
+			<PopoverHeader
+				icon={
+					<>
+						{ onGoBack && (
+							<IconButton size={ SIZE } aria-label={ __( 'Go Back', 'elementor' ) } onClick={ onGoBack }>
+								<ArrowLeftIcon fontSize={ SIZE } />
+							</IconButton>
+						) }
+						<TextIcon fontSize={ SIZE } />
+					</>
+				}
+				title={ __( 'Create variable', 'elementor' ) }
+				onClose={ closePopover }
+			/>
+
+			<Divider />
+
+			<Stack p={ 1.5 } gap={ 1.5 }>
+				<Grid container gap={ 0.75 } alignItems="center">
+					<Grid item xs={ 12 }>
+						<FormLabel size="small">{ __( 'Name', 'elementor' ) }</FormLabel>
+					</Grid>
+					<Grid item xs={ 12 }>
+						<TextField
+							size="tiny"
+							fullWidth
+							value={ label }
+							onChange={ ( e: React.ChangeEvent< HTMLInputElement > ) => setLabel( e.target.value ) }
+						/>
+					</Grid>
+				</Grid>
+
+				<Grid container gap={ 0.75 } alignItems="center">
+					<Grid item xs={ 12 }>
+						<FormLabel size="small">{ __( 'Value', 'elementor' ) }</FormLabel>
+					</Grid>
+					<Grid item xs={ 12 }>
+						<>
+							<UnstableTag
+								variant="outlined"
+								label={ fontFamily }
+								endIcon={ <ChevronDownIcon fontSize="tiny" /> }
+								{ ...bindTrigger( fontPopoverState ) }
+								fullWidth
+							/>
+							<Popover
+								disablePortal
+								disableScrollLock
+								anchorEl={ anchorRef.current }
+								anchorOrigin={ { vertical: 'top', horizontal: 'right' } }
+								transformOrigin={ { vertical: 'top', horizontal: -20 } }
+								{ ...bindPopover( fontPopoverState ) }
+							>
+								<FontFamilySelector
+									fontFamilies={ fontFamilies }
+									fontFamily={ fontFamily }
+									onFontFamilyChange={ setFontFamily }
+									onClose={ fontPopoverState.close }
+								/>
+							</Popover>
+						</>
+					</Grid>
+				</Grid>
+			</Stack>
+
+			<CardActions>
+				<Button size="small" variant="contained" disabled={ isFormInvalid() } onClick={ handleCreate }>
+					{ __( 'Create', 'elementor' ) }
+				</Button>
+			</CardActions>
+		</>
+	);
+};

package/src/components/font-variable-edit.tsx

@@ -0,0 +1,146 @@
+import * as React from 'react';
+import { useId, useRef, useState } from 'react';
+import { FontFamilySelector } from '@elementor/editor-controls';
+import { useFontFamilies } from '@elementor/editor-editing-panel';
+import { PopoverHeader } from '@elementor/editor-ui';
+import { ArrowLeftIcon, ChevronDownIcon, TextIcon } from '@elementor/icons';
+import {
+	bindPopover,
+	bindTrigger,
+	Button,
+	CardActions,
+	Divider,
+	FormLabel,
+	Grid,
+	IconButton,
+	Popover,
+	Stack,
+	TextField,
+	UnstableTag,
+	usePopupState,
+} from '@elementor/ui';
+import { __ } from '@wordpress/i18n';
+
+import { updateVariable, useVariable } from '../hooks/use-prop-variables';
+
+const SIZE = 'tiny';
+
+type Props = {
+	editId: string;
+	onClose: () => void;
+	onGoBack?: () => void;
+	onSubmit?: () => void;
+};
+
+export const FontVariableEdit = ( { onClose, onGoBack, onSubmit, editId }: Props ) => {
+	const variable = useVariable( editId );
+
+	if ( ! variable ) {
+		throw new Error( `Global font variable "${ editId }" not found` );
+	}
+
+	const [ fontFamily, setFontFamily ] = useState( variable.value );
+	const [ label, setLabel ] = useState( variable.label );
+
+	const variableNameId = useId();
+	const variableValueId = useId();
+
+	const anchorRef = useRef< HTMLDivElement >( null );
+	const fontPopoverState = usePopupState( { variant: 'popover' } );
+
+	const fontFamilies = useFontFamilies();
+
+	const handleUpdate = () => {
+		updateVariable( editId, {
+			value: fontFamily,
+			label,
+		} ).then( () => {
+			onSubmit?.();
+		} );
+	};
+
+	const noValueChanged = () => fontFamily === variable.value && label === variable.label;
+	const hasEmptyValue = () => '' === fontFamily.trim() || '' === label.trim();
+	const isSaveDisabled = () => noValueChanged() || hasEmptyValue();
+
+	return (
+		<>
+			<PopoverHeader
+				icon={
+					<>
+						{ onGoBack && (
+							<IconButton size={ SIZE } aria-label={ __( 'Go Back', 'elementor' ) } onClick={ onGoBack }>
+								<ArrowLeftIcon fontSize={ SIZE } />
+							</IconButton>
+						) }
+						<TextIcon fontSize={ SIZE } />
+					</>
+				}
+				title={ __( 'Edit variable', 'elementor' ) }
+				onClose={ onClose }
+			/>
+
+			<Divider />
+
+			<Stack p={ 1.5 } gap={ 1.5 }>
+				<Grid container gap={ 0.75 } alignItems="center">
+					<Grid item xs={ 12 }>
+						<FormLabel htmlFor={ variableNameId } size="small">
+							{ __( 'Name', 'elementor' ) }
+						</FormLabel>
+					</Grid>
+					<Grid item xs={ 12 }>
+						<TextField
+							id={ variableNameId }
+							size="tiny"
+							fullWidth
+							value={ label }
+							onChange={ ( e: React.ChangeEvent< HTMLInputElement > ) => setLabel( e.target.value ) }
+						/>
+					</Grid>
+				</Grid>
+
+				<Grid container gap={ 0.75 } alignItems="center">
+					<Grid item xs={ 12 }>
+						<FormLabel htmlFor={ variableValueId } size="small">
+							{ __( 'Value', 'elementor' ) }
+						</FormLabel>
+					</Grid>
+					<Grid item xs={ 12 }>
+						<>
+							<UnstableTag
+								id={ variableValueId }
+								variant="outlined"
+								label={ fontFamily }
+								endIcon={ <ChevronDownIcon fontSize="tiny" /> }
+								{ ...bindTrigger( fontPopoverState ) }
+								fullWidth
+							/>
+							<Popover
+								disablePortal
+								disableScrollLock
+								anchorEl={ anchorRef.current }
+								anchorOrigin={ { vertical: 'top', horizontal: 'right' } }
+								transformOrigin={ { vertical: 'top', horizontal: -20 } }
+								{ ...bindPopover( fontPopoverState ) }
+							>
+								<FontFamilySelector
+									fontFamilies={ fontFamilies }
+									fontFamily={ fontFamily }
+									onFontFamilyChange={ setFontFamily }
+									onClose={ fontPopoverState.close }
+								/>
+							</Popover>
+						</>
+					</Grid>
+				</Grid>
+			</Stack>
+
+			<CardActions>
+				<Button size="small" variant="contained" disabled={ isSaveDisabled() } onClick={ handleUpdate }>
+					{ __( 'Save', 'elementor' ) }
+				</Button>
+			</CardActions>
+		</>
+	);
+};