https://github.com/ElementUI/babel-plugin-component
Modular element-ui build plugin for babel.
https://github.com/ElementUI/babel-plugin-component
Last synced: about 1 year ago
JSON representation
Modular element-ui build plugin for babel.
- Host: GitHub
- URL: https://github.com/ElementUI/babel-plugin-component
- Owner: ElementUI
- Fork: true (umijs/babel-plugin-import)
- Created: 2016-05-24T09:31:08.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2021-01-20T07:09:41.000Z (over 5 years ago)
- Last Synced: 2025-03-19T05:03:25.469Z (over 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 120 KB
- Stars: 451
- Watchers: 6
- Forks: 96
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# babel-plugin-component
[](https://npmjs.org/package/babel-plugin-component)
[](https://travis-ci.org/ElementUI/babel-plugin-component)
[](https://coveralls.io/github/QingWei-Li/babel-plugin-component?branch=master)
## Install
```shell
npm i babel-plugin-component -D
# For babel6
npm i babel-plugin-component@0 -D
```
## Example
Converts
```javascript
import { Button } from 'components'
```
to
```javascript
var button = require('components/lib/button')
require('components/lib/button/style.css')
```
## styleLibraryName Example
Converts
```javascript
import Components from 'components'
import { Button } from 'components'
```
to
```javascript
require('components/lib/styleLibraryName/index.css')
var button = require('components/lib/styleLibraryName/button.css')
```
## Usage
Via `.babelrc` or babel-loader.
```javascript
{
"plugins": [["component", options]]
}
```
## Multiple Module
```javascript
{
"plugins": [xxx,
["component", {
libraryName: "antd",
style: true,
}, "antd"],
["component", {
libraryName: "test-module",
style: true,
}, "test-module"]
]
}
```
### Component directory structure
```
- lib // 'libDir'
- index.js // or custom 'root' relative path
- style.css // or custom 'style' relative path
- componentA
- index.js
- style.css
- componentB
- index.js
- style.css
```
### Theme library directory structure
```
- lib
- theme-default // 'styleLibraryName'
- base.css // required
- index.css // required
- componentA.css
- componentB.css
- theme-material
- ...
- componentA
- index.js
- componentB
- index.js
```
or
```
- lib
- theme-custom // 'styleLibrary.name'
- base.css // if styleLibrary.base true
- index.css // required
- componentA.css // default
- componentB.css
- theme-material
- componentA
-index.css // styleLibrary.path [module]/index.css
- componentB
-index.css
- componentA
- index.js
- componentB
- index.js
```
### options
- `["component"]`: import js modularly
- `["component", { "libraryName": "component" }]`: module name
- `["component", { "styleLibraryName": "theme_package" }]`: style module name
- `["component", { "styleLibraryName": "~independent_theme_package" }]`: Import a independent theme package
- `["component", { "styleLibrary": {} }]`: Import a independent theme package with more config
```
styleLibrary: {
"name": "xxx", // same with styleLibraryName
"base": true, // if theme package has a base.css
"path": "[module]/index.css", // the style path. e.g. module Alert => alert/index.css
"mixin": true // if theme-package not found css file, then use [libraryName]'s css file
}
```
- `["component", { "style": true }]`: import js and css from 'style.css'
- `["component", { "style": cssFilePath }]`: import style css from filePath
- `["component", { "libDir": "lib" }]`: lib directory
- `["component", { "root": "index" }]`: main file dir
- `["component", { "camel2Dash": false }]`: whether parse name to dash mode or not, default `true`