@vkontakte/vkui 4.28.0 → 4.28.1

package/src/components/ActionSheet/Readme.md

@@ -0,0 +1,256 @@
+ActionSheet – имитация [нативного компонента](https://developer.apple.com/ios/human-interface-guidelines/views/action-sheets/).
+Удобно использовать, когда нужно дать пользователю выбрать одно из множества действий. В качестве `children` принимает
+коллекцию `ActionSheetItem`.
+
+Передаётся в качестве значения свойства `popout` компонента [`SplitLayout`](#/SplitLayout).
+
+> **Важно**
+>
+> - Нужно обязательно передать `onClose` для обработки закрытия `ActionSheet` изнутри.
+> - Согласно гайдлайнам Apple, в `ActionSheet` должен быть элемент для закрытия, для этого предусмотрен атрибут `iosCloseItem`.
+>   В коде примера ниже можно посмотреть, как добавить такой элемент.
+>   Для Android версии он не нужен.
+
+```jsx { "props": { "layout": false, "adaptivity": true } }
+const [popout, setPopout] = useState(null);
+const onClose = () => setPopout(null);
+const [filter, setFilter] = useState("best");
+const onChange = (e) => setFilter(e.target.value);
+const baseTargetRef = React.useRef();
+const iconsTargetRef = React.useRef();
+const subtitleTargetRef = React.useRef();
+const selectableTargetRef = React.useRef();
+const titleTargetRef = React.useRef();
+const baseTopTargetRef = React.useRef();
+
+const openBase = () =>
+  setPopout(
+    <ActionSheet
+      onClose={onClose}
+      iosCloseItem={
+        <ActionSheetItem autoclose mode="cancel">
+          Отменить
+        </ActionSheetItem>
+      }
+      toggleRef={baseTargetRef}
+    >
+      <ActionSheetItem autoclose>Сохранить в закладках</ActionSheetItem>
+      <ActionSheetItem autoclose>Закрепить запись</ActionSheetItem>
+      <ActionSheetItem autoclose>Выключить комментирование</ActionSheetItem>
+      <ActionSheetItem autoclose>Закрепить запись</ActionSheetItem>
+      <ActionSheetItem autoclose mode="destructive">
+        Удалить запись
+      </ActionSheetItem>
+    </ActionSheet>
+  );
+
+const openIcons = () =>
+  setPopout(
+    <ActionSheet
+      onClose={onClose}
+      iosCloseItem={
+        <ActionSheetItem autoclose mode="cancel">
+          Отменить
+        </ActionSheetItem>
+      }
+      toggleRef={iconsTargetRef}
+    >
+      <ActionSheetItem autoclose before={<Icon28EditOutline />}>
+        Редактировать профиль
+      </ActionSheetItem>
+      <ActionSheetItem autoclose before={<Icon28ListPlayOutline />}>
+        Слушать далее
+      </ActionSheetItem>
+      <ActionSheetItem autoclose before={<Icon28ShareOutline />}>
+        Поделиться
+      </ActionSheetItem>
+      <ActionSheetItem autoclose before={<Icon28CopyOutline />}>
+        Скопировать ссылку
+      </ActionSheetItem>
+      <ActionSheetItem
+        autoclose
+        before={
+          platform === IOS ? (
+            <Icon28DeleteOutline />
+          ) : (
+            <Icon28DeleteOutlineAndroid />
+          )
+        }
+        mode="destructive"
+      >
+        Удалить плейлист
+      </ActionSheetItem>
+    </ActionSheet>
+  );
+
+const openSubtitle = () =>
+  setPopout(
+    <ActionSheet
+      onClose={onClose}
+      iosCloseItem={
+        <ActionSheetItem autoclose mode="cancel">
+          Отменить
+        </ActionSheetItem>
+      }
+      toggleRef={subtitleTargetRef}
+    >
+      <ActionSheetItem
+        before={<Icon28SettingsOutline />}
+        autoclose
+        subtitle="Авто"
+      >
+        Качество
+      </ActionSheetItem>
+      <ActionSheetItem
+        before={<Icon28SubtitlesOutline />}
+        autoclose
+        subtitle="Отсутствуют"
+        disabled
+      >
+        Субтитры
+      </ActionSheetItem>
+      <ActionSheetItem
+        before={<Icon28PlaySpeedOutline />}
+        autoclose
+        subtitle="Обычная"
+      >
+        Скорость воспроизведения
+      </ActionSheetItem>
+    </ActionSheet>
+  );
+
+const openSelectable = () =>
+  setPopout(
+    <ActionSheet
+      onClose={onClose}
+      iosCloseItem={
+        <ActionSheetItem autoclose mode="cancel">
+          Отменить
+        </ActionSheetItem>
+      }
+      toggleRef={selectableTargetRef}
+    >
+      <ActionSheetItem
+        onChange={onChange}
+        checked={filter === "best"}
+        name="filter"
+        value="best"
+        autoclose
+        selectable
+      >
+        Лучшие друзья
+      </ActionSheetItem>
+      <ActionSheetItem
+        onChange={onChange}
+        checked={filter === "relatives"}
+        name="filter"
+        value="relatives"
+        autoclose
+        selectable
+      >
+        Родственники
+      </ActionSheetItem>
+      <ActionSheetItem
+        onChange={onChange}
+        checked={filter === "collegues"}
+        name="filter"
+        value="collegues"
+        autoclose
+        selectable
+      >
+        Коллеги
+      </ActionSheetItem>
+      <ActionSheetItem
+        onChange={onChange}
+        checked={filter === "school"}
+        name="filter"
+        value="school"
+        autoclose
+        selectable
+      >
+        Друзья по школе
+      </ActionSheetItem>
+      <ActionSheetItem
+        onChange={onChange}
+        checked={filter === "university"}
+        name="filter"
+        value="university"
+        autoclose
+        selectable
+      >
+        Друзья по вузу
+      </ActionSheetItem>
+    </ActionSheet>
+  );
+
+const openTitle = () =>
+  setPopout(
+    <ActionSheet
+      onClose={onClose}
+      iosCloseItem={
+        <ActionSheetItem autoclose mode="cancel">
+          Отменить
+        </ActionSheetItem>
+      }
+      header="Вы действительно хотите удалить это видео из Ваших видео?"
+      toggleRef={titleTargetRef}
+    >
+      <ActionSheetItem autoclose mode="destructive">
+        Удалить видео
+      </ActionSheetItem>
+    </ActionSheet>
+  );
+
+const openBaseTop = () =>
+  setPopout(
+    <ActionSheet
+      onClose={onClose}
+      iosCloseItem={
+        <ActionSheetItem autoclose mode="cancel">
+          Отменить
+        </ActionSheetItem>
+      }
+      toggleRef={baseTopTargetRef}
+    >
+      <ActionSheetItem autoclose>Сохранить в закладках</ActionSheetItem>
+      <ActionSheetItem autoclose>Закрепить запись</ActionSheetItem>
+      <ActionSheetItem autoclose>Выключить комментирование</ActionSheetItem>
+      <ActionSheetItem autoclose>Закрепить запись</ActionSheetItem>
+      <ActionSheetItem autoclose mode="destructive">
+        Удалить запись
+      </ActionSheetItem>
+    </ActionSheet>
+  );
+
+React.useEffect(openBase, []);
+
+<SplitLayout popout={popout}>
+  <SplitCol>
+    <View activePanel="panel">
+      <Panel id="panel">
+        <PanelHeader>ActionSheet</PanelHeader>
+        <Group>
+          <CellButton getRootRef={baseTargetRef} onClick={openBase}>
+            Базовый список
+          </CellButton>
+          <CellButton getRootRef={iconsTargetRef} onClick={openIcons}>
+            Список с иконками
+          </CellButton>
+          <CellButton getRootRef={subtitleTargetRef} onClick={openSubtitle}>
+            С подзаголовком
+          </CellButton>
+          <CellButton getRootRef={selectableTargetRef} onClick={openSelectable}>
+            Выделяемые
+          </CellButton>
+          <CellButton getRootRef={titleTargetRef} onClick={openTitle}>
+            C заголовком
+          </CellButton>
+          <CellButton getRootRef={baseTopTargetRef} onClick={openBaseTop}>
+            Базовый список, открывается наверх на десктопах
+          </CellButton>
+        </Group>
+      </Panel>
+    </View>
+  </SplitCol>
+</SplitLayout>;
+```

package/src/components/ActionSheet/types.ts

@@ -0,0 +1,16 @@
+import * as React from "react";
+import { FocusTrapProps } from "../FocusTrap/FocusTrap";
+
+export type PopupDirection =
+  | "top"
+  | "bottom"
+  | ((elRef: React.RefObject<HTMLDivElement>) => "top" | "bottom");
+export type ToggleRef = Element | null | undefined | React.RefObject<Element>;
+
+export interface SharedDropdownProps
+  extends React.AllHTMLAttributes<HTMLElement>,
+    FocusTrapProps {
+  closing: boolean;
+  toggleRef: ToggleRef;
+  popupDirection: PopupDirection;
+}

package/src/components/ActionSheetItem/ActionSheetItem.css

@@ -0,0 +1,306 @@
+.ActionSheetItem {
+  position: relative;
+  z-index: 2;
+  overflow: hidden;
+  display: flex;
+  align-items: center;
+  text-decoration: none;
+  color: var(--text_primary);
+}
+
+.ActionSheetItem__container,
+.ActionSheetItem__before,
+.ActionSheetItem__after {
+  position: relative;
+  z-index: 2;
+}
+
+.ActionSheetItem__before,
+.ActionSheetItem__after {
+  flex-shrink: 0;
+}
+
+.ActionSheetItem__container {
+  max-width: 100%;
+  flex-grow: 1;
+  white-space: nowrap;
+  overflow: hidden;
+}
+
+.ActionSheetItem__content {
+  display: flex;
+  align-items: baseline;
+  overflow: hidden;
+}
+
+.ActionSheetItem__children {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.ActionSheetItem__subtitle {
+  color: var(--text_secondary);
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.ActionSheetItem__meta {
+  color: var(--text_secondary);
+  margin-left: 6px;
+  flex-shrink: 0;
+}
+
+.ActionSheetItem__before {
+  color: var(--action_sheet_action_foreground);
+}
+
+.ActionSheetItem--destructive .ActionSheetItem__container:first-child {
+  color: var(--destructive);
+}
+
+.ActionSheetItem--destructive .ActionSheetItem__before {
+  color: var(--destructive);
+}
+
+.ActionSheetItem--compact .ActionSheetItem__container {
+  color: var(--text_primary);
+}
+
+.ActionSheetItem__radio {
+  display: none;
+}
+
+.ActionSheetItem__marker {
+  display: none;
+  width: 24px;
+  height: 24px;
+  border-radius: 50%;
+  align-items: center;
+  justify-content: center;
+  background-color: var(--accent);
+  color: var(--white);
+}
+
+.ActionSheetItem__radio:checked ~ .ActionSheetItem__marker {
+  display: flex;
+}
+
+/**
+ * iOS
+ */
+
+.ActionSheetItem--ios {
+  padding: 0 20px;
+  min-height: 56px;
+  border-radius: 0;
+  color: var(--action_sheet_action_foreground);
+}
+
+.ActionSheetItem--ios.ActionSheetItem--destructive {
+  color: var(--destructive);
+}
+
+.ActionSheetItem--ios:first-child {
+  border-top-left-radius: 14px;
+  border-top-right-radius: 14px;
+}
+
+.ActionSheetItem--ios:not(.ActionSheetItem--desktop):nth-last-child(2),
+.ActionSheetItem--ios:last-child {
+  border-bottom-left-radius: 14px;
+  border-bottom-right-radius: 14px;
+}
+
+.ActionSheetItem--ios::before {
+  position: absolute;
+  left: 0;
+  top: 0;
+  width: 100%;
+  height: 100%;
+  background-color: var(--modal_card_background);
+  z-index: -1;
+  content: "";
+  transition: opacity 0.15s ease-out, background-color 0.15s ease-out;
+}
+
+.ActionSheetItem--ios::after {
+  position: absolute;
+  right: 0;
+  left: 0;
+  z-index: -1;
+  height: 1px;
+  content: "";
+  top: 0;
+  background: var(--action_sheet_separator);
+  transform-origin: center bottom;
+}
+
+@media (min-resolution: 2dppx) {
+  .ActionSheetItem--ios::after {
+    transform: scaleY(0.5);
+  }
+}
+
+@media (min-resolution: 3dppx) {
+  .ActionSheetItem--ios::after {
+    transform: scaleY(0.33);
+  }
+}
+
+.ActionSheetItem--ios:first-child::after,
+.ActionSheetItem--cancel::after {
+  content: none;
+}
+
+.ActionSheet--ios .ActionSheetItem--last::after,
+.ActionSheet--ios .ActionSheet__header:empty {
+  content: none;
+}
+
+.ActionSheetItem--ios.ActionSheetItem--active::before {
+  background: var(--separator_common);
+  opacity: 1;
+  transition: none;
+}
+
+.ActionSheetItem--ios .ActionSheetItem__container {
+  padding: 13px 0;
+}
+
+.ActionSheetItem--ios .ActionSheetItem__content {
+  justify-content: center;
+}
+
+.ActionSheetItem--ios .ActionSheetItem__subtitle {
+  margin-top: 2px;
+}
+
+.ActionSheetItem--ios .ActionSheetItem__marker {
+  margin-left: 12px;
+}
+
+.ActionSheetItem--ios.ActionSheetItem--compact .ActionSheetItem__content,
+.ActionSheetItem--ios
+  .ActionSheetItem__before
+  + .ActionSheetItem__container
+  .ActionSheetItem__content {
+  justify-content: flex-start;
+}
+
+.ActionSheetItem--ios .ActionSheetItem__before {
+  margin-right: 18px;
+  margin-left: -2px;
+}
+
+.ActionSheetItem--cancel {
+  margin-top: 7px;
+  margin-bottom: var(--safe-area-inset-bottom);
+  border-radius: 14px;
+  min-height: 52px;
+}
+
+/**
+ * Android
+ */
+
+.ActionSheetItem--android {
+  padding: 0 20px;
+  min-height: 48px;
+  border-radius: 0;
+}
+
+.ActionSheetItem--android.ActionSheetItem--active {
+  background-color: var(--action_sheet_separator);
+}
+
+.ActionSheetItem--android .ActionSheetItem__before {
+  margin-right: 18px;
+  margin-left: -2px;
+}
+
+.ActionSheetItem--android .ActionSheetItem__container {
+  padding: 11px 0;
+}
+
+.ActionSheetItem--android .ActionSheetItem__subtitle {
+  margin-top: 1px;
+  margin-bottom: -1px;
+}
+
+.ActionSheetItem--android .ActionSheetItem__marker {
+  margin-left: 16px;
+}
+
+/**
+ * VKCOM
+ */
+.ActionSheetItem--vkcom {
+  padding: 0 20px;
+  min-height: 48px;
+  border-radius: 0;
+}
+
+.ActionSheetItem--vkcom.ActionSheetItem--active {
+  background-color: var(--action_sheet_separator);
+}
+
+.ActionSheetItem--vkcom .ActionSheetItem__before {
+  margin-right: 17px;
+  margin-left: -1px;
+}
+
+.ActionSheetItem--vkcom .ActionSheetItem__subtitle {
+  margin-top: 2px;
+  margin-bottom: -2px;
+}
+
+.ActionSheetItem--vkcom .ActionSheetItem__marker {
+  margin-left: 26px;
+  color: var(--accent);
+  background-color: transparent;
+}
+
+/**
+ * Desktop
+ */
+
+.ActionSheetItem--desktop {
+  width: auto;
+  cursor: pointer;
+}
+
+/**
+ * Disabled
+ */
+
+.ActionSheetItem[disabled] .ActionSheetItem__children,
+.ActionSheetItem[disabled] .ActionSheetItem__meta,
+.ActionSheetItem[disabled] .ActionSheetItem__subtitle {
+  color: var(--text_secondary);
+}
+
+.ActionSheetItem[disabled] .ActionSheetItem__before {
+  color: var(--icon_secondary);
+}
+
+.ActionSheetItem[disabled] .ActionSheetItem__marker {
+  background: var(--icon_secondary);
+}
+
+/**
+ * SizeY = compact
+ */
+
+.ActionSheetItem--sizeY-compact {
+  min-height: 44px;
+}
+
+.ActionSheetItem--sizeY-compact .ActionSheetItem__container {
+  padding: 12px 0;
+}
+
+.ActionSheetItem--sizeY-compact.ActionSheetItem--withSubtitle
+  .ActionSheetItem__container {
+  padding: 10px 0;
+}