react以create-react-app为基础创建项目


Posted in Javascript onMarch 14, 2018

什么是create-react-app

create-react-app是一个js库,使用它能够很方便地建立react项目,免去了建立react项目时配置webpack、调试服务器、运行脚本等麻烦,你只需要使用这个库,便可以一键完成react项目的创建初始化项目

首先,要先利用create-react-app创建一个react项目,可参考https://github.com/facebookincubator/create-react-app

注:用“[ ]”包裹的都是可自定义的内容,例如:cd [project-name],实际上可能是cd my-app,也可能是cd my-project。总之“[ ]”包裹的内容,只表示上下文里相互对应的变量。

npm install -g create-react-app 
 
create-react-app [project-name] 
cd [project-name]

运行完以上命令就已经处在新建的项目中了,此时运行npm run start和npm run build了。但是,默认所有配置是隐藏起来的,要想自定义配置,需要运行一个命令:

npm run eject

此时会提示,该命令不可逆,是否继续,输入y,这样所有配置项就都出来了。这时候也可以做一些定制化的配置了,比如:

修改build后的output位置

js / css / img等静态资源会默认输出到 build -> static 下面,其配置项在config -> webpack.config.prod.js 里。

  1. js在output属性里,大约第60行 ;
  2. css在开头的cssFilename变量声明,大约第38行;
  3. 图片等在module -> rules的loader配置里,大约第143行;

map文件由devtool属性控制,如果不想要map,注释掉就可以,大约第57行;

manifest.json在ManifestPlugin的配置里,大约294行;

基础模板在HtmlWebpackPlugin的配置里,不过可以看到,是引的  ‘./paths.js' 文件,所以要修改 config -> paths.js 里面的 appHtml 属性;

默认在build时会清空build目录,配置项是scripts -> build.js 里的 fs.emptyDirSync(paths.appBuild); 这一句,注释掉就不会把老文件删掉了(灰度发布的时候可能会用到);

不eject其他修改配置的方法

除了 npm run eject 暴露出所有配置文件外,还有其他办法修改配置,由于本文主题原因不做展开,仅给出相关链。

一个(部分人认为)比较优雅的方法,即引入 react-app-rewired 插件来实现配置覆盖。需要在根目录新建一个 config-overrides.js 文件,想配置啥就写啥(怎么又多出来一种配置。。。),还需要重写下npm start等相关命令,详情点击链接查看。

另一个可参考create-react-app的git主页上推荐的Adding a CSS Preprocessor (Sass, Less etc.) 例子。大概思路就是先安装一个node环境可编译sass的插件node-sass-chokidar,然后利用npm-run-all同时运行npm start 和 watch-css(监听sass文件的命令)。个人感觉绕了个大圈,还是再议吧。。。

react等作为全局变量不打包

为了利用cdn,我们常会在页面里引用react或其他类似库的script标签,这样在浏览器环境里就有了相应的全局变量,同时减少了js的体积。下面以react为例。

首先在config -> webpack.config.prod.js 的配置里加入如下代码:

module.exports = { 
 ... 
 externals: { 
 'react': 'React', 
 'react-dom': 'ReactDOM' 
 }, 
 ... 
}

key对应的是库的名字,value对应的是全局变量的名字。这里要注意,全局变量的名字要与代码中import的名字一致,要保证规范。

另外,此处要修改下 html-webpack-plugin 插件配置的模板文件,因为需要加入全局变量,所以加入相应的script即可。以 public -> index.html 为例:

<!DOCTYPE html> 
<html lang="en"> 
 <head> 
 <meta charset="utf-8"> 
 <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> 
 <meta name="theme-color" content="#000000"> 
 <!-- 
  code here 
 --> 
 </head> 
 <body> 
 <noscript> 
  You need to enable JavaScript to run this app. 
 </noscript> 
 <div id="root"></div> 
 <!-- 
  code here 
 --> 
<!-- 新插入的两个js --> 
 <script src="http://st01.chrstatic.com/themes/chr-cdn/react/v0.14.8/react.min.js"></script> 
 <script src="http://st01.chrstatic.com/themes/chr-cdn/react/v0.14.8/react-dom.min.js"></script> 
 </body> 
</html>

问:既然浏览器里面都有了全局变量,如window.React,那么代码里面其实就不用 import React from 'react' 了,更进一步,如果连react都不用引了,那么设置externals又有什么用呢(这个地方好好缕缕,是不是这个理)?

答:如果按照上面所说,去掉import和external,build出来的文件是可以顺利的在浏览器端运行的。但是如果开发的时候是起的server,那么server端就没法分析引用了,也就没法做到热更新了,另外,对于前后端同构来说,服务端也是找不到依赖的。所以,如果你是开着静态文件的监听,并且手动刷新浏览器的话,不import和external理论上是没问题的。

安装sass或less(以sass为例)

npm install sass-loader node-sass --save-dev

或 

npm install less-loader less --save-dev

安装后修改config -> webpack.config.dev.js 和 webpack.config.prod.js,分别在css的loader配置里面修改两处:
一是 test: /\.css$/ 增加scss和sass;二是use里面最后再加个loader,直接加 "sass-loader" 就可以了,也不用配置别的了(less同)。

//test: /\.css$/ 
test: /\.(css|scss|sass)$/ 
... 
use:[ 
 { 
 ... 
 }, 
 "sass-loader" 
]

添加ant-design

安装antd及按需加载的插件babel-plugin-import,参考https://ant.design/docs/react/introduce-cn

npm install antd babel-plugin-import --save-dev

在config -> webpack.config.dev.js 和 webpack.config.prod.js 里(或者 .babelrc 文件)的babel-loader的options配置里,加入如下代码:

plugins: [ 
 ['import', { libraryName: 'antd', style: 'css' }] // `style: true` 会加载 less 文件 
]

如果启用了 style:true 那就必须是装less了

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
JavaScript数据类型学习笔记
Jan 25 Javascript
详解Vue.js Mixins 混入使用
Sep 15 Javascript
jQuery+SpringMVC中的复选框选择与传值实例
Jan 08 jQuery
解决vue build打包之后首页白屏的问题
Mar 06 Javascript
浅谈Vue响应式(数组变异方法)
May 07 Javascript
Vue注册组件命名时不能用大写的原因浅析
Apr 25 Javascript
jQuery实现条件搜索查询、实时取值及升降序排序的方法分析
May 04 jQuery
详解基于Vue/React项目的移动端适配方案
Aug 23 Javascript
JavaScript自动生成 年月范围 选择功能完整示例【基于jQuery插件】
Sep 03 jQuery
JS实现动态无缝轮播
Jan 11 Javascript
JavaScript本地储存:localStorage、sessionStorage、cookie的使用
Oct 13 Javascript
如何将JavaScript将数组转为树形结构
Jun 02 Javascript
200行代码实现blockchain 区块链实例详解
Mar 14 #Javascript
vue使用iframe嵌入网页的示例代码
Jun 09 #Javascript
JavaScript实现区块链
Mar 14 #Javascript
iview table render集成switch开关的实例
Mar 14 #Javascript
解决Vue.js 2.0 有时双向绑定img src属性失败的问题
Mar 14 #Javascript
Vue.js 动态为img的src赋值方法
Mar 14 #Javascript
基于datepicker定义自己的angular时间组件的示例
Mar 14 #Javascript
You might like
php 购物车的例子
2009/05/04 PHP
PHP文章按日期(月日)SQL归档语句
2012/11/29 PHP
2014年最新推荐的10款 PHP 开发框架
2014/08/01 PHP
php array_pop 删除数组最后一个元素实例
2016/11/02 PHP
PHP生成二维码与识别二维码的方法详解【附源码下载】
2019/03/07 PHP
Laravel框架学习笔记之批量更新数据功能
2019/05/30 PHP
基于jquery的一个拖拽到指定区域内的效果
2011/09/21 Javascript
JSCode all of Brower 全局屏蔽网页右键功能 具体实现
2013/06/05 Javascript
页面js遇到乱码问题的解决方法是和无法转码的情况
2014/04/30 Javascript
JS生成随机字符串的多种方法
2014/06/10 Javascript
jQuery插件扩展实例【添加回调函数】
2016/11/26 Javascript
select下拉框插件jquery.editable-select详解
2017/01/22 Javascript
Bootstrap禁用响应式布局的实现方法
2017/03/09 Javascript
基于vue2.0+vuex的日期选择组件功能实现
2017/03/13 Javascript
BootStrap点击保存后实现模态框自动关闭的思路(模态框)
2017/09/26 Javascript
vue组件发布到npm简单步骤
2017/11/30 Javascript
JS代码实现电脑配置检测功能
2018/03/21 Javascript
微信小程序模板template简单用法示例
2018/12/04 Javascript
点击按钮弹出模态框的一系列操作代码实例
2019/03/29 Javascript
Django中使用CORS实现跨域请求过程解析
2019/08/05 Python
学Python 3的理由和必要性
2019/11/19 Python
Python基于traceback模块获取异常信息
2020/07/23 Python
torchxrayvision包安装过程(附pytorch1.6cpu版安装)
2020/08/26 Python
Python 测试框架unittest和pytest的优劣
2020/09/26 Python
Python批量获取并保存手机号归属地和运营商的示例
2020/10/09 Python
CSS3教程:新增加的结构伪类
2009/04/02 HTML / CSS
Reebok官方旗舰店:美国知名健身品牌锐步
2019/01/07 全球购物
工作室成员个人发展规划范文
2014/01/24 职场文书
学生会主席事迹材料
2014/01/28 职场文书
仓库组长岗位职责
2014/01/29 职场文书
大学毕业寄语大全
2014/04/10 职场文书
电子商务专业自荐信
2014/06/02 职场文书
国际贸易毕业生自荐书
2014/06/22 职场文书
教师党员自我剖析材料
2014/09/29 职场文书
党员对十八届四中全会的期盼思想汇报范文
2014/10/17 职场文书
2016年中秋节寄语大全
2015/12/07 职场文书