在React中通过HTML数据属性传递映射数组数据

DDD
发布: 2025-10-25 10:40:27
原创
674人浏览过

在react中通过html数据属性传递映射数组数据

本教程旨在解决在React中将映射数组的数据附加到原生HTML元素(如

  • )并从事件处理函数中访问的问题。我们将深入探讨为什么直接使用自定义HTML属性会失败,并详细介绍如何利用HTML5的data-属性来安全、有效地存储和检索这些数据,同时提供示例代码和最佳实践。

    理解原生HTML元素与自定义属性的限制

    在React中,当您渲染一个原生HTML元素(例如<div>, <span>, <li>等)时,React会将其转换为真实的DOM元素。这些原生HTML元素只识别标准的HTML属性。如果您尝试直接附加非标准的自定义属性,例如在以下代码片段中尝试的airport、lat、name和long:

    <li
      key={airport.iata}
      airport={airport} // 非标准属性
      onClick={handleLiClickFirst}
      lat={airport.latitude} // 非标准属性
      name={airport.name}   // 非标准属性
      long={airport.longitude} // 非标准属性
    >
      {airport.name}
    </li>
    登录后复制

    这些非标准属性并不会被DOM视为可访问的数据属性。当事件(如onClick)触发时,您通过event.target访问到的DOM元素将不会包含这些属性,因此尝试通过event.target.lat等方式获取数据会失败,返回undefined。

    const handleLiClickFirst = (airport) => {
        // airport.target.lat 将是 undefined
        console.log(airport.target.lat);
    };
    登录后复制

    这是因为React在渲染原生HTML元素时,会过滤掉它不认识的属性,以保持DOM的整洁和符合标准。

    立即学习前端免费学习笔记(深入)”;

    使用HTML5数据属性(Data Attributes)解决问题

    为了将自定义数据附加到HTML元素上,HTML5引入了数据属性(Data Attributes)。数据属性以data-前缀开头,后跟自定义的名称,例如data-latitude、data-airport-name等。浏览器会识别这些属性,并将其存储在元素的dataset属性中,从而允许JavaScript安全地访问它们。

    1. 附加数据属性

    在React中,您可以像传递普通属性一样,将数据属性附加到原生HTML元素上。请确保属性名遵循data-your-custom-name的格式。

    <li
      key={airport.iata}
      // 使用data-属性来存储数据
      data-iata={airport.iata}
      data-latitude={airport.latitude}
      data-longitude={airport.longitude}
      data-name={airport.name}
      // 如果需要传递整个对象,可以将其JSON字符串化
      data-airport-data={JSON.stringify(airport)}
      onClick={handleLiClickFirst}
    >
      {airport.name}
    </li>
    登录后复制

    注意事项:

    • 命名规范: data-后的属性名可以使用小写字母、数字、连字符(-)。在JavaScript中访问时,连字符会被转换为驼峰命名法(例如data-airport-name在JavaScript中是dataset.airportName)。
    • 数据类型: 数据属性的值始终是字符串。如果您存储的是数字、布尔值或对象,您需要在检索时进行类型转换(例如parseInt(), JSON.parse())。
    • 复杂对象: 如果需要存储整个JavaScript对象,您必须先使用JSON.stringify()将其转换为JSON字符串。

    2. 从事件处理函数中访问数据

    当事件触发时,您可以通过event.target.dataset对象来访问这些数据属性。dataset对象会包含所有以data-开头的属性,属性名将自动从连字符命名法转换为驼峰命名法。

    怪兽AI数字人
    怪兽AI数字人

    数字人短视频创作,数字人直播,实时驱动数字人

    怪兽AI数字人 44
    查看详情 怪兽AI数字人

    以下是修改后的handleLiClickFirst函数示例:

    const handleLiClickFirst = (event) => {
        // event.target 指向触发事件的 <li> 元素
        const targetLi = event.target;
    
        // 从 dataset 中获取数据
        const iata = targetLi.dataset.iata;
        const latitude = parseFloat(targetLi.dataset.latitude); // 转换为数字
        const longitude = parseFloat(targetLi.dataset.longitude); // 转换为数字
        const name = targetLi.dataset.name;
    
        console.log("IATA:", iata);
        console.log("Latitude:", latitude);
        console.log("Longitude:", longitude);
        console.log("Name:", name);
    
        // 如果存储了整个对象,需要JSON.parse()解析
        if (targetLi.dataset.airportData) {
            try {
                const airportObject = JSON.parse(targetLi.dataset.airportData);
                console.log("Full Airport Object:", airportObject);
                // 您可以使用这个对象来更新状态或其他逻辑
                setFirst(airportObject.name); // 例如,更新状态为机场名称
            } catch (e) {
                console.error("Error parsing airport data:", e);
            }
        } else {
            setFirst(name); // 如果没有完整对象,则使用单独的名称
        }
    };
    登录后复制

    3. 完整示例代码

    结合上述修改,您的React组件代码将如下所示:

    import React, { useState, useEffect } from 'react';
    import { TextField } from '@mui/material'; // 假设您使用的是MUI组件
    
    // 模拟数据,实际应用中可能来自API
    const mockAirports = [
      { iata: 'JFK', name: 'John F. Kennedy International Airport', latitude: 40.6413, longitude: -73.7781 },
      { iata: 'LAX', name: 'Los Angeles International Airport', latitude: 33.9416, longitude: -118.4085 },
      { iata: 'ORD', name: 'O\'Hare International Airport', latitude: 41.9742, longitude: -87.9073 },
    ];
    
    function AirportSelector() {
      const [first, setFirst] = useState('');
      const [resultFirst, setResultFirst] = useState({ airports: [] });
    
      useEffect(() => {
        // 模拟数据过滤
        if (first) {
          const filtered = mockAirports.filter(airport =>
            airport.name.toLocaleLowerCase().includes(first) ||
            airport.iata.toLocaleLowerCase().includes(first)
          );
          setResultFirst({ airports: filtered });
        } else {
          setResultFirst({ airports: mockAirports }); // 或清空
        }
      }, [first]);
    
      const handleLiClickFirst = (event) => {
        const targetLi = event.target;
        const name = targetLi.dataset.name;
        const iata = targetLi.dataset.iata;
        const latitude = parseFloat(targetLi.dataset.latitude);
        const longitude = parseFloat(targetLi.dataset.longitude);
    
        console.log("Selected Airport Details:");
        console.log("Name:", name);
        console.log("IATA:", iata);
        console.log("Latitude:", latitude);
        console.log("Longitude:", longitude);
    
        setFirst(name); // 更新TextField的值为选中的机场名称
        setResultFirst({ airports: [] }); // 清空列表
      };
    
      return (
        <div className="header__first">
          <TextField
            id="outlined-basic"
            label="From"
            variant="outlined"
            value={first}
            onChange={(e) => setFirst(e.target.value.toLocaleLowerCase())}
          />
          <ul>
            {resultFirst.airports?.map((airport) => {
              return (
                <li
                  key={airport.iata}
                  // 使用data-属性传递数据
                  data-iata={airport.iata}
                  data-latitude={airport.latitude}
                  data-longitude={airport.longitude}
                  data-name={airport.name}
                  onClick={handleLiClickFirst}
                >
                  {airport.name}
                </li>
              );
            })}
          </ul>
        </div>
      );
    }
    
    export default AirportSelector;
    登录后复制

    最佳实践与替代方案

    虽然数据属性是解决此类问题的有效方法,但在某些情况下,还有其他更符合React范式的方法值得考虑:

    1. 避免存储整个对象: 尽量只存储您需要访问的最小数据单元(如ID、名称、坐标)。将整个复杂对象JSON.stringify到数据属性中可能会导致HTML属性字符串过长,增加DOM大小,并带来额外的序列化/反序列化开销。

    2. 直接传递数据到事件处理函数: 如果您不需要将数据实际存储在DOM元素上,而是仅仅在事件触发时需要访问它,那么最直接且React-idiomatic的方式是直接将数据作为参数传递给事件处理函数。

      // 在map中
      <li
        key={airport.iata}
        onClick={() => handleLiClickFirst(airport)} // 直接传递airport对象
      >
        {airport.name}
      </li>
      
      // 事件处理函数
      const handleLiClickFirst = (selectedAirport) => {
        console.log("Selected Airport Object:", selectedAirport);
        setFirst(selectedAirport.name);
        // ... 其他逻辑
      };
      登录后复制

      这种方法更简洁,避免了DOM操作,并且直接处理JavaScript对象,无需进行字符串化和解析。然而,如果您的需求是必须通过HTML属性来传递数据(例如,为了CSS选择器或其他非React的JavaScript逻辑),那么data-属性仍然是首选。

    总结

    当需要在React中将自定义数据附加到原生HTML元素并从事件处理函数中访问时,data-属性是标准且推荐的解决方案。它们允许您将字符串数据嵌入到HTML中,并通过event.target.dataset对象轻松检索。虽然直接将数据传递给事件处理函数在许多React场景中更为简洁和高效,但了解并正确使用data-属性对于处理特定需求或与传统JavaScript交互的场景至关重要。始终优先考虑存储最小必要数据,并注意数据类型的转换。

  • 以上就是在React中通过HTML数据属性传递映射数组数据的详细内容,更多请关注php中文网其它相关文章!

    HTML速学教程(入门课程)
    HTML速学教程(入门课程)

    HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

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

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