> For AI agents: the complete documentation index is available at /rspress-russian/llms.txt, the full documentation bundle is available at /rspress-russian/llms-full.txt.

# NavTitle

Этот компонент является частью панели навигации. `NavTitle` отображает логотип сайта и заголовок в левом верхнем углу панели навигации.

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

Используйте его через [кастомную тему](/rspress-russian/guide/basic/custom-theme.md). Компонент считывает конфигурацию из `rspress.config.ts` через [`useSite`](/rspress-russian/ui/hooks/use-site.md):

```ts title="rspress.config.ts"
import { defineConfig } from 'rspress/config';

export default defineConfig({
  title: 'Мой сайт',
  logo: '/logo.png',
  // Или поддержка светлого/тёмного режима:
  logo: {
    light: '/logo-light.png',
    dark: '/logo-dark.png',
  },
  logoText: 'Мой сайт',
});
```

### Пользовательский NavTitle

Вы можете настроить NavTitle через проп `navTitle` компонента Layout:

```tsx title="theme/index.tsx"
import { Layout as BasicLayout } from '@rspress/core/theme-original';

const Layout = () => <BasicLayout navTitle={<MyCustomNavTitle />} />;

export { Layout };
export * from '@rspress/core/theme-original';
```

Или используйте пропы `beforeNavTitle` и `afterNavTitle` для вставки пользовательского содержимого:

```tsx title="theme/index.tsx"
import { Layout as BasicLayout } from '@rspress/core/theme-original';

const Layout = () => (
  <BasicLayout
    beforeNavTitle={<div>Перед</div>}
    afterNavTitle={<div>После</div>}
  />
);

export { Layout };
export * from '@rspress/core/theme-original';
```

Для получения дополнительной информации о пользовательских темах см. документацию [Кастомная тема](/rspress-russian/guide/basic/custom-theme.md).

## Конфигурация

### logo

- **Тип:** `string | { light: string; dark: string; width?: number; height?: number }`

Логотип сайта. Может быть единичным путем к изображению или отдельными изображениями для светлого/темного режима. В объектной форме необязательные `width` и `height` (в пикселях) задают внутренние размеры для обоих изображений; используйте их фактические размеры, чтобы сохранить правильное соотношение сторон и уменьшить сдвиги макета.

### logoText

- **Тип:** `string`

Текст, отображаемый рядом с логотипом.

### title

- **Тип:** `string`

Заголовок сайта. Отображается, когда `logo` и `logoText` не настроены.

## Поддержка i18n

Для многоязычных сайтов вы можете настроить `title` для каждого языка:

```ts title="rspress.config.ts"
import { defineConfig } from 'rspress/config';

export default defineConfig({
  title: 'Мой сайт',
  themeConfig: {
    locales: [
      {
        lang: 'en',
        title: 'Мой сайт',
      },
      {
        lang: 'ru',
        title: 'Мой сайт',
      },
    ],
  },
});
```

Компонент NavTitle автоматически отобразит соответствующий заголовок в зависимости от текущего языка.
