Next.js 集成 Highcharts 官网文档说明(2025 新版)

Next.js

服务器端渲染

Highcharts 交互式图表无法在服务器端生成,因为交互性依赖于客户端环境。 可以使用 Highcharts 导出服务器 Highcharts Export Server 生成静态图片。

为了在使用最新版本(v13+)的 Next.js(使用应用路由)中使用 Highcharts, 你需要在包含 Highcharts 组件或模块的文件中添加 'use client',以确保它在客户端渲染。

jsx 复制代码
'use client';

import { Chart, Series, Title } from '@highcharts/react';
import { Accessibility } from '@highcharts/react/options/Accessibility';

export default function ChartPage() {
  return (
    <Chart>
      <Title>Hello NextJS!</Title>
      <Series type="line" data={[1, 2, 3, 4, 5]} />
      <Accessibility />
    </Chart>
  );
}

页面路由

如果你在 Next.js 中使用页面路由,Highcharts 仍然可以轻松使用,只要渲染限制在客户端即可。 主要注意事项是:

  • 避免在 getServerSideProps or getStaticProps中直接使用 Highcharts,因为它需要一个 DOM 环境。
  • 导入和渲染 Highcharts 的组件应为标准的 React 组件,通常在 /pages 目录下的页面中也能正常工作。

从服务器流式传输数据

虽然 Highcharts 在服务器端无法使用,但你可以使用服务器端渲染进行数据获取,然后将数据流式传输到客户端组件以渲染图表。

考虑这个 page.tsx 文件:

jsx 复制代码
import { Suspense } from 'react';
import DataChart from './chart';

export default function Page() {
  const data = fetch('https://www.highcharts.com/samples/data/aapl.json')
    .then(res => res.json());

  return (
    <Suspense fallback={<div>Loading data...</div>}>
      <DataChart data={data} />
    </Suspense>
  )
}

结合这个 chart.tsx:

jsx 复制代码
"use client";

import { use } from 'react';

import { StockChart } from '@highcharts/react/Stock';
import { LineSeries } from '@highcharts/react/series/Line';
import { Title } from '@highcharts/react/options';
import { Accessibility } from '@highcharts/react/options/Accessibility';

export default function DataChart({ data }) {
  const allData = use(data);

  return (
    <StockChart>
      <Title>Hello stock NextJS!</Title>
      <LineSeries data={allData} />
      <Accessibility />
    </StockChart>
  );
}

更多详情,请参阅 Next.js 文档.

更新发布于 2026 年 1 月 30 日

相关推荐
SoaringHeart7 分钟前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
ShineWinsu1 小时前
对于Qt:QFormLayout常见属性以及方法的解析
开发语言·c++·qt·面试·客户端·表单·qformlayout
Flynt1 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑2 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星2 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson2 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼3 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊3 小时前
CNC计算机数控加工模拟器
前端
张一凡934 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
Brookty4 小时前
CSS基础知识(一):选择器、优先级、层叠与继承、边框属性及盒模型
前端·css