Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 2 additions & 16 deletions .storybook/StorybookShell.tsx
Original file line number Diff line number Diff line change
@@ -1,29 +1,15 @@
import type { ReactNode } from 'react'
import { Appearance, View } from 'react-native'
import { StyleSheet } from 'react-native-unistyles'
import { Appearance } from 'react-native'

import { ThemeContextProvider, ThemeVariant } from '../src/theme'

import { StorybookToolbar } from './StorybookToolbar'

const initialTheme =
Appearance.getColorScheme() === 'dark'
? ThemeVariant.Dark
: ThemeVariant.Light

export const StorybookShell = ({ children }: { children: ReactNode }) => (
<ThemeContextProvider initialTheme={initialTheme}>
<View style={styles.container}>
<StorybookToolbar />
{children}
</View>
{children}
</ThemeContextProvider>
)

const styles = StyleSheet.create(({ semantic }, rt) => ({
container: {
flex: 1,
paddingTop: rt.insets.top,
backgroundColor: semantic.colorScheme.color.bg.surface.default.default,
},
}))
11 changes: 8 additions & 3 deletions .storybook/preview.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,17 @@ import type { Preview } from '@storybook/react'
import { StyleSheet } from 'react-native-unistyles'
import { View } from 'react-native'

import { StorybookToolbar } from './StorybookToolbar'

const preview: Preview = {
decorators: [
(Story) => (
<View style={styles.container}>
<Story />
</View>
<>
<StorybookToolbar />
<View style={styles.container}>
<Story />
</View>
</>
),
],
parameters: {
Expand Down
16 changes: 6 additions & 10 deletions design-tokens/input/tokens.json
Original file line number Diff line number Diff line change
Expand Up @@ -1353,12 +1353,8 @@
"extend": {
"borderColor": "{color.border.neutral.inverse}",
"circle": { "borderRadius": "{dimension.borderRadius.max}" },
"xl": {
"borderRadius": "{dimension.borderRadius.400}"
},
"lg": {
"borderRadius": "{dimension.borderRadius.350}"
}
"xl": { "borderRadius": "{dimension.borderRadius.400}" },
"lg": { "borderRadius": "{dimension.borderRadius.350}" }
},
"root": {
"width": "{dimension.size.900}",
Expand Down Expand Up @@ -2713,20 +2709,20 @@
"background": "{color.bg.surface.raised.default}",
"borderColor": "{color.border.neutral.default}",
"color": "{color.fg.default}",
"borderRadius": "{dimension.borderRadius.500}",
"borderRadius": "{dimension.size.700}",
"shadow": "{effects.elevation.400}"
},
"header": {
"padding": "{dimension.space.700} {dimension.space.700} {dimension.space.400} {dimension.space.700}",
"padding": "{dimension.space.600} {dimension.space.600} {dimension.space.400} {dimension.space.600}",
"gap": "{dimension.space.200}"
},
"title": {
"fontSize": "{fonts.fontSize.500}",
"fontSize": "{fonts.fontSize.400}",
"fontWeight": "{fonts.fontWeight.demibold}"
},
"content": { "padding": "{dimension.space.700}" },
"footer": {
"padding": "{dimension.space.none} {dimension.space.700} {dimension.space.700} {dimension.space.700}",
"padding": "{dimension.space.none} {dimension.space.600} {dimension.space.600} {dimension.space.600}",
"gap": "{dimension.space.200}"
},
"colorScheme": {
Expand Down
2 changes: 1 addition & 1 deletion jest.setup.ts
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ unistyles.StyleSheet.create = jest.fn(
(stylesheet: ((theme: ReturnType<typeof getTheme>) => unknown) | unknown) => {
const styleDefinitions =
typeof stylesheet === 'function'
? stylesheet(getTheme(runtime.themeName))
? stylesheet(getTheme(runtime.themeName), runtime.miniRuntime)
: stylesheet

const activeVariants: Record<string, unknown> = {}
Expand Down
191 changes: 191 additions & 0 deletions src/components/Dialog/Dialog.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,191 @@
# Dialog

Управляемое модальное окно с отдельными шапкой, содержимым и футером.

## Использование

```tsx
import { useState } from 'react'
import {
Button,
Dialog,
DialogActions,
DialogHeader,
Body,
} from '@cdek-it/react-native-ui-kit'

export function OrderDialog() {
const [visible, setVisible] = useState(false)
const close = () => setVisible(false)

return (
<>
<Button label='Детали заказа' onPress={() => setVisible(true)} />
<Dialog
visible={visible}
onClose={close}
header={<DialogHeader title='Детали заказа' onClose={close} />}
footer={
<DialogActions
actions={[{ key: 'close', label: 'Понятно', onPress: close }]}
/>
}
>
<Body>Заказ готов к отправке</Body>
</Dialog>
</>
)
}
```

## Props

- `visible` — управляет видимостью окна, по умолчанию `false`
- `onClose` — запрашивает закрытие по нажатию на фон, системной команде или
accessibility escape. Потребитель меняет `visible` самостоятельно
- `closeOnBackdropPress` — разрешает закрытие по нажатию на фон, по умолчанию
`true`. Системное закрытие и accessibility escape работают независимо от него
- `onHideComplete` — вызывается один раз после завершённой анимации закрытия.
Прерванное закрытие и размонтирование не вызывают callback
- `header` — готовая шапка, обычно `DialogHeader`
- `children` — основное содержимое
- `footer` — готовый React-элемент с действиями или другим содержимым

Полный контракт — [DialogProps](./Dialog.tsx).

Ширина окна — ширина экрана за вычетом 16 с каждой стороны, но не больше 336.
Высота ограничена доступным местом с учётом safe area и внешних отступов не
меньше 16 сверху и снизу. Тело занимает место, оставшееся после шапки и футера.
На очень низком экране нижняя часть окна может не поместиться; внешнюю прокрутку
Dialog не добавляет.

Для длинного содержимого передавайте `ScrollView`, `FlatList` или `SectionList`
в `children`. Шапка и футер находятся вне прокрутки тела. Внутренние отступы
тела добавляет Dialog.

```tsx
<Dialog visible={visible} onClose={close} header={header} footer={footer}>
<ScrollView nestedScrollEnabled style={{ flexGrow: 0, flexShrink: 1 }}>
<Body>{longText}</Body>
</ScrollView>
</Dialog>
```

`ScrollView` в этом примере импортируется из `react-native`.

Dialog не компенсирует перекрытие клавиатурой и не прокручивает содержимое к
полю. Фокус, прокрутку и размещение формы при появлении клавиатуры настраивает
потребитель. На Android окно также может менять размер средствами системы.

В Storybook есть отдельная история «Dialog with input»: она собирает нативный
`Modal`, `KeyboardAvoidingView` и `DialogComponent`. Это пример потребительской
композиции, а не дополнительное поведение Dialog или отдельный публичный
компонент. [Исходник примера](./stories/DialogInputExample.tsx).

## Немодальный вариант — DialogComponent

DialogComponent размещается прямо в разметке экрана. Он принимает `header`,
`children` и `footer` и использует оформление Dialog. Ширина не больше 336 и не
превышает ширину родителя. Внешние отступы и доступную высоту задаёт
потребитель. Для прокрутки длинного тела ограничьте высоту родительского
контейнера. Полный контракт — [DialogComponentProps](./DialogComponent.tsx).

```tsx
import {
Body,
DialogComponent,
DialogHeader,
} from '@cdek-it/react-native-ui-kit'

export function InlineNotice() {
return (
<DialogComponent header={<DialogHeader title='Детали заказа' />}>
<Body>Заказ готов к отправке</Body>
</DialogComponent>
)
}
```

Потребитель управляет показом через условный рендеринг. DialogComponent не
создаёт Modal и затемнение, не перехватывает системное закрытие и не управляет
фокусом или клавиатурой. Прокрутку длинного тела задаёт потребитель.

## DialogActions

Адаптивная группа кнопок для `footer`. Действия передаются массивом `actions` со
стабильными `key`, подписями `label` и свойствами Button. Порядок и варианты
оформления сохраняются. Размер `large` и обычная форма `rounded=false`
фиксированы: `size`, `rounded`, устаревший `shape` и внешний `style` не
принимаются. Иконку рядом с обязательной подписью задают через `Icon`, её
положение — через `iconPosition`. Доступны обработчики, `disabled`, `loading` и
остальные разрешённые свойства исходной кнопки. Для обычных кнопок задайте
`variant`, для статусных — `severity` и необязательный `appearance` (`filled` по
умолчанию, `outlined` или `text`). Например:
`{ key: 'delete', label: 'Удалить', severity: 'danger', onPress: remove }`.

Если кнопки помещаются, они поровну делят ширину строки. Иначе, а также при
масштабе шрифта от 200%, идут столбцом на всю ширину. Подписи должны помещаться
в одну строку полноширинной кнопки; слишком длинные подписи сократите.

```tsx
import { DialogActions } from '@cdek-it/react-native-ui-kit'
;<Dialog
visible={visible}
onClose={close}
footer={
<DialogActions
actions={[
{ key: 'cancel', label: 'Отмена', variant: 'tertiary', onPress: close },
{ key: 'save', label: 'Сохранить', variant: 'primary', onPress: save },
]}
/>
}
>
<Body>Проверьте данные перед сохранением</Body>
</Dialog>
```

Произвольный `footer` можно передать напрямую. Самостоятельно используемому
DialogActions задайте ширину родительского контейнера. Полный контракт —
[DialogActionsProps и DialogAction](./DialogActions.tsx).

## DialogHeader

Шапка с заголовком, необязательными статусной иконкой и кнопкой закрытия.

- `title` — текст заголовка. Занимает одну строку и сокращается многоточием
- `severity` — иконка статуса перед заголовком: `danger`, `warning`, `success`,
`info` или `help`. По умолчанию иконки нет
- `onClose` — показывает кнопку закрытия и вызывается без аргументов при
нажатии. Для Dialog и его шапки обычно передают один обработчик

Полный контракт — [DialogHeaderProps](./DialogHeader.tsx).

## Доступность

Dialog передаёт свойства доступности контейнеру содержимого с ролью `dialog`.
Кнопки и поля внутри остаются отдельными целями фокуса.

Доступное имя берётся из `accessibilityLabel` или стандартного `DialogHeader`.
Для окна без шапки или с произвольной шапкой рекомендуется явно задать
`accessibilityLabel`.

Стандартный заголовок имеет роль `header` и передаёт скринридеру полный текст,
даже если визуально сокращён. После нативного показа Dialog запрашивает фокус на
заголовке. Без стандартной шапки действует нативный порядок фокуса.
Восстановление фокуса после закрытия выполняет нативный Modal, его поведение
зависит от платформы.

Кнопка закрытия имеет имя «Закрыть диалог». Для уточнения контекста используйте
`DialogHeader.closeAccessibilityLabel`.

Фон, разделитель и статусная иконка скрыты от скринридера. Если статус важен для
понимания окна, передайте его в тексте заголовка или тела.

## Макет

[Dialog в Figma](https://www.figma.com/design/Q1BWgZ7zoV5UzlBOnjW0cM/UI-Kit--DS--v2.1?node-id=520-6572)
и
[шапка Dialog](https://www.figma.com/design/Q1BWgZ7zoV5UzlBOnjW0cM/UI-Kit--DS--v2.1?node-id=520-6548).

[Варианты со статусной иконкой](https://www.figma.com/design/Q1BWgZ7zoV5UzlBOnjW0cM/UI-Kit--DS--v2.1?node-id=520-6928).
Loading
Loading