react+antd搭建项目 手把手教你从零开始react+antd搭建项目
小码飞驰 人气:0之前的文章都是自己的学习日志,主要是防止自己遗忘之前遇到的坑。这次将从最基础的项目搭建开始讲起,做一个基于react和antd的后台管理系统。我会一步步进行下去,所以看完本文你哪怕不了解react,应该也会使用react做一个简单的项目。话不多少,直接开始。完整项目请前往GitHub查看,体验请点击这里。如果觉得可以请给一颗star,谢谢各位。
1、开发环境:
node.js -v 12.16.3
create-react-app -v 3.4.1
antd -v 4.3.3
项目开始前请自行全局安装create-react-app,macos请在指令前加上sudo不然会有报错说没有权限访问硬盘。
npm install -g create-react-app
2、项目构建:
初始化项目直接使用脚手架工具create-react-app的指令,本文接下来使用的是tsx。如需jsx版本,请跳过模板设置。这里简单介绍一下jsx,jsx是javascript的语法糖。他是react打造的,react为了做到多平台自己在js的基础上封装了一些合成事件。例如react中的onClick事件其实和原生js的click事件是不太一样的。
jsx版本的指令为:
npx create-react-app project-name
tsx版本如下:
等待安装完成后,项目的初始化工作已经完成了。
现在进入项目目录:cd react-admin(这里替换为你的项目名称),执行指令进入开发模式吧。
npm start
接下来我们进入正题,由于react默认没有router功能,所以需要安装react-router、react-router-dom。
如果需要状态管理的同学可以安装redux、react-redux、redux-actions。
需要按需加载的同学可以安装@loadable/component,注意ts版本可能会报错,创建一个loadable.d.ts的文件里面写上以下代码即可解决。
declare module '@loadable/component'
需要使用loadash的同学自行安装loadash。
接下来安装antd组建库。
npm i antd react-router react-router-dom redux react-redux redux-actions @types/redux-actions @types/react-router-dom @loadable/component axios loadash --save
create-react-app默认是使用sass的,如需使用less等其他css预处理器,请自行安装。
另外这里简单说个题外话。create-react-app默认使用的是react-scripts,是不能修改webpack配置的。如果需要修改webpack配置,有两种解决方案:
1、使用社区的第三方库比如react-app-rewired等。
2、执行指令:npm run eject这样会在当前目录生成scripts和config文件夹。你可以修改webpack的配置。注意:该操作为永久性的,不可逆。
话归正题,安装完这些基础库以后。初始化你的项目目录,这里可以根据自己的喜好设置目录结构,我的目录结构如下:
接下来打开router目录写router.tsx的代码。这里只展示主要代码:
接下来就可以使用数组来完成route的配置了,例如:
import loadable from '@loadable/component'; import { RouteComponentProps } from 'react-router'; const Index = loadable(() => import('../pages/index')); const Login = loadable(() => import('../pages/login')); export interface RouteConfigProps { path: string, exact: boolean, component: React.ComponentType<RouteComponentProps<any>> | React.ComponentType<any>, id: number, name?: string, routes?: Array<RouteConfigProps> } export const routeConfig: Array<RouteConfigProps> = [ { path: '/login', exact: true, component: Login, id: 1, name: '登陆', routes: [] }, { path: '/index', exact: false, component: Index, id: 2, name: '首页', routes: [] } ]
接下来就去app.tsx里面引入路由配置吧,顺便把antd的一些配置也整理一下。
import React from 'react'; import { Provider } from 'react-redux'; // redux提供的provider。 import zhCN from 'antd/es/locale-provider/zh_CN'; // antd的中文包 import { HashRouter } from 'react-router-dom'; import { MyRouter } from './router'; // 刚才的router.tsx import { ConfigProvider, message, notification } from 'antd'; import storeConfig from './store'; // redux的仓库 import moment from 'moment'; // momentjs。 import 'moment/locale/zh-cn'; // 中文包moment.js import 'antd/dist/antd.css'; // 引入antd的样式表 import './App.css' moment.locale('zh-cn'); // 将moment.js设置为中文 const store = storeConfig(); // 初始化redux的store,如不需要状态管理器,redux相关可以忽略。 message.config({ // antd的message组件配置,during持续时间单位为秒,maxcount最多显示个数 duration: 2, maxCount: 2 }); notification.config({ placement: 'topRight', // antd的通知组件配置,placement弹出位置。bottom距离底部的距离,during持续时间单位为秒 bottom: 50, duration: 2, }); function App() { return ( <Provider store={store}> <ConfigProvider locale={zhCN}> <HashRouter> <MyRouter /> </HashRouter> </ConfigProvider> </Provider> ); } export default App;
这样就大功告成了,接下来就是编写自己需要的组件了。
加载全部内容