首页 > web前端 > js教程 > 正文

事件的实用使用React React MUI数据网格:允许输入字段的箭头密钥导航

碧海醫心
发布: 2025-01-31 13:46:14
原创
1061人浏览过

在使用mui数据网格时,箭头键导航输入字段可能遇到问题:默认情况下,箭头键会滚动网格,影响用户体验。本文将介绍如何禁用网格滚动,并在输入字段中实现流畅的箭头键导航。

问题描述

假设您有一个包含多行的数据网格,每行都有输入字段。用户期望使用箭头键在这些输入字段之间移动光标。然而,MUI数据网格的默认行为会在按下箭头键时滚动整个网格,导致用户难以高效地编辑数据。

事件的实用使用React React MUI数据网格:允许输入字段的箭头密钥导航

解决方案

解决方法是覆盖输入字段获得焦点时的默认键盘事件处理。我们将创建一个可复用的TypeScript实用程序函数来处理此行为,并将其应用于数据网格的onKeyDown事件。

实用程序函数如下:

export const handleArrowKeyNavigation = (event: React.KeyboardEvent<HTMLDivElement>): void => {
  if (event.target instanceof HTMLInputElement) {
    if (event.key === 'ArrowLeft' || event.key === 'ArrowRight') {
      event.stopPropagation();
    }
  }
};
登录后复制

事件的实用使用React React MUI数据网格:允许输入字段的箭头密钥导航

此函数检查焦点元素是否为输入字段,如果是,则阻止箭头键事件的传播,从而允许用户在输入字段中导航而不会影响数据网格的滚动。

实现实用程序函数

在数据网格组件中实现此实用程序函数:

import React from 'react';
import { DataGrid } from '@mui/x-data-grid';
import { useForm, FormProvider, useFieldArray } from 'react-hook-form';
import { handleArrowKeyNavigation } from './utils/handleArrowKeyNavigation';

const CustomDataGrid: React.FC = () => {
  const methods = useForm({
    defaultValues: {
      rows: [
        { id: 1, firstName: 'John', lastName: 'Doe' },
        { id: 2, firstName: 'Jane', lastName: 'Smith' },
        { id: 3, firstName: 'Mike', lastName: 'Johnson' },
      ],
    },
  });

  const { control, setValue } = methods;
  const { fields } = useFieldArray({
    control,
    name: 'rows',
  });

  const handleInputChange = (index: number, field: string, value: string) => {
    setValue(`rows.${index}.${field}`, value);
  };

  const columns = [
    {
      field: 'firstName',
      headerName: 'First Name',
      width: 150,
      editable: true,
      renderCell: (params) => (
        <input
          type="text"
          value={params.row.firstName}
          onChange={(event) => handleInputChange(params.row.id -1, 'firstName', event.target.value)}
        />
      ),
    },
    {
      field: 'lastName',
      headerName: 'Last Name',
      width: 150,
      editable: true,
      renderCell: (params) => (
        <input
          type="text"
          value={params.row.lastName}
          onChange={(event) => handleInputChange(params.row.id -1, 'lastName', event.target.value)}
        />
      ),
    },
  ];

  return (
    <div style={{ height: 400, width: '100%' }}>
      <DataGrid
        onKeyDown={handleArrowKeyNavigation}
        columns={columns}
        rows={fields}
      />
    </div>
  );
};

export default CustomDataGrid;
登录后复制

通过将handleArrowKeyNavigation函数添加到数据网格的onKeyDown事件中,我们确保了箭头键事件的正确处理,从而提供无缝的用户体验。

测试实用程序函数

为了确保实用程序函数按预期工作,可以使用Jest和React Testing Library编写单元测试:

import { handleArrowKeyNavigation } from './handleArrowKeyNavigation';
import { render, screen } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import React from 'react';

describe('handleArrowKeyNavigation', () => {
  it('should stop event propagation of ArrowLeft key', () => {
    const stopPropagation = jest.fn();
    const event = {
      key: 'ArrowLeft',
      target: document.createElement('input'),
      stopPropagation,
    } as unknown as React.KeyboardEvent<HTMLInputElement>;

    handleArrowKeyNavigation(event);
    expect(stopPropagation).toHaveBeenCalled();
  });

  it('should stop event propagation of ArrowRight key', () => {
    const stopPropagation = jest.fn();
    const event = {
      key: 'ArrowRight',
      target: document.createElement('input'),
      stopPropagation,
    } as unknown as React.KeyboardEvent<HTMLInputElement>;

    handleArrowKeyNavigation(event);
    expect(stopPropagation).toHaveBeenCalled();
  });

  it('should not stop event propagation of other keys', () => {
    const stopPropagation = jest.fn();
    const event = {
      key: 'Enter',
      target: document.createElement('input'),
      stopPropagation,
    } as unknown as React.KeyboardEvent<HTMLInputElement>;

    handleArrowKeyNavigation(event);
    expect(stopPropagation).not.toHaveBeenCalled();
  });

  it('should not stop event propagation of non-input elements', () => {
    const stopPropagation = jest.fn();
    const event = {
      key: 'ArrowLeft',
      target: document.createElement('div'),
      stopPropagation,
    } as unknown as React.KeyboardEvent<HTMLDivElement>;

    handleArrowKeyNavigation(event);
    expect(stopPropagation).not.toHaveBeenCalled();
  });
});
登录后复制

这些测试涵盖了各种场景,以确保实用程序函数的正确性。

结论

通过自定义MUI数据网格中输入字段的键盘事件处理,我们可以显著提升用户体验。此解决方案允许用户使用箭头键在输入字段中导航,而不会影响网格的滚动行为。 欢迎尝试此解决方案并在您的项目中使用,并分享您的反馈。

(注意:代码示例已进行修正,使用了更准确的类型和DataGrid组件,并修复了handleInputChange函数中的错误。 renderCell用于渲染单元格内容,而不是renderHeader。 同时,代码更符合React的最佳实践。)

以上就是事件的实用使用React React MUI数据网格:允许输入字段的箭头密钥导航的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习
PHP中文网抖音号
发现有趣的

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号