Add unified data sources and stage debug

This commit is contained in:
zhougf committed 2026-05-31 00:04:45 +08:00
1 parent 3fae670e6b
commit 5b300dee0d
18 files changed
+940 -72

No files matched your search

+43 -12
View File
@@ -38,11 +38,27 @@ Dev Screen Starter 只复用基础能力,不复用完整业务页面。每个
使用方式:
```tsx
<ScreenStage background="#061826">
<ScreenStage background="#061826" scaleMode="fit" debug>
<YourScreen />
</ScreenStage>
```
`scaleMode` 支持:
- `fit`:完整显示设计稿,保持比例,可能留黑边,推荐默认使用。
- `fill`:铺满窗口,保持比例,可能裁切边缘。
- `stretch`:横向和纵向分别缩放,不留黑边,但会变形。
- `none`:不缩放,适合局部调试。
`debug` 开启后会显示设计尺寸、视口尺寸、缩放模式和缩放比例。demo 页面支持通过 URL 参数切换:
```txt
http://localhost:5173/?scaleMode=fit
http://localhost:5173/?scaleMode=fill
http://localhost:5173/?scaleMode=stretch
http://localhost:5173/?scaleMode=none
```
### Panel
用于常规图表面板或信息区域。
@@ -75,11 +91,16 @@ Dev Screen Starter 只复用基础能力,不复用完整业务页面。每个
当前提供:
- `createLineOption`:折线图,支持单序列和多序列。
- `createAreaTrendOption`:面积趋势图。
- `createBarOption`:柱状图,支持单序列和多序列。
- `createStackedBarOption`:堆叠柱状图。
- `createDualAxisOption`:双轴折线柱状图。
- `createRankBarOption`:横向排名条。
- `createPieOption`:饼图/环图。
- `createRosePieOption`:玫瑰图。
- `createGaugeOption`:仪表盘。
- `createRadarOption`:雷达图。
- `mergeChartOption`:在默认工厂配置基础上做局部覆盖。
推荐用法:
@@ -95,7 +116,7 @@ Dev Screen Starter 只复用基础能力,不复用完整业务页面。每个
## 4. data
`data` 提供轻量数据工具。
`data` 提供统一数据源工具。一个页面可以集中声明多个数据源,并让不同组件消费同一种 `DataState<T>`。
### requestJson
@@ -105,18 +126,25 @@ Dev Screen Starter 只复用基础能力,不复用完整业务页面。每个
用于定时刷新接口数据。
适合:
### useScreenDataSources
- 30 秒刷新指标。
- 5 秒刷新告警。
- 项目开发时接 mock loader。
统一消费页面级数据源:
不适合:
```tsx
const data = useScreenDataSources(screenDataSources)
const metrics = data.metrics.data ?? []
```
- 高频毫秒级数据。
- 大规模实时流。
配套声明函数:
这些场景建议按项目单独实现 WebSocket、SSE 或 MQTT。
- `defineDataSources`
- `mockSource`
- `httpSource`
- `websocketSource`
- `mqttSource`
- `signalrSource`
其中 `mockSource`、`httpSource`、`websocketSource` 已可用;`mqttSource`、`signalrSource` 已预留类型和声明入口,具体 SDK 在客户项目需要时再接。
## 5. debug
@@ -126,8 +154,6 @@ Dev Screen Starter 只复用基础能力,不复用完整业务页面。每个
显示缩放比例、数据更新时间等轻量信息。生产环境默认不显示,项目可显式打开。
## 6. 项目模板
## 6. visual-kit
`visual-kit` 提供轻量大屏视觉材料,不承担图表逻辑。
@@ -137,9 +163,14 @@ Dev Screen Starter 只复用基础能力,不复用完整业务页面。每个
- `GlowPanel`:带轻微光感的内容面板。
- `CornerFrame`:四角框容器。
- `SectionTitle`:区块标题。
- `TitleBar`:标题栏,支持右侧 action。
- `Divider`:装饰分割线。
- `DigitalNumber`:数字强调。
- `FlipNumber`:数字翻牌。
- `StatusPill`:状态标签。
- `TrendBadge`:趋势标签。
- `ScrollTable`:紧凑滚动表格结构。
- `MarqueeList`:自动滚动列表。
- `WaterLevel`:水位图。
推荐组合: