Compare commits

..
6 Commits
Author SHA1 Message Date
hz4th_coder 13abdea15b feat: 新增5种表格主题风格
- ocean 海洋蓝:清爽专业,适合商务科技场景
- forest 森林绿:自然护眼,适合长时间阅读
- sunset 日落橙:温暖活力,吸引注意力
- lavender 薰衣草紫:优雅浪漫,柔和梦幻
- minimal 极简灰:干净现代,强调内容本身

现在共10种表格主题可选
2026-07-17 12:55:46 +08:00
hz4th_coder e2f9892a2a feat: 新增表格图片生成功能
- 新增 POST/GET /api/table 接口
- 支持5种主题风格、自定义字体大小、斑马纹等
- 前端新增图表/表格模式切换
- 完美支持中文内容显示(Noto Sans CJK SC)
- 更新 API 文档和 README
2026-07-17 12:40:47 +08:00
hz4th_coder 02212e9ef7 chore: 修改默认端口为16016 2026-07-17 12:15:50 +08:00
hz4th_coder df2981889e docs: 添加独立的 API 调用文档 2026-07-16 12:36:07 +08:00
hz4th_coder d4ce91efd1 feat: 添加 API 接口支持服务端生成图表图片
- 新增 Node.js + Express 后端服务 (server.js)
- POST /api/chart: JSON 请求体生成图表 PNG
- GET /api/chart: URL 参数生成图表 PNG
- 支持所有前端配置参数(图表类型/主题/标签/堆叠/分割等)
- 使用 @napi-rs/canvas + echarts 服务端渲染
- 自定义分辨率和像素倍率
- 添加 /api/health 和 /api/docs 接口
- 更新 README 文档,添加 API 使用说明
2026-07-16 11:33:39 +08:00
hz4th_coder ad3e74e391 docs: 添加项目说明文档 2026-06-13 21:56:16 +08:00
9 changed files with 2855 additions and 8 deletions
+4
View File
@@ -0,0 +1,4 @@
node_modules/
logs/
*.png
*.svg
+310
View File
@@ -0,0 +1,310 @@
# 📡 数据可视化图表生成器 - API 文档
> 版本:v1.1.0 | 基础地址:`http://192.168.0.101:16016`
---
## 接口总览
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/chart` | 生成图表图片(JSON body,推荐) |
| GET | `/api/chart` | 生成图表图片(URL 参数) |
| GET | `/api/health` | 健康检查 |
| GET | `/api/docs` | 返回本文档(JSON |
---
## 1. POST /api/chart(推荐)
通过 JSON 请求体生成图表,返回 PNG 图片。
### 请求
```
POST /api/chart
Content-Type: application/json
```
### 参数说明
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|:----:|--------|------|
| `data` | string | ✅ | — | CSV 格式数据,`\n` 换行,第一行表头,第一列横坐标 |
| `chartType` | string | — | `bar` | 图表类型:`bar` / `line` / `bar-line` |
| `title` | string | — | `""` | 图表标题 |
| `theme` | string | — | `default` | 主题风格:`default` / `dark` / `macarons` / `gradient` / `retro` |
| `showLegend` | boolean | — | `true` | 显示图例 |
| `showGrid` | boolean | — | `true` | 显示网格线 |
| `showLabel` | boolean | — | `false` | 显示数据标签 |
| `stackMode` | boolean | — | `false` | 堆叠模式 |
| `smoothLine` | boolean | — | `true` | 折线平滑 |
| `enableSplit` | boolean | — | `false` | 启用区域分割 |
| `splitIndex` | number | — | `3` | 分割位置(第几个数据后分割) |
| `leftLabel` | string | — | `"左侧"` | 左侧区域标签 |
| `rightLabel` | string | — | `"右侧"` | 右侧区域标签 |
| `splitStyle` | string | — | `"solid"` | 分割线样式:`solid` / `dashed` / `dotted` |
| `width` | number | — | `800` | 图片宽度(px |
| `height` | number | — | `500` | 图片高度(px |
| `pixelRatio` | number | — | `2` | 像素倍率(越大越清晰) |
### 返回
- **Content-Type:** `image/png`
- **响应头:**
- `X-Chart-Width` — 图片宽度
- `X-Chart-Height` — 图片高度
- `X-Chart-Pixel-Ratio` — 像素倍率
### curl 示例
**基础柱状图:**
```bash
curl -X POST http://192.168.0.101:16016/api/chart \
-H "Content-Type: application/json" \
-d '{
"data": "产品, Q1, Q2, Q3, Q4\n手机, 1200, 1800, 2100, 2500\n平板, 800, 950, 1100, 1300\n笔记本, 600, 750, 900, 1050",
"chartType": "bar",
"title": "季度销售对比"
}' -o chart.png
```
**深色主题折线图 + 数据标签:**
```bash
curl -X POST http://192.168.0.101:16016/api/chart \
-H "Content-Type: application/json" \
-d '{
"data": "月份, 营收(万), 利润(万), 用户(千)\n1月, 500, 80, 50\n2月, 680, 120, 85\n3月, 820, 160, 130\n4月, 1050, 230, 200\n5月, 1380, 350, 320",
"chartType": "line",
"title": "年度增长趋势",
"theme": "dark",
"showLabel": true,
"width": 900,
"height": 500
}' -o trend.png
```
**区域分割对比图:**
```bash
curl -X POST http://192.168.0.101:16016/api/chart \
-H "Content-Type: application/json" \
-d '{
"data": "月份, 方案A, 方案B\n1月, 85, 78\n2月, 88, 82\n3月, 92, 88\n4月, 90, 95\n5月, 95, 98\n6月, 98, 102",
"chartType": "bar",
"title": "方案对比",
"theme": "gradient",
"enableSplit": true,
"splitIndex": 3,
"leftLabel": "上半年",
"rightLabel": "下半年",
"splitStyle": "dashed"
}' -o compare.png
```
**堆叠柱状图:**
```bash
curl -X POST http://192.168.0.101:16016/api/chart \
-H "Content-Type: application/json" \
-d '{
"data": "季度, 线上, 线下, 批发\nQ1, 300, 200, 150\nQ2, 450, 280, 200\nQ3, 520, 350, 180\nQ4, 680, 400, 250",
"chartType": "bar",
"title": "渠道销售分布",
"stackMode": true,
"theme": "macarons"
}' -o stack.png
```
**高分辨率大图:**
```bash
curl -X POST http://192.168.0.101:16016/api/chart \
-H "Content-Type: application/json" \
-d '{
"data": "产品, 2023, 2024, 2025\nA, 100, 200, 300\nB, 150, 250, 350",
"width": 1600,
"height": 900,
"pixelRatio": 3
}' -o hd-chart.png
```
---
## 2. GET /api/chart
通过 URL 参数生成图表,适合简单场景或直接在浏览器中使用。
### 参数
| 参数 | 说明 |
|------|------|
| `data` | CSV 数据(换行用 `\n` 表示,需 URL 编码) |
| `type` | 图表类型(bar / line / bar-line |
| `title` | 图表标题 |
| `theme` | 主题风格 |
| `width` | 图片宽度 |
| `height` | 图片高度 |
### curl 示例
```bash
curl "http://192.168.0.101:16016/api/chart?data=%E4%BA%A7%E5%93%81,Q1,Q2%0A%E6%89%8B%E6%9C%BA,100,200%0A%E5%B9%B3%E6%9D%BF,150,250&type=bar&title=%E6%B5%8B%E8%AF%95" -o chart.png
```
---
## 3. GET /api/health
健康检查。
```bash
curl http://192.168.0.101:16016/api/health
```
返回:
```json
{
"status": "ok",
"service": "data-chart-tool",
"version": "1.1.0",
"endpoints": {
"POST /api/chart": "生成图表图片(JSON body",
"GET /api/chart": "生成图表图片(URL 参数)",
"GET /api/health": "健康检查"
}
}
```
---
## 数据格式说明
CSV 格式,规则:
1. **第一行**:表头(系列名称)
2. **第一列**:横坐标值
3. **其余单元格**:数值
4. **分隔符**:逗号(自动识别制表符和 `|`
```
类别, 系列1, 系列2, 系列3
A, 10, 20, 30
B, 15, 25, 35
C, 20, 30, 40
```
在 JSON 中用 `\n` 表示换行:
```json
{
"data": "类别, 系列1, 系列2, 系列3\nA, 10, 20, 30\nB, 15, 25, 35\nC, 20, 30, 40"
}
```
---
## 各语言调用示例
### Python
```python
import requests
resp = requests.post('http://192.168.0.101:16016/api/chart', json={
"data": "月份, 营收, 利润\n1月, 500, 80\n2月, 680, 120\n3月, 820, 160",
"chartType": "line",
"title": "增长趋势",
"theme": "dark",
"showLabel": True,
"width": 900,
"height": 500
})
with open('chart.png', 'wb') as f:
f.write(resp.content)
print(f"图片大小: {len(resp.content)} bytes")
```
### JavaScript (Node.js)
```javascript
const fetch = require('node-fetch');
const fs = require('fs');
const resp = await fetch('http://192.168.0.101:16016/api/chart', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
data: "产品, Q1, Q2\n手机, 1200, 2500\n平板, 800, 1300",
chartType: "bar",
title: "销售对比",
width: 800,
height: 500
})
});
const buffer = await resp.buffer();
fs.writeFileSync('chart.png', buffer);
```
### JavaScript (浏览器 fetch)
```javascript
const resp = await fetch('http://192.168.0.101:16016/api/chart', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
data: "产品, Q1, Q2\n手机, 1200, 2500\n平板, 800, 1300",
chartType: "bar",
title: "销售对比"
})
});
const blob = await resp.blob();
const url = URL.createObjectURL(blob);
const img = document.createElement('img');
img.src = url;
document.body.appendChild(img);
```
### Shell (保存到文件)
```bash
curl -X POST http://192.168.0.101:16016/api/chart \
-H "Content-Type: application/json" \
-d '{"data":"A,B\n1,2\n3,4","chartType":"bar"}' \
-o chart.png
```
---
## 主题预览
| 主题 | 说明 | 适用场景 |
|------|------|----------|
| `default` | 经典蓝绿配色 | 通用 |
| `dark` | 深色背景 + 高亮色 | 大屏展示、PPT |
| `macarons` | 柔和马卡龙色 | 清新风格 |
| `gradient` | 渐变色 + 圆角柱 | 现代感设计 |
| `retro` | 复古低饱和度 | 文艺风格 |
---
## 错误处理
请求失败时返回 JSON
```json
{
"error": "缺少 data 参数(CSV 格式数据)"
}
```
常见错误:
| HTTP 状态码 | 原因 |
|:-----------:|------|
| 400 | 缺少 `data` 参数或数据格式错误 |
| 500 | 服务端渲染异常 |
---
*文档更新时间:2026-07-16*
+257
View File
@@ -0,0 +1,257 @@
# 📊 数据可视化图表生成器
一个简洁强大的数据可视化工具,支持 **Web UI****API** 两种方式生成精美的对比图表和表格图片。
![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Version](https://img.shields.io/badge/version-1.2.0-green.svg)
## ✨ 功能特性
### 📈 图表类型
- **柱状图** - 支持单系列/多系列对比
- **折线图** - 支持平滑曲线、面积填充
- **混合图** - 柱状图+折线图组合展示
### 📋 表格功能
- **表格图片生成** - 根据数据生成精美的表格图片
- **多种主题** - 与图表共享5种主题风格
- **自定义样式** - 字体大小、斑马纹、边框等可配置
- **中文支持** - 完美支持中文内容显示
### 🎨 自定义配置
- **主题风格** - 5种预设主题(默认/深色/马卡龙/渐变/复古)
- **颜色自定义** - 每个系列可单独设置颜色
- **顺序调整** - 拖拽即可调整系列显示顺序(Web UI)
- **显示选项** - 图例、网格线、数据标签、堆叠模式等
### 📐 区域分割
- 支持左右区域分割,适合对比分析(如:2023年 vs 2024年)
- 可自定义分割线样式(实线/虚线/点线)
- 自动标注左右区域标签
### 📡 API 接口
- **POST /api/chart** - JSON 请求体生成图表(完整参数支持)
- **GET /api/chart** - URL 参数生成图表(简单场景)
- **POST /api/table** - JSON 请求体生成表格图片
- **GET /api/table** - URL 参数生成表格图片
- 返回 PNG 图片,支持自定义分辨率和像素倍率
### 📥 导出功能
- Web UI 导出 PNG2倍分辨率)
- API 直接返回 PNG 图片流
## 🚀 快速开始
### 启动服务
```bash
cd data-chart-tool
npm install
npm start
# 或
node server.js
```
服务默认运行在 `16016` 端口,可通过环境变量修改:
```bash
PORT=8080 node server.js
```
### Web UI
浏览器访问 `http://localhost:16016` 即可使用可视化界面。
### API 调用
#### POST 方式(推荐)
```bash
curl -X POST http://localhost:16016/api/chart \
-H "Content-Type: application/json" \
-d '{
"data": "产品, Q1, Q2, Q3, Q4\n手机, 1200, 1800, 2100, 2500\n平板, 800, 950, 1100, 1300",
"chartType": "bar",
"title": "季度销售对比",
"theme": "default",
"width": 800,
"height": 500
}' -o chart.png
```
#### GET 方式
```bash
curl "http://localhost:16016/api/chart?data=产品,Q1,Q2\n手机,100,200\n平板,150,250&type=bar&title=测试" -o chart.png
```
#### Python 调用示例
```python
import requests
resp = requests.post('http://localhost:16016/api/chart', json={
"data": "月份, 营收, 利润\n1月, 500, 80\n2月, 680, 120\n3月, 820, 160",
"chartType": "line",
"title": "增长趋势",
"theme": "dark",
"showLabel": True,
"width": 900,
"height": 500
})
with open('chart.png', 'wb') as f:
f.write(resp.content)
```
### 生成表格图片
#### POST 方式
```bash
curl -X POST http://localhost:16016/api/table \
-H "Content-Type: application/json" \
-d '{
"data": "姓名, 部门, 职位, 薪资\n张三, 技术部, 工程师, 15000\n李四, 产品部, 产品经理, 18000\n王五, 设计部, UI设计师, 16000",
"title": "员工信息表",
"theme": "default"
}' -o table.png
```
#### GET 方式
```bash
curl "http://localhost:16016/api/table?data=产品,价格,库存\n手机,2999,100\n平板,1999,50&title=产品列表" -o table.png
```
## 📡 API 文档
### POST /api/chart
通过 JSON 请求体生成图表图片。
**请求参数:**
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| data | string | ✅ | - | CSV 格式数据(`\n` 换行,第一行表头,第一列横坐标) |
| chartType | string | - | bar | 图表类型:`bar` / `line` / `bar-line` |
| title | string | - | "" | 图表标题 |
| theme | string | - | default | 主题:`default` / `dark` / `macarons` / `gradient` / `retro` |
| showLegend | boolean | - | true | 是否显示图例 |
| showGrid | boolean | - | true | 是否显示网格线 |
| showLabel | boolean | - | false | 是否显示数据标签 |
| stackMode | boolean | - | false | 是否堆叠模式 |
| smoothLine | boolean | - | true | 折线图是否平滑 |
| enableSplit | boolean | - | false | 是否启用区域分割 |
| splitIndex | number | - | 3 | 分割位置索引 |
| leftLabel | string | - | "左侧" | 左侧区域标签 |
| rightLabel | string | - | "右侧" | 右侧区域标签 |
| splitStyle | string | - | "solid" | 分割线样式:`solid` / `dashed` / `dotted` |
| width | number | - | 800 | 图片宽度(px) |
| height | number | - | 500 | 图片高度(px) |
| pixelRatio | number | - | 2 | 像素倍率(清晰度) |
**返回:** `image/png` 二进制流
### GET /api/chart
通过 URL 参数生成图表(适合简单场景)。
| 参数 | 说明 |
|------|------|
| data | CSV 数据(换行用 `\n` 表示) |
| type | 图表类型 |
| title | 图表标题 |
| theme | 主题风格 |
| width | 图片宽度 |
| height | 图片高度 |
### POST /api/table
通过 JSON 请求体生成表格图片。
**请求参数:**
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| data | string | ✅ | - | CSV 格式数据(`\n` 换行,第一行表头) |
| title | string | - | "" | 表格标题 |
| theme | string | - | default | 主题:`default` / `dark` / `macarons` / `gradient` / `retro` |
| fontSize | number | - | 14 | 字体大小 |
| cellPadding | number | - | 12 | 单元格内边距 |
| borderWidth | number | - | 1 | 边框宽度 |
| stripeRows | boolean | - | true | 是否斑马纹 |
| pixelRatio | number | - | 2 | 像素倍率(清晰度) |
| maxWidth | number | - | 1200 | 最大宽度(px) |
**返回:** `image/png` 二进制流
### GET /api/table
通过 URL 参数生成表格图片。
| 参数 | 说明 |
|------|------|
| data | CSV 数据(换行用 `\n` 表示) |
| title | 表格标题 |
| theme | 主题风格 |
| fontSize | 字体大小 |
| stripeRows | 是否斑马纹 |
### GET /api/health
健康检查,返回服务状态。
### GET /api/docs
返回 API 文档(JSON 格式)。
## 📝 数据格式
第一行为**表头**(系列名称),第一列为**横坐标值**,支持逗号、制表符分隔:
```
类别, 系列1, 系列2, 系列3
A, 10, 20, 30
B, 15, 25, 35
C, 20, 30, 40
```
## 🛠️ 技术栈
- **ECharts 5.5.0** - 图表渲染引擎
- **@napi-rs/canvas** - Node.js 服务端 Canvas 渲染
- **Express** - Web 服务框架
- **原生 HTML/CSS/JS** - 前端无框架依赖
## 📁 项目结构
```
data-chart-tool/
├── server.js # Node.js 后端(API 服务)
├── app.js # 前端核心逻辑
├── index.html # Web UI 主页面
├── style.css # 样式文件
├── package.json # 依赖管理
└── README.md # 项目说明
```
## 🔧 开发计划
- [x] 支持 API 生成图表图片
- [x] 支持表格图片生成
- [ ] 支持饼图、雷达图等更多图表类型
- [ ] 支持从 Excel/CSV 文件导入
- [ ] 支持数据编辑和实时预览
- [ ] 添加更多主题风格
- [ ] 支持图表模板保存和分享
- [ ] 支持 SVG 格式服务端导出
## 📄 License
MIT License
---
Made with ❤️ by 黄庄4号程序员
+113
View File
@@ -3,6 +3,8 @@ let chartInstance = null;
let parsedData = null;
let seriesColors = [];
let seriesOrder = [];
let currentMode = 'chart'; // 'chart' or 'table'
let tableImageBlob = null;
// ===== 预设颜色方案 =====
const colorPalettes = {
@@ -605,3 +607,114 @@ function exportChart(format) {
svgChart.dispose();
}
}
// ===== 模式切换 =====
function switchMode(mode) {
currentMode = mode;
// 更新按钮状态
document.getElementById('btnChartMode').classList.toggle('active', mode === 'chart');
document.getElementById('btnTableMode').classList.toggle('active', mode === 'table');
// 显示/隐藏配置区
document.getElementById('chartConfigSection').style.display = mode === 'chart' ? 'block' : 'none';
document.getElementById('tableConfigSection').style.display = mode === 'table' ? 'block' : 'none';
document.getElementById('seriesConfigSection').style.display = mode === 'chart' ? 'block' : 'none';
document.getElementById('splitConfigSection').style.display = mode === 'chart' ? 'block' : 'none';
// 更新生成按钮
const btnGenerate = document.getElementById('btnGenerate');
btnGenerate.textContent = mode === 'chart' ? '🎨 生成图表' : '📋 生成表格';
// 更新导出按钮
const btnExportSvg = document.getElementById('btnExportSvg');
btnExportSvg.style.display = mode === 'chart' ? 'inline-flex' : 'none';
// 重新生成
generate();
}
// ===== 统一生成入口 =====
function generate() {
if (currentMode === 'chart') {
generateChart();
} else {
generateTable();
}
}
// ===== 更新字体大小显示 =====
function updateFontSize() {
const val = document.getElementById('tableFontSize').value;
document.getElementById('fontSizeValue').textContent = val;
}
// ===== 生成表格 =====
function generateTable() {
const rawText = document.getElementById('dataInput').value;
if (!rawText.trim()) {
alert('请输入数据');
return;
}
const params = {
data: rawText,
title: document.getElementById('tableTitle').value,
theme: document.getElementById('tableTheme').value,
fontSize: parseInt(document.getElementById('tableFontSize').value) || 14,
stripeRows: document.getElementById('stripeRows').checked,
pixelRatio: 2
};
const chartArea = document.getElementById('chartArea');
chartArea.innerHTML = '<div class="placeholder"><p>⏳</p><p>正在生成表格...</p></div>';
fetch('/api/table', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(params)
})
.then(res => {
if (!res.ok) throw new Error('表格生成失败');
return res.blob();
})
.then(blob => {
tableImageBlob = blob;
const url = URL.createObjectURL(blob);
chartArea.innerHTML = `<div class="table-preview"><img src="${url}" alt="表格预览"></div>`;
})
.catch(err => {
chartArea.innerHTML = `<div class="placeholder"><p>❌</p><p>${err.message}</p></div>`;
});
}
// ===== 更新表格(配置变更时) =====
function updateTable() {
if (currentMode === 'table' && document.getElementById('dataInput').value.trim()) {
generateTable();
}
}
// ===== 统一导出图片 =====
function exportImage(format) {
if (currentMode === 'chart') {
exportChart(format);
} else {
exportTable(format);
}
}
// ===== 导出表格 =====
function exportTable(format) {
if (!tableImageBlob) {
alert('请先生成表格');
return;
}
const url = URL.createObjectURL(tableImageBlob);
const a = document.createElement('a');
a.href = url;
a.download = 'table.png';
a.click();
URL.revokeObjectURL(url);
}
+54 -8
View File
@@ -12,18 +12,26 @@
<!-- 顶部标题 -->
<header class="app-header">
<h1>📊 数据可视化图表生成器</h1>
<p class="subtitle">粘贴数据,生成精美图表</p>
<p class="subtitle">粘贴数据,生成精美图表或表格</p>
</header>
<div class="main-content">
<!-- 左侧面板:数据输入和配置 -->
<div class="left-panel">
<!-- 模式切换 -->
<div class="panel-section">
<div class="mode-switch">
<button class="mode-btn active" id="btnChartMode" onclick="switchMode('chart')">📈 图表模式</button>
<button class="mode-btn" id="btnTableMode" onclick="switchMode('table')">📋 表格模式</button>
</div>
</div>
<!-- 数据输入区 -->
<div class="panel-section">
<h2>📝 数据输入</h2>
<div class="input-format-hint">
<p><strong>格式说明:</strong></p>
<p>第一行为表头(系列名称),第一列为横坐标值</p>
<p>第一行为表头,后续行为数据</p>
<pre>类别, 系列1, 系列2, 系列3
A, 10, 20, 30
B, 15, 25, 35
@@ -31,14 +39,14 @@ C, 20, 30, 40</pre>
</div>
<textarea id="dataInput" placeholder="在此粘贴数据...&#10;支持逗号、制表符分隔&#10;&#10;示例:&#10;产品, 2023年, 2024年, 2025年&#10;Q1, 120, 150, 180&#10;Q2, 200, 220, 260&#10;Q3, 180, 210, 240&#10;Q4, 250, 280, 320"></textarea>
<div class="btn-group">
<button class="btn btn-primary" onclick="generateChart()">🎨 生成图表</button>
<button class="btn btn-primary" id="btnGenerate" onclick="generate()">🎨 生成图表</button>
<button class="btn btn-secondary" onclick="loadSampleData()">📋 加载示例</button>
<button class="btn btn-secondary" onclick="clearData()">🗑️ 清空</button>
</div>
</div>
<!-- 图表配置区 -->
<div class="panel-section">
<div class="panel-section" id="chartConfigSection">
<h2>⚙️ 图表配置</h2>
<div class="config-group">
@@ -78,8 +86,46 @@ C, 20, 30, 40</pre>
</div>
</div>
<!-- 表格配置区 -->
<div class="panel-section" id="tableConfigSection" style="display:none;">
<h2>⚙️ 表格配置</h2>
<div class="config-group">
<label>标题</label>
<input type="text" id="tableTitle" placeholder="表格标题" oninput="updateTable()">
</div>
<div class="config-group">
<label>主题风格</label>
<select id="tableTheme" onchange="updateTable()">
<option value="default">默认</option>
<option value="dark">深色</option>
<option value="macarons">马卡龙</option>
<option value="gradient">渐变</option>
<option value="retro">复古</option>
<option value="ocean">海洋</option>
<option value="forest">森林</option>
<option value="sunset">日落</option>
<option value="lavender">薰衣草</option>
<option value="minimal">极简</option>
</select>
</div>
<div class="config-group">
<label>字体大小: <span id="fontSizeValue">14</span>px</label>
<input type="range" id="tableFontSize" min="10" max="24" value="14" oninput="updateFontSize(); updateTable()">
</div>
<div class="config-group">
<label>显示选项</label>
<div class="checkbox-group">
<label><input type="checkbox" id="stripeRows" checked onchange="updateTable()"> 斑马纹</label>
</div>
</div>
</div>
<!-- 系列配置区 -->
<div class="panel-section">
<div class="panel-section" id="seriesConfigSection">
<h2>🎨 系列配置</h2>
<div id="seriesConfig" class="series-config">
<p class="hint-text">生成图表后可在此调整各系列的顺序和颜色</p>
@@ -87,7 +133,7 @@ C, 20, 30, 40</pre>
</div>
<!-- 区域分割配置 -->
<div class="panel-section">
<div class="panel-section" id="splitConfigSection">
<h2>📐 区域分割</h2>
<div class="config-group">
<label><input type="checkbox" id="enableSplit" onchange="updateChart()"> 启用区域分割</label>
@@ -119,8 +165,8 @@ C, 20, 30, 40</pre>
<!-- 导出按钮 -->
<div class="panel-section">
<div class="btn-group">
<button class="btn btn-success" onclick="exportChart('png')">📥 导出PNG</button>
<button class="btn btn-success" onclick="exportChart('svg')">📥 导出SVG</button>
<button class="btn btn-success" onclick="exportImage('png')">📥 导出PNG</button>
<button class="btn btn-success" id="btnExportSvg" onclick="exportImage('svg')">📥 导出SVG</button>
</div>
</div>
</div>
+1146
View File
File diff suppressed because it is too large Load Diff
+16
View File
@@ -0,0 +1,16 @@
{
"name": "data-chart-tool",
"version": "1.1.0",
"description": "数据可视化图表生成器 - 支持 Web UI 和 API 生成图表图片",
"main": "server.js",
"scripts": {
"start": "node server.js",
"dev": "node server.js"
},
"dependencies": {
"express": "^4.18.2",
"echarts": "^5.5.0",
"@napi-rs/canvas": "^0.1.58",
"cors": "^2.8.5"
}
}
+876
View File
@@ -0,0 +1,876 @@
const express = require('express');
const cors = require('cors');
const { createCanvas, registerFont } = require('@napi-rs/canvas');
const echarts = require('echarts');
const path = require('path');
// 注册中文字体
try {
registerFont('/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc', { family: 'Noto Sans CJK SC' });
registerFont('/usr/share/fonts/opentype/noto/NotoSansCJK-Bold.ttc', { family: 'Noto Sans CJK SC', weight: 'bold' });
} catch (e) {
console.warn('中文字体注册失败,将使用系统默认字体:', e.message);
}
const app = express();
const PORT = process.env.PORT || 16016;
// 中间件
app.use(cors());
app.use(express.json({ limit: '10mb' }));
app.use(express.urlencoded({ extended: true, limit: '10mb' }));
// 静态文件(前端页面)
app.use(express.static(path.join(__dirname)));
// ===== 预设颜色方案 =====
const colorPalettes = {
default: ['#5470c6', '#91cc75', '#fac858', '#ee6666', '#73c0de', '#3ba272', '#fc8452', '#9a60b4', '#ea7ccc'],
dark: ['#4fc3f7', '#81c784', '#fff176', '#ff8a65', '#ba68c8', '#4dd0e1', '#ffab91', '#aed581', '#f48fb1'],
macarons: ['#2ec7c9', '#b6a2de', '#5ab1ef', '#ffb980', '#d87a80', '#8d98b3', '#e5cf0d', '#97b552', '#95706d'],
gradient: ['#7f7fd5', '#86a8e7', '#91eae4', '#ff6b6b', '#feca57', '#48dbfb', '#ff9ff3', '#54a0ff', '#5f27cd'],
retro: ['#d4a5a5', '#95b9c7', '#f6e8c3', '#dfceb4', '#a4c3b5', '#c9b1ff', '#f5c7b8', '#b8d4e3', '#e8c8a0']
};
// ===== 数据解析(与前端一致) =====
function parseData(rawText) {
const lines = rawText.trim().split('\n').filter(l => l.trim());
if (lines.length < 2) {
throw new Error('数据至少需要包含表头和一行数据');
}
// 自动检测分隔符
let delimiter = ',';
if (lines[0].includes('\t')) {
delimiter = '\t';
} else if (lines[0].split('|').length > lines[0].split(',').length) {
delimiter = '|';
}
const rows = lines.map(line => {
return line.split(delimiter).map(cell => cell.trim());
});
const headers = rows[0];
const categories = [];
const seriesData = {};
for (let i = 1; i < headers.length; i++) {
seriesData[headers[i]] = [];
}
for (let i = 1; i < rows.length; i++) {
categories.push(rows[i][0]);
for (let j = 1; j < rows[i].length && j < headers.length; j++) {
const val = parseFloat(rows[i][j]);
seriesData[headers[j]].push(isNaN(val) ? 0 : val);
}
}
return {
categories,
seriesNames: headers.slice(1),
seriesData
};
}
// ===== 颜色工具 =====
function adjustColor(hex, amount) {
hex = hex.replace('#', '');
const num = parseInt(hex, 16);
let r = Math.min(255, ((num >> 16) & 0xff) + amount);
let g = Math.min(255, ((num >> 8) & 0xff) + amount);
let b = Math.min(255, (num & 0xff) + amount);
return `rgb(${r},${g},${b})`;
}
// ===== 构建 ECharts option =====
function buildChartOption(params) {
const {
data,
chartType = 'bar',
title = '',
theme = 'default',
showLegend = true,
showGrid = true,
showLabel = false,
stackMode = false,
smoothLine = true,
enableSplit = false,
splitIndex = 3,
leftLabel = '左侧',
rightLabel = '右侧',
splitStyle = 'solid',
seriesColors: customColors = null
} = params;
const parsedData = parseData(data);
const palette = colorPalettes[theme] || colorPalettes.default;
const seriesColorsArr = customColors || parsedData.seriesNames.map((_, i) => palette[i % palette.length]);
// 背景色和文字色
const bgColor = theme === 'dark' ? '#1a1a2e' : '#ffffff';
const textColor = theme === 'dark' ? '#e0e0e0' : '#333333';
const axisLineColor = theme === 'dark' ? '#444' : '#ddd';
// 构建系列
const series = parsedData.seriesNames.map((name, idx) => {
const dataArr = parsedData.seriesData[name];
const color = seriesColorsArr[idx] || palette[idx % palette.length];
let type = chartType === 'bar-line'
? (idx % 2 === 0 ? 'bar' : 'line')
: chartType;
const seriesItem = {
name: name,
type: type,
data: [...dataArr],
itemStyle: { color: color },
emphasis: {
focus: 'series',
itemStyle: {
shadowBlur: 10,
shadowColor: 'rgba(0,0,0,0.3)'
}
}
};
if (stackMode) {
seriesItem.stack = 'total';
}
if (type === 'line') {
seriesItem.smooth = smoothLine;
seriesItem.lineStyle = { width: 3 };
seriesItem.symbolSize = 8;
seriesItem.areaStyle = theme === 'gradient' ? { opacity: 0.15 } : undefined;
}
if (type === 'bar') {
seriesItem.barMaxWidth = 40;
seriesItem.itemStyle.borderRadius = stackMode ? [0, 0, 0, 0] : [4, 4, 0, 0];
}
if (showLabel) {
seriesItem.label = {
show: true,
position: 'top',
fontSize: 11,
color: textColor,
formatter: (p) => {
if (p.value >= 10000) return (p.value / 10000).toFixed(1) + 'w';
if (p.value >= 1000) return (p.value / 1000).toFixed(1) + 'k';
return p.value;
}
};
}
return seriesItem;
});
// 区域分割
if (enableSplit && splitIndex < parsedData.categories.length && series.length > 0) {
const splitLineColor = theme === 'dark' ? '#ff6b6b' : '#e74c3c';
series[0].markArea = {
silent: true,
data: [
[
{
name: leftLabel,
xAxis: parsedData.categories[0],
itemStyle: {
color: theme === 'dark' ? 'rgba(79,195,247,0.06)' : 'rgba(79,70,229,0.05)',
borderWidth: 0
},
label: {
show: true,
position: 'insideTop',
fontSize: 13,
fontWeight: 'bold',
color: theme === 'dark' ? '#4fc3f7' : '#4f46e5',
offset: [0, 10]
}
},
{ xAxis: parsedData.categories[splitIndex - 1] }
],
[
{
name: rightLabel,
xAxis: parsedData.categories[splitIndex],
itemStyle: {
color: theme === 'dark' ? 'rgba(255,107,107,0.06)' : 'rgba(239,68,68,0.05)',
borderWidth: 0
},
label: {
show: true,
position: 'insideTop',
fontSize: 13,
fontWeight: 'bold',
color: theme === 'dark' ? '#ff6b6b' : '#ef4444',
offset: [0, 10]
}
},
{ xAxis: parsedData.categories[parsedData.categories.length - 1] }
]
]
};
}
// 完整 option
const option = {
backgroundColor: bgColor,
title: title ? {
text: title,
left: 'center',
top: 15,
textStyle: {
color: textColor,
fontSize: 18,
fontWeight: 600
}
} : undefined,
tooltip: { show: false },
legend: showLegend ? {
show: true,
top: title ? 50 : 15,
textStyle: { color: textColor, fontSize: 12 },
itemGap: 20,
icon: 'roundRect'
} : { show: false },
grid: {
left: '3%',
right: '4%',
bottom: '3%',
top: showLegend ? (title ? 90 : 60) : (title ? 60 : 30),
containLabel: true
},
xAxis: {
type: 'category',
data: parsedData.categories,
axisLine: { lineStyle: { color: axisLineColor } },
axisLabel: {
color: textColor,
fontSize: 12,
interval: 0,
rotate: parsedData.categories.length > 10 ? 30 : 0
},
axisTick: { show: false }
},
yAxis: {
type: 'value',
axisLine: { show: false },
axisTick: { show: false },
axisLabel: { color: textColor, fontSize: 11 },
splitLine: {
show: showGrid,
lineStyle: {
color: theme === 'dark' ? '#333' : '#f0f0f0',
type: 'dashed'
}
}
},
series: series,
animation: false // 服务端渲染关闭动画
};
return option;
}
// ===== API: 生成图表图片 =====
app.post('/api/chart', (req, res) => {
try {
const params = req.body;
if (!params.data) {
return res.status(400).json({ error: '缺少 data 参数(CSV 格式数据)' });
}
const width = parseInt(params.width) || 800;
const height = parseInt(params.height) || 500;
const format = params.format || 'png';
const pixelRatio = parseInt(params.pixelRatio) || 2;
// 构建图表配置
const option = buildChartOption(params);
// 创建 canvas 并渲染
const canvas = createCanvas(width * pixelRatio, height * pixelRatio);
const chart = echarts.init(canvas, null, {
renderer: 'canvas',
width: width,
height: height,
devicePixelRatio: pixelRatio
});
chart.setOption(option);
// 输出图片
if (format === 'svg') {
// SVG 需要用 SVG 渲染器重新渲染
// node-canvas 不支持 SVG,返回 PNG 并提示
const buffer = canvas.toBuffer('image/png');
res.set({
'Content-Type': 'image/png',
'Content-Length': buffer.length,
'X-Chart-Format': 'png',
'X-Chart-Note': 'SVG format not supported in server-side rendering, returned PNG instead'
});
res.send(buffer);
} else {
const buffer = canvas.toBuffer('image/png');
res.set({
'Content-Type': 'image/png',
'Content-Length': buffer.length,
'X-Chart-Width': width,
'X-Chart-Height': height,
'X-Chart-Pixel-Ratio': pixelRatio
});
res.send(buffer);
}
chart.dispose();
} catch (err) {
console.error('Chart generation error:', err);
res.status(500).json({ error: '图表生成失败: ' + err.message });
}
});
// ===== API: 生成图表(GET 方式,方便 URL 直接调用) =====
app.get('/api/chart', (req, res) => {
try {
const params = {
data: req.query.data,
chartType: req.query.chartType || req.query.type || 'bar',
title: req.query.title || '',
theme: req.query.theme || 'default',
showLegend: req.query.showLegend !== 'false',
showGrid: req.query.showGrid !== 'false',
showLabel: req.query.showLabel === 'true',
stackMode: req.query.stackMode === 'true',
smoothLine: req.query.smoothLine !== 'false',
enableSplit: req.query.enableSplit === 'true',
splitIndex: parseInt(req.query.splitIndex) || 3,
leftLabel: req.query.leftLabel || '左侧',
rightLabel: req.query.rightLabel || '右侧',
splitStyle: req.query.splitStyle || 'solid',
width: parseInt(req.query.width) || 800,
height: parseInt(req.query.height) || 500,
format: req.query.format || 'png',
pixelRatio: parseInt(req.query.pixelRatio) || 2
};
if (!params.data) {
return res.status(400).json({ error: '缺少 data 参数' });
}
// 解码 data(支持 URL 编码的换行符)
params.data = params.data.replace(/\\n/g, '\n');
const option = buildChartOption(params);
const width = params.width;
const height = params.height;
const pixelRatio = params.pixelRatio;
const canvas = createCanvas(width * pixelRatio, height * pixelRatio);
const chart = echarts.init(canvas, null, {
renderer: 'canvas',
width: width,
height: height,
devicePixelRatio: pixelRatio
});
chart.setOption(option);
const buffer = canvas.toBuffer('image/png');
res.set({
'Content-Type': 'image/png',
'Content-Length': buffer.length,
'X-Chart-Width': width,
'X-Chart-Height': height
});
res.send(buffer);
chart.dispose();
} catch (err) {
console.error('Chart generation error:', err);
res.status(500).json({ error: '图表生成失败: ' + err.message });
}
});
// ===== 表格数据解析(保留原始文本) =====
function parseTableData(rawText) {
const lines = rawText.trim().split('\n').filter(l => l.trim());
if (lines.length < 2) {
throw new Error('数据至少需要包含表头和一行数据');
}
// 自动检测分隔符
let delimiter = ',';
if (lines[0].includes('\t')) {
delimiter = '\t';
} else if (lines[0].split('|').length > lines[0].split(',').length) {
delimiter = '|';
}
const rows = lines.map(line => {
return line.split(delimiter).map(cell => cell.trim());
});
return {
headers: rows[0],
rows: rows.slice(1)
};
}
// ===== 表格主题配置 =====
const tableThemes = {
default: {
bgColor: '#ffffff',
headerBg: '#5470c6',
headerColor: '#ffffff',
cellColor: '#333333',
borderColor: '#e0e0e0',
stripeColor: '#f8f9fa',
titleColor: '#333333'
},
dark: {
bgColor: '#1a1a2e',
headerBg: '#4fc3f7',
headerColor: '#1a1a2e',
cellColor: '#e0e0e0',
borderColor: '#444444',
stripeColor: '#252540',
titleColor: '#e0e0e0'
},
macarons: {
bgColor: '#ffffff',
headerBg: '#2ec7c9',
headerColor: '#ffffff',
cellColor: '#333333',
borderColor: '#e8e8e8',
stripeColor: '#f0fafb',
titleColor: '#333333'
},
gradient: {
bgColor: '#ffffff',
headerBg: '#7f7fd5',
headerColor: '#ffffff',
cellColor: '#333333',
borderColor: '#e8e8e8',
stripeColor: '#f5f5ff',
titleColor: '#333333'
},
retro: {
bgColor: '#fefefe',
headerBg: '#95b9c7',
headerColor: '#ffffff',
cellColor: '#444444',
borderColor: '#d4a5a5',
stripeColor: '#f6e8c3',
titleColor: '#444444'
},
ocean: {
bgColor: '#f0f8ff',
headerBg: '#0077b6',
headerColor: '#ffffff',
cellColor: '#023e58',
borderColor: '#90e0ef',
stripeColor: '#caf0f8',
titleColor: '#023e58'
},
forest: {
bgColor: '#f5faf5',
headerBg: '#2d6a4f',
headerColor: '#ffffff',
cellColor: '#1b4332',
borderColor: '#95d5b2',
stripeColor: '#d8f3dc',
titleColor: '#1b4332'
},
sunset: {
bgColor: '#fff8f0',
headerBg: '#e85d04',
headerColor: '#ffffff',
cellColor: '#6a040f',
borderColor: '#ffba08',
stripeColor: '#fff3e0',
titleColor: '#6a040f'
},
lavender: {
bgColor: '#faf5ff',
headerBg: '#7c3aed',
headerColor: '#ffffff',
cellColor: '#4c1d95',
borderColor: '#c4b5fd',
stripeColor: '#ede9fe',
titleColor: '#4c1d95'
},
minimal: {
bgColor: '#ffffff',
headerBg: '#f8f9fa',
headerColor: '#212529',
cellColor: '#495057',
borderColor: '#dee2e6',
stripeColor: '#f8f9fa',
titleColor: '#212529'
}
};
// ===== 测量文字宽度 =====
function measureTextWidth(ctx, text, fontSize) {
ctx.font = `${fontSize}px "Noto Sans CJK SC", sans-serif`;
const metrics = ctx.measureText(text);
return metrics.width;
}
// ===== 生成表格图片 =====
function generateTableImage(params) {
const {
data,
title = '',
theme = 'default',
fontSize = 14,
cellPadding = 12,
borderWidth = 1,
stripeRows = true,
pixelRatio = 2,
maxWidth = 1200
} = params;
const tableData = parseTableData(data);
const { headers, rows } = tableData;
const themeConfig = tableThemes[theme] || tableThemes.default;
// 创建临时 canvas 用于测量文字
const tempCanvas = createCanvas(100, 100);
const tempCtx = tempCanvas.getContext('2d');
// 计算每列最大宽度
const colWidths = headers.map((header, colIdx) => {
let maxW = measureTextWidth(tempCtx, header, fontSize) + cellPadding * 2;
rows.forEach(row => {
if (row[colIdx]) {
const cellW = measureTextWidth(tempCtx, row[colIdx], fontSize) + cellPadding * 2;
if (cellW > maxW) maxW = cellW;
}
});
return Math.min(maxW, 300); // 单列最大宽度 300px
});
// 计算表格总宽度
const tableWidth = colWidths.reduce((sum, w) => sum + w, 0) + borderWidth * 2;
const finalWidth = Math.min(tableWidth, maxWidth);
// 如果超出最大宽度,按比例缩放列宽
if (tableWidth > maxWidth) {
const scale = maxWidth / tableWidth;
colWidths.forEach((_, i) => colWidths[i] *= scale);
}
// 计算行高
const headerHeight = fontSize * 2.5;
const rowHeight = fontSize * 2.2;
const titleHeight = title ? fontSize * 3 : 0;
const tableHeight = headerHeight + rows.length * rowHeight + borderWidth * 2;
const finalHeight = tableHeight + titleHeight;
// 创建正式 canvas
const canvas = createCanvas(finalWidth * pixelRatio, finalHeight * pixelRatio);
const ctx = canvas.getContext('2d');
ctx.scale(pixelRatio, pixelRatio);
// 绘制背景
ctx.fillStyle = themeConfig.bgColor;
ctx.fillRect(0, 0, finalWidth, finalHeight);
let startY = 0;
// 绘制标题
if (title) {
ctx.fillStyle = themeConfig.titleColor;
ctx.font = `bold ${fontSize * 1.4}px "Noto Sans CJK SC", sans-serif`;
ctx.textAlign = 'center';
ctx.textBaseline = 'middle';
ctx.fillText(title, finalWidth / 2, titleHeight / 2);
startY = titleHeight;
}
// 绘制表头背景
ctx.fillStyle = themeConfig.headerBg;
ctx.fillRect(0, startY, finalWidth, headerHeight);
// 绘制表头文字
ctx.fillStyle = themeConfig.headerColor;
ctx.font = `bold ${fontSize}px "Noto Sans CJK SC", sans-serif`;
ctx.textAlign = 'left';
ctx.textBaseline = 'middle';
let x = 0;
headers.forEach((header, i) => {
ctx.fillText(header, x + cellPadding, startY + headerHeight / 2, colWidths[i] - cellPadding * 2);
x += colWidths[i];
});
// 绘制数据行
rows.forEach((row, rowIdx) => {
const y = startY + headerHeight + rowIdx * rowHeight;
// 斑马纹背景
if (stripeRows && rowIdx % 2 === 1) {
ctx.fillStyle = themeConfig.stripeColor;
ctx.fillRect(0, y, finalWidth, rowHeight);
}
// 绘制单元格文字
ctx.fillStyle = themeConfig.cellColor;
ctx.font = `${fontSize}px "Noto Sans CJK SC", sans-serif`;
ctx.textAlign = 'left';
ctx.textBaseline = 'middle';
let cellX = 0;
row.forEach((cell, colIdx) => {
if (cell && colWidths[colIdx]) {
ctx.fillText(cell, cellX + cellPadding, y + rowHeight / 2, colWidths[colIdx] - cellPadding * 2);
}
cellX += colWidths[colIdx];
});
});
// 绘制边框
ctx.strokeStyle = themeConfig.borderColor;
ctx.lineWidth = borderWidth;
// 外边框
ctx.strokeRect(0, startY, finalWidth, tableHeight);
// 横线
ctx.beginPath();
ctx.moveTo(0, startY + headerHeight);
ctx.lineTo(finalWidth, startY + headerHeight);
ctx.stroke();
rows.forEach((_, rowIdx) => {
const y = startY + headerHeight + (rowIdx + 1) * rowHeight;
ctx.beginPath();
ctx.moveTo(0, y);
ctx.lineTo(finalWidth, y);
ctx.stroke();
});
// 竖线
x = 0;
colWidths.forEach((width, i) => {
if (i > 0) {
ctx.beginPath();
ctx.moveTo(x, startY);
ctx.lineTo(x, startY + tableHeight);
ctx.stroke();
}
x += width;
});
return canvas;
}
// ===== API: 生成表格图片 (POST) =====
app.post('/api/table', (req, res) => {
try {
const params = req.body;
if (!params.data) {
return res.status(400).json({ error: '缺少 data 参数(CSV 格式数据)' });
}
const pixelRatio = parseInt(params.pixelRatio) || 2;
const canvas = generateTableImage(params);
const buffer = canvas.toBuffer('image/png');
res.set({
'Content-Type': 'image/png',
'Content-Length': buffer.length,
'X-Table-Format': 'png'
});
res.send(buffer);
} catch (err) {
console.error('Table generation error:', err);
res.status(500).json({ error: '表格生成失败: ' + err.message });
}
});
// ===== API: 生成表格图片 (GET) =====
app.get('/api/table', (req, res) => {
try {
const params = {
data: req.query.data,
title: req.query.title || '',
theme: req.query.theme || 'default',
fontSize: parseInt(req.query.fontSize) || 14,
cellPadding: parseInt(req.query.cellPadding) || 12,
borderWidth: parseInt(req.query.borderWidth) || 1,
stripeRows: req.query.stripeRows !== 'false',
pixelRatio: parseInt(req.query.pixelRatio) || 2,
maxWidth: parseInt(req.query.maxWidth) || 1200
};
if (!params.data) {
return res.status(400).json({ error: '缺少 data 参数' });
}
// 解码 data(支持 URL 编码的换行符)
params.data = params.data.replace(/\\n/g, '\n');
const canvas = generateTableImage(params);
const buffer = canvas.toBuffer('image/png');
res.set({
'Content-Type': 'image/png',
'Content-Length': buffer.length,
'X-Table-Format': 'png'
});
res.send(buffer);
} catch (err) {
console.error('Table generation error:', err);
res.status(500).json({ error: '表格生成失败: ' + err.message });
}
});
// ===== API: 健康检查 =====
app.get('/api/health', (req, res) => {
res.json({
status: 'ok',
service: 'data-chart-tool',
version: '1.2.0',
endpoints: {
'POST /api/chart': '生成图表图片(JSON body',
'GET /api/chart': '生成图表图片(URL 参数)',
'POST /api/table': '生成表格图片(JSON body',
'GET /api/table': '生成表格图片(URL 参数)',
'GET /api/health': '健康检查'
}
});
});
// ===== API: 文档/使用说明 =====
app.get('/api/docs', (req, res) => {
res.json({
name: '数据可视化图表生成器 API',
version: '1.2.0',
endpoints: [
{
method: 'POST',
path: '/api/chart',
description: '通过 JSON 请求体生成图表图片',
'Content-Type': 'application/json',
params: {
data: { type: 'string', required: true, description: 'CSV 格式数据(第一行表头,第一列横坐标)' },
chartType: { type: 'string', default: 'bar', options: ['bar', 'line', 'bar-line'], description: '图表类型' },
title: { type: 'string', default: '', description: '图表标题' },
theme: { type: 'string', default: 'default', options: ['default', 'dark', 'macarons', 'gradient', 'retro'], description: '主题风格' },
showLegend: { type: 'boolean', default: true, description: '是否显示图例' },
showGrid: { type: 'boolean', default: true, description: '是否显示网格线' },
showLabel: { type: 'boolean', default: false, description: '是否显示数据标签' },
stackMode: { type: 'boolean', default: false, description: '是否堆叠模式' },
smoothLine: { type: 'boolean', default: true, description: '折线图是否平滑' },
enableSplit: { type: 'boolean', default: false, description: '是否启用区域分割' },
splitIndex: { type: 'number', default: 3, description: '分割位置索引' },
leftLabel: { type: 'string', default: '左侧', description: '左侧区域标签' },
rightLabel: { type: 'string', default: '右侧', description: '右侧区域标签' },
splitStyle: { type: 'string', default: 'solid', options: ['solid', 'dashed', 'dotted'], description: '分割线样式' },
width: { type: 'number', default: 800, description: '图片宽度(px)' },
height: { type: 'number', default: 500, description: '图片高度(px)' },
format: { type: 'string', default: 'png', options: ['png'], description: '输出格式' },
pixelRatio: { type: 'number', default: 2, description: '像素倍率(清晰度)' }
},
returns: 'image/png',
example: {
request: `curl -X POST http://localhost:16016/api/chart \\
-H "Content-Type: application/json" \\
-d '{
"data": "产品, Q1, Q2, Q3, Q4\\n手机, 1200, 1800, 2100, 2500\\n平板, 800, 950, 1100, 1300",
"chartType": "bar",
"title": "季度销售对比",
"theme": "default",
"width": 800,
"height": 500
}' -o chart.png`,
response: 'PNG 图片二进制流'
}
},
{
method: 'GET',
path: '/api/chart',
description: '通过 URL 参数生成图表图片(适合简单场景)',
params: {
data: { type: 'string', required: true, description: 'CSV 数据(换行用 \\n 分隔)' },
type: { type: 'string', default: 'bar', description: '图表类型' },
title: { type: 'string', description: '图表标题' },
theme: { type: 'string', default: 'default', description: '主题风格' },
width: { type: 'number', default: 800 },
height: { type: 'number', default: 500 }
},
returns: 'image/png',
example: {
request: `curl "http://localhost:16016/api/chart?data=产品,Q1,Q2\\n手机,100,200\\n平板,150,250&type=bar&title=测试" -o chart.png`
}
},
{
method: 'POST',
path: '/api/table',
description: '通过 JSON 请求体生成表格图片',
'Content-Type': 'application/json',
params: {
data: { type: 'string', required: true, description: 'CSV 格式数据(第一行表头)' },
title: { type: 'string', default: '', description: '表格标题' },
theme: { type: 'string', default: 'default', options: ['default', 'dark', 'macarons', 'gradient', 'retro', 'ocean', 'forest', 'sunset', 'lavender', 'minimal'], description: '主题风格' },
fontSize: { type: 'number', default: 14, description: '字体大小' },
cellPadding: { type: 'number', default: 12, description: '单元格内边距' },
borderWidth: { type: 'number', default: 1, description: '边框宽度' },
stripeRows: { type: 'boolean', default: true, description: '是否斑马纹' },
pixelRatio: { type: 'number', default: 2, description: '像素倍率(清晰度)' },
maxWidth: { type: 'number', default: 1200, description: '最大宽度(px)' }
},
returns: 'image/png',
example: {
request: `curl -X POST http://localhost:16016/api/table \\
-H "Content-Type: application/json" \\
-d '{
"data": "姓名, 部门, 职位, 薪资\\n张三, 技术部, 工程师, 15000\\n李四, 产品部, 产品经理, 18000\\n王五, 设计部, UI设计师, 16000",
"title": "员工信息表",
"theme": "default"
}' -o table.png`,
response: 'PNG 图片二进制流'
}
},
{
method: 'GET',
path: '/api/table',
description: '通过 URL 参数生成表格图片',
params: {
data: { type: 'string', required: true, description: 'CSV 数据(换行用 \\n 分隔)' },
title: { type: 'string', description: '表格标题' },
theme: { type: 'string', default: 'default', description: '主题风格' },
fontSize: { type: 'number', default: 14 },
stripeRows: { type: 'boolean', default: true }
},
returns: 'image/png',
example: {
request: `curl "http://localhost:16016/api/table?data=产品,价格,库存\\n手机,2999,100\\n平板,1999,50&title=产品列表" -o table.png`
}
}
]
});
});
// ===== 启动服务 =====
app.listen(PORT, '0.0.0.0', () => {
console.log(`🚀 数据可视化图表生成器已启动`);
console.log(`📊 Web UI: http://0.0.0.0:${PORT}`);
console.log(`📡 图表API: http://0.0.0.0:${PORT}/api/chart`);
console.log(`📋 表格API: http://0.0.0.0:${PORT}/api/table`);
console.log(`📖 文档: http://0.0.0.0:${PORT}/api/docs`);
console.log(`❤️ 健康: http://0.0.0.0:${PORT}/api/health`);
});
+79
View File
@@ -378,3 +378,82 @@ body {
.panel-section {
animation: fadeIn 0.3s ease-out;
}
/* ===== 模式切换 ===== */
.mode-switch {
display: flex;
gap: 8px;
}
.mode-btn {
flex: 1;
padding: 10px 16px;
border: 2px solid var(--border);
border-radius: 8px;
background: white;
font-size: 0.9rem;
font-weight: 500;
cursor: pointer;
transition: all 0.2s;
color: var(--text-light);
}
.mode-btn:hover {
border-color: var(--primary);
color: var(--primary);
}
.mode-btn.active {
background: var(--primary);
border-color: var(--primary);
color: white;
}
/* ===== 表格预览 ===== */
.table-preview {
width: 100%;
height: 100%;
display: flex;
align-items: center;
justify-content: center;
overflow: auto;
}
.table-preview img {
max-width: 100%;
max-height: 100%;
border-radius: 8px;
box-shadow: var(--shadow);
}
/* ===== 滑块样式 ===== */
input[type="range"] {
width: 100%;
height: 6px;
border-radius: 3px;
background: #e2e8f0;
outline: none;
-webkit-appearance: none;
appearance: none;
}
input[type="range"]::-webkit-slider-thumb {
-webkit-appearance: none;
appearance: none;
width: 18px;
height: 18px;
border-radius: 50%;
background: var(--primary);
cursor: pointer;
box-shadow: 0 2px 4px rgba(0,0,0,0.2);
}
input[type="range"]::-moz-range-thumb {
width: 18px;
height: 18px;
border-radius: 50%;
background: var(--primary);
cursor: pointer;
border: none;
box-shadow: 0 2px 4px rgba(0,0,0,0.2);
}