当前位置：首页 > news >正文

React Grid Layout基础使用

news 2025/8/4 17:15:09

摘要

React Grid Layout是一个用于在React应用程序中创建可拖拽和可调整大小的网格布局的库。它提供了一个灵活的网格系统，可以帮助开发人员构建响应式的布局，并支持拖拽、调整大小和动画效果。本文将介绍如何使用React Grid Layout来创建自适应的布局。

1. 安装和引入

首先，我们需要安装React Grid Layout库。在命令行中运行以下命令：

npm install react-grid-layout

注意，在typescript中无法指引引入react-grid-layout，需要创建一个types文件夹，文件夹内创建一个index.d.ts文件，然后再文件内添加declare module 'react-grid-layout';

然后，在你的React组件中引入所需的组件和样式：

import React from 'react';
import { Responsive, WidthProvider } from 'react-grid-layout';
import '/node_modules/react-grid-layout/css/styles.css';
import '/node_modules/react-resizable/css/styles.css';const ResponsiveReactGridLayout = WidthProvider(Responsive);const MyLayout = () => {// 组件代码...
}

2. 布局属性的定义

在React Grid Layout中，每个网格项都有一些属性来定义其位置和大小。以下是这些属性的含义：

i：网格项的唯一标识符。
x：网格项的起始列位置。
y：网格项的起始行位置。
w：网格项的宽度，以列为单位。
h：网格项的高度，以行为单位。

3. 创建布局

接下来，我们可以开始创建我们的布局。在MyLayout组件中，我们可以使用ResponsiveReactGridLayout组件来创建自适应的布局。以下是一个示例：

const MyLayout = () => {const layout = [{ i: 'a', x: 0, y: 0, w: 2, h: 2 },{ i: 'b', x: 2, y: 0, w: 2, h: 4 },{ i: 'c', x: 4, y: 0, w: 2, h: 2 },];/*** @description 渲染当前仪表盘* @param el 部件包*/function createElement(el) {return (<divkey={el.i}data-grid={el}>{el.i}</div>);}return (<ResponsiveReactGridLayoutclassName="layout"margin={[8, 16]}breakpoints={{ lg: 1100, md: 996, sm: 768, xs: 480, xxs: 0 }}cols={{ lg: 6, md: 4, sm: 4, xs: 1, xxs: 1 }}isDraggable={true}isResizable={true}rowHeight={rowHeight}>layout.map((el: any) =>createElement(el))}</ResponsiveReactGridLayout>);
}