feat(pull-down-refresh): support disabled props

src/pull-down-refresh/README.en-US.md

@@ -6,10 +6,12 @@
 
 name | type | default | description | required
 -- | -- | -- | -- | --
-header | Slot | - | `1.2.10` | N
+style | Object | - | CSS(Cascading Style Sheets) | N
+custom-style | Object | - | CSS(Cascading Style Sheets)，used to set style on virtual component | N
+disabled | Boolean | false | disabled pull down refresh | N
 enable-back-to-top | Boolean | true | `1.1.5` | N
 enable-passive | Boolean | false | `1.1.5` | N
-external-classes | Array | - | `['t-class', 't-class-loading','t-class-text', 't-class-indicator']` | N
+header | Slot | - | `1.2.10`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
 loading-bar-height | String / Number | 50 | \- | N
 loading-props | Object | - | Typescript：`LoadingProps`，[Loading API Documents](./loading?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/pull-down-refresh/type.ts) | N
 loading-texts | Array | [] | Typescript：`string[]` | N
@@ -27,15 +29,25 @@ default-value | Boolean | undefined | uncontrolled property | N
 name | params | description
 -- | -- | --
 change | `(value: boolean)` | \-
+dragend | `(scrollTop: number, scrollLeft: number)` | `1.2.10`
+dragging | `(scrollTop: number, scrollLeft: number)` | `1.2.10`
+dragstart | `(scrollTop: number, scrollLeft: number)` | `1.2.10`
 refresh | \- | \-
+scrolltolower | \- | \-
 timeout | \- | \-
-dragstart | `(scrollTop: number, scrollLeft: number)` | `1.2.10`
-dragging | `(scrollTop: number, scrollLeft: number)` | `1.2.10`
-dragend | `(scrollTop: number, scrollLeft: number)` | `1.2.10`
+
+### PullDownRefresh External Classes
+
+className | Description
+-- | --
+t-class | \-
+t-class-indicator | \-
+t-class-loading | \-
+t-class-text | \-
 
 ### CSS Variables
 
 The component provides the following CSS variables, which can be used to customize styles.
 Name | Default Value | Description
 -- | -- | --
---td-pull-down-refresh-color | @font-gray-3 | -
+--td-pull-down-refresh-color | @font-gray-3 | -

src/pull-down-refresh/README.md

@@ -31,11 +31,14 @@ isComponent: true
 
 ### PullDownRefresh Props
 
-名称 | 类型 | 默认值 | 说明 | 必传
+名称 | 类型 | 默认值 | 描述 | 必传
 -- | -- | -- | -- | --
-header | Slot | - | `1.2.10` | N
+style | Object | - | 样式 | N
+custom-style | Object | - | 样式，一般用于开启虚拟化组件节点场景 | N
+disabled | Boolean | false | 是否禁用下拉刷新 | N
 enable-back-to-top | Boolean | true | `1.1.5`。iOS点击顶部状态栏、安卓双击标题栏时，滚动条返回顶部，只支持竖向。自 2.27.3 版本开始，若非显式设置为 false，则在显示尺寸大于屏幕 90% 时自动开启 | N
 enable-passive | Boolean | false | `1.1.5`。开启 passive 特性，能优化一定的滚动性能 | N
+header | Slot | - | `1.2.10`。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
 loading-bar-height | String / Number | 50 | 加载中下拉高度，如果值为数字则单位是：'px' | N
 loading-props | Object | - | 加载loading样式。TS 类型：`LoadingProps`，[Loading API Documents](./loading?tab=api)。[详细类型定义](https://github.com/Tencent/tdesign-miniprogram/tree/develop/src/pull-down-refresh/type.ts) | N
 loading-texts | Array | [] | 提示语，组件内部默认值为 ['下拉刷新', '松手刷新', '正在刷新', '刷新完成']。TS 类型：`string[]` | N
@@ -53,24 +56,25 @@ default-value | Boolean | undefined | 组件状态，值为 `true` 表示下拉
 名称 | 参数 | 描述
 -- | -- | --
 change | `(value: boolean)` | 下拉或收起时触发，用户手势往下滑动触发下拉状态，手势松开触发收起状态
+dragend | `(scrollTop: number, scrollLeft: number)` | `1.2.10`。滑动结束事件
+dragging | `(scrollTop: number, scrollLeft: number)` | `1.2.10`。滑动事件
+dragstart | `(scrollTop: number, scrollLeft: number)` | `1.2.10`。滑动开始事件
 refresh | \- | 结束下拉时触发
+scrolltolower | \- | 滚动到页面底部时触发
 timeout | \- | 刷新超时触发
-dragstart | `(scrollTop: number, scrollLeft: number)` | `1.2.10`。滑动开始事件
-dragging | `(scrollTop: number, scrollLeft: number)` | `1.2.10`。滑动事件
-dragend | `(scrollTop: number, scrollLeft: number)` | `1.2.10`。滑动结束事件
 
 ### PullDownRefresh 外部样式类
 
-类名 | 说明
+类名 | 描述
 -- | --
 t-class | 根节点样式类
+t-class-indicator | 指示样式类
 t-class-loading | 加载样式类
 t-class-text | 文本样式类
-t-class-indicator | 指示样式类
 
 ### CSS 变量
 
 组件提供了下列 CSS 变量，可用于自定义样式。
 名称 | 默认值 | 描述
 -- | -- | --
---td-pull-down-refresh-color | @font-gray-3 | -
+--td-pull-down-refresh-color | @font-gray-3 | -

src/pull-down-refresh/props.ts

@@ -6,6 +6,11 @@
 
 import { TdPullDownRefreshProps } from './type';
 const props: TdPullDownRefreshProps = {
+  /** 是否禁用下拉刷新 */
+  disabled: {
+    type: Boolean,
+    value: false,
+  },
   /** iOS点击顶部状态栏、安卓双击标题栏时，滚动条返回顶部，只支持竖向。自 2.27.3 版本开始，若非显式设置为 false，则在显示尺寸大于屏幕 90% 时自动开启 */
   enableBackToTop: {
     type: Boolean,

src/pull-down-refresh/pull-down-refresh.ts

@@ -119,7 +119,7 @@ export default class PullDownRefresh extends SuperComponent {
       this.triggerEvent('scroll', { scrollTop });
     },
     onTouchStart(e: WechatMiniprogram.Component.TrivialInstance) {
-      if (this.isPulling || !this.data.enableToRefresh) return;
+      if (this.isPulling || !this.data.enableToRefresh || this.properties.disabled) return;
       const { touches } = e;
       if (touches.length !== 1) return;
       const { pageX, pageY } = touches[0];
@@ -130,7 +130,7 @@ export default class PullDownRefresh extends SuperComponent {
     },
 
     onTouchMove(e: WechatMiniprogram.Component.TrivialInstance) {
-      if (!this.startPoint) return;
+      if (!this.startPoint || this.properties.disabled) return;
 
       const { touches } = e;
 
@@ -145,7 +145,7 @@ export default class PullDownRefresh extends SuperComponent {
     },
 
     onTouchEnd(e: WechatMiniprogram.Component.TrivialInstance) {
-      if (!this.startPoint) return;
+      if (!this.startPoint || this.properties.disabled) return;
       const { changedTouches } = e;
       if (changedTouches.length !== 1) return;
       const { pageY } = changedTouches[0];
@@ -166,24 +166,28 @@ export default class PullDownRefresh extends SuperComponent {
     },
 
     onDragStart(e: WechatMiniprogram.ScrollViewDragStart) {
+      if (this.properties.disabled) return;
       const { scrollTop, scrollLeft } = e.detail;
 
       this.triggerEvent('dragstart', { scrollTop, scrollLeft });
     },
 
     onDragging(e: WechatMiniprogram.ScrollViewDragging) {
+      if (this.properties.disabled) return;
       const { scrollTop, scrollLeft } = e.detail;
 
       this.triggerEvent('dragging', { scrollTop, scrollLeft });
     },
 
     onDragEnd(e: WechatMiniprogram.ScrollViewDragEnd) {
+      if (this.properties.disabled) return;
       const { scrollTop, scrollLeft } = e.detail;
 
       this.triggerEvent('dragend', { scrollTop, scrollLeft });
     },
 
     doRefresh() {
+      if (this.properties.disabled) return;
       this.setData({
         barHeight: this.loadingBarHeight,
         refreshStatus: 2,

src/pull-down-refresh/type.ts

@@ -7,6 +7,14 @@
 import { LoadingProps } from '../loading/index';
 
 export interface TdPullDownRefreshProps {
+  /**
+   * 是否禁用下拉刷新
+   * @default false
+   */
+  disabled?: {
+    type: BooleanConstructor;
+    value?: boolean;
+  };
   /**
    * iOS点击顶部状态栏、安卓双击标题栏时，滚动条返回顶部，只支持竖向。自 2.27.3 版本开始，若非显式设置为 false，则在显示尺寸大于屏幕 90% 时自动开启
    * @default true