目录
创建项目
配置环境
创建脚手架
项目结构及其目录、
路由
配置路由
嵌套路由
编程式导航和声明式导航
声明式导航
编程式导航
约定式路由
路由传参
query传参(问号)
接收参数
params传参(动态传参)
接收参数
创建项目
配置环境
首先得有 node,并确保 node 版本是 10.13 或以上。(18版本可能会不适配)
$ node -v //查看版本
v16.20.2
如果出现版本错误,可以使用nvm进行node版本管理https://blog.csdn.net/kkkys_kkk/article/details/135071784?spm=1001.2014.3001.5501
推荐使用 yarn 管理 npm 依赖,并使用国内源(阿里用户使用内网源)。
# 国内源
$ npm i yarn tyarn -g
# 后面文档里的 yarn 换成 tyarn
$ tyarn -v
# 阿里内网源
$ tnpm i yarn @ali/yarn -g
# 后面文档里的 yarn 换成 ayarn
$ ayarn -v
创建脚手架
创建项目文件夹
$ mkdir myapp && cd myapp
通过官方工具创建项目,
$ yarn create @umijs/umi-app
# 或 npx @umijs/create-umi-app
Copy: .editorconfig
Write: .gitignore
Copy: .prettierignore
Copy: .prettierrc
Write: .umirc.ts
Copy: mock/.gitkeep
Write: package.json
Copy: README.md
Copy: src/pages/index.less
Copy: src/pages/index.tsx
Copy: tsconfig.json
Copy: typings.d.ts
安装依赖
$ yarn
或者
$ npm i
启动项目
$ yarn start
或者
$ npm start
在浏览器里打开 http://localhost:8000/,能看到以下界面
项目结构及其目录、
├── package.json 项目基本信息 、依赖信息
├── tsconfig.json ts的配置文件
├── typings.d.ts ts的类型声明文件(凡是以xxx.d.ts结尾的文件都是咱们的ts类型声明文件)
├── .umirc.ts 核心配置文件
├── .env 环境参数文件
├── mock mock数据
├── src
├── .umi 编译后自动生成的文件,不需要动
├── pages 业务组件文件夹(页面)
├── index.less
└── index.tsx 业务组件
路由
umi的路由分为配置路由与约定路由
配置路由
在`pages`中新建一个页面
export default function Home() {
return (
<div>Home</div>
)
}
在.umirc.ts中的routes配置项中新增路由配置
import { defineConfig } from 'umi';
export default defineConfig({
nodeModulesTransform: {
type: 'none',
},
routes: [
{
path: '/home',
component: '@/pages/Home'
},
{
path: '/course',
component: '@/pages/Course'
}
],
fastRefresh: {},
});
umi官方推荐我们使用config方法
在项目文件下创建config文件夹,复制umirc.ts内容,同时删除umirc.ts文件,因为umirc.ts的权重高
创建config文件,粘贴umirc.ts,将routes作为文件导入引入
import { defineConfig } from 'umi';
import routes from './router/index';
export default defineConfig({
nodeModulesTransform: {
type: 'none',
},
fastRefresh: {},
routes
});
创建路由文件,声明路由,导出
const routes=[
{
path: '/home',
component: '@/pages/Home'
},
{
path: '/course',
component: '@/pages/Course'
}
],
export default routes
嵌套路由
嵌套路由是通过`routes`属性来实现的
const routes=[
{
path:'/index',
component:'@/pages/Base/Base',
routes:[
{
path:'one',
component:'@/pages/One/One'
},
{path:'two',component:'@/pages/Two/Two'},
{path:'three',component:'@/pages/Three/Three'},
]
},
]
然后在组件中通过props.children来渲染子路由
import React from 'react';
import styles from './index.less';
export default (props:any) => {
return (
<div className={ styles['container'] }>
{ props.children }
</div>
)
}
编程式导航和声明式导航
声明式导航
import React from 'react';
import styles from './index.less';
import { NavLink } from 'umi';
// 通过接口定义props类型
interface Props {
children: React.ReactNode
}
// 在umijs中,Props类型的定义一般会用到React.FC类型,FunctionComponent类型
// 在React.FC类型中,Props类型是一个泛型,用来定义组件所接收的Props类型
const Course:React.FC<Props> = (props) => {
return (
<div className={ styles['container'] }>
{/* v5版本的路由是一样的 */}
<NavLink to="/course" activeClassName="active">去课程</NavLink>
Course <br />
{ props.children }
</div>
)
}
export default Course;
编程式导航
编程式导航是通过: history.push 方法来实现的
import styles from './index.less';
import { NavLink, history } from 'umi';
export default function Home() {
return (
<div className={ styles['container'] }>
Pages Home
{/* 声明式导航 */}
<NavLink to="/course" activeClassName="active">去课程</NavLink>
{/* 编程式导航 */}
<button onClick={ () => history.push('/course') }>去课程</button>
</div>
)
}
约定式路由
如果没有routes 配置 , Umi 会进入约定式路由模式, 然后分析src/pages 目录拿到路由配置。 比如以下文件结构:
└── pages
├── index.tsx
└── users.tsx
会得到以下路由配置
[
{ exact: true, path: '/', component: '@/pages/index' },
{ exact: true, path: '/users', component: '@/pages/users' }
]
路由传参
query传参(问号)
写入路径中
history.push('/list?id=1');
以对象形式
history.push({
pathname: '/list',
query: {
name: 'b',
},
});
接收参数
使用history方法
import {history } from 'umi'
生成变量接收参数
const id =history.location.search.split('=')[1]
或者使用useLocation函数,返回表示当前 URL 的对象。您可以将其视为每当 URL 更改时返回新位置。
import { useLocation } from 'umi';
export default () => {
const location = useLocation();
return (
<div>
<ul>
<li>location: {location.pathname}</li>
</ul>
</div>
);
};
params传参(动态传参)
路由表配置改为动态
{
path:'/anthor/:id',
component:'@/pages/detail/Id'
},
同样使用history方法
<button onClick={()=>{history.push('/anthor/1')}}>click me</button>
将需要传递的参数直接写入路径当中
接收参数
useParams
返回 URL 参数的键/值对的对象。使用它来访问当前路由文章来源:https://www.toymoban.com/news/detail-803163.html
import { useParams } from 'umi';
export default () => {
const params = useParams();
return (
<div>
<ul>
<li>params: {JSON.stringify(params)}</li>
</ul>
</div>
);
};
返回的是包含数据信息的对象文章来源地址https://www.toymoban.com/news/detail-803163.html
到了这里,关于Umi3 创建,配置环境,路由传参(代码示例)的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!