Glsx-applet-component NPM

miniprogram-custom-component

使用之前

使用 glsx-applet-components Weapp 前，请确保你已经学习过微信官方的小程序简易教程和自定义组件介绍。

安装

方式一. 通过 npm 安装 (推荐)

小程序已经支持使用 npm 安装第三方包，详见 npm 支持

# 通过 npm 安装
npm i glsx-applet-component --S
# 通过 yarn 安装
yarn add glsx-applet-component --production
# 安装 0.x 版本
npm i glsx-applet-component -S --production

### 方式二. 下载代码

直接通过 git 下载 glsx-applet-component Weapp 源代码，并将 `dist` 目录拷贝到自己的项目中。

## 使用组件

以按钮组件为例，只需要在 json 文件中引入按钮对应的自定义组件即可

```json
{
  "usingComponents": {
    "gl-button": "/path/to/glsx-applet-component/button/index"
  }
}

接着就可以在 wxml 中直接使用组件

<gl-button type="primary">按钮</gl-button>

## 在开发者工具中预览

```bash
# 安装项目依赖
npm install
# 执行组件编译
npm run dev

小程序自定义组件开发模板：

支持使用 less 语法编写 wxss 文件
使用 webpack 构建 js
支持自定义组件单元测试
支持 eslint
支持多入口构建

使用

使用命令行工具进行初始化
直接从 github 上 clone 下来

开发

安装依赖：

npm install

执行命令：

npm run dev

默认会在包根目录下生成 miniprogram_dev 目录，src 中的源代码会被构建并生成到 miniprogram_dev/components 目录下。如果需要监听文件变化动态构建，则可以执行命令：

npm run watch

ps: 如果 minirpogram_dev 目录下已存在小程序 demo，执行npm run dev则不会再将 tools 下的 demo 拷贝到此目录下。而执行npm run watch则会监听 tools 目录下的 demo 变动并进行拷贝。

生成的 miniprogram_dev 目录是一个小程序项目目录，以此目录作为小程序项目目录在开发者工具中打开即可查看自定义组件被使用的效果。
进阶：

如果有额外的构建需求，可自行修改 tools 目录中的构建脚本。
内置支持 webpack、less 语法、sourcemap 等功能，默认关闭。如若需要可以自行修改 tools/config.js 配置文件中相关配置。
内置支持多入口构建，如若需要可自行调整 tools/config.js 配置文件的 entry 字段。
默认开启 eslint，可自行调整规则或在 tools/config.js 中注释掉 eslint-loader 行来关闭此功能。

发布

ps: 发布前得确保已经执行构建，小程序 npm 包只有构建出来的目录是真正被使用到的。

如果还没有 npm 帐号，可以到 npm 官网注册一个 npm 帐号。
在本地登录 npm 帐号，在本地执行：

npm adduser

或者

npm login

npm publish

到此，npm 包就成功发布到 npm 平台了。

PS：一些开发者在开发过程中可能修改过 npm 的源，所以当进行登录或发布时需要注意要将源切回 npm 的源。

目录结构

以下为推荐使用的目录结构，如果有必要开发者也可以自行做一些调整:

|--miniprogram_dev // 开发环境构建目录
|--miniprogram_dist // 生产环境构建目录
|--src // 源码
|   |--components // 通用自定义组件
|   |--images // 图片资源
|   |
|   |--xxx.js/xxx.wxml/xxx.json/xxx.wxss // 暴露的 js 模块/自定义组件入口文件
|
|--test // 测试用例
|--tools // 构建相关代码
|   |--demo // demo 小程序目录，开发环境下会被拷贝生成到 miniprogram_dev 目录中
|   |--config.js // 构建相关配置文件
|
|--gulpfile.js