admin管理员组文章数量:1632798
app: {
// 可选,根节点 id,默认为 ice-container
rootId: ‘ice-container’,
// 可选,根节点 DOM 元素,更灵活的 rootId
mountNode: document.getElementById(‘ice-container’),
// 可选,是否解析路由组件的查询参数,默认 true
parseSearchParams: true
// 可选,自定义添加 Provider
addProvider: ({ children }) => {
return {children};
},
// 可选,常用于 SSR 场景或者异步获取数据请求的场景
// 如果返回字段中包含 initialStates 字段将会作为状态管理 store 的初始值
// 如果返回字段中包含 auth 字段将会作为权限管理 auth 的初始值
getInitialData: async() => {
const result = await request();
return result;
},
// 可选,自定义错误边界的 fallback UI
ErrorBoundaryFallback:
渲染错误 ,// 可选,自定义错误的处理事件
onErrorBoundaryHander: (error, componentStack) {
// Do something with the error
},
// 可选,用于渲染一个简单组件,不再需要耦合 react-router 的路由系统
// 需要配合设置 build.json 的 router 项为 false
renderComponent: SimpleComponent,
},
};
runApp(appConfig);
工程配置:
如何开启新的 JSX 转换#
ice.js 1.16.0+ 支持 New JSX Transform,开启该能力之后,编写 React 组件时不再需要在头部引入 React
。
只需要修改 tsconfig.json
中的 compilerOptions.jsx
即可:
{
“compilerOptions”: {
- “jsx”: “react”,
+ “jsx”: “react-jsx”,
}
}
//接下来书写组件就不再需要引入 React 了:
- import React from ‘react’;
function Example() {
return <>Hello</>;
}
自定义工程配置#
如果基础配置和已有插件都无法支持业务需求,可以通过自定义配置来实现,自定义配置同时也是一个 webpack 插件。
首先新建 build.plugin.js
文件作为一个自定义插件,然后写入以下代码:
module.exports = ({ context, onGetWebpackConfig }) => {
onGetWebpackConfig((config) => {});
};
插件内部代码写法可以参考文档 通过插件定制工程能力。
最后在 build.json
里引入自定义插件即可:
{
“plugins”: [“build-plugin-ice-app”, “./build.plugin.js”]
}
配置路由信息#
应用的路由信息统一在 src/routes.ts
中配置,配置协议支持多级嵌套,具体如下:
import UserLayout from ‘@/Layouts/UserLayout’;
import UserLogin from ‘@/pages/UserLogin’;
import NotFound from ‘@/components/NotFound’;
import wrapperPage from ‘@/components/WrapperPage’;
const routerConfig = [
// 分组路由,children 里的路由会将父节点的 component 作为布局组件
{
path: ‘/user’,
component: UserLayout,
children: [
{
// 路由路径
path: ‘/login’,
// 精确匹配
exact: true,
// 路由组件
component: UserLogin,
// 配置路由的高阶组件
wrappers: [wrapperPage],
},
{
path: ‘/’,
// 重定向
redirect: ‘/user/login’,
},
{
// 404 没有匹配到的路由
component: NotFound,
},
],
},
// 非分组路由
{
path: ‘/about’,
component: About,
},
];
export default routerConfig;
注意:路由有一个按顺序匹配的规则,从上到下一旦命中路由匹配规则就会停止遍历,因此如果你在最前面配置了 / 这样一个路由,则所有的路由都会命中该规则,导致其他路由没有效果,所以在开发时要注意路由的顺序以及 exact 属性的使用。
运行时配置#
在 src/app.ts
中,我们可以配置路由的类型和基础路径等信息,具体配置如下:
import { runApp } from ‘ice’;
const appConfig = {
router: {
type: ‘browser’,
basename: ‘/seller’,
fallback:
loading…modifyRoutes: (routes) => {
return routes;
}
}
};
runApp(appConfig);
options:
-
type: 路由类型,默认值
hash
,可选值browser|hash|static
-
basename: 路由基准地址
-
fallback: 开启按需加载时配置 fallback UI
-
modifyRoutes: 动态修改路由
-
history: 自定义创建 history 对象,详见
路由组件参数#
对于路由组件(即页面级组件),可通过组件 props
获取到如下属性:
-
location
:当前路由的 location 对象,包含pathname
、search
、hash
、state
属性 -
history
:详见 history api -
searchParams
:当前 URL 的查询参数对象(需要开启 parseSearchParams) -
match
:当前路由和 URL match 后的对象,包含path
、url
、params
、isExact
属性
对于非路由组件,组件内如想获取上述属性需要借助 useHistory, useLocation, useParams, withRouter 等 API。
路由跳转#
通常使用 Link
组件或者 history
API 进行路由的跳转:
import { Link, useHistory } from ‘ice’;
function Home() {
const history = useHistory();
return (
<>
去 about 页面<span
onClick={() => {
history.push(‘/about’);
}}
去 about 页面
</>
);
}
路由跳转传递参数,除了通过 url params 如 /projects/:id
以及 url query 如 /project?id=1
以外,也可通过 state
参数:
注意:state 传递参数仅支持 BrowserHistory 不支持 HashHistory,通过
src/app.ts
里的router.type
字段可配置。
import { Link, useHistory } from ‘ice’;
function Home() {
const history = useHistory();
return (
<>
to={{
pathname: ‘/about’,
state: { from: ‘click link’ },
}}
去 about 页面
<span
onClick={() => {
history.push({
pathname: ‘/about’,
state: { from: ‘click span’ },
});
}}
去 about 页面
</>
);
}
在 about 页面即可通过 location
访问到对应的 state:
import { useLocation } from ‘ice’;
function About() {
const location = useLocation();
console.log(‘history state’, location.state);
return <></>;
}
路由高阶组件#
通过 src/routes.ts
中的 wrappers
字段可配置路由的高阶组件,常用于路由级别的权限检验。
最后
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长,自己不成体系的自学效果低效漫长且无助。
因此收集整理了一份《2024年Web前端开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点!不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门!
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
果低效漫长且无助。**
因此收集整理了一份《2024年Web前端开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
[外链图片转存中…(img-DR8GZaBJ-1715457221751)]
[外链图片转存中…(img-q7CBuZL6-1715457221751)]
[外链图片转存中…(img-FX91tg9p-1715457221752)]
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点!不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门!
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
版权声明:本文标题:Ice飞冰目录结构&应用入口&工程配置&路由配置《四》 内容由热心网友自发贡献,该文观点仅代表作者本人, 转载请联系作者并注明出处:https://www.elefans.com/xitong/1729141981a1187671.html, 本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容,一经查实,本站将立刻删除。
发表评论