@salutejs/plasma-new-hope 0.78.0-canary.1203.8970261959.0 → 0.78.0-dev.0

package/styled-components/cjs/components/Dropdown/Dropdown.template-doc.mdx

@@ -3,78 +3,337 @@ id: dropdown
 title: Dropdown
 ---
 
-import { PropsTable, Description } from '@site/src/components';
+import { PropsTable, Description, StorybookLink } from '@site/src/components';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # Dropdown
-Набор компонентов для создания выпадающих списков. 
+Выпадающий многоуровневый список.
+
+<StorybookLink name="Dropdown" />
 
 <Description name="Dropdown" />
-<PropsTable name="Dropdown" exclude={['css']} />
+<PropsTable name="Dropdown" />
 
-# DropdownItem
+## Использование
+Обязательным параметром является только массив `items`. Внутри items может быть такой же вложенный массив items. Формат следующий:
 
-<Description name="DropdownItem" />
-<PropsTable name="DropdownItem" exclude={['css']} />
+```tsx
+type Items = Array<{
+        /**
+         *  Значение у item
+         */
+        value: string | number;
+        /**
+         * Метка-подпись к item
+         */
+        label: string;
+        /**
+         * Список дочерних items.
+         */
+        items?: Items;
+        /**
+         * Item не активен
+         */
+        disabled?: boolean;
+        /**
+         * Слот для контента слева
+         */
+        contentLeft?: ReactNode;
+        /**
+         * Слот для контента справа
+         */
+        contentRight?: ReactNode;
+        /**
+         * Выбранный item.
+         * @deprecated использовать ContentLeft || ContentRight
+         */
+        isActive?: boolean;
+        /**
+         * Кастомный цвет текста
+         * @deprecated
+         */
+        color?: string;
+        /**
+         * Айтем не активен
+         * @deprecated использовать disabled
+         */
+        isDisabled?: boolean;
+    }>;
+```
 
-## Использование
+## Примеры
+
+<Tabs>
+    <TabItem value="default" label="Default" default>
+        ```tsx live
+        import React from 'react';
+        import { Button, Dropdown } from '@salutejs/plasma-web';
 
-```tsx live
-import React, { useState } from 'react';
-import { Dropdown, DropdownItem } from '@salutejs/{{ package }}';
-import { surfaceSolidSecondary } from '@salutejs/{{ theme }}';
-
-export function App() {
-    const [selected, setSelected] = useState('');
-    const [isOpen, setIsOpen] = useState(false);
-
-    const handleSelect = (value: string, text: string) => {
-        setSelected(value);
-        setIsOpen(false);
-    };
-
-    const getDropdownItems = (slug: string, elemCount: number) =>
-    [...Array(elemCount).keys()].map((num) => ({
-        value: `${slug}_${num}`,
-        child: `${slug} ${num}`,
-    }));
-
-    return (
-        <div style=\{{height: "400px", background: surfaceSolidSecondary, padding: "1rem" }}>
-            <Dropdown
-                    target={<Button>Target</Button>}
-                    isOpen={isOpen}
-                    onToggle={() => {
-                        setIsOpen(!isOpen);
-                    }}
-                    offset={[10, 15]}
-                    view="primary"
-                    size="m"
-                    placement="right"
-                    trigger="click"
-                    closeOnOverlayClick={false}
-                    closeOnEsc
-                    isFocusTrapped
-                >
-                    {getDropdownItems('item', 6).map((item) => (
-                        <DropdownItem
-                            key={item.value}
-                            isSelected={Boolean(item.value === selected)}
-                            onSelect={() => handleSelect(item.value, item.child)}
-                            value={item.value}
-                        >
-                            {item.child}
-                        </DropdownItem>
-                    ))}
-                    <DropdownItem
-                        isSelected={selected === 'disabled'}
-                        onSelect={() => handleSelect('disabled', 'disabled')}
-                        value="disabled"
-                        disabled
+        export function App() {
+            const items = [
+                {
+                    value: 'north_america',
+                    label: 'Северная Америка',
+                },
+                {
+                    value: 'south_america',
+                    label: 'Южная Америка',
+                    items: [
+                        {
+                            value: 'brazil',
+                            label: 'Бразилия',
+                            items: [
+                                {
+                                    value: 'rio_de_janeiro',
+                                    label: 'Рио-де-Жанейро',
+                                },
+                                {
+                                    value: 'sao_paulo',
+                                    label: 'Сан-Паулу',
+                                },
+                            ],
+                        },
+                        {
+                            value: 'argentina',
+                            label: 'Аргентина',
+                        },
+                    ],
+                },
+            ];
+
+
+            return (
+                <div style={{ height:"300px" }}>
+                    <Dropdown
+                        items={items}
                     >
-                        disabled
-                    </DropdownItem>
-                </Dropdown>
-            </div>
-    );
-}
-```
+                        <Button text="Список стран" />
+                    </Dropdown>
+                </div>
+            );
+        }
+        ```
+    </TabItem>
+
+    <TabItem value="size" label="Size">
+        Размер `Dropdown` задается с помощью свойства `size`.<br />
+        Возможные значения свойства: `"l"`, `"m"`, `"s"` или `"xs"`.
+
+        ```tsx live
+        import React from 'react';
+        import { Button, Dropdown } from '@salutejs/plasma-web';
+
+        export function App() {
+            const items = [
+                {
+                    value: 'north_america',
+                    label: 'Северная Америка',
+                },
+                {
+                    value: 'south_america',
+                    label: 'Южная Америка',
+                    items: [
+                        {
+                            value: 'brazil',
+                            label: 'Бразилия',
+                            items: [
+                                {
+                                    value: 'rio_de_janeiro',
+                                    label: 'Рио-де-Жанейро',
+                                },
+                                {
+                                    value: 'sao_paulo',
+                                    label: 'Сан-Паулу',
+                                },
+                            ],
+                        },
+                        {
+                            value: 'argentina',
+                            label: 'Аргентина',
+                        },
+                    ],
+                },
+            ];
+
+            return (
+                <div style={{ height: "300px", display: "flex", gap: "50px" }}>
+                    <Dropdown
+                        items={items}
+                        size="l"
+                    >
+                        <Button text="Список стран" />
+                    </Dropdown>
+
+                    <Dropdown
+                        items={items}
+                        size="m" // default
+                    >
+                        <Button text="Список стран" />
+                    </Dropdown>
+
+                    <Dropdown
+                        items={items}
+                        size="s"
+                    >
+                        <Button text="Список стран" />
+                    </Dropdown>
+
+                    <Dropdown
+                        items={items}
+                        size="xs"
+                    >
+                        <Button text="Список стран" />
+                    </Dropdown>
+                </div>
+            );
+        }
+        ```
+    </TabItem>
+
+    <TabItem value="placement" label="Placement">
+        Параметр `placement` принимает либо строку: `"top"`,  `"right"`, `"bottom"`, `"left"`, `"auto"`, либо массив этих же значений, например: `["top", "bottom"]`.<br />
+        Default value для placement - `"bottom"`.
+
+        ```tsx live
+        import React from 'react';
+        import { Button, Dropdown } from '@salutejs/plasma-web';
+
+        export function App() {
+            const items = [
+                {
+                    value: 'north_america',
+                    label: 'Северная Америка',
+                },
+                {
+                    value: 'south_america',
+                    label: 'Южная Америка',
+                    items: [
+                        {
+                            value: 'brazil',
+                            label: 'Бразилия',
+                            items: [
+                                {
+                                    value: 'rio_de_janeiro',
+                                    label: 'Рио-де-Жанейро',
+                                },
+                                {
+                                    value: 'sao_paulo',
+                                    label: 'Сан-Паулу',
+                                },
+                            ],
+                        },
+                        {
+                            value: 'argentina',
+                            label: 'Аргентина',
+                        },
+                    ],
+                },
+            ];
+
+            return (
+                <div style={{ height: "300px", display: "flex", gap: "50px" }}>
+                    <Dropdown
+                        items={items}
+                    >
+                        <Button text="Список стран" />
+                    </Dropdown>
+
+                    <Dropdown
+                        items={items}
+                        placement="right"
+                    >
+                        <Button text="Список стран" />
+                    </Dropdown>
+
+                    <Dropdown
+                        items={items}
+                        placement="left"
+                    >
+                        <Button text="Список стран" />
+                    </Dropdown>
+
+                    <Dropdown
+                        items={items}
+                        placement={['top', 'bottom']}
+                    >
+                        <Button text="Список стран" />
+                    </Dropdown>
+                </div>
+            );
+        }
+        ```
+    </TabItem>
+
+    <TabItem value="trigger" label="Trigger">
+        Параметр `trigger` принимает строку: `"click"` или `"hover"`.<br />
+        Default value - `"click"`.<br />
+        Для примера показано значение `"hover"`.
+
+        ```tsx live
+        import React from 'react';
+        import { Button, Dropdown } from '@salutejs/plasma-web';
+
+        export function App() {
+            const items = [
+                {
+                    value: 'north_america',
+                    label: 'Северная Америка',
+                },
+                {
+                    value: 'south_america',
+                    label: 'Южная Америка',
+                    items: [
+                        {
+                            value: 'brazil',
+                            label: 'Бразилия',
+                            items: [
+                                {
+                                    value: 'rio_de_janeiro',
+                                    label: 'Рио-де-Жанейро',
+                                },
+                                {
+                                    value: 'sao_paulo',
+                                    label: 'Сан-Паулу',
+                                },
+                            ],
+                        },
+                        {
+                            value: 'argentina',
+                            label: 'Аргентина',
+                        },
+                    ],
+                },
+            ];
+
+
+            return (
+                <div style={{ height:"300px" }}>
+                    <Dropdown
+                        items={items}
+                        trigger="hover"
+                    >
+                        <Button text="Список стран" />
+                    </Dropdown>
+                </div>
+            );
+        }
+        ```
+    </TabItem>
+</Tabs>
+
+## Клавиатурная навигация
+
+Данный компонент соответствует требования W3C: [Combobox](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/) и частично [TreeView](https://www.w3.org/WAI/ARIA/apg/patterns/treeview/).
+
+- `Tab` - закрывает дропдаун. Перемещает фокус на следующий элемент на странице;
+- `Enter` - открывает/закрывает дропдаун. Если на элементе - выбирает его;
+- `Space` - открывает/закрывает дропдаун. Если на элементе - выбирает его;
+- `Home` - открывает дропдаун и перемещает фокус на первый элемент;
+- `End` - открывает дропдаун и перемещает фокус на последний элемент;
+- `PageUp` - перемещает фокус на 10 элементов выше либо в начало списка;
+- `PageDown` - перемещает фокус на 10 элементов ниже либо в конце списка;
+- `ArrowUp` - открывает дропдаун и перемещает фокус на первый элемент. Перемещает фокус на один элемент выше;
+- `ArrowDown` - открывает дропдаун и перемещает фокус на первый элемент. Перемещает фокус на один элемент ниже;
+- `ArrowRight` - если фокус на элементе вложенного списка - открывает его и перемещает фокус на первый элемент;
+- `ArrowLeft` - закрывает текущий список и перемещает фокус на предыдущий;

package/styled-components/cjs/components/Dropdown/Dropdown.tokens.js

@@ -5,47 +5,38 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.tokens = exports.classes = void 0;
 var classes = exports.classes = {
-  dropdownItemIsSelected: 'dropdown-item-is-selected',
-  dropdownItemIsDisabled: 'dropdown-item-is-disabled'
+  dropdownRoot: 'dropdown-root',
+  dropdownItemIsFocused: 'dropdown-item-is-focused',
+  dropdownItemIsDisabled: 'dropdown-item-is-disabled',
+  dropdownItemIsActive: 'dropdown-item-is-active',
+  dropdownItemIsSelected: 'dropdownItemIsSelected'
 };
 var tokens = exports.tokens = {
   background: '--plasma-dropdown-background',
   boxShadow: '--plasma-dropdown-box-shadow',
   width: '--plasma-dropdown-width',
-  height: '--plasma-dropdown-height',
   borderRadius: '--plasma-dropdown-border-radius',
-  paddingTop: '--plasma-dropdown-padding-top',
-  paddingRight: '--plasma-dropdown-padding-right',
-  paddingBottom: '--plasma-dropdown-padding-bottom',
-  paddingLeft: '--plasma-dropdown-padding-left',
+  padding: '--plasma-dropdown-padding',
+  disclosureIconColor: '--plasma-dropdown-disclosure-icon-color',
   itemBackground: '--plasma-dropdown-item-background',
   itemColor: '--plasma-dropdown-item-color',
   itemBackgroundHover: '--plasma-dropdown-item-background-hover',
-  itemBackgroundSelected: '--plasma-dropdown-item-background-selected',
-  itemColorSelected: '--plasma-dropdown-item-color-selected',
-  itemBackgroundSelectedHover: '--plasma-dropdown-item-background-selected-hover',
-  itemColorSelectedHover: '--plasma-dropdown-item-color-selected-hover',
-  itemWidth: '--plasma-dropdown-item-width',
-  itemHeight: '--plasma-dropdown-item-height',
   itemBorderRadius: '--plasma-dropdown-item-border-radius',
   itemPaddingTop: '--plasma-dropdown-item-padding-top',
+  itemPaddingTopTight: '--plasma-dropdown-item-padding-top-tight',
   itemPaddingRight: '--plasma-dropdown-item-padding-right',
   itemPaddingBottom: '--plasma-dropdown-item-padding-bottom',
+  itemPaddingBottomTight: '--plasma-dropdown-item-padding-bottom-tight',
   itemPaddingLeft: '--plasma-dropdown-item-padding-left',
-  itemMarginTop: '--plasma-dropdown-item-margin-top',
-  itemMarginRight: '--plasma-dropdown-item-margin-right',
-  itemMarginBottom: '--plasma-dropdown-item-margin-bottom',
-  itemMarginLeft: '--plasma-dropdown-item-margin-left',
   itemFontFamily: '--plasma-dropdown-item-font-family',
   itemFontSize: '--plasma-dropdown-item-font-size',
   itemFontStyle: '--plasma-dropdown-item-font-style',
   itemFontWeightBold: '--plasma-dropdown-item-letter-spacing',
   itemFontLetterSpacing: '--plasma-dropdown-item-line-height',
   itemFontLineHeight: '--plasma-dropdown-item-font-weight',
-  itemContentLeftColor: '--plasma-dropdown-item-content-left-color',
-  itemContentRightColor: '--plasma-dropdown-item-content-right-color',
-  itemContentLeftWidth: '--plasma-dropdown-item-content-left-width',
-  itemContentRightWidth: '--plasma-dropdown-item-content-right-width',
+  disabledOpacity: '--plasma-dropdown-disabled-opacity',
+  focusColor: '--plasma-dropdown-focus-color',
+  // TODO: Remove below tokens as soon as they are no longer needed
   footerBackground: '--plasma-dropdown-footer-background',
   footerWidth: '--plasma-dropdown-footer-width',
   footerHeight: '--plasma-dropdown-footer-height',
@@ -113,6 +104,18 @@ var tokens = exports.tokens = {
   groupLabelMarginRight: '--plasma-dropdown-group-label-margin-right',
   groupLabelMarginBottom: '--plasma-dropdown-group-label-margin-bottom',
   groupLabelMarginLeft: '--plasma-dropdown-group-label-margin-left',
-  disabledOpacity: '--plasma-dropdown-disabled-opacity',
-  focusColor: '--plasma-dropdown-focus-color'
+  itemBackgroundSelected: '--plasma-dropdown-item-background-selected',
+  itemColorSelected: '--plasma-dropdown-item-color-selected',
+  itemBackgroundSelectedHover: '--plasma-dropdown-item-background-selected-hover',
+  itemColorSelectedHover: '--plasma-dropdown-item-color-selected-hover',
+  itemContentLeftColor: '--plasma-dropdown-item-content-left-color',
+  itemContentRightColor: '--plasma-dropdown-item-content-right-color',
+  itemWidth: '--plasma-dropdown-item-width',
+  itemHeight: '--plasma-dropdown-item-height',
+  itemMarginTop: '--plasma-dropdown-item-margin-top',
+  itemMarginRight: '--plasma-dropdown-item-margin-right',
+  itemMarginBottom: '--plasma-dropdown-item-margin-bottom',
+  itemMarginLeft: '--plasma-dropdown-item-margin-left',
+  itemContentLeftWidth: '--plasma-dropdown-item-content-left-width',
+  itemContentRightWidth: '--plasma-dropdown-item-content-right-width'
 };

package/styled-components/cjs/components/Dropdown/hooks/useHashMaps.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useHashMaps = void 0;
+var _react = /*#__PURE__*/require("react");
+// Данный хук рекурсивно проходится по дереву items и создает 2 мапы: мапу путей и мапу фокусов.
+// Нужно для получения всей информации об item, зная только путь до него.
+
+var useHashMaps = exports.useHashMaps = function useHashMaps(items) {
+  return (0, _react.useMemo)(function () {
+    var pathMap = new Map();
+    var focusedToValueMap = new Map();
+    pathMap.set('root', items.length);
+    var rec = function rec(items) {
+      var prevIndex = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+      items.forEach(function (item, index) {
+        var value = item.value,
+          innerItems = item.items;
+        var currIndex = "".concat(prevIndex, "/").concat(index).replace(/^(\/)/, '');
+        focusedToValueMap.set(currIndex, item);
+        if (innerItems) {
+          pathMap.set(value, innerItems.length);
+          rec(innerItems, currIndex);
+        }
+      });
+    };
+    rec(items);
+    return [pathMap, focusedToValueMap];
+  }, [items]);
+};