大家好,我是编程小6,很高兴遇见你,有问题可以及时留言哦。
持续创作,加速成长!这是我参与「掘金日新计划 · 6 月更文挑战」的第1天,点击查看活动详情
什么是React?
React是一个简单的javascript UI库,用于构建高效、快速的用户界面。它是一个轻量级库,因此很受欢迎。它遵循组件设计模式、声明式编程范式 和 函数式编程 概念,使前端应用程序更高效。它使用虚拟DOM来有效地操作DOM。它遵循从高阶组件到低阶组件的单向数据流。
React 中一切都是组件。 我们通常将应用程序的整个逻辑分解为小的单个部分。 我们将每个单独的部分称为组件。 通常,组件是一个javascript函数,它接受输入,处理它并返回在UI中呈现的React元素。
预期效果:
实际效果:GitHub Pages预览
想要搭建一个好的项目,称手的工具必不可少。
在我们已经安装好 vscode 和 node 的前提下,我们需要在终端环境下初始化一个项目,项目我们取名为 bilibili-page:
这里我们使用 vite 进行搭建,它相比于 webpack 更快
npm init @vitejs/app bilibili-page
执行该命令后我们选择 react:
因为这个项目使用的是 js 语法,所以我们选择 react,如果对 ts 语法比较熟悉的小伙伴也可以选择 react-ts。
选择好以后,我们依次执行如下命令: 进入项目目录,并使用 npm i 或 (npm install) 安装 react。
cd bilibili-page
npm install
除此之外,我们还需要安装以下依赖,使用命令(npm i xxx)默认安装最新版本:
antd-mobile
:Ant Design Mobile 简称 antd-mobile,是 Ant Design 的移动规范的 React 实现,是一个基于Preact/React/React Native的UI组件库。我们用它来实现轮播图效果。
axios
:axios 是一个基于 promise 的网络请求库,用于获取后端数据,是前端常用的数据请求工具。
react-router
和 react-router-dom
:react-router 用来实现了路由的核心功能,而 react-router-dom 基于 react-router,加入了在浏览器运行环境下的一些功能。
weui
和 react-weui
:weui 是一套同微信原生视觉体验一致的基础样式库,react-weui 是微信提供的前端 UI 库,在 react 中我们可以直接拿来使用。这里我们用来实现 loading 状态,优化用户体验。
styled-components
:安装这一依赖,我们能够实现 css in js,是 react 中设计组件很好用的一种方法。
classnames
:它是用来合并类名的,存在多个类名变量时,想添加到对应的元素中,采用 classnames 非常方便。
另外,我还使用了在线接口工具 faskmock。fastmock
可以让你在没有后端程序的情况下真实地在线模拟 ajax 请求,实现前后端分离,这里我用 fatmock
实现项目初期纯前端的效果演示。
路由跳转及tab切换,包括一级路由和二级路由,当用户进入到首页时,默认跳转到首页的推荐页面。
轮播图的实现,可自动循环播放以及手动滑动。
loading状态,由于视频数据是从远程请求过来的,需要一些等待时间,加上了 loading 状态后,填补了页面的空白状态,优化用户体验。
在该项目中,我主要用来实现 bilibili 首页页面的快速搭建,具体的实现功能后面我会一一去实现,例如下拉刷新、上滑加载、点击视频详情页功能,以及搜索、点赞、投币等功能。
根据需求,我们需要在 src 目录下新建以下文件夹:
getVideos
用来获取视频信息数据。import axios from 'axios'
export const getVideos = () =>
axios.get('https://www.fastmock.site/mock/059647e88be0d33ef58d6ab4bf009dd9/bilibili/videolist')
在 assets 文件夹用来存放静态资源文件,如:本地图片、下载的图标字体和全局的css样式,用来做 reset,样式重置。
components 文件夹用来存放组件,主要有底部路由(一级路由)、头部搜索框以及导航路由(二级路由)。
config 目录下的 index,js,用来对页面进行标题配置:
// 页面标题配置
export const pageTitle = {
'/': '首页',
'/home': '首页',
'/dynamic': '动态',
'/vip': '会员购',
'/mine': '我的'
}
document.documentElement.style.fontSize =
document.documentElement.clientWidth / 3.75 + 'px'
window.onresize = function() {
document.documentElement.style.fontSize =
document.documentElement.clientWidth / 3.75 + "px"
}
pages 目录,用来存放单页面级别组件,例如:主页(主页下的多个页面)、动态、会员购和我的。
routes 目录,这里我们将路由抽离出来放到这个文件夹下,便于管理。我们希望有些比较大的组件,只有在此组件被加载时,内部资源才被引用,因此我们引入 lazy 实现懒加载。由于我们在 vite.config.js
中添加了如下配置,引入了 nodejs 的 path
模块,使用path.resolve
来处理绝对路径:
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import path from 'path'
export default defineConfig({
plugins: [react()],
resolve: {
alias: {
'@': path.resolve(__dirname, 'src')
}
}
})
完成配置之后,就可以用 @
来替代 src
:
import { lazy } from 'react'
import { Routes, Route } from 'react-router-dom'
import Home from '@/pages/Home' // 首页
const Dynamic = lazy(() => import('@/pages/Dynamic')) // 动态
const Vip = lazy(() => import('@/pages/Vip')) // 会员购
const Mine = lazy(() => import('@/pages/Mine')) // 我的
const Live = lazy(() => import('@/pages/Home/Live')) // 直播
const Recommend = lazy(() => import('@/pages/Home/Recommend')) // 推荐
const Hot = lazy(() => import('@/pages/Home/Hot')) // 热门
const Animation = lazy(() => import('@/pages/Home/Animation')) // 动画
const Movies = lazy(() => import('@/pages/Home/Movies')) // 影视
const Campus = lazy(() => import('@/pages/Home/Campus')) // 校园
const RoutesConfig = () => {
return (
<Routes> <Route path="/" element={<Home />}></Route> <Route path="/home" element={<Home />} > {/* 二级路由 */} <Route path="/home/live" element={<Live />} /> <Route path="/home/recommend" element={<Recommend />} /> <Route path="/home/hot" element={<Hot />} /> <Route path="/home/animation" element={<Animation />} /> <Route path="/home/movies" element={<Movies />} /> <Route path="/home/campus" element={<Campus />} /> </Route> <Route path="/dynamic" element={<Dynamic />}></Route> <Route path="/vip" element={<Vip />}></Route> <Route path="/mine" element={<Mine />}></Route> </Routes>
)
}
export default RoutesConfig
index.js
中,我新建了一个 isPathPartlyExisted
函数,用来判断路径中是否存在 '/home'
。/** * @author codinglin * @func 根据path判断是否在数组配置中 * @params {path string} * @return boolean */
export const isPathPartlyExisted = (path) => {
let pathRes = path.split('/')
if (pathRes[1] && pathRes[1] === 'home') return true
return false
}
我们从 react-router-dom 中解构出
Link
和useLocation
,Link 实现页面的跳转,从 useLocation 中我们解构出pathname
,用来判断当前路径是否匹配,如果匹配就将active
样式添加上去。例如首页,当路径为'/','/home'或者'/home/...'
时,底部的首页图标高亮。
import React from 'react'
import { Link, useLocation } from 'react-router-dom'
import { FooterWrapper } from './style'
import classnames from 'classnames'
import { isPathPartlyExisted } from '@/utils'
export default function Footer(props) {
const { pathname } = useLocation()
return (
<FooterWrapper> <Link to="/home" className={classnames( {active:pathname == '/' || isPathPartlyExisted(pathname)} )}> <i className='iconfont icon-shouye'></i> <span>首页</span> </Link> ... </FooterWrapper>
)
}
效果如下图:
我们首先将二级路由放到一个数组中,包括id、desc和path,然后我们使用 map 方法代替forEach循环,来遍历并对每个值应用转换函数,通过点击我们既想要跳转又想要添加样式,我们使用了比 Link 更高级的
NavLink
。
import React from 'react'
import { Wrapper } from './style'
import { NavLink } from 'react-router-dom'
export default function HomeNav() {
let homeNavs = [
{ id: 1, desc: '直播', path: '/live'},
{ id: 2, desc: '推荐', path: '/recommend'},
{ id: 3, desc: '热门', path: '/hot'},
{ id: 4, desc: '动画', path: '/animation'},
{ id: 5, desc: '影视', path: '/movies'},
{ id: 6, desc: '校园', path: '/campus'}
]
return (
<Wrapper> <div className="navbar swiper-container"> <div className="nav-box swiper-wrapper"> { homeNavs.map((item, index) => { return ( <NavLink index={index} to={`/home${item.path}`} key={item.id} className="nav-item swiper-slide" > {item.desc} </NavLink> ) }) } </div> </div> </Wrapper>
)
}
轮播图我使用了 antd-mobile 中的
Swiper
和Toast
,具体大家可以参考:mobile.ant.design/zh/componen… 在 Swiper 组件中加入autoplay
和loop
,使得轮播图既能自动播放又能循环。Toast.show
在你触发了点击事件之后,能够弹出相关信息。
import React from 'react'
import './style.css'
import { Swiper, Toast } from 'antd-mobile'
import classnames from 'classnames'
export default function SetMovie() {
const images = [
'https://dogefs.s3.ladydaily.com/~/source/wallhaven/small/o3/o3wel5.jpg',
'https://dogefs.s3.ladydaily.com/~/source/wallhaven/small/28/28wqwg.jpg',
'https://dogefs.s3.ladydaily.com/~/source/wallhaven/small/x8/x8kwd3.jpg',
'https://dogefs.s3.ladydaily.com/~/source/wallhaven/small/o3/o3edql.jpg'
]
const items = images.map((image, index) => (
<Swiper.Item key={index}> <div className={classnames('content')} style={{backgroundImage: `url(${image})`}} onClick={() => { Toast.show(`你点击了电影 ${index + 1}`) }} > </div> </Swiper.Item>
))
return (
<div className='wrapper'> <Swiper autoplay loop>{items}</Swiper> </div>
)
}
效果如下图:
首先我们从引入的 WeUI 中解构出
Toast
,然后再给 loading 设置默认状态为 true,当从远程请求到数据之后,setLoading(false),状态消失,数据显示,优化用户体验。
import React, { useEffect, useState } from 'react'
import SetMovie from '../SetMovie'
import { Wrapper } from './style'
import { getVideos } from '@/api/request'
import { Link } from 'react-router-dom'
import WeUI from 'react-weui'
const {
Toast
} = WeUI;
export default function Recommend() {
const [loading, setLoading] = useState(true)
const [videos, setVideos] = useState([])
useEffect(() => {
(async() => {
let { data } = await getVideos()
setVideos([...data])
setLoading(false)
})()
}, [])
return (
<> <SetMovie /> <Wrapper> <Toast show={loading} icon="loading">加载中...</Toast> ... </Wrapper> </>
)
}
效果如下图:
从远程请求过来的数据通过唯一 key 值
video.id
,通过 map 分配给 video,完成数据的渲染。
...
export default function Recommend() {
const [loading, setLoading] = useState(true)
const [videos, setVideos] = useState([])
useEffect(() => {
(async() => {
let { data } = await getVideos()
setVideos([...data])
setLoading(false)
})()
}, [])
return (
<> <SetMovie /> <Wrapper> <Toast show={loading} icon="loading">加载中...</Toast> { videos && videos.map( video => ( <div className='videos-flex' key={video.id}> <Link to={`/campus/video${video.id}`} key={video.id} > <div className='videos-box'> <div className="videos-img"> <img src={video.img} alt="" /> <div className="info"> <i className='iconfont icon-bofangqi-bofangxiaodianshi'></i> <span>{video.bofang}</span> <i className='iconfont icon-jianyi'></i> <span>{video.pinglun}</span> <span>{video.time}</span> </div> </div> <div className='title'> <span>{video.title}</span> </div> <div className='up'> <span>{video.up}</span> </div> </div> </Link> </div> ) ) } </Wrapper> </>
)
}
单个视频 demo 效果如下图:
当我们在自己动手写第一个React项目(或其他项目)时,建议大家把思路理清楚,不要急于写样式,把大致的模板建好,然后逐个组件进行完善,如果大家想要快速搭建项目,可以直接使用我在 github 上传的一个 React 的单页应用模板,如果你对 git 较为熟悉,建议直接在终端 git clone
,然后再 npm i
,不会使用 git 的小伙伴也可以直接下载,模板地址:React单页应用模板
项目地址:哔哩哔哩移动端首页
预览效果:GitHub Pages
上一篇
已是最后文章