website/plasma-web-docs/docs/components/Loader.mdx - dev - sdds/plasma

website/plasma-web-docs/docs/components/Loader.mdx
197 строк6 KB
iljs
fix(*): remove popup from loader
02 дек 2025, 09:53
02 дек 2025, 09:53322b45c
# Loader

import { PropsTable, Description } from '@site/src/components';

**Loader** - универсальный компонент для отображения индикаторов загрузки. Поддерживает два типа индикаторов: спиннер (`spinner`) и круговой прогресс-бар (`progress`).

<Description name="Loader" />
<PropsTable name="Loader" exclude={['css']} />

:::info Особенности работы
- Автоматически ограничивает значение прогресса в диапазоне от 0 до `maxValue`
- Поддерживает различные степени размытия фона (`blur`)
- Может отображаться поверх контента с полупрозрачным оверлеем
- Адаптирует толщину линии прогресса под размер компонента
:::

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

### Спиннер
Используется для отображения процесса загрузки без указания прогресса:

```tsx live
import React from 'react';
import { Loader } from '@salutejs/plasma-web';

export function App() {
    return <Loader type="spinner" />;
}
```

### Прогресс-бар
Отображает прогресс выполнения задачи в виде круговой диаграммы:

```tsx live
import React from 'react';
import { Loader } from '@salutejs/plasma-web';

export function App() {
    return <Loader type="progress" value={45} />;
}
```

## Примеры

### Размеры индикатора
Размер задается с помощью свойства `size`:

```tsx live
import React from 'react';
import { Loader } from '@salutejs/plasma-web';

export function App() {
    return (
        <div style={{ display: 'flex', alignItems: 'center', gap: '1rem', flexWrap: 'wrap' }}>
            <Loader type="spinner" size="s" />
            <Loader type="spinner" size="m" />
            <Loader type="spinner" size="l" />

            <Loader type="progress" size="s" value={25} />
            <Loader type="progress" size="m" value={50} />
            <Loader type="progress" size="l" value={75} />
        </div>
    );
}
```

### Виды индикатора
Вид задается с помощью свойства `view`:

```tsx live
import React from 'react';
import { Loader } from '@salutejs/plasma-web';

export function App() {
    return (
        <div style={{ display: 'flex', alignItems: 'center', gap: '1rem', flexWrap: 'wrap' }}>
            <Loader type="spinner" view="default" />
            <Loader type="spinner" view="accent" />
            <Loader type="spinner" view="positive" />

            <Loader type="progress" view="default" value={25} />
            <Loader type="progress" view="accent" value={50} />
            <Loader type="progress" view="positive" value={75} />
        </div>
    );
}
```

### Полупрозрачный оверлей с размытием
Отображение индикатора поверх затемненного фона с blur эффектом:

```tsx live
import React, { useState, useEffect } from 'react';
import { Loader, Button } from '@salutejs/plasma-web';

export function App() {
    const [loading, setLoading] = useState(false);

    const handleShowLoader = () => {
        setLoading(true);
    };

    useEffect(() => {
        if (loading) {
            const timer = setTimeout(() => {
                setLoading(false);
            }, 5000);
            return () => clearTimeout(timer);
        }
    }, [loading]);

    return (
        <div style={{ position: 'relative', height: '200px' }}>
            <Button onClick={handleShowLoader}>Показать загрузку</Button>
            {loading && (
                <Loader
                    type="spinner"
                    hasOverlay
                    withBlur
                />
            )}
        </div>
    );
}
```

### Контент внутри прогресс-бара
Отображение дополнительной информации внутри кругового индикатора:

```tsx live
import React from 'react';
import { Loader } from '@salutejs/plasma-web';
import { IconClose } from '@salutejs/plasma-icons';

export function App() {
    return (
        <div style={{ display: 'flex', alignItems: 'center', gap: '1rem', flexWrap: 'wrap' }}>
            <Loader type="progress" value={25} size="xl">25%</Loader>
            <Loader type="progress" value={75} size="l">
                <IconClose color="var(--text-primary)" size="s" />
            </Loader>
        </div>
    );
}
```

### Настройка толщины линии прогресса
Изменение толщины обводки прогресс-бара:

```tsx live
import React from 'react';
import { Loader } from '@salutejs/plasma-web';

export function App() {
    return (
        <div style={{ display: 'flex', alignItems: 'center', gap: '1rem', flexWrap: 'wrap' }}>
            <Loader type="progress" value={50} strokeSize={2} />
            <Loader type="progress" value={50} strokeSize={4} />
            <Loader type="progress" value={50} strokeSize={8} />
        </div>
    );
}
```

### Отключение фоновой дорожки
Скрытие фоновой линии прогресс-бара:

```tsx live
import React from 'react';
import { Loader } from '@salutejs/plasma-web';

export function App() {
    return (
        <div style={{ display: 'flex', alignItems: 'center', gap: '1rem', flexWrap: 'wrap' }}>
            <Loader type="progress" value={50} hasTrack />
            <Loader type="progress" value={50} hasTrack={false} />
        </div>
    );
}
```

### Кастомный максимальный показатель
Изменение максимального значения прогресса:

```tsx live
import React from 'react';
import { Loader } from '@salutejs/plasma-web';

export function App() {
    return (
        <div style={{ display: 'flex', alignItems: 'center', gap: '1rem', flexWrap: 'wrap' }}>
            <Loader type="progress" value={25} maxValue={50} size="xl">25/50</Loader>
            <Loader type="progress" value={75} maxValue={150} size="xl">75/150</Loader>
        </div>
    );
}
```