@salutejs/plasma-new-hope 0.78.0-canary.1203.8970261959.0 → 0.79.0-canary.1195.9053577477.0

package/styled-components/es/components/Dropdown/Dropdown.js

@@ -1,82 +1,169 @@
-var _excluded = ["id", "target", "children", "hasArrow", "role", "view", "size", "frame", "onToggle", "isFocusTrapped", "isOpen", "placement", "trigger", "offset", "preventOverflow", "closeOnOverlayClick", "closeOnEsc"];
+var _excluded = ["items", "children", "placement", "offset", "closeOnOverlayClick", "onToggle", "size", "view", "itemRole", "className", "listWidth", "listHeight", "listOverflow", "closeOnSelect", "onHover", "onItemSelect", "onItemClick", "trigger", "variant", "hasArrow"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-import React, { forwardRef, useRef } from 'react';
-import { useFocusTrap, useForkRef, useUniqId } from '@salutejs/plasma-core';
+import React, { forwardRef, useReducer } from 'react';
+import { cx } from '../../utils';
+import { pathReducer } from './reducers/pathReducer';
+import { focusedPathReducer } from './reducers/focusedPathReducer';
+import { DropdownInner } from './ui';
 import { base as viewCSS } from './variations/_view/base';
 import { base as sizeCSS } from './variations/_size/base';
-import { StyledDropdown, StyledPopover } from './Dropdown.styles';
-import { getPlacements } from './utils';
+import { Ul, StyledPopover, base } from './Dropdown.styles';
+import { getPlacements, childrenWithProps } from './utils';
+import { classes } from './Dropdown.tokens';
+import { useKeyNavigation } from './hooks/useKeyboardNavigation';
+import { useHashMaps } from './hooks/useHashMaps';
+
 /**
- * Выпадающий список без внешнего контроля видимости.
+ * Выпадающий список.
  */
 export var dropdownRoot = function dropdownRoot(Root) {
-  return /*#__PURE__*/forwardRef(function (_ref, outerRootRef) {
-    var id = _ref.id,
-      target = _ref.target,
+  return /*#__PURE__*/forwardRef(function (_ref, ref) {
+    var items = _ref.items,
       children = _ref.children,
-      hasArrow = _ref.hasArrow,
-      role = _ref.role,
-      view = _ref.view,
-      size = _ref.size,
-      frame = _ref.frame,
-      _onToggle = _ref.onToggle,
-      _ref$isFocusTrapped = _ref.isFocusTrapped,
-      isFocusTrapped = _ref$isFocusTrapped === void 0 ? true : _ref$isFocusTrapped,
-      _ref$isOpen = _ref.isOpen,
-      isOpen = _ref$isOpen === void 0 ? false : _ref$isOpen,
       _ref$placement = _ref.placement,
-      placement = _ref$placement === void 0 ? 'auto' : _ref$placement,
-      _ref$trigger = _ref.trigger,
-      trigger = _ref$trigger === void 0 ? 'click' : _ref$trigger,
+      placement = _ref$placement === void 0 ? 'bottom' : _ref$placement,
       _ref$offset = _ref.offset,
-      offset = _ref$offset === void 0 ? [0, 6] : _ref$offset,
-      _ref$preventOverflow = _ref.preventOverflow,
-      preventOverflow = _ref$preventOverflow === void 0 ? false : _ref$preventOverflow,
+      offset = _ref$offset === void 0 ? [0, 0] : _ref$offset,
       _ref$closeOnOverlayCl = _ref.closeOnOverlayClick,
-      closeOnOverlayClick = _ref$closeOnOverlayCl === void 0 ? false : _ref$closeOnOverlayCl,
-      _ref$closeOnEsc = _ref.closeOnEsc,
-      closeOnEsc = _ref$closeOnEsc === void 0 ? false : _ref$closeOnEsc,
+      closeOnOverlayClick = _ref$closeOnOverlayCl === void 0 ? true : _ref$closeOnOverlayCl,
+      onToggle = _ref.onToggle,
+      size = _ref.size,
+      view = _ref.view,
+      _ref$itemRole = _ref.itemRole,
+      itemRole = _ref$itemRole === void 0 ? 'treeitem' : _ref$itemRole,
+      className = _ref.className,
+      listWidth = _ref.listWidth,
+      listHeight = _ref.listHeight,
+      listOverflow = _ref.listOverflow,
+      _ref$closeOnSelect = _ref.closeOnSelect,
+      closeOnSelect = _ref$closeOnSelect === void 0 ? true : _ref$closeOnSelect,
+      onHover = _ref.onHover,
+      onItemSelect = _ref.onItemSelect,
+      onItemClick = _ref.onItemClick,
+      _ref$trigger = _ref.trigger,
+      trigger = _ref$trigger === void 0 ? 'click' : _ref$trigger,
+      _ref$variant = _ref.variant,
+      variant = _ref$variant === void 0 ? 'normal' : _ref$variant,
+      _ref$hasArrow = _ref.hasArrow,
+      hasArrow = _ref$hasArrow === void 0 ? true : _ref$hasArrow,
       rest = _objectWithoutProperties(_ref, _excluded);
-    var uniqId = useUniqId();
-    var innerId = id || uniqId;
-    var rootRef = useRef(null);
-    var dropdownRef = useRef(null);
-    var handleRef = useForkRef(rootRef, outerRootRef);
-    var trapRef = useFocusTrap(isOpen && isFocusTrapped);
-    var dropdownForkRef = useForkRef(dropdownRef, trapRef);
-    return /*#__PURE__*/React.createElement(StyledPopover, {
-      role: role,
-      isOpen: isOpen,
+    var _useReducer = useReducer(pathReducer, []),
+      _useReducer2 = _slicedToArray(_useReducer, 2),
+      path = _useReducer2[0],
+      dispatchPath = _useReducer2[1];
+    var _useReducer3 = useReducer(focusedPathReducer, []),
+      _useReducer4 = _slicedToArray(_useReducer3, 2),
+      focusedPath = _useReducer4[0],
+      dispatchFocusedPath = _useReducer4[1];
+    var _useHashMaps = useHashMaps(items),
+      _useHashMaps2 = _slicedToArray(_useHashMaps, 2),
+      pathMap = _useHashMaps2[0],
+      focusedToValueMap = _useHashMaps2[1];
+    var handleGlobalToggle = function handleGlobalToggle(opened, event) {
+      if (opened) {
+        dispatchPath({
+          type: 'opened_first_level'
+        });
+      } else {
+        dispatchFocusedPath({
+          type: 'reset'
+        });
+        dispatchPath({
+          type: 'reset'
+        });
+      }
+      if (onToggle) {
+        onToggle(opened, event);
+      }
+    };
+    var _useKeyNavigation = useKeyNavigation({
+        focusedPath: focusedPath,
+        dispatchFocusedPath: dispatchFocusedPath,
+        path: path,
+        dispatchPath: dispatchPath,
+        pathMap: pathMap,
+        focusedToValueMap: focusedToValueMap,
+        handleGlobalToggle: handleGlobalToggle,
+        closeOnSelect: closeOnSelect,
+        onItemSelect: onItemSelect,
+        onItemClick: onItemClick
+      }),
+      onKeyDown = _useKeyNavigation.onKeyDown;
+    var isCurrentListOpen = Boolean(path[0]);
+    var getActiveDescendant = function getActiveDescendant() {
+      var _focusedToValueMap$ge;
+      var focusedPathAsString = focusedPath.reduce(function (acc, n) {
+        return "".concat(acc, "/").concat(n);
+      }, '').replace(/^(\/)/, '');
+      return focusedToValueMap === null || focusedToValueMap === void 0 || (_focusedToValueMap$ge = focusedToValueMap.get(focusedPathAsString)) === null || _focusedToValueMap$ge === void 0 ? void 0 : _focusedToValueMap$ge.value.toString();
+    };
+    return /*#__PURE__*/React.createElement(Root, _extends({
+      className: cx(className, classes.dropdownRoot),
+      ref: ref,
+      view: view,
+      size: size,
+      items: items
+    }, rest), /*#__PURE__*/React.createElement(StyledPopover, {
+      isOpen: isCurrentListOpen,
       usePortal: false,
-      onToggle: function onToggle(is, event) {
-        return _onToggle === null || _onToggle === void 0 ? void 0 : _onToggle(is, event);
-      },
-      id: innerId,
-      ref: dropdownForkRef,
-      target: target,
+      onToggle: handleGlobalToggle,
       offset: offset,
-      preventOverflow: preventOverflow,
-      hasArrow: hasArrow,
       placement: getPlacements(placement),
       trigger: trigger,
       closeOnOverlayClick: closeOnOverlayClick,
-      closeOnEsc: closeOnEsc,
-      isFocusTrapped: isFocusTrapped,
-      frame: frame
-    }, /*#__PURE__*/React.createElement(Root, _extends({
-      ref: handleRef,
-      view: view,
-      size: size
-    }, rest), /*#__PURE__*/React.createElement(StyledDropdown, null, children)));
+      isFocusTrapped: false,
+      target: childrenWithProps(children, {
+        role: 'combobox',
+        'aria-controls': 'tree_level_1',
+        'aria-expanded': isCurrentListOpen,
+        'aria-activedescendant': getActiveDescendant(),
+        onKeyDown: onKeyDown
+      }),
+      preventOverflow: false
+    }, /*#__PURE__*/React.createElement(Ul, {
+      listHeight: listHeight,
+      listOverflow: listOverflow,
+      role: "tree",
+      id: "tree_level_1",
+      listWidth: listWidth
+    }, items.map(function (item, index) {
+      return /*#__PURE__*/React.createElement(DropdownInner, {
+        key: "".concat(index, "/0"),
+        item: item,
+        currentLevel: 0,
+        focusedPath: focusedPath,
+        trigger: trigger,
+        path: path,
+        dispatchPath: dispatchPath,
+        index: index,
+        itemRole: itemRole,
+        listHeight: listHeight,
+        listOverflow: listOverflow,
+        handleGlobalToggle: handleGlobalToggle,
+        closeOnSelect: closeOnSelect,
+        onHover: onHover,
+        onItemSelect: onItemSelect,
+        onItemClick: onItemClick,
+        listWidth: listWidth,
+        variant: variant,
+        hasArrow: hasArrow
+      });
+    }))));
   });
 };
 export var dropdownConfig = {
   name: 'Dropdown',
   tag: 'div',
   layout: dropdownRoot,
-  base: '',
+  base: base,
   variations: {
     view: {
       css: viewCSS

package/styled-components/es/components/Dropdown/Dropdown.styles.js

@@ -1,13 +1,26 @@
 import styled from 'styled-components';
+import { css } from 'styled-components';
 import { component } from '../../engines';
 import { popoverConfig, popoverClasses } from '../Popover';
+import { getCorrectHeight } from './utils';
 import { tokens } from './Dropdown.tokens';
-
-// issue #823
 var Popover = /*#__PURE__*/component(popoverConfig);
 export var StyledPopover = /*#__PURE__*/styled(Popover).withConfig({
   componentId: "plasma-new-hope__sc-13ezpo5-0"
-})([".", "{display:block;}"], /*#__PURE__*/String(popoverClasses.target));
-export var StyledDropdown = /*#__PURE__*/styled.div.withConfig({
+})([".", ",.", "{display:block;}"], /*#__PURE__*/String(popoverClasses.wrapper), /*#__PURE__*/String(popoverClasses.target));
+export var Ul = /*#__PURE__*/styled.ul.withConfig({
   componentId: "plasma-new-hope__sc-13ezpo5-1"
-})(["box-sizing:border-box;background:var(", ");box-shadow:var(", ");border-radius:var(", ");width:var(", ");height:var(", ");padding:var(", ") var(", ") var(", ") var(", ");"], tokens.background, tokens.boxShadow, tokens.borderRadius, tokens.width, tokens.height, tokens.paddingTop, tokens.paddingRight, tokens.paddingBottom, tokens.paddingLeft);
+})(["box-sizing:border-box;background:var(", ");box-shadow:var(", ");border-radius:var(", ");width:", ";height:", ";overflow:", ";margin:", ";padding:var(", ");"], tokens.background, tokens.boxShadow, tokens.borderRadius, function (_ref) {
+  var listWidth = _ref.listWidth;
+  return listWidth || "var(".concat(tokens.width, ")");
+}, function (_ref2) {
+  var listHeight = _ref2.listHeight;
+  return listHeight ? getCorrectHeight(listHeight) : 'auto';
+}, function (_ref3) {
+  var listOverflow = _ref3.listOverflow;
+  return listOverflow || 'initial';
+}, function (_ref4) {
+  var isInnerUl = _ref4.isInnerUl;
+  return isInnerUl ? "calc(var(".concat(tokens.padding, ") * -1) 0 0 var(").concat(tokens.padding, ")") : 0;
+}, tokens.padding);
+export var base = /*#__PURE__*/css(["display:inline-block;"]);

package/styled-components/es/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` - закрывает текущий список и перемещает фокус на предыдущий;