React 移动Web - 上

目标

能够初始化项目
能够使用 antd-mobile 组件库
能够完成项目整体布局
能够理解嵌套路由
能够使用antd-mobile提供的TabBar组件
能够对TabBar进行定制
能够实现首页路由的处理

项目介绍

移动 Web 端
项目介绍：本项目是一个在线租房项目，实现了类似链家等项目的功能，解决了用户租房的需求
核心业务：在线找房（地图、条件搜索）、用户登录、房源发布等

在这里插入图片描述

技术栈

React核心库：react、react-dom、react-router-dom
脚手架：create-react-app
数据请求：axios
UI组件库：antd-mobile
其他组件库：react-virtualized、formik+yup、react-spring等
百度地图API

项目准备

项目搭建（★★★）

本地接口部署
- 创建并导入数据：数据库名称hkzf(固定名称)
使用脚手架初始化项目
- 使用 npx create-react-app hkzf-mobile
- 进入到项目根目录使用 npm start

项目目录结构（★★★）

在这里插入图片描述

调整项目结构

在这里插入图片描述

antd-mobile 组件库（★★★）

介绍与使用

打开 antd-mobile的文档
antd-mobile 是 Ant Design 的移动规范的 React 实现，服务于蚂蚁及口碑无线业务。

特性

UI 样式高度可配置，拓展性更强，轻松适应各类产品风格
基于 React Native 的 iOS / Android / Web 多平台支持，组件丰富、能全面覆盖各类场景 (antd-mobile-rn)
提供 “组件按需加载” / “Web 页面高清显示” / “SVG Icon” 等优化方案，一体式开发
使用 TypeScript 开发，提供类型定义文件，支持类型及属性智能提示，方便业务开发
全面兼容 react / preact

适用场景

适合于中大型产品应用
适合于基于 react / preact / react-native 的多终端应用
适合不同 UI 风格的高度定制需求的应用

快速上手

创建一个项目
安装
- npm install antd-mobile --save

使用

导入组件
导入样式

// 导入组件
import {
      
       Button } from 'antd-mobile';
// 导入样式
import 'antd-mobile/dist/antd-mobile.css';  // or 'antd-mobile/dist/antd-mobile.less'
ReactDOM.render(<Button>Start</Button>, mountNode);

配置路由

安装 yarn add react-router-dom
导入路由组件：Router / Route / Link
在pages文件夹中创建 Home/index.js 和 CityList/index.js 两个组件
使用Route组件配置首页和城市选择页面

在这里插入图片描述

外观和样式调整

修改页面标题，在index.html里面修改
基础样式调整，在index.css 中调整

在这里插入图片描述

项目整体布局

两种页面布局

有TabBar的页面：首页、找房、资讯、我的
无TabBar的页面：城市选择等
TabBar 的菜单也可以实现路由切换，也就是路由内部切换路由（嵌套路由）

在这里插入图片描述

嵌套路由（★★★）

嵌套路由：路由内部包含路由
用Home组件表示父路由的内容
用News组件表示子路由的内容

使用步骤

在pages文件夹中创建News/index.js 组件
在Home组件中，添加一个Route作为子路由的出口
设置嵌套路由的path，格式以父路由path开头(父组件展示了，子组件才会展示)
修改pathname为 /home/news，News组件的内容就会展示在Home组件中了

在这里插入图片描述

实现TabBar（★★★）

拷贝TabBar组件结构

打开 antd-mobile 组件库中TabBar的组件文档
选择APP型选项卡菜单，点击 </>显示源码
拷贝核心代码到 Home 组件中（Home是父路由组件）
调整代码

修改TabBar组件样式

修改TabBar菜单项文字标题
- TabBar的文字标题在TabBar.Item 的title属性中，所以我们修改对应四个title属性即可

<TabBar.Item
    title="首页"
    ...
>
</TabBar.Item>
<TabBar.Item
    title="找房"
    ...
>
</TabBar.Item>
<TabBar.Item
    title="咨询"
    ...
>
</TabBar.Item>
<TabBar.Item
    title="我的"
    ...
>
</TabBar.Item>

修改TabBar菜单文字标题颜色
- TabBar菜单选中的文字颜色在 TabBar的 tintColor 属性中设置
- 未选中文字颜色用默认的即可，删除 TabBar中的 unselectedTintColor 属性

<TabBar
    tintColor="#21b97a"
    barTintColor="white"
>
...
</TabBar>

使用字图图标，修改TabBar菜单的图标
- 字体图标的资源在课件的素材中，直接复制过来即可
- 在 index.js里面引入字体图标的 css样式文件，这样我们只需要在组件中设置对应的类名即可,icon代表是默认图标，selectedIcon代表是选中的图标

<TabBar.Item
    {/*默认的图标*/}
    icon={
        <i className="iconfont icon-ind"></i>
    }
     {/*选中图标*/}
    selectedIcon={
   
   <i className="iconfont icon-ind"></i>
    }
    ...
>
</TabBar.Item>
<TabBar.Item
    icon={
     
     
        <i className="iconfont icon-findHouse"></i>
    }
    selectedIcon={
        <i className="iconfont icon-findHouse"></i>
    }
    ...
>
</TabBar.Item>
<TabBar.Item
    icon={
     
     
        <i className="iconfont icon-infom"></i>
    }
    selectedIcon={
        <i className="iconfont icon-infom"></i>
    }
    ...
>
</TabBar.Item>
<TabBar.Item
    icon={
     
     
        <i className="iconfont icon-my"></i>
    }
    selectedIcon={
   
   <i className="iconfont icon-my"></i>}
    ...
>
</TabBar.Item>

修改TabBar菜单项的图标大小
- 在当前组件对应文件夹中创建index.css文件，修改一下字体图标的大小，设置为20px（注意，在home.js中记得导入当前的样式）
调整TabBar的位置，固定在最底部
- 通过调试工具我们发现，底部的TabBar的类名叫 am-tab-bar-bar，所以我们只需要设置一下这个类名的属性即可
去掉TabBar的徽章
- 找到TabBar.Item里面对应的 badge 属性，删除即可

TabBar配合路由实现

根据TabBar组件文档设置不渲染内容（只保留菜单项，不显示内容）
- 给TabBar设置 noRenderContent 属性即可

<TabBar
    ...
    noRenderContent = "true"
>

给TabBar.Item 绑定点击事件，在点击事件逻辑里面利用编程式导航，进行路由的切换
- 利用 this.props.history,push() 来实现

 <TabBar.Item
    ...
    onPress={
    
    () => {
    
    
        this.setState({
    
    
            selectedTab: 'blueTab',
        });
        {
    
    /* 切换路由 */}
        this.props.history.push('/home/index')
    }}
>
</TabBar.Item>
<TabBar.Item
    ...
    onPress={
    
    () => {
    
    
        this.setState({
    
    
            selectedTab: 'redTab',
        });
        this.props.history.push('/home/list')
    }}
>
</TabBar.Item>
<TabBar.Item
    ...
    onPress={
    
    () => {
    
    
        this.setState({
    
    
            selectedTab: 'greenTab',
        });
        this.props.history.push('/home/news')
    }}
>
</TabBar.Item>
<TabBar.Item
    ...
    onPress={
    
    () => {
    
    
        this.setState({
    
    
            selectedTab: 'yellowTab',
        });
        this.props.history.push('/home/profile')
    }}
>
</TabBar.Item>

创建TabBar组件菜单项对应的其他3个组件，并在Home组件中配置路由信息
- 创建对应的组件，然后在 home.js中进行导入，最后配置一下路由

{/* 配置路由信息 */}
<Route path="/home/index" component={Index}></Route>
<Route path="/home/list" component={HouseList}></Route>
<Route path="/home/news" component={News}></Route>
<Route path="/home/profile" component={Profile}></Route>

给菜单项添加selected属性，设置当前匹配的菜单项高亮
- 通过 this.props.location.pathname 就能拿到当前的路由的path
- 在TabBarItem里面设置 selected的属性，判断是否等于当前的pathname
- 在state中记录当前的pathname
```
 state = {
      
      
     // 选中的菜单项,记录当前的pathname来匹配对应的tab
     selectedTab: this.props.location.pathname,

 }
```
- 在每个TabBar.Item里面利用selected属性判断一下

<TabBar.Item
     selected={
    
    this.state.selectedTab === '/home/index'}
     onPress={
    
    () => {
    
    
         this.setState({
    
    
             selectedTab: '/home/index',
         });
         this.props.history.push('/home/index')
     }}
     ...
 >
 </TabBar.Item>
 <TabBar.Item
     selected={
    
    this.state.selectedTab === '/home/list'}
     onPress={
    
    () => {
    
    
         this.setState({
    
    
             selectedTab: '/home/list',
         });
         this.props.history.push('/home/list')
     }}
     ...
 >
 </TabBar.Item>
 <TabBar.Item
     selected={
    
    this.state.selectedTab === '/home/news'}
     onPress={
    
    () => {
    
    
         this.setState({
    
    
             selectedTab: '/home/news',
         });
         this.props.history.push('/home/news')
     }}
     ...
 >
 </TabBar.Item>
 <TabBar.Item
     selected={
    
    this.state.selectedTab === '/home/profile'}
     onPress={
    
    () => {
    
    
         this.setState({
    
    
             selectedTab: '/home/profile',
         });
         this.props.history.push('/home/profile')
     }}
     ...
 >
 </TabBar.Item>

TabBar代码的重构

发现TabBar的Iitem里面的内容几乎是一致的，只是里面内容不同
所以我们可以封装一下
提供菜单数据

在这里插入图片描述

使用map来进行遍历

声明一下数据源

const tabItems = [{
    
    
    title: '首页',
    icon: 'icon-ind',
    path: '/home/index'
},
{
    
    
    title: '找房',
    icon: 'icon-findHouse',
    path: '/home/list'
},
{
    
    
    title: '资讯',
    icon: 'icon-infom',
    path: '/home/news'
},
{
    
    
    title: '我的',
    icon: 'icon-my',
    path: '/home/profile'
}]

封装一个函数来遍历渲染

renderTabBarItem() {
    
    
   return tabItems.map(item => {
    
    
        return (
            <TabBar.Item
                title={
    
    item.title}
                key={
    
    item.title}
                icon={
    
    
                    <i className={
    
    `iconfont ${
      
      item.icon}`}></i>
                }
                selectedIcon={
    
    <i className={
    
    `iconfont ${
      
      item.icon}`}></i>
                }
                selected={
    
    this.state.selectedTab === item.path}
                onPress={
    
    () => {
    
    
                    this.setState({
    
    
                        selectedTab: item.path,
                    });
                    this.props.history.push(item.path)
                }}
            >
            </TabBar.Item>

        )
    })
}

在render方法中调用即可

render() {
    
    
    return (<div>
        {
    
    /* 配置路由信息 */}
        <Route path="/home/index" component={
    
    Index}></Route>
        <Route path="/home/list" component={
    
    HouseList}></Route>
        <Route path="/home/news" component={
    
    News}></Route>
        <Route path="/home/profile" component={
    
    Profile}></Route>
        {
    
    /* 底部导航栏 */}
        <TabBar
            tintColor="#21b97a"
            barTintColor="white"
            noRenderContent="true"
        >
            {
    
    this.renderTabBarItem()}
        </TabBar>
    </div>)
}

首页实现（★★★）

首页的路由是需要去处理的
修改首页路由的配置： /home(去掉后面的index)；这里需要添加 exact属性
如果是默认路由需要跳转到 /home

在这里插入图片描述

{
    
    /* 配置默认路由 */}
<Route path="/" exact render={
    
    () => <Redirect to="/home"></Redirect>}></Route>

【React项目】=＞ [01] 项目演示&项目搭建&antd-mobile的TabBar使用

React 移动Web - 上

目标

项目介绍

技术栈

项目准备

项目搭建（★★★）

项目目录结构（★★★）

antd-mobile 组件库（★★★）

介绍与使用

特性

适用场景

快速上手

配置路由

外观和样式调整

项目整体布局

两种页面布局

嵌套路由（★★★）

使用步骤

实现TabBar（★★★）

拷贝TabBar组件结构

修改TabBar组件样式

TabBar配合路由实现

TabBar代码的重构

首页实现（★★★）

猜你喜欢