Пользовательская тема

Создание пользовательской темы

Примечание: Этот API нестабилен и может измениться в ближайшем будущем. Мы рекомендуем пока использовать встроенные темы.

Хотя встроенные темы предоставляют некоторый уровень настройки, тип Theme позволяет вам определить собственные темы с более низким уровнем доступа к основным переменным темы.

import { RainbowKitProvider, Theme } from '@rainbow-me/rainbowkit';

const myCustomTheme: Theme = {
  blurs: {
    modalOverlay: '...',
  },
  colors: {
    accentColor: '...',
    accentColorForeground: '...',
    actionButtonBorder: '...',
    actionButtonBorderMobile: '...',
    actionButtonSecondaryBackground: '...',
    closeButton: '...',
    closeButtonBackground: '...',
    connectButtonBackground: '...',
    connectButtonBackgroundError: '...',
    connectButtonInnerBackground: '...',
    connectButtonText: '...',
    connectButtonTextError: '...',
    connectionIndicator: '...',
    downloadBottomCardBackground: '...',
    downloadTopCardBackground: '...',
    error: '...',
    generalBorder: '...',
    generalBorderDim: '...',
    menuItemBackground: '...',
    modalBackdrop: '...',
    modalBackground: '...',
    modalBorder: '...',
    modalText: '...',
    modalTextDim: '...',
    modalTextSecondary: '...',
    profileAction: '...',
    profileActionHover: '...',
    profileForeground: '...',
    selectedOptionBorder: '...',
    standby: '...',
  },
  fonts: {
    body: '...',
  },
  radii: {
    actionButton: '...',
    connectButton: '...',
    menuButton: '...',
    modal: '...',
    modalMobile: '...',
  },
  shadows: {
    connectButton: '...',
    dialog: '...',
    profileDetailsAction: '...',
    selectedOption: '...',
    selectedWallet: '...',
    walletLogo: '...',
  },
};

const App = () => (
  <RainbowKitProvider theme={myCustomTheme} {...etc}>
    {/* Your App */}
  </RainbowKitProvider>;
)

Расширение встроенной темы

Вы можете расширить встроенную тему, не переопределяя всю тему. Это полезно, когда вы хотите изменить только определенные токены темы.

Для этого установите lodash.merge (или аналогичный):

npm install lodash.merge

Импортируйте его вместе с той темой, которую вы хотите расширить (например: darkTheme) и типом Theme для использования в TypeScript:

import merge from 'lodash.merge';
import {
  RainbowKitProvider,
  darkTheme,
  Theme,
} from '@rainbow-me/rainbowkit';

Затем объедините встроенную тему с токенами темы, которые вы хотите изменить. В этом примере я переопределяю токен accentColor, чтобы соответствовать акцентному цвету моего бренда.

const myTheme = merge(darkTheme(), {
  colors: {
    accentColor: '#07296d',
  },
} as Theme);

Наконец, теперь вы можете передать вашу пользовательскую тему в свойство theme компонента RainbowKitProvider.

const App = () => {
  return (
    <RainbowKitProvider theme={myTheme} {...etc}>
      {/* Your App */}
    </RainbowKitProvider>
  );
};

Создание пользовательских селекторов тем

Если ваше приложение серверно/статически отрисовывается и позволяет пользователям вручную переключаться между темами, система тем RainbowKit может быть подключена к пользовательским селекторам CSS с помощью следующих функций, которые можно использовать с любой системой CSS-in-JS:

cssStringFromTheme
cssObjectFromTheme

Эти функции возвращают CSS, который устанавливает все необходимые переменные темы. Поскольку поддерживаются как строки, так и объекты, это может быть интегрировано с любой системой CSS-in-JS.

В качестве основного примера, вы можете рендерить свой собственный элемент style с пользовательскими селекторами для каждой темы. Поскольку мы берем на себя управление рендерингом CSS-темы, мы передаем null в свойство theme, чтобы RainbowKitProvider не рендерил для нас какие-либо стили. Обратите также внимание на использование опции extends в функции cssStringFromTheme, которая исключает любые переменные темы, совпадающие с базовой темой.

import {
  RainbowKitProvider,
  cssStringFromTheme,
  lightTheme,
  darkTheme,
} from '@rainbow-me/rainbowkit';

const App = () => {
  return (
    <RainbowKitProvider theme={null} {...etc}>
      <style
        dangerouslySetInnerHTML={{
          __html: `
            :root {
              ${cssStringFromTheme(lightTheme)}
            }

            html[data-dark] {
              ${cssStringFromTheme(darkTheme, {
                extends: lightTheme,
              })}
            }
          `,
        }}
      />

      {/* ... */}
    </RainbowKitProvider>
  );
};

Обзор

Начало работы

Продвинутый уровень

Пользовательская тема

Создание пользовательской темы

Расширение встроенной темы

Создание пользовательских селекторов тем