babel-plugin-import-less

This plugin is used for import module on demand loading.

README: English | 简体中文

Install

npm install -D babel-plugin-import-less

Usage

Use for lodash

babel.config.js

var plugins = [
    ['babel-plugin-import-less', {
        library: 'lodash',
        module: '[little-camel]'
    }]
];

app.js

import { indexOf } from 'lodash';
indexOf([1, 2, 3], 2);
        ↓
var _indexOf = require('lodash/indexOf');
_indexOf([1, 2, 3], 2);

Use for antd

babel.config.js

var plugins = [
    ['babel-plugin-import-less', {
        library: 'antd',
        // import module
        module: 'es/[dash]',        // use ES module for tree shaking
        // or
        module: 'lib/[dash]',       // use commonjs module
        // import style
        style: 'style',             // use less style for custom theme
        // or
        style: 'style/css'          // use css style
    }]
];

app.jsx

import { Button } from 'antd';
ReactDOM.render(<Button>xxxx</Button>);
        ↓
// module: 'es/[dash]'
var _button = require('antd/es/button');
// module: 'lib/[dash]'
var _button = require('antd/lib/button');
// style: 'style'
require('antd/lib/button/style');               // import less style
// style: 'style/css'
require('antd/lib/button/style/css');           // import css style
ReactDOM.render(<_button>xxxx</_button>);

Use for antd-mobile

babel.config.js

var plugins = [
    ['babel-plugin-import-less', {
        library: 'antd-mobile',
        // import module
        module: 'es/[dash]',        // use ES module for tree shaking
        // or
        module: 'lib/[dash]',       // use commonjs module
        // import style
        style: 'style',             // use less style for custom theme
        // or
        style: 'style/css'          // use css style
    }]
];

app.jsx

import { Button } from 'antd-mobile';
ReactDOM.render(<Button>xxxx</Button>);
        ↓
// module: 'es/[dash]'
var _button = require('antd-mobile/es/button');
// module: 'lib/[dash]'
var _button = require('antd-mobile/lib/button');
// style: 'style'
require('antd-mobile/lib/button/style');
// style: 'style/css'
require('antd-mobile/lib/button/style/css');
ReactDOM.render(<_button>xxxx</_button>);

Use for @material-ui/core

babel.config.js

var plugins = [
    ['babel-plugin-import-less', {
        library: '@material-ui/core',
        module: '[big-camel]'
    }]
];

app.jsx

import { Button } from '@material-ui/core';
ReactDOM.render(<Button>xxxx</Button>);
        ↓
var _button = require('@material-ui/core/Button');
ReactDOM.render(<_button>xxxx</_button>);

Use for reactstrap

babel.config.js

var plugins = [
    ['babel-plugin-import-less', {
        library: 'reactstrap',
        module: 'lib/[big-camel]'
    }]
];

app.jsx

import { Button } from 'reactstrap';
ReactDOM.render(<Button>xxxx</Button>);
        ↓
var _button = require('reactstrap/lib/Button');
ReactDOM.render(<_button>xxxx</_button>);

Use multiple plugins

babel.config.js

var plugins = [
    ['babel-plugin-import-less', {
        library: 'lodash',
        module: '[little-camel]'
    }, 'lodash'],                   // need a plugin name 'lodash'
    ['babel-plugin-import-less', {
        library: 'antd',
        module: 'es/[dash]',
        style: 'style'
    }, 'antd']                      // need a plugin name 'antd'
];

Template

The following substitutions are available in module and style template strings.

Template	Example
[little-camel]	componentName
[big-camel]	ComponentName
[dash]	component-name
[underline]	component_name

Options

{
    library,
    importDefault,
    module,
    style
}

library

Library name. Suport String, required.

importDefault

Transform import type to default, false means addNamed. Boolean, default to true.

// true
import Button from 'xxx/lib/button';
// false
import { Button } from 'xxx/lib/button';

module

Import module path. Suport string and function type, required.
function return value also suport template string. return null or false won't import module.

var plugins = [
    ['babel-plugin-import-less', {
        library: 'xxx',
        module: name => `lib/${name === 'MyButton' ? 'myButton' : '[little-camel]'}`,
    }]
];

style

Import style path with module. Suport string, function and array type.
function return value also suport template string. return null or false won't import module.
NOTE: if start with '/' then style path will append to library path otherwise append to module path.

style start with "/":

['babel-plugin-import-less', {
    library: 'xxx',
    module: 'lib/[dash]',
    style: '/less/[little-camel]'
}]
 
import { DateTime } from 'xxx';
        ↓
var _button = require('xxx/lib/date-time');
 
require('xxx/less/dateTime');

style to upper path:

['babel-plugin-import-less', {
    library: 'xxx',
    module: 'lib/[dash]',
    style: '../less/[little-camel]'
}]
 
import { DateTime } from 'xxx';
        ↓
var _button = require('xxx/lib/date-time');
require('xxx/lib/less/dateTime');