@tarojs/taro-h5 3.3.20 → 3.4.0-beta.3

package/dist/api/utils/handler.js

@@ -30,10 +30,18 @@ export class CallbackManager {
     constructor() {
         this.callbacks = [];
     }
+    /**
+     * 添加回调
+     * @param {{ callback: function, ctx: any } | function} opt
+     */
     add(opt) {
         if (opt)
             this.callbacks.push(opt);
     }
+    /**
+     * 移除回调
+     * @param {{ callback: function, ctx: any } | function} opt
+     */
     remove(opt) {
         if (opt) {
             let pos = -1;
@@ -47,9 +55,17 @@ export class CallbackManager {
             }
         }
     }
+    /**
+     * 获取回调函数数量
+     * @return {number}
+     */
     count() {
         return this.callbacks.length;
     }
+    /**
+     * 触发回调
+     * @param  {...any} args 回调的调用参数
+     */
     trigger(...args) {
         this.callbacks.forEach(opt => {
             if (typeof opt === 'function') {

package/dist/api/utils/index.js

@@ -1,3 +1,4 @@
+/* eslint-disable prefer-promise-reject-errors */
 import { Current, container, SERVICE_IDENTIFIER } from '@tarojs/runtime';
 export function shouldBeObject(target) {
     if (target && typeof target === 'object')
@@ -105,6 +106,7 @@ export const isValidColor = (color) => {
     return VALID_COLOR_REG.test(color);
 };
 export function processOpenApi(apiName, defaultOptions, formatResult = res => res, formatParams = options => options) {
+    // @ts-ignore
     if (!window.wx) {
         return weixinCorpSupport(apiName);
     }
@@ -124,11 +126,16 @@ export function processOpenApi(apiName, defaultOptions, formatResult = res => re
                     }
                 };
             });
+            // @ts-ignore
             wx[apiName](formatParams(obj));
         });
         return p;
     };
 }
+/**
+ * ease-in-out的函数
+ * @param t 0-1的数字
+ */
 export const easeInOut = (t) => t < 0.5 ? 4 * t * t * t : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1;
 export const getTimingFunc = (easeFunc, frameCnt) => {
     return x => {

package/dist/api/worker/index.js

@@ -1,2 +1,3 @@
 import { temporarilyNotSupport } from '../utils';
+// Worker
 export const createWorker = temporarilyNotSupport('createWorker');

package/dist/api/wxml/selectorQuery.js

@@ -25,6 +25,8 @@ function filter(fields, dom, selector) {
             }
         }
         else {
+            // TODO https://developers.weixin.qq.com/miniprogram/dev/component/scroll-view.html
+            // if (/^taro-scroll-view-core/i.test(tagName))
             res.nodeCanvasType = '';
             res.node = dom;
         }
@@ -33,6 +35,7 @@ function filter(fields, dom, selector) {
     if (context) {
         const tagName = dom.tagName;
         if (/^taro-video-core/i.test(tagName)) {
+            // TODO HTMLVideoElement to VideoContext
             return { context: dom };
         }
         else if (/^taro-canvas-core/i.test(tagName)) {
@@ -104,14 +107,22 @@ function filter(fields, dom, selector) {
     }
     return res;
 }
+/**
+ * WXML节点信息API
+ * @return {Object} SelectorQuery 对象实例
+ */
 function queryBat(queue, cb) {
     const result = [];
     queue.forEach(item => {
         var _a;
         const { selector, single, fields, component } = item;
+        // selector 的容器节点
+        /* eslint-disable */
         const container = (component !== null ?
             (findDOM(component) || document) :
             document);
+        /* eslint-enable */
+        // 特殊处理 ---- 选自己
         let selectSelf = false;
         if (container !== document) {
             const $nodeList = (_a = container.parentNode) === null || _a === void 0 ? void 0 : _a.querySelectorAll(selector);
@@ -153,11 +164,13 @@ export class SelectorQuery {
         return this;
     }
     select(selector) {
+        // 小程序里跨自定义组件的后代选择器 '>>>' 在 h5 替换为普通后代选择器 '>'
         if (typeof selector === 'string')
             selector = selector.replace('>>>', '>');
         return new NodesRef(selector, this, true);
     }
     selectAll(selector) {
+        // 小程序里跨自定义组件的后代选择器 '>>>' 在 h5 替换为普通后代选择器 '>'
         if (typeof selector === 'string')
             selector = selector.replace('>>>', '>');
         return new NodesRef(selector, this, false);