Библиотека компонентов SDDS DFA

Реализация компонентов для создания веб-приложений.

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

Компоненты реализованы на typescript с помощью react и styled-components;

Использование данного пакета предполагает установку зависимостей: react & react-dom;

Использование styled-components на проект необязательно, так же как и использование typescript.

Установка пакета

$ npm install --save react react-dom
$ npm install --save styled-components@5.3.1
$ npm install --save @salutejs/sdds-dfa @salutejs/sdds-themes

Настройка

Создайте компонент для подключения глобальных стилей:

import { createGlobalStyle } from 'styled-components';
import { sdds_dfa__light } from '@salutejs/sdds-themes';

const ThemeStyle = createGlobalStyle(sdds_dfa__light);

export const GlobalStyle = () => (
    <>
        <ThemeStyle />
    </>
);

Корень приложения

В корне приложения вызовите компонент глобальных стилей GlobalStyle:

• Если вы используете Create React App, делайте вызов внутри src/index.tsx.
• Если вы используете Next.js, создайте файл pages/_app.tsx и подключите стили в нем.

Для корректной работы SSR - server side rendering - приложение нужно обернуть в SSRProvider (доступен в sdds-dfa);

Использование компонентов

Все компоненты доступны из папки components или напрямую из пакета:

// App.tsx
import { Button } from '@salutejs/sdds-dfa';
import { textAccent } from '@salutejs/sdds-themes/tokens/sdds-dfa';

export const App = () => {
    return (
        <Button>Hello, SDDS DFA!</Button>

        <p style={{color: textAccent}}>
            Token usage example
        </p>
    );
};