react-ant-admin
TypeScript 版GitHub(國外地址) |TypeScript 版碼雲(國內鏡像)
此框架使用與二次開發,前端框架使用react,UI框架使用ant-design,全局數據狀態管理使用redux,ajax使用庫為axios。用於快速搭建中后台頁面。歡迎各位提issue
預覽地址
nodejs后台web服務:react-ant-admin-server
文檔地址
更多建議歡迎騷擾~
歡迎各位提出建議與問題!
特性
- 菜單配置:扁平化數據組織,方便編寫,存庫,頁面菜單,標題,側邊欄,頂部導航欄同步
- 頁面懶加載:使用@loadable/component來解決首次打開頁面過慢的問題.
- Ajax請求:restful規范,自動錯誤提示,提示可配置;自動打斷未完成的請求;
- 權限控制: 根據不用角色的功能類型顯示菜單,路由頁面攔截.
- 自定義主題,可以自己定義界面顏色。
- 代理轉發,解決前端請求跨域問題。
- 路由自動生成,去中心化。
系統提供了一些基礎的頁面
- 登錄頁
- 詳情頁
- 表單頁
- 列表頁
- 權限管理
- 結果頁
快速使用
- 下載本項目到本地
D:> git clone https://github.com/kongyijilafumi/react-ant-admin.git //github地址 慢
D:> git clone https://gitee.com/kong_yiji_and_lavmi/react-ant-admin.git //碼雲地址 快
- 安裝依賴
// npm 慢
npm i
// cnpm 國內鏡像 快
cnpm i
- 啟動
npm run "start mock" // 啟動本地mock數據 (暫時沒有后台接口,請用此模式預覽項目)
npm run start // 啟動本地API接口來獲取數據
瀏覽器打開 http://localhost:3000 即可
創建一個新的頁面
- 在src/pages文件夾下創建一個test.js文件,代碼如下
// 函數組件
import React from "react";
export default function Test() {
return <div>test頁面</div>;
}
// 類組件
export default class Test extends React.Component {
render() {
return <div>test頁面</div>;
}
}
/**
* 給 pages 組件追加路由信息
* export default 組件的原型上添加route信息,或者向外暴露一個 route
* 會被webpack的webpack-router-generator插件捕獲信息
*/
// 1.被捕獲 export default 原型上的route
Test.route={
tile : "test頁面",
key : "test",
path: "/test"
}
// 2.被捕獲 暴露的route信息 優先級比上面高
export const route = {
tile : "test頁面",
key : "test",
path: "/test"
}
創建一個菜單
該添加方式適用於 npm run "start mock" 啟動的項目
- 在
src/mock/index.js
找到menu
變量,往里添加一條菜單信息.代碼如下所示
import dayjs from "dayjs";
let menu = [
{
menu_id: 2,
title: "詳情頁",
path: "/details",
key: "details",
parentKey: "",
icon: "icon_edit",
order: 1,
keepAlive: "true",
},
{
menu_id: 1,
title: "個人中心",
path: "/person",
key: "detailsPerson",
parentKey: "details",
icon: "icon_infopersonal",
order: 1,
keepAlive: "true",
},
// .... 開始添加菜單信息 ....
{
menu_id: 9, // 菜單id 用於關聯權限
title: "test", // 標題
path: "/test",// 訪問路徑
key: "test", // 唯一key
parentKey: "",// 空表示 為主菜單而非子菜單
icon: "icon_infopersonal",// 菜單圖標
order:1,// 菜單排序 越小越靠前
keepAlive: "true", // 頁面保持狀態
}
// .....
]
- 由於菜單會走本地會話存儲
window.sessionStorage
,所以保存代碼后需要關閉當前窗口,重新打開地址 http://localhost:3000/react-ant-admin
打開之后,會發現菜單會多出一個
test
欄目,點擊會打開之前我們創建的test頁面.這樣就完成了菜單和頁面的編寫.
腳本啟動
在完成依賴安裝之后,有以下幾種啟動方式。
- npm run start
請求接口數據,通過后台返回數據顯示項目信息
- npm run "start color"
請求接口數據,通過后台返回數據顯示項目信息,並且開啟主題色配置。
- npm run "start mock"
本地模擬數據,假數據來顯示項目信息
- npm run "start mock color"
本地模擬數據,假數據來顯示項目信息,並且開啟主題色配置。
- npm run build
普通打包模式。
- npm run "build color"
打包主題色。項目體積會有所增加。
vscode快速啟動項目
把此項目文件夾拖入vscode編輯器
,找到左下角npm 腳本欄目
選擇快速啟動,免命令。
項目截圖
- 登錄
- 詳情頁
- 列表
- 權限管理
- 結果頁