first commit

Author: weihongyu12

.gitignore

@@ -0,0 +1,22 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+

.idea/.gitignore

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+### Installation
+
+```
+$ yarn
+```
+
+### Local Development
+
+```
+$ yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```
+$ yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+### Deployment
+
+Using SSH:
+
+```
+$ USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```
+$ GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

.idea/miniprogram.iml

@@ -0,0 +1,154 @@
+---
+lang: zh-cmn-Hans-CN
+title: Cookbook
+---
+
+# Cookbook
+
+## 计算属性和侦听器
+
+如果代码中，存在依赖响应式状态的复杂逻辑，可以使用 **计算属性（computed）** 和 **侦听器（watch）** 简化代码。
+
+由于小程序本身不带计算属性（computed）和侦听器（watch）功能，需要通过 `miniprogram-computed` 引入相关的 behaviors，提供框架扩展支持。
+
+```js{1,5,12-19,21-28}
+import { behavior as computedBehavior } from 'miniprogram-computed';
+import otherBehavior from './behavior/otherBehavior';
+
+Component({
+  behaviors: [otherBehavior, computedBehavior],
+  data: {
+    a: 1,
+    b: 1,
+    pow: 0,
+  },
+
+  // 计算属性
+  computed: {
+    sum(data) {
+      // 注意： computed 函数中不能访问 this ，只有 data 对象可供访问
+      // 这个函数的返回值会被设置到 this.data.sum 字段中
+      return data.a + data.b + data.c // data.c 为自定义 behavior 数据段
+    },
+  },
+
+  // 侦听器
+  watch: {
+    'a, b': function (a, b) {
+      this.setData({
+        pow: a ** b,
+      })
+    },
+  },
+
+  methods: {
+    onTap() {
+      this.setData({
+        a: this.data.b,
+        b: this.data.a + this.data.b,
+      });
+    },
+  },
+});
+```
+
+## Lodash 的使用
+
+[Lodash](https://lodash.com/) 是一个 JS 工具库，可以在微信小程序中使用。
+
+使用 Lodash 时，由于小程序不提供全局环境，需要手动 polyfill。
+
+```js
+// utlis/lodash-miniprogram-polyfill.js
+
+global.Object = Object;
+global.Array = Array;
+global.DataView = DataView;
+global.Date = Date;
+global.Error = Error;
+global.Float32Array = Float32Array;
+global.Float64Array = Float64Array;
+global.Function = Function;
+global.Int8Array = Int8Array;
+global.Int16Array = Int16Array;
+global.Int32Array = Int32Array;
+global.Map = Map;
+global.Math = Math;
+global.Promise = Promise;
+global.RegExp = RegExp;
+global.Set = Set;
+global.String = String;
+global.Symbol = Symbol;
+global.TypeError = TypeError;
+global.Uint8Array = Uint8Array;
+global.Uint8ClampedArray = Uint8ClampedArray;
+global.Uint16Array = Uint16Array;
+global.Uint32Array = Uint32Array;
+global.WeakMap = WeakMap;
+global.clearTimeout = clearTimeout;
+/* eslint-disable-next-line no-restricted-properties */
+global.isFinite = Number.isFinite;
+global.parseInt = parseInt;
+global.setTimeout = setTimeout;
+```
+
+由于完整版的 Lodash 包非常大（构建后大概 400KB），并且微信小程序不支持 Tree-Shaking，因此不要使用全量版本的 Lodash
+
+**使用 Lodash 的[独立方法包](https://lodash.com/per-method-packages)**，可以有效减少包的体积。
+
+:::danger 反面例子 👎
+缺少必要的 polyfill
+
+```js
+import throttle from 'lodash.throttle';
+```
+
+使用全量的 lodash 包
+
+```js
+import './utils/lodash-miniprogram-polyfill';
+import { throttle } from 'lodash';
+```
+:::
+
+:::tip 正面例子 👍
+```js
+import './utils/lodash-miniprogram-polyfill';
+import throttle from 'lodash.throttle';
+```
+:::
+
+注意，在使用中，有部分方法不能使用箭头函数，否则会改变 `this` 的指向
+
+:::danger 反面例子 👎
+使用箭头函数，会改变 `this` 的指向。
+
+```js
+import './utils/lodash-miniprogram-polyfill';
+import throttle from 'lodash.throttle';
+
+Page({
+  onChange: throttle(() => {
+    // ...
+  }, 300),
+});
+```
+:::
+
+:::tip 正面例子 👍
+使用 `function` 函数，不会改变 `this` 的指向。
+
+```js
+import './utils/lodash-miniprogram-polyfill';
+import throttle from 'lodash.throttle';
+
+Page({
+  onChange: throttle(function () {
+    // ...
+  }, 300),
+});
+```
+:::
+
+
+

.idea/modules.xml

@@ -0,0 +1,91 @@
+---
+lang: zh-cmn-Hans-CN
+title: 部署
+---
+
+# 部署
+
+:::tip
+小程序的上传和发布推荐使用 [MiniProgram CI](https://developers.weixin.qq.com/miniprogram/dev/devtools/ci.html)。
+:::
+
+## 命令行配置
+
+```json
+{
+  "scripts": {
+    "build": "node scripts/build.js",
+    "deploy": "node scripts/deploy.js"
+  },
+  "devDependencies": {
+    "miniprogram-ci": "^1.8.35"
+  }
+}
+```
+
+```bash
+# 构建 npm
+npm run build
+
+# 上传代码
+npm run deploy
+```
+
+## 构建 npm
+
+```js
+// scripts/build.js
+
+const path = require('path');
+const ci = require('miniprogram-ci');
+
+(async () => {
+  const packResult = await ci.packNpmManually({
+    packageJsonPath: path.join(__dirname, '../package.json'),
+    miniprogramNpmDistDir: path.join(__dirname, '../src/'),
+    ignores: [],
+  });
+
+  console.log('pack done, packResult:', packResult);
+})();
+```
+
+## 上传代码
+
+```js
+// scripts/deploy.js
+
+const path = require('path');
+const ci = require('miniprogram-ci');
+
+(async () => {
+  const project = new ci.Project({
+    appid: '<YOUR_APPID>',
+    projectPath: path.join(__dirname, '../'),
+    privateKeyPath: '<YOUR_PROJECT_KEY>',
+    type: 'miniProgram',
+    ignores: ['node_modules/**/*'],
+  });
+
+  const uploadResult = await ci.upload({
+    project,
+    version: '<VERSION>',
+    desc: '修复了一些已知问题',
+    setting: {
+      es6: true,
+      es7: true,
+      disableUseStrict: false,
+      minify: true,
+      codeProtect: true,
+      autoPrefixWXSS: true,
+    },
+    onProgressUpdate: console.log,
+  });
+
+  console.log(uploadResult);
+})();
+```
+
+:::tip
+上传密钥可以在 “[微信公众平台](https://mp.weixin.qq.com/) - 开发 - 开发设置” 获取，并建议设置上传白名单 IP
+:::