/hy-react-web-music

a react web music application

Primary LanguageJavaScript

React实战之云音乐项目

如果觉得不错,或者对你有帮助,点一个star~ coderwhy

1.1. 项目简介

使用React编写的云音乐PC Web项目,接口来源于开源的接口,自己已经做了部署。

项目已经完成功能如下:(你可以下载下来自己体验一下)

推荐页面:

  • 轮播图
  • 热门推荐
  • 新碟上架
  • 榜单
  • 等等

推荐页面

推荐页面

歌曲播放:

  • 目前做了榜单中歌曲的点击播放;
  • 事实上其他页面只要将歌曲的id传入到redux中就可以,整个逻辑已经打通;
  • 做了歌曲的各种控制(暂停、播放、上一首、下一首、进度改变);
  • 做了播放循序切换:顺序播放、随机播放、单曲循环;
  • 做了歌词的解析、展示、滚动;

歌曲播放

排行榜页面:

  • 各种榜单的切换;

排行榜页面

歌单页面:

  • 选择分类、选择分类后根据分类切换歌单;
  • 根据分类,歌单列表的展示;
  • 分页功能;

歌单页面

主播电台:

  • 电台分类的展示、滚动;
  • 不同分类展示不同的数据;
  • 电台排行榜展示、分页;

主播电台

歌手页面:

  • 各种歌手分类(没找到接口,还自定义了一些数据)
  • 歌手字母分类、对应歌手展示;

歌手页面

新碟上架页面:

  • 热门新碟;
  • 全部新碟、分页展示;

新碟上架页面

1.2. 项目规范

项目规范:项目中有一些开发规范和代码风格

  • 1.文件夹、文件名称统一小写、多个单词以连接符(-)连接;
  • 2.JavaScript变量名称采用小驼峰标识,常量全部使用大写字母,组件采用大驼峰;
  • 3.CSS采用普通CSS和styled-component结合来编写(全局采用普通CSS、局部采用styled-component);
  • 4.整个项目不再使用class组件,统一使用函数式组件,并且全面使用Hooks;
  • 5.所有的函数式组件,为了避免不必要的渲染,全部使用memo进行包裹;
  • 6.组件内部的状态,使用useState、useReducer;业务数据全部放在redux中管理;
  • 7.函数组件内部基本按照如下顺序编写代码:
    • 组件内部state管理;
    • redux的hooks代码;
    • 其他组件hooks代码;
    • 其他逻辑代码;
    • 返回JSX代码;
  • 8.redux代码规范如下:
    • redux结合ImmutableJS
    • 每个模块有自己独立的reducer,通过combineReducer进行合并;
    • 异步请求代码使用redux-thunk,并且写在actionCreators中;
    • redux直接采用redux hooks方式编写,不再使用connect;
  • 9.网络请求采用axios
    • 对axios进行二次封装;
    • 所有的模块请求会放到一个请求文件中单独管理;
  • 10.项目使用AntDesign
    • 项目中某些AntDesign中的组件会被拿过来使用;
    • 但是多部分组件还是自己进行编写;
  • 其他规范在项目中根据实际情况决定和编写;

1.3. 项目运行

clone项目:

git clone https://github.com/coderwhy/hy-react-web-music.git

安装项目依赖:

yarn install

项目运行:

yarn start