主题
2025/01/15

主题

为 Fumadocs UI 添加主题

使用方法

注意只支持 Tailwind CSS v4：

Tailwind CSS
@import 'tailwindcss';
@import 'fumadocs-ui/css/neutral.css';
@import 'fumadocs-ui/css/preset.css';

/* path of `fumadocs-ui` relative to the CSS file */
@source '../node_modules/fumadocs-ui/dist/**/*.js';

预设更改

通过使用 Tailwind CSS 插件或预构建的样式表，您的默认边框、文本和背景颜色将被更改。

明/暗模式

Fumadocs 通过 next-themes 支持明/暗模式，它包含在 Root Provider 中。

参见 Root Provider 了解更多信息。

RTL 布局

支持 RTL（从右到左）布局。

要启用 RTL，请在 body 和 root provider（Radix UI 需要）中将 dir 属性设置为 rtl。

import { RootProvider } from 'fumadocs-ui/provider';
import type { ReactNode } from 'react';

export default function RootLayout({ children }: { children: ReactNode }) {
  return (
    <html lang="en" suppressHydrationWarning>
      <body dir="rtl">
        <RootProvider dir="rtl">{children}</RootProvider>
      </body>
    </html>
  );
}

前缀

Fumadocs UI 有自己的颜色、动画和工具。 默认情况下，它添加了 fd- 前缀，以避免与 Shadcn UI 或您自己的 CSS 变量冲突。

您可以通过添加一些别名来使用它们，而无需前缀：

Tailwind CSS
@theme {
  --color-primary: var(--color-fd-primary);
}

您可以将其与 CSS 媒体查询一起使用，实现响应式设计。

布局宽度

使用 CSS 变量自定义文档布局的最大宽度。

:root {
  --fd-layout-width: 1400px;
}

Tailwind CSS 预设

Tailwind CSS 预设引入了新的颜色和额外的工具，包括 fd-steps。

主题

它开箱即用地提供了许多主题，您可以选择一个您喜欢的。

@import 'fumadocs-ui/css/<theme>.css';

/* Example */
@import 'fumadocs-ui/css/black.css';

Neutral

Black

Vitepress

Dusk

Catppuccin

Ocean

Purple

颜色

设计系统的灵感来自 Shadcn UI，您可以使用 CSS 变量轻松自定义颜色。

global.css
:root {
  --color-fd-background: hsl(0, 0%, 100%);
}

.dark {
  --color-fd-background: hsl(0, 0%, 0%);
}

排版

我们有一个内置插件，它是从 Tailwind CSS Typography 派生而来的。

该插件添加了一个 prose 类和变体来自定义它。

<div className="prose">
  <h1>Good Heading</h1>
</div>

该插件仅与 Fumadocs UI 的 MDX 组件一起工作，它可能与 @tailwindcss/typography 冲突。 如果您需要使用 @tailwindcss/typography 而不是默认插件，请设置类名选项以避免冲突。

全部文章

更多文章

邮件列表

加入我们的社区

订阅邮件列表，及时获取最新消息和更新