沒有發佈過npm包的同學,可能會對NPM對開發有一種蜜汁敬畏,覺得這是一個很高大上的東西。甚至有次面試,面試官問我有沒有發過npm包,當時只用過還沒寫過,我想應該挺難的,就小聲說了沒有,然後就讓我回去了o(╯□╰)o。
其實,在現在的我看來,npm包就是一個我們平時經常寫的一個export出來的模塊而已,只不過跟其它業務代碼耦合性低,具有較高的獨立性。
當然,要發佈一個npm包,除了寫的模塊組件外,還需要做一些基礎的包裝工作。
下面我就以最近開發的react-loading組件爲例
源碼地址,如果對你有幫助的話希望不要吝嗇你的 Star
本文主要記錄一下如何開發react組件(以react-loding爲例),並在 npm 上發佈。廢話不多說,進入正題
創建組件
新建項目倉庫並初始化
在github上新建一個倉庫,名字可以自己取。確保你創建的組件名稱沒有在 npm 上被使用過, 這裏我們用 wsm-loading作爲示例。打開編輯器將項目拉到自己本地並初始化
git clone https://github.com/xxx/wsm-loading.git
cd wsm-loading
npm init
運行npm init問題提示列表可以根據自己的個人愛好填寫,也可以採取默認的選項。
安裝項目的依賴
我麼需要開發的是一個React的loading組件,所以我們要先在項目中安裝react依賴
npm i react react-dom -D
我們的項目將通過webpack4進行構建,安裝項目所需的webpack依賴
npm i webpack webpack-cli webpack-dev-server html-webpack-plugin style-loader css-loader babel-core babel-loader babel-preset-env babel-preset-react -D
在項目中我們經常會用到scss作爲css的編譯,因此我們在安裝webpack
npm install sass sass-loader node-sass webpack -D
這時上面安裝的依賴已經被添加到根目錄下的 package.json中了,接下來我們添加一個 start的腳本,用於啓動我們本地開發的服務器, start如下:
{
"name": "wsm-loading",
"version": "0.0.1",
"description": "這是一個react-loading組件",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"start": "webpack-dev-server --mode development",
},
開發loading組件
現在讓在我們的項目中創建組件和示例代碼目錄,目錄樹結構如下
├── examples // 示例代碼存放目錄
│ └── src
├── node_modules
├── package.json
└── src // 組件源代碼和樣式存放目錄
└── .babelrc // es6及jsx語法編譯
└── .gitignore // git提交管理
└── package-lock.json
└── package.json
└── webpack.config.js webpack配置
lodaing組件接收兩個props,一個size控制loading的大小,一個color控制loading的顏色
/*** src/index.js ***/
import React, { Component } from "react";
import "./index.scss";
export default class MyComponent extends Component {
render() {
const { color, size } = this.props;
const sizeStyle = {
width: `${size}px`,
height: `${size}px`
};
const colorStyle = {
border: `1px solid ${color}`,
borderColor: `${color} transparent transparent transparent`
};
const ringStyle = Object.assign({}, colorStyle, sizeStyle);
return (
<div className="loading" style={sizeStyle}>
<div className="loading__ring" style={ringStyle} />
<div className="loading__ring" style={ringStyle} />
<div className="loading__ring" style={ringStyle} />
</div>
);
}
}
MyComponent.defaultProps = {
size: '36',
color: '#000'
}
loading組件的樣式這裏就不給了,可以直接從我的代碼庫中複製到你的項目裏css。
接下來我們添加一個演示demo
<!-- examples/src/index.html -->
<html>
<head>
<title>My Component Demo</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
</head>
<body>
<div id="root"></div>
</body>
</html>
/*** examples/src/index.js ***/
import React from 'react';
import { render} from 'react-dom';
import MyComponent from '../../src';
const App = () => (
<MyComponent size='36' color='red' />
);
render(<App />, document.getElementById("root"));
loading組件優化
以上就完成了一個基本的loading組件,但是我們還有一個疑問,就是現在引入的loading是在類名爲root的元素之中,而一些被廣泛使用的UI框架中的loading組件確實在body層,無論你在哪裏引入,這樣就可以防止loading組件受到父組件的樣式的干擾。
我們平時普通的組件的html結構如上圖,可見我們的loading是嵌套在我們的主體root元素中的。在仔細看下面這張圖。
想要實現這種效果,我們必須得先了解React自帶的特性:Portals(傳送門)。這個特性是在16版本之後添加的。
我們哎src目錄下新建一個newPortal/newPortal.js文件
import React from 'react';
import ReactDOM from 'react-dom';
class NewPortal extends React.Component {
constructor(props) {
super(props)
this.node = document.createElement('div');
document.body.appendChild(this.node);
}
render() {
const { children } = this.props;
return ReactDOM.createPortal(
children,
this.node,
);
}
}
export default NewPortal
將其引入到我們的loading組件中
import NewPortal from './newPortal/newPortal'
並對組件進行一層包裹
<NewPortal>
<div className="loading" style={sizeStyle}>
<div className="loading__ring" style={ringStyle} />
<div className="loading__ring" style={ringStyle} />
<div className="loading__ring" style={ringStyle} />
</div>
</NewPortal>
這裏作者是參考這篇文章對組件進行優化的。大家感興趣可以去了解下。
配置webpack
接下來配置 webpack, 在項目根路徑下創建 webpack.config.js文件。關於webpack配置不太瞭解或不熟悉的可以參考我之前之篇文章webpack詳細配置,這裏講不在一一講解。
const path = require("path");
const HtmlWebpackPlugin = require("html-webpack-plugin");
const htmlWebpackPlugin = new HtmlWebpackPlugin({
template: path.join(__dirname, "examples/src/index.html"),
filename: "./index.html"
});
module.exports = {
entry: path.join(__dirname, "examples/src/index.js"),
output: {
path: path.join(__dirname, "examples/dist"),
filename: "bundle.js"
},
module: {
rules: [
{
test: /\.(js|jsx)$/,
use: "babel-loader",
exclude: /node_modules/
},
{
test: /\.css$/,
use: ["style-loader", "css-loader"]
},
{
test: /\.scss$/,
use: ["style-loader", "css-loader", "sass-loader"]
}
]
},
plugins: [htmlWebpackPlugin],
resolve: {
extensions: [".js", ".jsx"]
},
devServer: {
port: 3001
}
};
配置babelrc
最後需要指定 Babel 需要對哪些文件進行編譯,毫無疑問 React 中使用的 JSX 文件需要被編譯,讓它轉換成被主流瀏覽器都支持的 ES5 ,通用的配置也很簡單,只需要添加一對 presets,在項目根目錄下添加文件.babelrc
{
"presets": ["env", "react"]
}
接下來運行 demo
npm start
啓動完成後打開瀏覽器輸入 http://localhost:3001,你將會在頁面上看到你寫的組件,你可以修改你的代碼並保存,頁面將會自動刷新,我們的開發環境已經處於監控模式
發佈到npm上
我們要發佈被 babel 編譯且被壓縮後的版本,要讓沒有使用 babel 的項目也能夠正常的使用,比如不能出現 JSX 語法。
首先需要安裝 babel cli
npm i babel-cli -D
現在我們添加 transpile腳本,以便使用 Babel 編譯我們的源代碼,同時拷貝一些靜態文件(如:css 文件)到目標打包目錄dist下
同時指定被編譯後的版本爲組件的主入口,更改後的 package.json如下
{
"name": "test",
"version": "1.0.0",
"description": "ceshi",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"start": "webpack-dev-server --mode development",
"transpile": "babel src -d dist --copy-files"
},
嘗試編譯
npm run transpile
最後讓我們在項目的根目錄下添加.npmignore文件,告訴 npm,我們項目中哪些文件和文件夾是在發佈的包中被忽略掉的
# .npmignore
src
examples
.babelrc
.gitignore
webpack.config.js
發佈我們的組件到 npm 上
npm publish
提交npm之前需要去npm上開通自己的賬號,並驗證郵箱,這樣才能正常的提交上去。在終端使用npm login登陸自己的信息
將代碼上傳到git
項目上傳到git之前,我們需要配置下.gitignore,在項目的根目錄下添加.npmignore文件
# .gitignore
node_modules
dist
這樣我們上傳時,不會上傳node_modules和dist的目錄
git add .
git commit -m 'react-loading組件'
git push
後語
當我們不停的陷於業務代碼的開發中,何不嘗抽出一點時間來做點自己喜歡做的事呢,比如將自己的業務組件抽出來做成一個npm,開源組件庫不僅可以提高自己還能接觸到原來接觸不到東西。這只是一個簡單的教程,希望能對你有所啓發。
感謝你的閱讀!