@atlaskit/editor-common
Version:
A package that contains common classes and components for editor and renderer
430 lines (421 loc) • 17.6 kB
JavaScript
import _extends from "@babel/runtime/helpers/extends";
import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
/**
* @jsxRuntime classic
* @jsx jsx
*/
import React, { memo, useCallback, useEffect, useRef, useState } from 'react';
// eslint-disable-next-line @atlaskit/ui-styling-standard/use-compiled -- Ignored via go/DSP-18766
import { css, jsx } from '@emotion/react';
import { FormattedMessage } from 'react-intl-next';
import withAnalyticsContext from '@atlaskit/analytics-next/withAnalyticsContext';
import withAnalyticsEvents from '@atlaskit/analytics-next/withAnalyticsEvents';
import { ACTION, ACTION_SUBJECT, EVENT_TYPE, fireAnalyticsEvent } from '../../analytics';
import editorUGCToken from '../../ugc-tokens/get-editor-ugc-token';
import { DEVICE_BREAKPOINT_NUMBERS, ELEMENT_BROWSER_ID, GRID_SIZE, INLINE_SIDEBAR_HEIGHT, SIDEBAR_HEADING_WRAPPER_HEIGHT, SIDEBAR_WIDTH } from '../constants';
import useContainerWidth from '../hooks/use-container-width';
import useSelectAndFocusOnArrowNavigation from '../hooks/use-select-and-focus-on-arrow-navigation';
import { ViewMore } from '../ViewMore';
import CategoryList from './CategoryList';
import ElementList from './ElementList/ElementList';
import ElementSearch from './ElementSearch';
var wrapper = css({
width: '100%',
maxHeight: 'inherit',
overflow: 'hidden'
});
var baseBrowserContainerStyles = css({
display: 'flex',
height: '100%',
minHeight: '-webkit-fill-available'
});
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values, @atlaskit/design-system/consistent-css-prop-usage -- Ignored via go/DSP-18766
var mobileElementBrowserContainer = css(baseBrowserContainerStyles, {
flexDirection: 'column'
});
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values, @atlaskit/design-system/consistent-css-prop-usage -- Ignored via go/DSP-18766
var elementBrowserContainer = css(baseBrowserContainerStyles, {
flexDirection: 'row'
});
var baseSidebarStyles = css({
display: 'flex',
flexDirection: 'column',
overflowX: 'auto',
overflowY: 'hidden'
});
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values, @atlaskit/design-system/consistent-css-prop-usage -- Ignored via go/DSP-18766
var mobileSideBar = css(baseSidebarStyles, {
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-imported-style-values, @atlaskit/ui-styling-standard/no-unsafe-values -- Ignored via go/DSP-18766
flex: "0 0 ".concat(INLINE_SIDEBAR_HEIGHT),
padding: "var(--ds-space-150, 12px)".concat(" ", "var(--ds-space-150, 12px)", " 0 ", "var(--ds-space-150, 12px)")
});
var mobileSideBarShowCategories = css({
flex: '0 0 auto'
});
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values, @atlaskit/design-system/consistent-css-prop-usage -- Ignored via go/DSP-18766
var sideBar = css(baseSidebarStyles, {
flex: "0 0 'auto'"
});
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values, @atlaskit/design-system/consistent-css-prop-usage -- Ignored via go/DSP-18766
var sideBarShowCategories = css(baseSidebarStyles, {
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-imported-style-values, @atlaskit/ui-styling-standard/no-unsafe-values -- Ignored via go/DSP-18766
flex: "0 0 ".concat(SIDEBAR_WIDTH)
});
var sidebarHeading = css({
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-imported-style-values, @atlaskit/ui-styling-standard/no-unsafe-values -- Ignored via go/DSP-18766
flex: "0 0 ".concat(SIDEBAR_HEADING_WRAPPER_HEIGHT),
display: 'inline-flex',
alignItems: 'center',
paddingLeft: "var(--ds-space-150, 12px)",
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-imported-style-values, @atlaskit/ui-styling-standard/no-unsafe-values
font: editorUGCToken('editor.font.heading.h1', 'typography-modernized') // use editor h1 modernized here as the style matches
});
var mobileMainContent = css({
flex: '1 1 auto',
display: 'flex',
flexDirection: 'column',
overflowY: 'auto',
height: '100%'
});
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values, @atlaskit/design-system/consistent-css-prop-usage -- Ignored via go/DSP-18766
var mainContent = css(mobileMainContent, {
marginLeft: "var(--ds-space-200, 16px)",
height: 'auto'
});
var searchContainer = css({
paddingBottom: "var(--ds-space-200, 16px)"
});
var mobileCategoryListWrapper = css({
display: 'flex',
overflowX: 'auto',
padding: "var(--ds-space-200, 8px)".concat(" 0 ", "var(--ds-space-200, 16px)", " 0"),
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-imported-style-values, @atlaskit/ui-styling-standard/no-unsafe-values -- Ignored via go/DSP-18766
minHeight: "".concat(GRID_SIZE * 4, "px"),
overflow: '-moz-scrollbars-none',
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-selectors -- Ignored via go/DSP-18766
'&::-webkit-scrollbar': {
display: 'none'
},
scrollbarWidth: 'none',
MsOverflowStyle: 'none'
});
// eslint-disable-next-line @atlaskit/ui-styling-standard/no-unsafe-values, @atlaskit/design-system/consistent-css-prop-usage -- Ignored via go/DSP-18766
var categoryListWrapper = css(mobileCategoryListWrapper, {
padding: 0,
marginTop: "var(--ds-space-200, 24px)",
flexDirection: 'column'
});
function StatelessElementBrowser(props) {
var _props$categories;
var items = props.items,
onSelectItem = props.onSelectItem,
onInsertItem = props.onInsertItem,
viewMoreItem = props.viewMoreItem,
selectedCategory = props.selectedCategory,
onSelectCategory = props.onSelectCategory,
searchTerm = props.searchTerm,
showCategories = props.showCategories,
cache = props.cache;
var _useContainerWidth = useContainerWidth(),
containerWidth = _useContainerWidth.containerWidth,
ContainerWidthMonitor = _useContainerWidth.ContainerWidthMonitor;
var categoryBeenChosen = useRef(false);
var _useState = useState(1),
_useState2 = _slicedToArray(_useState, 2),
columnCount = _useState2[0],
setColumnCount = _useState2[1];
var isFocusSearch;
var selectedCategoryIndex = (_props$categories = props.categories) === null || _props$categories === void 0 ? void 0 : _props$categories.findIndex(function (category) {
return category.name === selectedCategory;
});
if (showCategories) {
var isEmptySearchTerm = !searchTerm || (searchTerm === null || searchTerm === void 0 ? void 0 : searchTerm.length) === 0;
if (!isEmptySearchTerm) {
// clear the flag if the search happens after a user has chosen the category
categoryBeenChosen.current = false;
}
// A11Y: if categories exists, on the initial render search element should receive focus.
// After user pick some category the category should stay focused.
isFocusSearch = !categoryBeenChosen.current || !isEmptySearchTerm;
}
var itemIsDisabled = useCallback(function (index) {
var _items$index$isDisabl, _items$index;
return (_items$index$isDisabl = (_items$index = items[index]) === null || _items$index === void 0 ? void 0 : _items$index.isDisabled) !== null && _items$index$isDisabl !== void 0 ? _items$index$isDisabl : false;
}, [items]);
var _useSelectAndFocusOnA = useSelectAndFocusOnArrowNavigation(items.length - 1, columnCount, !!viewMoreItem, itemIsDisabled, isFocusSearch),
selectedItemIndex = _useSelectAndFocusOnA.selectedItemIndex,
focusedItemIndex = _useSelectAndFocusOnA.focusedItemIndex,
setFocusedItemIndex = _useSelectAndFocusOnA.setFocusedItemIndex,
setFocusedCategoryIndex = _useSelectAndFocusOnA.setFocusedCategoryIndex,
focusedCategoryIndex = _useSelectAndFocusOnA.focusedCategoryIndex,
focusOnSearch = _useSelectAndFocusOnA.focusOnSearch,
focusOnViewMore = _useSelectAndFocusOnA.focusOnViewMore,
onKeyDown = _useSelectAndFocusOnA.onKeyDown,
setFocusOnSearch = _useSelectAndFocusOnA.setFocusOnSearch;
useEffect(function () {
fireAnalyticsEvent(props.createAnalyticsEvent)({
payload: {
action: ACTION.OPENED,
actionSubject: ACTION_SUBJECT.ELEMENT_BROWSER,
eventType: EVENT_TYPE.UI,
attributes: {
mode: props.mode
}
}
});
return function () {
fireAnalyticsEvent(props.createAnalyticsEvent)({
payload: {
action: ACTION.CLOSED,
actionSubject: ACTION_SUBJECT.ELEMENT_BROWSER,
eventType: EVENT_TYPE.UI,
attributes: {
mode: props.mode
}
}
});
};
}, [props.createAnalyticsEvent, props.mode]);
/* Only for hitting enter to select item when focused on search bar,
* The actual enter key press is handled on individual items level.
*/
var selectedItem = selectedItemIndex !== undefined ? items[selectedItemIndex] : null;
var onItemsEnterTabKeyPress = useCallback(function (e) {
var _selectedItem$isDisab;
if (e.key !== 'Enter' && (e.key !== 'Tab' || !showCategories)) {
return;
}
if (showCategories && e.key === 'Tab' && selectedCategoryIndex !== undefined) {
// A11Y: Set focus on first category if tab pressed on search
setFocusedCategoryIndex(selectedCategoryIndex);
e.preventDefault();
return;
}
if (onInsertItem && selectedItem != null && !((_selectedItem$isDisab = selectedItem.isDisabled) !== null && _selectedItem$isDisab !== void 0 ? _selectedItem$isDisab : false)) {
onInsertItem(selectedItem);
}
e.preventDefault();
}, [onInsertItem, selectedItem, setFocusedCategoryIndex, showCategories, selectedCategoryIndex]);
/**
* On arrow key selection and clicks the selectedItemIndex will change.
* Making sure to update parent component.
*/
useEffect(function () {
if (onSelectItem && selectedItem != null) {
onSelectItem(selectedItem);
}
}, [onSelectItem, selectedItem]);
var onSelectCategoryCB = useCallback(function (category) {
onSelectCategory(category);
categoryBeenChosen.current = true;
}, [categoryBeenChosen, onSelectCategory]);
return jsx("div", {
css: wrapper,
"data-testid": "element-browser",
id: ELEMENT_BROWSER_ID
}, jsx(ContainerWidthMonitor, null), containerWidth < DEVICE_BREAKPOINT_NUMBERS.medium ? jsx(MobileBrowser
// Ignored via go/ees005
// eslint-disable-next-line react/jsx-props-no-spreading
, _extends({}, props, {
selectedItemIndex: selectedItemIndex,
focusedItemIndex: focusedItemIndex,
setFocusedItemIndex: setFocusedItemIndex,
focusedCategoryIndex: focusedCategoryIndex,
setFocusedCategoryIndex: setFocusedCategoryIndex,
focusOnSearch: focusOnSearch,
columnCount: columnCount,
setColumnCount: setColumnCount,
setFocusOnSearch: setFocusOnSearch,
onKeyPress: onItemsEnterTabKeyPress,
onKeyDown: onKeyDown,
viewMoreItem: viewMoreItem,
focusOnViewMore: focusOnViewMore,
cache: cache
})) : jsx(DesktopBrowser
// Ignored via go/ees005
// eslint-disable-next-line react/jsx-props-no-spreading
, _extends({}, props, {
selectedItemIndex: selectedItemIndex,
focusedItemIndex: focusedItemIndex,
setFocusedItemIndex: setFocusedItemIndex,
focusOnSearch: focusOnSearch,
setColumnCount: setColumnCount,
columnCount: columnCount,
setFocusOnSearch: setFocusOnSearch,
onKeyPress: onItemsEnterTabKeyPress,
onKeyDown: onKeyDown,
focusedCategoryIndex: focusedCategoryIndex,
setFocusedCategoryIndex: setFocusedCategoryIndex,
selectedCategoryIndex: selectedCategoryIndex,
onSelectCategory: onSelectCategoryCB,
cache: cache
})));
}
function MobileBrowser(_ref) {
var showCategories = _ref.showCategories,
showSearch = _ref.showSearch,
onSearch = _ref.onSearch,
mode = _ref.mode,
categories = _ref.categories,
onSelectCategory = _ref.onSelectCategory,
items = _ref.items,
onInsertItem = _ref.onInsertItem,
selectedCategory = _ref.selectedCategory,
selectedItemIndex = _ref.selectedItemIndex,
focusedItemIndex = _ref.focusedItemIndex,
setFocusedItemIndex = _ref.setFocusedItemIndex,
focusedCategoryIndex = _ref.focusedCategoryIndex,
setFocusedCategoryIndex = _ref.setFocusedCategoryIndex,
focusOnSearch = _ref.focusOnSearch,
focusOnViewMore = _ref.focusOnViewMore,
columnCount = _ref.columnCount,
setColumnCount = _ref.setColumnCount,
setFocusOnSearch = _ref.setFocusOnSearch,
onKeyPress = _ref.onKeyPress,
onKeyDown = _ref.onKeyDown,
searchTerm = _ref.searchTerm,
createAnalyticsEvent = _ref.createAnalyticsEvent,
emptyStateHandler = _ref.emptyStateHandler,
viewMoreItem = _ref.viewMoreItem,
cache = _ref.cache;
return (
// eslint-disable-next-line jsx-a11y/no-static-element-interactions
jsx("div", {
css: mobileElementBrowserContainer,
onKeyDown: onKeyDown,
"data-testid": "mobile__element-browser"
}, jsx("div", {
css: showCategories ? [mobileSideBar, mobileSideBarShowCategories] : mobileSideBar
}, showSearch && jsx(ElementSearch, {
onSearch: onSearch,
onKeyDown: onKeyPress,
mode: mode,
focus: focusOnSearch,
onClick: setFocusOnSearch,
searchTerm: searchTerm,
items: items,
selectedItemIndex: selectedItemIndex
}), showCategories && jsx("nav", {
css: mobileCategoryListWrapper,
tabIndex: -1
}, jsx(CategoryList, {
categories: categories,
onSelectCategory: onSelectCategory,
selectedCategory: selectedCategory,
focusedCategoryIndex: focusedCategoryIndex,
setFocusedCategoryIndex: setFocusedCategoryIndex,
setFocusedItemIndex: setFocusedItemIndex,
setFocusOnSearch: setFocusOnSearch
}))), jsx("div", {
css: mobileMainContent
}, jsx(ElementList, {
items: items,
mode: mode,
onInsertItem: onInsertItem,
selectedItemIndex: selectedItemIndex,
focusedItemIndex: focusedItemIndex,
setFocusedItemIndex: setFocusedItemIndex,
columnCount: columnCount,
setColumnCount: setColumnCount,
createAnalyticsEvent: createAnalyticsEvent,
emptyStateHandler: emptyStateHandler,
selectedCategory: selectedCategory,
searchTerm: searchTerm,
cache: cache
})), viewMoreItem && jsx(ViewMore, {
item: viewMoreItem,
focus: focusOnViewMore
}))
);
}
function DesktopBrowser(_ref2) {
var showCategories = _ref2.showCategories,
showSearch = _ref2.showSearch,
onSearch = _ref2.onSearch,
mode = _ref2.mode,
categories = _ref2.categories,
onSelectCategory = _ref2.onSelectCategory,
items = _ref2.items,
onInsertItem = _ref2.onInsertItem,
selectedCategory = _ref2.selectedCategory,
selectedItemIndex = _ref2.selectedItemIndex,
focusedItemIndex = _ref2.focusedItemIndex,
setFocusedItemIndex = _ref2.setFocusedItemIndex,
focusedCategoryIndex = _ref2.focusedCategoryIndex,
setFocusedCategoryIndex = _ref2.setFocusedCategoryIndex,
selectedCategoryIndex = _ref2.selectedCategoryIndex,
focusOnSearch = _ref2.focusOnSearch,
columnCount = _ref2.columnCount,
setColumnCount = _ref2.setColumnCount,
setFocusOnSearch = _ref2.setFocusOnSearch,
onKeyPress = _ref2.onKeyPress,
onKeyDown = _ref2.onKeyDown,
searchTerm = _ref2.searchTerm,
createAnalyticsEvent = _ref2.createAnalyticsEvent,
emptyStateHandler = _ref2.emptyStateHandler,
cache = _ref2.cache;
return jsx("div", {
css: elementBrowserContainer,
"data-testid": "desktop__element-browser"
}, showCategories && jsx("div", {
css: showCategories ? sideBarShowCategories : sideBar
}, jsx("div", {
css: sidebarHeading,
"data-testid": "sidebar-heading",
id: "sidebar-heading"
}, jsx(FormattedMessage, {
id: "fabric.editor.elementbrowser.sidebar.heading",
defaultMessage: "Browse",
description: "Sidebar heading"
})), jsx("nav", {
role: "tablist",
"aria-labelledby": "sidebar-heading",
css: categoryListWrapper
}, jsx(CategoryList, {
categories: categories,
onSelectCategory: onSelectCategory,
selectedCategory: selectedCategory,
createAnalyticsEvent: createAnalyticsEvent,
focusedCategoryIndex: focusedCategoryIndex,
setFocusedCategoryIndex: setFocusedCategoryIndex,
setFocusedItemIndex: setFocusedItemIndex,
setFocusOnSearch: setFocusOnSearch
}))), jsx("div", {
css: mainContent,
onKeyDown: onKeyDown,
"data-testid": "main-content"
}, showSearch &&
// eslint-disable-next-line
jsx("div", {
css: searchContainer
}, jsx(ElementSearch, {
onSearch: onSearch,
onKeyDown: onKeyPress,
mode: mode,
focus: focusOnSearch,
onClick: setFocusOnSearch,
searchTerm: searchTerm,
items: items,
selectedItemIndex: selectedItemIndex
})), jsx(ElementList, {
items: items,
mode: mode,
onInsertItem: onInsertItem,
selectedItemIndex: selectedItemIndex,
focusedItemIndex: focusedItemIndex,
setFocusedItemIndex: setFocusedItemIndex,
columnCount: columnCount,
setColumnCount: setColumnCount,
createAnalyticsEvent: createAnalyticsEvent,
emptyStateHandler: emptyStateHandler,
selectedCategory: selectedCategory,
selectedCategoryIndex: selectedCategoryIndex,
searchTerm: searchTerm,
setFocusedCategoryIndex: showCategories ? setFocusedCategoryIndex : undefined,
cache: cache
})));
}
var MemoizedElementBrowser = /*#__PURE__*/memo(withAnalyticsContext({
source: 'ElementBrowser'
})(withAnalyticsEvents()(StatelessElementBrowser)));
export default MemoizedElementBrowser;