test/ant-design
1
0
Fork 0
mirror of https://gitee.com/ant-design/ant-design.git synced 2024-12-15 09:21:22 +08:00
Code Issues Actions 19 Packages Projects Releases Wiki Activity
b0f0975a4a
ant-design/docs/react/use-with-next.en-US.md

250 lines
7.6 KiB
Markdown
Raw Normal View History

docs: update site use-with-next (#42903) * docs: update use-with-next * update * update
2023-06-12 16:42:06 +08:00
---
docs: react docs arrange (#44029) * docs: react docs arrange * chore: code clean * docs: arrange docs en * docs: update * docs: update * docs: update en doc * docs: update
2023-08-04 19:27:38 +08:00
group:
title: Basic Usage
order: 2
docs: update site use-with-next (#42903) * docs: update use-with-next * update * update
2023-06-12 16:42:06 +08:00
title: Usage with Next.js
---
[Next.js](https://nextjs.org/) is currently the most popular React server-side isomorphic framework in the world. This article will try to use `antd` components in projects created by Next.js.
## Install and Initialization
Before all start, you may need install [yarn](https://github.com/yarnpkg/yarn/) or [pnpm](https://pnpm.io/).
<InstallDependencies npm='$ npx create-next-app antd-demo' yarn='$ yarn create next-app antd-demo' pnpm='$ pnpm create next-app antd-demo'></InstallDependencies>
The tool will create and initialize environment and dependencies automatically, please try config your proxy setting, or use another npm registry if any network errors happen during it.
After the initialization is complete, we enter the project and start.
```bash
$ cd antd-demo
$ npm run dev
```
Open the browser at http://localhost:3000/. if you see the NEXT logo, it is considered a success.
## Import antd
site: update Next.js docs (#43448) * site: update nextjs docs * fix * add
2023-07-10 10:08:28 +08:00
Now we install `antd` from yarn or npm or pnpm.
docs: update site use-with-next (#42903) * docs: update use-with-next * update * update
2023-06-12 16:42:06 +08:00
site: update Next.js docs (#43448) * site: update nextjs docs * fix * add
2023-07-10 10:08:28 +08:00
<InstallDependencies npm='$ npm install antd --save' yarn='$ yarn add antd' pnpm='$ pnpm install antd --save'></InstallDependencies>
docs: update site use-with-next (#42903) * docs: update use-with-next * update * update
2023-06-12 16:42:06 +08:00
Modify `src/app/page.tsx`, import Button component from `antd`.
```jsx
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
'use client'; // If used in Pages Router, is no need to add this line
docs: update site use-with-next (#42903) * docs: update use-with-next * update * update
2023-06-12 16:42:06 +08:00
import React from 'react';
import { Button } from 'antd';
const Home = () => (
<div className="App">
<Button type="primary">Button</Button>
</div>
);
export default Home;
```
OK, you should now see a blue primary button displayed on the page. Next you can choose any components of `antd` to develop your application. Visit other workflows of `Next.js` at its [User Guide](https://nextjs.org/).
We are successfully running antd components now, go build your own application!
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
## Use the Pages Router of Next.js
If you are using the Pages Router in Next.js and using antd as your component library, to make the antd component library work better in your Next.js application and provide a better user experience, you can try using the following method to extract and inject antd's first-screen styles into HTML to avoid page flicker.
1. Install `@ant-design/cssinjs`
<InstallDependencies npm='$ npm install @ant-design/cssinjs --save' yarn='$ yarn add @ant-design/cssinjs' pnpm='$ pnpm install @ant-design/cssinjs --save'></InstallDependencies>
2. Rewrite `pages/_document.tsx`
```tsx
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
import React from 'react';
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
import { StyleProvider, createCache, extractStyle } from '@ant-design/cssinjs';
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
import Document, { Head, Html, Main, NextScript } from 'next/document';
import type { DocumentContext } from 'next/document';
docs: update _document example in next.js (#43657)
2023-07-19 18:43:44 +08:00
const MyDocument = () => (
<Html lang="en">
<Head />
<body>
<Main />
<NextScript />
</body>
</Html>
);
MyDocument.getInitialProps = async (ctx: DocumentContext) => {
const cache = createCache();
const originalRenderPage = ctx.renderPage;
ctx.renderPage = () =>
originalRenderPage({
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
enhanceApp: (App) => (props) => (
<StyleProvider cache={cache}>
<App {...props} />
</StyleProvider>
),
docs: update _document example in next.js (#43657)
2023-07-19 18:43:44 +08:00
});
const initialProps = await Document.getInitialProps(ctx);
const style = extractStyle(cache, true);
return {
...initialProps,
styles: (
<>
{initialProps.styles}
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
<style dangerouslySetInnerHTML={{ __html: style }} />
docs: update _document example in next.js (#43657)
2023-07-19 18:43:44 +08:00
</>
),
};
};
export default MyDocument;
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
```
3. Supports custom themes
site: update doc example in next.js agin (#43663)
2023-07-20 00:24:57 +08:00
```ts
// theme/themeConfig.ts
import type { ThemeConfig } from 'antd';
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
site: update doc example in next.js agin (#43663)
2023-07-20 00:24:57 +08:00
const theme: ThemeConfig = {
token: {
fontSize: 16,
colorPrimary: '#52c41a',
},
};
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
site: update doc example in next.js agin (#43663)
2023-07-20 00:24:57 +08:00
export default theme;
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
```
4. Rewrite `pages/_app.tsx`
```tsx
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
import React from 'react';
site: update doc example in next.js agin (#43663)
2023-07-20 00:24:57 +08:00
import { ConfigProvider } from 'antd';
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
import type { AppProps } from 'next/app';
site: update doc example in next.js agin (#43663)
2023-07-20 00:24:57 +08:00
import theme from './themeConfig';
const App = ({ Component, pageProps }: AppProps) => (
<ConfigProvider theme={theme}>
<Component {...pageProps} />
</ConfigProvider>
);
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
site: update doc example in next.js agin (#43663)
2023-07-20 00:24:57 +08:00
export default App;
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
```
5. Use antd in page component
```tsx
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
import React from 'react';
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
import { Button } from 'antd';
site: update doc example in next.js agin (#43663)
2023-07-20 00:24:57 +08:00
const Home = () => (
<div className="App">
<Button type="primary">Button</Button>
</div>
);
export default Home;
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
```
For more detailed information, please refer to [with-nextjs-inline-style](https://github.com/ant-design/ant-design-examples/tree/main/examples/with-nextjs-inline-style).
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
## Using Next.js App Router
If you are using the App Router in Next.js and using antd as your component library, to make the antd component library work better in your Next.js application and provide a better user experience, you can try using the following method to extract and inject antd's first-screen styles into HTML to avoid page flicker.
1. Install `@ant-design/cssinjs`
<InstallDependencies npm='$ npm install @ant-design/cssinjs --save' yarn='$ yarn add @ant-design/cssinjs' pnpm='$ pnpm install @ant-design/cssinjs --save'></InstallDependencies>
2. Create `lib/AntdRegistry.tsx`
```tsx
'use client';
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
import React from 'react';
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
import { StyleProvider, createCache, extractStyle } from '@ant-design/cssinjs';
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
import { useServerInsertedHTML } from 'next/navigation';
docs: update next.js docs (#44440) * Update use-with-next.zh-CN.md Signed-off-by: lijianan <574980606@qq.com> * Update use-with-next.en-US.md Signed-off-by: lijianan <574980606@qq.com> * Update use-with-next.en-US.md Signed-off-by: lijianan <574980606@qq.com> --------- Signed-off-by: lijianan <574980606@qq.com>
2023-08-26 23:28:18 +08:00
import type Entity from '@ant-design/cssinjs/es/Cache';
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
const StyledComponentsRegistry = ({ children }: { children: React.ReactNode }) => {
docs: update next.js docs (#44440) * Update use-with-next.zh-CN.md Signed-off-by: lijianan <574980606@qq.com> * Update use-with-next.en-US.md Signed-off-by: lijianan <574980606@qq.com> * Update use-with-next.en-US.md Signed-off-by: lijianan <574980606@qq.com> --------- Signed-off-by: lijianan <574980606@qq.com>
2023-08-26 23:28:18 +08:00
const cache = React.useMemo<Entity>(() => createCache(), [createCache]);
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
useServerInsertedHTML(() => (
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
<style id="antd" dangerouslySetInnerHTML={{ __html: extractStyle(cache, true) }} />
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
));
return <StyleProvider cache={cache}>{children}</StyleProvider>;
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
};
export default StyledComponentsRegistry;
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
```
3. Use it in `app/layout.tsx`
```tsx
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
import React from 'react';
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
import { Inter } from 'next/font/google';
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
import StyledComponentsRegistry from '../lib/AntdRegistry';
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
import '@/globals.css';
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
const inter = Inter({ subsets: ['latin'] });
export const metadata = {
title: 'Create Next App',
description: 'Generated by create next app',
};
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
const RootLayout = ({ children }: { children: React.ReactNode }) => (
<html lang="en">
<body className={inter.className}>
<StyledComponentsRegistry>{children}</StyledComponentsRegistry>
</body>
</html>
);
export default RootLayout;
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
```
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
4. Customize theme config in `theme/*.ts`
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
```ts
// theme/themeConfig.ts
import type { ThemeConfig } from 'antd';
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
const theme: ThemeConfig = {
token: {
fontSize: 16,
colorPrimary: '#52c41a',
},
};
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
export default theme;
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
```
5. Use in page
```tsx
import React from 'react';
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
import { Button, ConfigProvider } from 'antd';
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
import theme from './themeConfig';
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
const HomePage = () => (
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
<ConfigProvider theme={theme}>
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
<div className="App">
<Button type="primary">Button</Button>
</div>
site: improve docs use-with-next (#43590)
2023-07-16 23:43:48 +08:00
</ConfigProvider>
);
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
export default HomePage;
```
site: update docs Usage with Next.js (#43720) * site: update docs Usage with Next.js * docs: update * docs: update
2023-07-22 21:43:13 +08:00
> Tips: The above method does not use sub-components such as `<Select.Option />` and `<Typography.text />` in the page, so it can be used normally. However, if you use a sub-component like this in your page, you will currently see the following warning in next.js: `Error: Cannot access .Option on the server. You cannot dot into a client module from a server component. You can only pass the imported name through.`, currently need to wait for Next.js official solution. Before again, if you use the above sub-components in your page, you can add `"use client"` to the first line of the page component to avoid warnings. See examples for more details: [with-sub-components](https://github.com/ant-design/ant-design-examples/blob/main/examples/with-nextjs-app-router-inline-style/src/app/with-sub-components/page.tsx).
docs: update docs about nextjs pages router (#43651) * docs: update docs about nextjs pages router * Update docs/react/use-with-next.en-US.md Co-authored-by: afc163 <afc163@gmail.com> Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> * docs: update docs --------- Signed-off-by: kiner-tang(文辉) <1127031143@qq.com> Co-authored-by: afc163 <afc163@gmail.com>
2023-07-19 16:56:08 +08:00
docs: update docs about app router in use-with-next (#43579) * docs: update docs * docs: update docs * feat: optimize code * docs: update docs * docs: update docs
2023-07-16 12:13:22 +08:00
For more detailed information, please refer to [with-nextjs-app-router-inline-style](https://github.com/ant-design/ant-design-examples/tree/main/examples/with-nextjs-app-router-inline-style)。
Reference in New Issue Copy Permalink