Next.jsではじめる
パッケージをインストールする
まず、アプリケーションを作成します。
ターミナルで次のコマンドのいずれかを実行します。
pnpm create next-app my-app --typescript
Yamada UIは、@yamada-ui/react
をインストールするだけで、ほとんどのコンポーネントやフックを使用できます。
pnpm add @yamada-ui/react
テーブル・カレンダー・カルーセルなど使用する場合は、別途インストールをする必要があります。
pnpm add @yamada-ui/table
パッケージ | 説明 | |
---|---|---|
@yamada-ui/table | @tanstack/react-tableを使用した、便利なテーブルコンポーネントを提供します。 | |
@yamada-ui/calendar | dayjsを使用した、便利なカレンダーとデイトピッカーコンポーネントを提供します。 | |
@yamada-ui/carousel | embla-carousel-reactを使用した、便利なカルーセルコンポーネントを提供します。 | |
@yamada-ui/dropzone | react-dropzoneを使用した、便利なドロップゾーンコンポーネントを提供します。 | |
@yamada-ui/charts | rechartsを使用した、便利なチャートコンポーネントを提供します。 | |
@yamada-ui/markdown | react-markdownとreact-syntax-highlighterを使用した、便利なマークダウンコンポーネントを提供します。 | |
@yamada-ui/fontawesome | Font Awesomeを便利に使用するためのコンポーネントを提供します。 |
UIProvider
を追加する
Yamada UIをインストール後、UIProvider
を追加します。
layout.tsx
import { UIProvider } from "@yamada-ui/react"export default function RootLayout({children,}: {children: React.ReactNode}) {return (<html lang="en"><body><UIProvider>{children}</UIProvider></body></html>)}
デフォルトのテーマは、UIProvider
のなかに含まれています。
テーマやコンフィグをカスタマイズしたい場合は、テーマをカスタマイズするとコンフィグをカスタマイズするをご覧ください。
ColorModeScript
を追加する
カラーモードを正常に動作させるために、body
内にColorModeScript
を追加する必要があります。
理由は、カラーモードがlocalStorage
やcookies
を用いて実装されており、ページの読み込み時に同期を正しく機能させるためです。
layout.tsx
import { UIProvider, ColorModeScript } from "@yamada-ui/react"export default function RootLayout({children,}: {children: React.ReactNode}) {return (<html lang="en"><body><ColorModeScript /><UIProvider>{children}</UIProvider></body></html>)}
コンポーネントを使用する
UIProvider
を追加したら、アプリケーション内でコンポーネントを呼び出します。
page.tsx
import { Button } from "@yamada-ui/react"export default function Home() {return <Button>Click me!</Button>}
GitHubでこのページを編集する