如何在JavaScript中实现虚拟列表？-js教程-PHP中文网

如何在JavaScript中实现虚拟列表？

裘德小鎮的故事

发布： 2025-04-24 16:00:02

原创

775人浏览过

在javascript中实现虚拟列表的步骤包括：1) 创建virtuallist类，管理列表渲染和滚动事件；2) 优化滚动性能，使用requestanimationframe；3) 处理动态高度，扩展为dynamicvirtuallist类；4) 实现预加载和缓冲，提升用户体验；5) 进行性能测试与调优，确保最佳效果。

如何在JavaScript中实现虚拟列表？

在JavaScript中实现虚拟列表是一种优化大型列表渲染性能的技术，下面我将详细讲解如何实现这一功能，同时分享一些我在实际项目中的经验和踩过的坑。

实现虚拟列表的核心思想是只渲染用户当前可见的部分，而不是一次性渲染整个列表。这在处理数千甚至数万条数据时尤为重要，因为它能显著减少DOM操作和内存使用。

让我们从一个简单的例子开始，逐步深入到更复杂的实现：

立即学习“Java免费学习笔记（深入）”；

阿里云-虚拟数字人

阿里云-虚拟数字人是什么？ ...

查看详情

class VirtualList {
  constructor(container, items, itemHeight) {
    this.container = container;
    this.items = items;
    this.itemHeight = itemHeight;
    this.visibleItems = [];
    this.startIndex = 0;
    this.endIndex = 0;
    this.scrollTop = 0;

    this.init();
  }

  init() {
    this.container.style.overflow = 'auto';
    this.container.addEventListener('scroll', this.handleScroll.bind(this));
    this.render();
  }

  handleScroll() {
    this.scrollTop = this.container.scrollTop;
    this.updateVisibleItems();
  }

  updateVisibleItems() {
    const containerHeight = this.container.clientHeight;
    this.startIndex = Math.floor(this.scrollTop / this.itemHeight);
    this.endIndex = this.startIndex + Math.ceil(containerHeight / this.itemHeight);

    this.render();
  }

  render() {
    this.container.innerHTML = '';
    const totalHeight = this.items.length * this.itemHeight;
    this.container.style.height = `${totalHeight}px`;

    const fragment = document.createDocumentFragment();
    for (let i = this.startIndex; i < Math.min(this.endIndex, this.items.length); i++) {
      const item = document.createElement('div');
      item.style.position = 'absolute';
      item.style.top = `${i * this.itemHeight}px`;
      item.style.height = `${this.itemHeight}px`;
      item.textContent = this.items[i];
      fragment.appendChild(item);
    }

    this.container.appendChild(fragment);
  }
}

// 使用示例
const items = Array.from({ length: 10000 }, (_, i) => `Item ${i}`);
const container = document.getElementById('list-container');
const virtualList = new VirtualList(container, items, 30);

登录后复制

这个实现中，我们创建了一个VirtualList类，它负责管理列表的渲染和滚动事件。核心逻辑在于updateVisibleItems方法，它根据当前滚动位置计算出需要渲染的项目的起始和结束索引，然后通过render方法更新DOM。

在实际项目中，我发现以下几个方面需要特别注意：

滚动性能优化：频繁的滚动事件可能会导致性能问题，可以通过requestAnimationFrame来优化滚动处理。

handleScroll() {
  if (!this.scrollRaf) {
    this.scrollRaf = requestAnimationFrame(() => {
      this.scrollRaf = null;
      this.scrollTop = this.container.scrollTop;
      this.updateVisibleItems();
    });
  }
}

登录后复制

动态高度：如果列表项的高度不固定，需要实现一个更复杂的算法来计算可见区域和滚动位置。

class DynamicVirtualList extends VirtualList {
  constructor(container, items, estimateHeight) {
    super(container, items, estimateHeight);
    this.heights = new Array(items.length).fill(estimateHeight);
    this.totalHeight = items.length * estimateHeight;
  }

  updateVisibleItems() {
    const containerHeight = this.container.clientHeight;
    let accumulatedHeight = 0;
    this.startIndex = 0;
    while (this.startIndex < this.items.length && accumulatedHeight + this.heights[this.startIndex] <= this.scrollTop) {
      accumulatedHeight += this.heights[this.startIndex];
      this.startIndex++;
    }

    this.endIndex = this.startIndex;
    while (this.endIndex < this.items.length && accumulatedHeight + this.heights[this.endIndex] < this.scrollTop + containerHeight) {
      accumulatedHeight += this.heights[this.endIndex];
      this.endIndex++;
    }

    this.render();
  }

  render() {
    this.container.innerHTML = '';
    this.container.style.height = `${this.totalHeight}px`;

    const fragment = document.createDocumentFragment();
    let accumulatedHeight = 0;
    for (let i = this.startIndex; i < Math.min(this.endIndex, this.items.length); i++) {
      const item = document.createElement('div');
      item.style.position = 'absolute';
      item.style.top = `${accumulatedHeight}px`;
      item.style.height = `${this.heights[i]}px`;
      item.textContent = this.items[i];
      fragment.appendChild(item);

      accumulatedHeight += this.heights[i];
    }

    this.container.appendChild(fragment);
  }

  // 假设我们有一个方法来更新单个项目的高度
  updateItemHeight(index, height) {
    const oldHeight = this.heights[index];
    this.heights[index] = height;
    this.totalHeight += height - oldHeight;

    if (index >= this.startIndex && index < this.endIndex) {
      this.render();
    }
  }
}

登录后复制

预加载和缓冲：为了提升用户体验，可以在可见区域的前后预加载一些项目，减少滚动时的加载延迟。

updateVisibleItems() {
  const containerHeight = this.container.clientHeight;
  const buffer = 5; // 预加载的项目数量
  this.startIndex = Math.max(0, Math.floor(this.scrollTop / this.itemHeight) - buffer);
  this.endIndex = Math.min(this.items.length, this.startIndex + Math.ceil(containerHeight / this.itemHeight) + buffer);

  this.render();
}

登录后复制