egjs-infinitegrid 文档

项目目录结构及介绍

这个开源项目名为 egjs-infinitegrid，旨在提供一个模块，用于无限地根据网格类型排列元素（包括内容）。项目的核心是一个名为 InfiniteGrid 的模块，它支持各种网格类型，包括 Masonry、Justified、Frame、Packing 等。通过使用这个模块，开发者可以实现不同大小的卡片元素组成的各种网格，并保证性能，即使在元素数量增多的情况下，也能保持较低的 DOM 数量。

项目的启动文件介绍

egjs-infinitegrid 提供了多种启动方式，包括使用 npm 安装、使用 CDN 加载等。以下是几种常见的启动方式：

• 使用 npm 安装：

  npm install @egjs/infinitegrid
  

  安装完成后，在项目中引入模块并创建实例：

  import { MasonryInfiniteGrid } from '@egjs/infinitegrid';
  const grid = new MasonryInfiniteGrid('container', { gap: 5 });
  

• 使用 CDN 加载：

  <script src="https://unpkg.com/@egjs/infinitegrid/dist/infinitegrid.min.js"></script>
  <script>
    var grid = new InfiniteGrid('container', { gap: 5 });
  </script>
  

项目的配置文件介绍

egjs-infinitegrid 提供了丰富的配置选项，可以满足不同场景的需求。以下是一些常用的配置选项：

• gap: 设置网格项之间的间距，例如 { gap: 10 } 表示间距为 10 像素。
• stretch: 设置是否启用拉伸模式，例如 { stretch: true } 表示启用拉伸模式。
• passUnstretchRow: 设置是否在最后一行禁用拉伸，例如 { passUnstretchRow: true } 表示在最后一行禁用拉伸。
• sizeRange: 设置元素大小的范围，例如 { sizeRange: [100, 200] } 表示元素大小在 100 像素到 200 像素之间。
• stretchRange: 设置拉伸的范围，例如 { stretchRange: [120, 180] } 表示拉伸范围在 120% 到 180% 之间。
• isEqualSize: 设置是否所有元素大小相同，例如 { isEqualSize: true } 表示所有元素大小相同。
• useResizeObserver: 设置是否使用 ResizeObserver 监听容器尺寸变化，例如 { useResizeObserver: true } 表示使用 ResizeObserver。
• observeChildren: 设置是否监听子元素尺寸变化，例如 { observeChildren: true } 表示监听子元素尺寸变化。

更多配置选项和详细说明，请参考官方文档。