@arco-plugins/webpack-react
@arco-plugins/webpack-react
is a webpack plugin to help deal with arco usage issues.
Feature
-
Style lazy load
:Add babel-plugin-import to babel-loader to enable style lazy loading。If there is a babel-plugin-import for arco-design/web-react, it will be replaced。 -
Theme import
:Specify the theme package name, the plugin will read the variable content of the theme package and inject it into modifyVars of less-loader。 -
Remove the font package that comes with the component library
:SetremoveFontFace
totrue
to remove the font file that comes with the component library。 -
Icon replacement
:Specify the package name of the icon library, the plug-in will read the icon in the package and replace the icon with the same name used in the component library.。 -
Replace default language
:The default imported language pack of the component library is Chinese, which determines that Chinese will be included in the packaged product. If you don't want Chinese, you can use this parameter to replace it with the language you need. -
Get lazy load babel plugin configuration
:The implementation of on-demand loading is achieved by injecting babel-plugin-import configuration into babel. These configurations are open for everyone to use and can be obtained through(new ArcoWebpackPlugin()).pluginForImport().getBabelPlugins()
.
Install
Use npm/yarn to install the plugin:
# npm
$ npm install -D @arco-plugins/webpack-react
# yarn
$ yarn add @arco-plugins/webpack-react
Usage
To to the plugin, add the following code in webpack config:
const ArcoWebpackPlugin = require('@arco-plugins/webpack-react');
// webpack config
{
plugins: [
new ArcoWebpackPlugin(options)
]
}
options
The plugin supports the following parameters:
Params | Type | Default Value | Description |
---|---|---|---|
include |
{(String|RegExp)[]} |
['src'] |
File directory used by bebel-plugin-import |
extensions |
{String[]} |
['js', 'jsx', 'ts', 'tsx'] |
File suffix used by bebel-plugin-import |
theme |
{String} |
- |
Theme package name |
iconBox |
{String} |
- |
Icon library package name |
modifyVars |
{Object} |
{} |
Less variables |
style |
{String|Boolean} |
true |
Style import method |
removeFontFace |
{Boolean} |
false |
Whether to remove the font file that comes with the component library |
defaultLanguage |
{string} |
- |
Replace the default language,language list |
webpackImplementation |
{webpack} |
- |
Specifying which webpack implementation to use |
varsInjectScope |
{(String|RegExp)[]} |
- |
Scope of injection of less variables (modifyVars and the theme package's variables) |
modifyBabelLoader |
{Boolean} |
true |
Whether to inject babel-plugin-import for babel-loader or adding a new loader |
**Style import methods **
style: true
will import less file
import '@arco-design/web-react/Affix/style'
style: 'css'
will import css file
import '@arco-design/web-react/Affix/style/css'
style: false
will not import any style file