Ice飞冰目录结构&应用入口&工程配置&路由配置《四》

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开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！