webpack集成
注:内部webpack插件版本基于webpack@3.12.0开发选择,暂不兼容webpack4。
通过以下步骤,可以让webpack项目中使用chameleon的任意组件。
1 安装npm包
npm i easy-chameleon chameleon-ui-builtin
2 执行脚本
node node_modules/\easy-chameleon/bin/index.js
,该脚本会执行检测,安装未安装的第三方npm包3 .babelrc 的preset 添加flow, chameleon中用了flow语法,如果需要用到
chameleon-api
,建议配置babel-plugin-chameleon-import
插件实现按需加载。例如:
{
"presets": [
"flow",
["env", {
"targets": {
"browsers": ["> 1%", "last 2 versions", "not ie <= 8"]
}
}],
"stage-0"
],
"plugins": [
"transform-vue-jsx",
"transform-runtime",
[
"babel-plugin-chameleon-import", {
"libraryName": "chameleon-api",
"libraryDirectory": "src/interfaces",
"libraryFileName": "index.js",
"defaulLibraryDirectory": "",
"defaulLibraryFileName": "index.js",
}
]
]
}
4 入口代码中,引入代码
import 'easy-chameleon/entry/web_global.js';
5 修改webpack配置文件,
easy-chameleon
提供了getConfig
方法获取webpack配置,利用webpack-merge
将项目原有webpack配置与getConfig
方法获取的配置进行合并,例如:
const merge = require('webpack-merge')
const {getConfig} = require('easy-chameleon');
devWebpackConfig = merge(devWebpackConfig, getConfig({
cmlType: 'web',
media: 'dev',
hot: true,
disableExtract: false,
context: path.join(__dirname,'../'),
cmss: {
rem: false,
scale: 0.5
}
}))
getConfig方法参数
getConfig(Object object)
参数类型默认值必填说明cmlTypeString是端类型,可选值为web|wx|weexmediaString是构建模式,可选值为dev|buildhotBooleanfalse否是否开启热更新,只在web端生效disableExtractBooleanfalse否不提取css文件cmssObject否cmss处理的配置,参见下方cmss对象属性列表wxConfigObject否微信端构建配置,参见下方wxConfig对象属性列表
cmss 对象属性列表
参数 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
rem | Boolean | true | 否 | 将cpx以75cpx=1rem为标准转换成rem |
scale | Number | 0.5 | 否 | 当rem为false时,scale将生效,将cpx乘以scale为px |
wxConfig 对象属性列表
参数 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
entry | Array[String] | 是 | 指定输出的组件入口,以项目根目录下的相对路径,会寻找指定路径下的cml文件进行编译 | |
outputPath | String | 否 | 输出路径 |
示例
详细示例戳这里webpack集成chameleon