xt-element-ui 2.2.3 → 2.2.4

package/src/components/xt-date-picker/style/index.scss

@@ -1,62 +1,89 @@
 
 @import '../../../styles/variables.scss';
 .xt-date-picker-container {
-    display: inline-block;
-    width: 100%;
-    --xt-input-height: 32px;
-  }
-  .xt-date .el-date-editor .el-input__inner {
-    background-color: var(--xt-fill-color-blank);
-    border-color: var(--xt-border-color);
-    color: var(--xt-text-color-regular);
-    font-size: var(--xt-font-size-base, 14px);
-    border-radius: var(--xt-border-radius-small, 4px);
-    height: var(--xt-input-height);
-    line-height: var(--xt-input-height);
-    padding: 0 30px;
-}
-  .xt-date-dimension {
-    margin-bottom: 8px;
-  }
+  display: inline-block;
+  width: 100%;
+  --xt-input-height: 32px;
+}
+.xt-date .el-date-editor .el-input__inner {
+  background-color: var(--xt-fill-color-blank);
+  border-color: var(--xt-border-color);
+  color: var(--xt-text-color-regular);
+  font-size: var(--xt-font-size-base, 14px);
+  border-radius: var(--xt-border-radius-small, 4px);
+  height: var(--xt-input-height);
+  line-height: var(--xt-input-height);
+  padding: 0 30px;
+}
+.xt-date-dimension {
+  margin-bottom: 8px;
+}
+
+.xt-date-picker-wrapper {
+  display: inline-block;
+}
   
-  .xt-date-picker-wrapper {
-    display: inline-block;
+
+
+
+.quarter-panel {
+  padding: 10px;
+
+  .quarter-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 10px;
   }
-  
 
+  .quarter-list {
+    display: grid;
+    grid-template-columns: repeat(2, 1fr);
+    gap: 8px;
+  }
 
+  .quarter-item {
+    text-align: center;
+    padding: 8px 0;
+    border: 1px solid #e4e7ed;
+    border-radius: 4px;
+    cursor: pointer;
+  }
 
-  .quarter-panel {
-    padding: 10px;
-  
-    .quarter-header {
-      display: flex;
-      align-items: center;
-      justify-content: space-between;
-      margin-bottom: 10px;
-    }
-  
-    .quarter-list {
-      display: grid;
-      grid-template-columns: repeat(2, 1fr);
-      gap: 8px;
-    }
-  
-    .quarter-item {
-      text-align: center;
-      padding: 8px 0;
-      border: 1px solid #e4e7ed;
-      border-radius: 4px;
-      cursor: pointer;
-    }
-  
-    .quarter-item.active {
-      background: #409eff;
-      color: #fff;
-      border-color: #409eff;
-    }
+  .quarter-item.active {
+    background: #409eff;
+    color: #fff;
+    border-color: #409eff;
+  }
+
+  ::v-deep .base-date-popper {
+    border-radius: 4px;
+  }
+}
   
-    ::v-deep .base-date-popper {
-      border-radius: 4px;
-    }
-  }
+.range-picker {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 8px;
+  width: 100%;
+}
+.range-picker .el-date-editor {
+  flex: 1;
+  min-width: 130px;
+}
+.split {
+  flex-shrink: 0;
+  padding: 0 4px;
+}
+/* 手机/窄侧边栏自动竖向排列 */
+@media (max-width: 360px) {
+  .range-picker {
+    flex-direction: column;
+    align-items: stretch;
+  }
+  .split {
+    text-align: center;
+    margin: 4px 0;
+  }
+}

package/src/components/xt-list/index.vue

@@ -30,10 +30,10 @@
       </div>
     </div>
 
-    <!-- 主体区域 -->
-    <div
+    <!-- 主体区域：使用 xt-scroll 作为滚动容器 -->
+    <xt-scroll
       ref="scrollContainer"
-      class="xt-list__body"
+      :class="['xt-list__body', { 'xt-list__body--virtual': virtualScroll }]"
       :style="bodyStyle"
       @scroll="onScroll"
     >
@@ -184,7 +184,7 @@
           {{ loadMoreText }}
         </el-button>
       </div>
-    </div>
+    </xt-scroll>
 
     <!-- 加载状态 -->
     <div v-if="loading" class="xt-list__loading">
@@ -212,12 +212,18 @@
 </template>
 
 <script>
+import XtScroll from '../xt-scroll'
+
 const CARD_ITEM_HEIGHT = 160
 const GROUP_HEADER_HEIGHT = 44
 
 export default {
   name: 'XtList',
 
+  components: {
+    XtScroll
+  },
+
   props: {
     data: { type: Array, default: () => [] },
     // 分组配置
@@ -547,9 +553,10 @@ export default {
       return group._items.indexOf(item)
     },
 
-    onScroll() {
+    onScroll(e) {
       if (!this.virtualScroll) return
-      this.scrollTop = this.$refs.scrollContainer.scrollTop
+      // xt-scroll 传递的是 { scrollTop, scrollLeft } 对象
+      this.scrollTop = e && e.scrollTop != null ? e.scrollTop : 0
       if (this.rafId) return
       if (typeof requestAnimationFrame === 'undefined') return
       this.rafId = requestAnimationFrame(() => {
@@ -560,18 +567,22 @@ export default {
 
     updateContainerHeight() {
       if (this.$refs.scrollContainer) {
-        this.containerHeight = this.$refs.scrollContainer.clientHeight
+        const scrollCmp = this.$refs.scrollContainer
+        const wrap = scrollCmp.getScrollContainer && scrollCmp.getScrollContainer()
+        this.containerHeight = wrap ? wrap.clientHeight : 0
       }
     },
 
     bindResizeObserver() {
       if (typeof ResizeObserver === 'undefined') return
-      const container = this.$refs.scrollContainer
-      if (!container) return
+      const scrollCmp = this.$refs.scrollContainer
+      if (!scrollCmp) return
+      const wrap = scrollCmp.getScrollContainer && scrollCmp.getScrollContainer()
+      if (!wrap) return
       this.resizeObserver = new ResizeObserver(() => {
         this.updateContainerHeight()
       })
-      this.resizeObserver.observe(container)
+      this.resizeObserver.observe(wrap)
     },
 
     unbindResizeObserver() {
@@ -611,8 +622,8 @@ export default {
 
     // ========== 对外暴露方法 ==========
     scrollToTop() {
-      if (this.$refs.scrollContainer) {
-        this.$refs.scrollContainer.scrollTo({ top: 0, behavior: 'smooth' })
+      if (this.$refs.scrollContainer && this.$refs.scrollContainer.scrollToStart) {
+        this.$refs.scrollContainer.scrollToStart()
       }
     },
 

package/src/components/xt-scroll/index.js

@@ -0,0 +1,9 @@
+import './style/index.scss'
+import XtScroll from './index.vue'
+
+XtScroll.install = function (Vue) {
+  Vue.component(XtScroll.name, XtScroll)
+}
+
+export default XtScroll
+export { XtScroll }

package/src/components/xt-scroll/index.vue

@@ -0,0 +1,363 @@
+<template>
+  <div class="xt-scroll" :class="[`xt-scroll--${scrollDirection}`]" :style="containerStyle">
+    <!-- 原生滚动容器 -->
+    <div
+      ref="scrollWrap"
+      class="xt-scroll__wrap"
+      :class="[`xt-scroll__wrap--${scrollDirection}`]"
+      @scroll="onScroll"
+    >
+      <!-- 虚拟滚动模式 -->
+      <div v-if="vScroll" class="xt-scroll__virtual" :style="virtualWrapperStyle">
+        <!-- 虚拟滚动 phantom -->
+        <div
+          v-if="scrollDirection === 'vertical'"
+          class="xt-scroll__phantom"
+          :style="{ height: totalSize + 'px' }"
+        >
+          <div :style="{ transform: `translateY(${offsetStart}px)` }">
+            <template v-for="(item, index) in visibleData">
+              <div
+                :key="getItemKey(item, index)"
+                class="xt-scroll__item"
+                :style="itemStyle"
+                :class="itemClassName"
+              >
+                <slot name="item" :item="item" :index="getOriginalIndex(index)">
+                  {{ item }}
+                </slot>
+              </div>
+            </template>
+          </div>
+        </div>
+
+        <!-- 横向虚拟滚动 phantom -->
+        <div
+          v-else-if="scrollDirection === 'horizontal'"
+          class="xt-scroll__phantom"
+          :style="{ width: totalSize + 'px' }"
+        >
+          <div :style="{ transform: `translateX(${offsetStart}px)` }">
+            <template v-for="(item, index) in visibleData">
+              <div
+                :key="getItemKey(item, index)"
+                class="xt-scroll__item"
+                :style="itemStyle"
+                :class="itemClassName"
+              >
+                <slot name="item" :item="item" :index="getOriginalIndex(index)">
+                  {{ item }}
+                </slot>
+              </div>
+            </template>
+          </div>
+        </div>
+      </div>
+
+      <!-- 空状态 -->
+      <div v-if="vScroll && (!data || !data.length) && !loading" class="xt-scroll__empty">
+        <slot name="empty">
+          <span>{{ emptyText }}</span>
+        </slot>
+      </div>
+
+      <!-- 加载状态 -->
+      <div v-if="loading" class="xt-scroll__loading">
+        <slot name="loading">
+          <i class="el-icon-loading"></i>
+          <span>加载中...</span>
+        </slot>
+      </div>
+
+      <!-- 非虚拟滚动模式：默认插槽 -->
+      <div v-if="!vScroll" class="xt-scroll__default">
+        <slot></slot>
+      </div>
+
+      <!-- 触底/触顶加载更多 -->
+      <div v-if="vScroll && showLoadMore && !loading" class="xt-scroll__loadmore" @click="onLoadMore">
+        <el-button type="text" :loading="loadMoreLoading">
+          {{ loadMoreText }}
+        </el-button>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script>
+export default {
+  name: 'XtScroll',
+
+  props: {
+    // ========== 虚拟滚动配置 ==========
+    /** 是否启用虚拟滚动 */
+    vScroll: { type: Boolean, default: false },
+    /** 数据源 */
+    data: { type: Array, default: () => [] },
+    /** 每个 item 的固定尺寸（px），纵向为高度，横向为宽度 */
+    itemSize: { type: Number, default: 50 },
+    /** item 的唯一键字段名 */
+    keyField: { type: String, default: 'id' },
+    /** 预渲染缓冲区大小（item 数量） */
+    bufferSize: { type: Number, default: 5 },
+    /** 虚拟滚动方向 */
+    scrollDirection: {
+      type: String,
+      default: 'vertical',
+      validator: (v) => ['vertical', 'horizontal'].includes(v)
+    },
+    /** item 的自定义 CSS 类名 */
+    itemClassName: { type: String, default: '' },
+
+    // ========== 容器尺寸 ==========
+    height: { type: [Number, String], default: '' },
+    maxHeight: { type: [Number, String], default: '' },
+    width: { type: [Number, String], default: '' },
+    maxWidth: { type: [Number, String], default: '' },
+
+    // ========== 状态 ==========
+    loading: { type: Boolean, default: false },
+    emptyText: { type: String, default: '暂无数据' },
+
+    // ========== 加载更多 ==========
+    loadMore: { type: Boolean, default: false },
+    loadMoreText: { type: String, default: '加载更多' },
+    loadMoreLoading: { type: Boolean, default: false }
+  },
+
+  data() {
+    return {
+      scrollPos: 0,
+      containerSize: 0,
+      resizeObserver: null,
+      rafId: null
+    }
+  },
+
+  computed: {
+    containerStyle() {
+      const style = {}
+      if (this.height) {
+        style.height = typeof this.height === 'number' ? this.height + 'px' : this.height
+      }
+      if (this.maxHeight) {
+        style.maxHeight = typeof this.maxHeight === 'number' ? this.maxHeight + 'px' : this.maxHeight
+      }
+      if (this.width) {
+        style.width = typeof this.width === 'number' ? this.width + 'px' : this.width
+      }
+      if (this.maxWidth) {
+        style.maxWidth = typeof this.maxWidth === 'number' ? this.maxWidth + 'px' : this.maxWidth
+      }
+      return style
+    },
+
+    virtualWrapperStyle() {
+      const style = {}
+      if (this.scrollDirection === 'horizontal') {
+        style.height = '100%'
+      }
+      return style
+    },
+
+    itemStyle() {
+      return this.scrollDirection === 'vertical'
+        ? { height: this.itemSize + 'px' }
+        : { width: this.itemSize + 'px', display: 'inline-block' }
+    },
+
+    /** 数据总条数 */
+    dataCount() {
+      return (this.data && this.data.length) || 0
+    },
+
+    /** 总滚动尺寸 */
+    totalSize() {
+      return this.dataCount * this.itemSize
+    },
+
+    /** 虚拟滚动：可见范围起始索引 */
+    visibleStartIndex() {
+      if (!this.vScroll) return 0
+      const start = Math.floor(this.scrollPos / this.itemSize)
+      return Math.max(0, start - this.bufferSize)
+    },
+
+    /** 虚拟滚动：可见范围结束索引 */
+    visibleEndIndex() {
+      if (!this.vScroll) return this.dataCount
+      const visibleCount = Math.ceil(this.containerSize / this.itemSize)
+      const end = Math.ceil(this.scrollPos / this.itemSize) + visibleCount
+      return Math.min(this.dataCount, end + this.bufferSize)
+    },
+
+    /** 可见数据 */
+    visibleData() {
+      if (!this.vScroll || !this.data) return this.data || []
+      return this.data.slice(this.visibleStartIndex, this.visibleEndIndex)
+    },
+
+    /** 偏移量（px） */
+    offsetStart() {
+      return this.visibleStartIndex * this.itemSize
+    },
+
+    /** 是否显示加载更多 */
+    showLoadMore() {
+      if (!this.loadMore || !this.dataCount) return false
+      if (this.scrollDirection === 'vertical') {
+        return this.scrollPos + this.containerSize >= this.totalSize - this.itemSize * 2
+      }
+      return false
+    }
+  },
+
+  watch: {
+    data: {
+      handler() {
+        this.$nextTick(() => {
+          this.updateContainerSize()
+        })
+      }
+    },
+    vScroll(val) {
+      if (val) {
+        this.$nextTick(() => {
+          this.updateContainerSize()
+          this.bindResizeObserver()
+        })
+      }
+    }
+  },
+
+  mounted() {
+    this.$nextTick(() => {
+      this.updateContainerSize()
+      if (this.vScroll) {
+        this.bindResizeObserver()
+      }
+    })
+  },
+
+  beforeDestroy() {
+    this.unbindResizeObserver()
+    if (this.rafId && typeof cancelAnimationFrame !== 'undefined') {
+      cancelAnimationFrame(this.rafId)
+      this.rafId = null
+    }
+  },
+
+  methods: {
+    // ========== 虚拟滚动 ==========
+    onScroll() {
+      const wrap = this.$refs.scrollWrap
+      if (!wrap) return
+
+      const pos = this.scrollDirection === 'vertical' ? wrap.scrollTop : wrap.scrollLeft
+      this.scrollPos = pos
+
+      // 对外 emit scroll 事件，传递 scrollTop/scrollLeft 方便父组件使用
+      this.$emit('scroll', {
+        scrollTop: wrap.scrollTop,
+        scrollLeft: wrap.scrollLeft
+      })
+
+      if (this.rafId) return
+      if (typeof requestAnimationFrame === 'undefined') return
+      this.rafId = requestAnimationFrame(() => {
+        this.$forceUpdate()
+        this.rafId = null
+      })
+    },
+
+    getItemKey(item, index) {
+      if (item && typeof item === 'object' && this.keyField && item[this.keyField] != null) {
+        return item[this.keyField]
+      }
+      return `vitem_${this.visibleStartIndex + index}`
+    },
+
+    getOriginalIndex(index) {
+      return this.visibleStartIndex + index
+    },
+
+    // ========== 容器尺寸 ==========
+    updateContainerSize() {
+      const wrap = this.$refs.scrollWrap
+      if (!wrap) return
+
+      this.containerSize = this.scrollDirection === 'vertical'
+        ? wrap.clientHeight
+        : wrap.clientWidth
+    },
+
+    bindResizeObserver() {
+      if (typeof ResizeObserver === 'undefined') return
+      this.unbindResizeObserver()
+
+      const wrap = this.$refs.scrollWrap
+      if (!wrap) return
+
+      this.resizeObserver = new ResizeObserver(() => {
+        this.updateContainerSize()
+      })
+      this.resizeObserver.observe(wrap)
+    },
+
+    unbindResizeObserver() {
+      if (this.resizeObserver) {
+        this.resizeObserver.disconnect()
+        this.resizeObserver = null
+      }
+    },
+
+    // ========== 加载更多 ==========
+    onLoadMore() {
+      this.$emit('load-more')
+    },
+
+    // ========== 对外暴露方法 ==========
+    /** 获取原生滚动容器 DOM 元素 */
+    getScrollContainer() {
+      return this.$refs.scrollWrap
+    },
+
+    /** 滚动到指定位置 */
+    scrollTo(pos, behavior) {
+      const wrap = this.$refs.scrollWrap
+      if (!wrap) return
+
+      const opts = behavior && typeof behavior === 'string'
+        ? { behavior }
+        : { behavior: 'smooth' }
+
+      if (this.scrollDirection === 'vertical') {
+        wrap.scrollTo({ top: pos, ...opts })
+      } else {
+        wrap.scrollTo({ left: pos, ...opts })
+      }
+    },
+
+    /** 滚动到指定索引的 item */
+    scrollToItem(index) {
+      const pos = index * this.itemSize
+      this.scrollTo(pos)
+    },
+
+    /** 滚动到顶部/左侧 */
+    scrollToStart() {
+      this.scrollTo(0)
+    },
+
+    /** 滚动到底部/右侧 */
+    scrollToEnd() {
+      this.scrollTo(this.totalSize)
+    },
+
+    /** 获取当前滚动位置 */
+    getScrollPos() {
+      return this.scrollPos
+    }
+  }
+}
+</script>

package/src/components/xt-scroll/style/index.scss

@@ -0,0 +1,107 @@
+@import '../../../styles/variables.scss';
+
+.xt-scroll {
+  width: 100%;
+  height: 100%;
+
+  // 原生滚动容器
+  &__wrap {
+    width: 100%;
+    height: 100%;
+    overflow: auto;
+
+    // 纵向滚动
+    &--vertical {
+      overflow-x: hidden;
+      overflow-y: auto;
+    }
+
+    // 横向滚动
+    &--horizontal {
+      overflow-x: auto;
+      overflow-y: hidden;
+    }
+  }
+
+  // 虚拟滚动容器
+  &__virtual {
+    width: 100%;
+    position: relative;
+  }
+
+  &__phantom {
+    position: relative;
+    box-sizing: border-box;
+  }
+
+  &__item {
+    box-sizing: border-box;
+    overflow: hidden;
+  }
+
+  // 默认内容区
+  &__default {
+    width: 100%;
+  }
+
+  // 空状态
+  &__empty {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: 48px 0;
+    color: #909399;
+    font-size: 14px;
+  }
+
+  // 加载状态
+  &__loading {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 8px;
+    padding: 48px 0;
+    color: #909399;
+    font-size: 14px;
+
+    .el-icon-loading {
+      font-size: 20px;
+      animation: xt-scroll-rotating 2s linear infinite;
+    }
+  }
+
+  // 加载更多
+  &__loadmore {
+    display: flex;
+    justify-content: center;
+    padding: 16px 0;
+  }
+
+  // 横向模式
+  &--horizontal {
+    .xt-scroll__virtual {
+      height: 100%;
+    }
+
+    .xt-scroll__phantom {
+      white-space: nowrap;
+    }
+
+    .xt-scroll__item {
+      display: inline-block;
+      vertical-align: top;
+    }
+  }
+
+  // 纵向模式
+  &--vertical {
+    .xt-scroll__item {
+      width: 100%;
+    }
+  }
+}
+
+@keyframes xt-scroll-rotating {
+  from { transform: rotate(0deg); }
+  to { transform: rotate(360deg); }
+}