Add unified data sources and stage debug
This commit is contained in:
1 parent
3fae670e6b
commit
5b300dee0d
18 files changed
+940
-72
No files matched your search
+43
-12
@@ -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`:水位图。
|
||||
|
||||
推荐组合:
|
||||
|
||||
Reference in new issue
Block a user