u-pull-refresh.vue 7.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332
  1. <template>
  2. <view
  3. class="u-pull-refresh"
  4. @touchstart="onTouchStart"
  5. @touchmove="onTouchMove"
  6. @touchend="onTouchEnd"
  7. @touchcancel="onTouchEnd"
  8. >
  9. <!-- 下拉刷新区域 -->
  10. <view
  11. class="refresh-area"
  12. :style="{ height: refreshDistance + 'px' }"
  13. :class="{ refreshing: isRefreshing }"
  14. >
  15. <!-- 不同状态的插槽 -->
  16. <slot
  17. v-if="refreshStatus === 'pull'"
  18. name="pull"
  19. :distance="refreshDistance"
  20. :threshold="threshold"
  21. >
  22. <!-- 默认下拉状态 -->
  23. <view class="refresh-content">
  24. <view class="refresh-indicator">
  25. <up-icon name="arrow-downward" size="26px"></up-icon>
  26. </view>
  27. <text class="refresh-text">下拉刷新</text>
  28. </view>
  29. </slot>
  30. <slot
  31. v-else-if="refreshStatus === 'release'"
  32. name="release"
  33. :distance="refreshDistance"
  34. :threshold="threshold"
  35. >
  36. <!-- 默认释放状态 -->
  37. <view class="refresh-content">
  38. <view class="refresh-indicator">
  39. <up-icon name="arrow-upward" size="26px"></up-icon>
  40. </view>
  41. <text class="refresh-text">释放刷新</text>
  42. </view>
  43. </slot>
  44. <slot
  45. v-else-if="refreshStatus === 'refreshing'"
  46. name="refreshing"
  47. >
  48. <!-- 默认刷新中状态 -->
  49. <view class="refresh-content">
  50. <view class="refresh-indicator">
  51. <view class="spinner"></view>
  52. </view>
  53. <text class="refresh-text">正在刷新...</text>
  54. </view>
  55. </slot>
  56. </view>
  57. <!-- 内容区域 -->
  58. <view
  59. class="refresh-content-wrapper"
  60. :style="{ transform: `translateY(${contentTranslateY}px)` }"
  61. >
  62. <scroll-view
  63. v-if="useScrollView"
  64. class="scroll-wrapper"
  65. :scroll-y="true"
  66. :enable-back-to-top="enableBackToTop"
  67. :scroll-top="scrollTop"
  68. :lower-threshold="lowerThreshold"
  69. @scroll="handleScroll"
  70. @scrolltolower="handleScrollToLower"
  71. >
  72. <slot></slot>
  73. <!-- 使用 u-loadmore 组件实现上拉加载更多 -->
  74. <u-loadmore
  75. v-if="showLoadmore"
  76. v-bind="loadmoreProps"
  77. />
  78. </scroll-view>
  79. <view v-else>
  80. <slot></slot>
  81. <!-- 使用 u-loadmore 组件实现上拉加载更多 -->
  82. <u-loadmore
  83. v-if="showLoadmore"
  84. v-bind="loadmoreProps"
  85. />
  86. </view>
  87. </view>
  88. </view>
  89. </template>
  90. <script>
  91. export default {
  92. name: 'u-pull-refresh',
  93. props: {
  94. // 是否正在刷新
  95. refreshing: {
  96. type: Boolean,
  97. default: false
  98. },
  99. // 下拉刷新阈值
  100. threshold: {
  101. type: Number,
  102. default: 80
  103. },
  104. // 阻尼系数
  105. damping: {
  106. type: Number,
  107. default: 0.4
  108. },
  109. // 最大下拉距离
  110. maxDistance: {
  111. type: Number,
  112. default: 120
  113. },
  114. // 是否显示加载更多
  115. showLoadmore: {
  116. type: Boolean,
  117. default: false
  118. },
  119. // u-loadmore 组件的 props 配置
  120. loadmoreProps: {
  121. type: Object,
  122. default: () => ({
  123. status: 'loadmore',
  124. loadmoreText: '加载更多',
  125. loadingText: '正在加载...',
  126. nomoreText: '没有更多了'
  127. })
  128. },
  129. // 是否使用 scroll-view 包装内容
  130. useScrollView: {
  131. type: Boolean,
  132. default: true
  133. },
  134. // scroll-view 相关属性
  135. enableBackToTop: {
  136. type: Boolean,
  137. default: false
  138. },
  139. lowerThreshold: {
  140. type: [Number, String],
  141. default: 50
  142. },
  143. scrollTop: {
  144. type: [Number, String],
  145. default: 0
  146. }
  147. },
  148. data() {
  149. return {
  150. // 下拉刷新相关
  151. isRefreshing: false,
  152. refreshStatus: 'pull', // pull, release, refreshing
  153. refreshDistance: 0,
  154. startY: 0,
  155. currentY: 0,
  156. touching: false,
  157. // 动画相关
  158. contentTranslateY: 0
  159. }
  160. },
  161. emits: ['refresh', 'loadmore', 'scroll'],
  162. watch: {
  163. refreshing: {
  164. handler(newVal) {
  165. if (!newVal) {
  166. this.finishRefresh()
  167. } else {
  168. this.startRefresh()
  169. }
  170. }
  171. }
  172. },
  173. methods: {
  174. // 触摸开始
  175. onTouchStart(e) {
  176. if (this.isRefreshing) return
  177. this.touching = true
  178. this.startY = e.touches[0].pageY
  179. this.currentY = this.startY
  180. this.refreshStatus = 'pull'
  181. },
  182. // 触摸移动
  183. onTouchMove(e) {
  184. if (!this.touching || this.isRefreshing) return
  185. this.currentY = e.touches[0].pageY
  186. const diff = this.currentY - this.startY
  187. // 只有在顶部且下拉时才触发下拉刷新
  188. if (diff > 0 && this.isScrollViewAtTop()) {
  189. this.refreshDistance = Math.min(diff * this.damping, this.maxDistance)
  190. this.contentTranslateY = this.refreshDistance
  191. // 更新状态
  192. if (this.refreshDistance >= this.threshold) {
  193. this.refreshStatus = 'release'
  194. } else {
  195. this.refreshStatus = 'pull'
  196. }
  197. // 阻止默认滚动行为,防止触发页面级滚动
  198. e.preventDefault()
  199. e.stopPropagation()
  200. }
  201. },
  202. // 触摸结束
  203. onTouchEnd() {
  204. if (!this.touching) return
  205. this.touching = false
  206. if (this.refreshDistance >= this.threshold && !this.isRefreshing) {
  207. // 触发刷新
  208. this.startRefresh()
  209. this.$emit('refresh')
  210. } else {
  211. // 回弹
  212. this.resetRefresh()
  213. }
  214. },
  215. // 开始刷新
  216. startRefresh() {
  217. this.isRefreshing = true
  218. this.refreshStatus = 'refreshing'
  219. this.refreshDistance = this.threshold
  220. this.contentTranslateY = this.threshold
  221. },
  222. // 完成刷新
  223. finishRefresh() {
  224. this.isRefreshing = false
  225. this.refreshStatus = 'pull'
  226. this.resetRefresh()
  227. },
  228. // 重置刷新状态
  229. resetRefresh() {
  230. this.refreshDistance = 0
  231. this.contentTranslateY = 0
  232. },
  233. // 检查 scroll-view 是否在顶部
  234. isScrollViewAtTop() {
  235. // 这里可以更精确地判断,但简单起见直接返回 true
  236. // 实际项目中可能需要通过 scroll 事件获取 scrollTop 判断
  237. return true
  238. },
  239. // 处理滚动事件
  240. handleScroll(e) {
  241. this.$emit('scroll', e)
  242. },
  243. // 处理滚动到底部事件
  244. handleScrollToLower(e) {
  245. // 只有当 loadmore 状态为 loadmore 时才触发
  246. if (this.showLoadmore && this.loadmoreProps.status === 'loadmore') {
  247. this.$emit('loadmore')
  248. }
  249. }
  250. }
  251. }
  252. </script>
  253. <style scoped lang="scss">
  254. .u-pull-refresh {
  255. position: relative;
  256. height: 100%;
  257. overflow: hidden;
  258. }
  259. .refresh-area {
  260. position: absolute;
  261. left: 0;
  262. right: 0;
  263. top: 0;
  264. display: flex;
  265. align-items: flex-end;
  266. justify-content: center;
  267. overflow: hidden;
  268. transition: height 0.2s ease-out;
  269. }
  270. .refresh-content-wrapper {
  271. height: 100%;
  272. transition: transform 0.2s ease-out;
  273. }
  274. .scroll-wrapper {
  275. height: 100%;
  276. }
  277. .refresh-content {
  278. display: flex;
  279. flex-direction: column;
  280. align-items: center;
  281. justify-content: center;
  282. width: 100%;
  283. padding-bottom: 10px;
  284. }
  285. .spinner {
  286. width: 16px;
  287. height: 16px;
  288. border: 2px solid #f3f3f3;
  289. border-top: 2px solid #666;
  290. border-radius: 50%;
  291. animation: spin 1s linear infinite;
  292. }
  293. @keyframes spin {
  294. 0% { transform: rotate(0deg); }
  295. 100% { transform: rotate(360deg); }
  296. }
  297. .refresh-text {
  298. font-size: 14px;
  299. color: #666;
  300. }
  301. </style>