From 7207aa914cdb8a34c77d67b6e5acddfe64744223 Mon Sep 17 00:00:00 2001 From: zhougf Date: Fri, 29 May 2026 00:29:53 +0800 Subject: [PATCH] Add visual kit components --- README.md | 1 + apps/customer-demo/package.json | 1 + apps/demo-screen/package.json | 1 + apps/demo-screen/src/demo/mockData.ts | 7 + apps/demo-screen/src/pages/DemoOverview.tsx | 28 ++- apps/demo-screen/src/styles/screen.css | 223 ++++++++++++++++++++ doc/framework.md | 31 +++ doc/project-plan.md | 2 + packages/visual-kit/package.json | 20 ++ packages/visual-kit/src/CornerFrame.tsx | 18 ++ packages/visual-kit/src/DigitalNumber.tsx | 18 ++ packages/visual-kit/src/GlowPanel.tsx | 17 ++ packages/visual-kit/src/ScrollTable.tsx | 35 +++ packages/visual-kit/src/SectionTitle.tsx | 13 ++ packages/visual-kit/src/StatusPill.tsx | 8 + packages/visual-kit/src/WaterLevel.tsx | 22 ++ packages/visual-kit/src/index.ts | 7 + packages/visual-kit/tsconfig.json | 7 + pnpm-lock.yaml | 22 ++ templates/project-basic/package.json | 1 + 20 files changed, 481 insertions(+), 1 deletion(-) create mode 100644 packages/visual-kit/package.json create mode 100644 packages/visual-kit/src/CornerFrame.tsx create mode 100644 packages/visual-kit/src/DigitalNumber.tsx create mode 100644 packages/visual-kit/src/GlowPanel.tsx create mode 100644 packages/visual-kit/src/ScrollTable.tsx create mode 100644 packages/visual-kit/src/SectionTitle.tsx create mode 100644 packages/visual-kit/src/StatusPill.tsx create mode 100644 packages/visual-kit/src/WaterLevel.tsx create mode 100644 packages/visual-kit/src/index.ts create mode 100644 packages/visual-kit/tsconfig.json diff --git a/README.md b/README.md index 71b5b6e..9882f1f 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,7 @@ packages/screen-core/ 屏幕适配、舞台、布局基础能力 packages/charts/ ECharts 容器、状态封装、主题工具 packages/data/ HTTP、轮询、mock、数据转换 packages/debug/ 开发调试面板和日志工具 +packages/visual-kit/ 大屏视觉装饰和展示组件 templates/project-basic/ 新客户项目模板 doc/ 项目规划和实施文档 ``` diff --git a/apps/customer-demo/package.json b/apps/customer-demo/package.json index 8c6d519..10abf6c 100644 --- a/apps/customer-demo/package.json +++ b/apps/customer-demo/package.json @@ -13,6 +13,7 @@ "@dev-screen-starter/data": "workspace:*", "@dev-screen-starter/debug": "workspace:*", "@dev-screen-starter/screen-core": "workspace:*", + "@dev-screen-starter/visual-kit": "workspace:*", "@vitejs/plugin-react": "^5.0.4", "echarts": "^6.0.0", "react": "^19.1.1", diff --git a/apps/demo-screen/package.json b/apps/demo-screen/package.json index 0abd757..542904c 100644 --- a/apps/demo-screen/package.json +++ b/apps/demo-screen/package.json @@ -14,6 +14,7 @@ "@dev-screen-starter/data": "workspace:*", "@dev-screen-starter/debug": "workspace:*", "@dev-screen-starter/screen-core": "workspace:*", + "@dev-screen-starter/visual-kit": "workspace:*", "@vitejs/plugin-react": "^5.0.4", "echarts": "^6.0.0", "react": "^19.1.1", diff --git a/apps/demo-screen/src/demo/mockData.ts b/apps/demo-screen/src/demo/mockData.ts index ef0a9da..3f25941 100644 --- a/apps/demo-screen/src/demo/mockData.ts +++ b/apps/demo-screen/src/demo/mockData.ts @@ -36,3 +36,10 @@ export const qualityRadar = { ], values: [88, 76, 68, 92, 84] } + +export const alertRows = [ + { time: '18:20', area: '华东仓', status: '履约延迟' }, + { time: '18:12', area: '华南仓', status: '库存预警' }, + { time: '17:48', area: '华北仓', status: '接口抖动' }, + { time: '17:36', area: '西南仓', status: '人工介入' } +] diff --git a/apps/demo-screen/src/pages/DemoOverview.tsx b/apps/demo-screen/src/pages/DemoOverview.tsx index 416d7c5..c6c5d54 100644 --- a/apps/demo-screen/src/pages/DemoOverview.tsx +++ b/apps/demo-screen/src/pages/DemoOverview.tsx @@ -9,7 +9,8 @@ import { } from '@dev-screen-starter/charts' import { DebugBadge } from '@dev-screen-starter/debug' import { MetricCard, Panel, ScreenStage } from '@dev-screen-starter/screen-core' -import { channelOrders, metrics, orderShare, orderTrend, qualityRadar, regionRank } from '../demo/mockData' +import { CornerFrame, DigitalNumber, GlowPanel, ScrollTable, SectionTitle, StatusPill, WaterLevel } from '@dev-screen-starter/visual-kit' +import { alertRows, channelOrders, metrics, orderShare, orderTrend, qualityRadar, regionRank } from '../demo/mockData' export function DemoOverview() { return ( @@ -19,6 +20,31 @@ export function DemoOverview() { 运营态势总览 +
+ + +
+ + + +
+
+ + + + + + + +
+
{metrics.map((metric) => ( diff --git a/apps/demo-screen/src/styles/screen.css b/apps/demo-screen/src/styles/screen.css index 4bb8c18..79e334e 100644 --- a/apps/demo-screen/src/styles/screen.css +++ b/apps/demo-screen/src/styles/screen.css @@ -46,6 +46,18 @@ body { letter-spacing: 0; } +.visual-strip { + align-items: stretch; + display: grid; + gap: 18px; + grid-template-columns: 1.1fr 0.8fr 0.8fr 1.35fr; + height: 150px; + left: 720px; + position: absolute; + right: 56px; + top: 42px; +} + .metric-row { display: grid; gap: 24px; @@ -141,3 +153,214 @@ body { position: absolute; right: 18px; } + +.vk-glow-panel, +.vk-corner-frame, +.vk-digital-number, +.vk-water-level { + background: rgb(8 22 36 / 78%); + border: 1px solid rgb(88 130 171 / 38%); + border-radius: 8px; +} + +.vk-glow-panel { + box-shadow: 0 0 22px rgb(99 164 255 / 10%); + display: flex; + flex-direction: column; + min-height: 0; + padding: 14px; +} + +.vk-glow-panel header { + color: #d7e6f7; + font-size: 15px; + font-weight: 700; + margin-bottom: 10px; +} + +.vk-glow-panel-body { + flex: 1; + min-height: 0; +} + +.vk-glow-panel.tone-amber { + border-color: rgb(216 161 62 / 42%); + box-shadow: 0 0 22px rgb(216 161 62 / 10%); +} + +.vk-corner-frame { + min-height: 0; + padding: 16px; + position: relative; +} + +.vk-corner-frame .corner { + border-color: #63a4ff; + height: 16px; + position: absolute; + width: 16px; +} + +.corner-tl { + border-left: 1px solid; + border-top: 1px solid; + left: 8px; + top: 8px; +} + +.corner-tr { + border-right: 1px solid; + border-top: 1px solid; + right: 8px; + top: 8px; +} + +.corner-bl { + border-bottom: 1px solid; + border-left: 1px solid; + bottom: 8px; + left: 8px; +} + +.corner-br { + border-bottom: 1px solid; + border-right: 1px solid; + bottom: 8px; + right: 8px; +} + +.vk-section-title strong { + color: #f0f7ff; + display: block; + font-size: 18px; +} + +.vk-section-title span { + color: #88a1bd; + display: block; + font-size: 12px; + margin-top: 4px; +} + +.visual-status-row { + display: flex; + gap: 8px; + margin-top: 18px; +} + +.vk-status-pill { + border: 1px solid rgb(86 208 138 / 45%); + border-radius: 999px; + color: #9ee8b8; + font-size: 12px; + padding: 5px 10px; +} + +.vk-status-pill.status-warning { + border-color: rgb(216 161 62 / 50%); + color: #eac66f; +} + +.vk-status-pill.status-danger { + border-color: rgb(236 100 108 / 50%); + color: #ff9fa7; +} + +.vk-digital-number { + display: flex; + flex-direction: column; + justify-content: center; + padding: 18px; +} + +.vk-digital-number span, +.vk-water-level > span { + color: #9fb4cc; + font-size: 14px; +} + +.vk-digital-number strong { + color: #f0f7ff; + font-size: 42px; + line-height: 1; + margin-top: 12px; +} + +.vk-digital-number small { + color: #9fb4cc; + font-size: 16px; + margin-left: 6px; +} + +.vk-water-level { + align-items: center; + display: flex; + gap: 14px; + justify-content: center; + padding: 14px; +} + +.vk-water-level-tank { + border: 1px solid rgb(99 164 255 / 42%); + border-radius: 999px; + height: 96px; + overflow: hidden; + position: relative; + width: 96px; +} + +.vk-water-level-fill { + background: rgb(99 164 255 / 42%); + bottom: 0; + left: 0; + position: absolute; + right: 0; +} + +.vk-water-level-tank strong { + color: #f0f7ff; + font-size: 24px; + left: 50%; + position: absolute; + top: 50%; + transform: translate(-50%, -50%); +} + +.vk-water-level-tank small { + color: #9fb4cc; + font-size: 12px; +} + +.vk-scroll-table { + display: flex; + flex-direction: column; + height: 100%; + min-height: 0; +} + +.vk-scroll-table-head, +.vk-scroll-table-row { + display: flex; + gap: 10px; +} + +.vk-scroll-table-head { + color: #88a1bd; + font-size: 12px; + padding-bottom: 6px; +} + +.vk-scroll-table-body { + display: flex; + flex-direction: column; + gap: 5px; + overflow: hidden; +} + +.vk-scroll-table-row { + background: rgb(99 164 255 / 8%); + border-radius: 4px; + color: #d7e6f7; + font-size: 12px; + padding: 6px 8px; +} diff --git a/doc/framework.md b/doc/framework.md index cb1300f..3aac56e 100644 --- a/doc/framework.md +++ b/doc/framework.md @@ -10,6 +10,7 @@ Dev Screen Starter 只复用基础能力,不复用完整业务页面。每个 - 图表生命周期 - 数据刷新 - 调试体验 +- 视觉装饰 - 项目模板 - 部署约定 @@ -127,6 +128,36 @@ Dev Screen Starter 只复用基础能力,不复用完整业务页面。每个 ## 6. 项目模板 +## 6. visual-kit + +`visual-kit` 提供轻量大屏视觉材料,不承担图表逻辑。 + +当前提供: + +- `GlowPanel`:带轻微光感的内容面板。 +- `CornerFrame`:四角框容器。 +- `SectionTitle`:区块标题。 +- `DigitalNumber`:数字强调。 +- `StatusPill`:状态标签。 +- `ScrollTable`:紧凑滚动表格结构。 +- `WaterLevel`:水位图。 + +推荐组合: + +```tsx + + + +``` + +原则: + +- `visual-kit` 可以包住 `charts`。 +- `charts` 不依赖 `visual-kit`。 +- 客户视觉差异较大时,可以复制组件到项目内定制。 + +## 7. 项目模板 + `templates/project-basic` 是新客户项目起点。 创建命令: diff --git a/doc/project-plan.md b/doc/project-plan.md index a4ed19d..b22f974 100644 --- a/doc/project-plan.md +++ b/doc/project-plan.md @@ -45,6 +45,7 @@ packages/ charts/ ECharts 容器和通用图表默认配置 data/ 请求、轮询、mock、数据转换 debug/ 开发调试浮层 + visual-kit/ 视觉装饰和展示组件 templates/ project-basic/ 新客户项目模板 scripts/ @@ -67,6 +68,7 @@ doc/ - `EChart`:ECharts 自动初始化、销毁和 resize。 - `usePollingData`:基础轮询数据 hook。 - `DebugBadge`:开发环境调试浮层。 +- `visual-kit`:发光面板、四角框、标题、数字强调、状态标签、滚动表格、水位图。 - `demo-screen`:示例大屏项目。 - `project-basic`:新客户项目模板。 - `pnpm new [title]`:新建项目命令。 diff --git a/packages/visual-kit/package.json b/packages/visual-kit/package.json new file mode 100644 index 0000000..ada9a90 --- /dev/null +++ b/packages/visual-kit/package.json @@ -0,0 +1,20 @@ +{ + "name": "@dev-screen-starter/visual-kit", + "version": "0.1.0", + "private": true, + "type": "module", + "exports": { + ".": "./src/index.ts" + }, + "scripts": { + "build": "tsc --noEmit", + "typecheck": "tsc --noEmit" + }, + "dependencies": { + "react": "^19.1.1" + }, + "devDependencies": { + "@types/react": "^19.1.16", + "typescript": "^5.9.2" + } +} diff --git a/packages/visual-kit/src/CornerFrame.tsx b/packages/visual-kit/src/CornerFrame.tsx new file mode 100644 index 0000000..2d691c9 --- /dev/null +++ b/packages/visual-kit/src/CornerFrame.tsx @@ -0,0 +1,18 @@ +import type { ReactNode } from 'react' + +type CornerFrameProps = { + className?: string + children: ReactNode +} + +export function CornerFrame({ className = '', children }: CornerFrameProps) { + return ( +
+ + + + + {children} +
+ ) +} diff --git a/packages/visual-kit/src/DigitalNumber.tsx b/packages/visual-kit/src/DigitalNumber.tsx new file mode 100644 index 0000000..d0f2f7b --- /dev/null +++ b/packages/visual-kit/src/DigitalNumber.tsx @@ -0,0 +1,18 @@ +type DigitalNumberProps = { + label: string + value: string | number + unit?: string + tone?: 'blue' | 'green' | 'amber' +} + +export function DigitalNumber({ label, value, unit, tone = 'blue' }: DigitalNumberProps) { + return ( +
+ {label} + + {value} + {unit ? {unit} : null} + +
+ ) +} diff --git a/packages/visual-kit/src/GlowPanel.tsx b/packages/visual-kit/src/GlowPanel.tsx new file mode 100644 index 0000000..55bce6a --- /dev/null +++ b/packages/visual-kit/src/GlowPanel.tsx @@ -0,0 +1,17 @@ +import type { ReactNode } from 'react' + +type GlowPanelProps = { + title?: string + tone?: 'blue' | 'green' | 'amber' + className?: string + children: ReactNode +} + +export function GlowPanel({ title, tone = 'blue', className = '', children }: GlowPanelProps) { + return ( +
+ {title ?
{title}
: null} +
{children}
+
+ ) +} diff --git a/packages/visual-kit/src/ScrollTable.tsx b/packages/visual-kit/src/ScrollTable.tsx new file mode 100644 index 0000000..3ebfb81 --- /dev/null +++ b/packages/visual-kit/src/ScrollTable.tsx @@ -0,0 +1,35 @@ +type ScrollTableColumn = { + key: keyof T + title: string + width?: string +} + +type ScrollTableProps> = { + columns: Array> + rows: T[] +} + +export function ScrollTable>({ columns, rows }: ScrollTableProps) { + return ( +
+
+ {columns.map((column) => ( + + {column.title} + + ))} +
+
+ {rows.map((row, index) => ( +
+ {columns.map((column) => ( + + {row[column.key]} + + ))} +
+ ))} +
+
+ ) +} diff --git a/packages/visual-kit/src/SectionTitle.tsx b/packages/visual-kit/src/SectionTitle.tsx new file mode 100644 index 0000000..aba9f20 --- /dev/null +++ b/packages/visual-kit/src/SectionTitle.tsx @@ -0,0 +1,13 @@ +type SectionTitleProps = { + title: string + subtitle?: string +} + +export function SectionTitle({ title, subtitle }: SectionTitleProps) { + return ( +
+ {title} + {subtitle ? {subtitle} : null} +
+ ) +} diff --git a/packages/visual-kit/src/StatusPill.tsx b/packages/visual-kit/src/StatusPill.tsx new file mode 100644 index 0000000..b123c85 --- /dev/null +++ b/packages/visual-kit/src/StatusPill.tsx @@ -0,0 +1,8 @@ +type StatusPillProps = { + label: string + status?: 'normal' | 'warning' | 'danger' +} + +export function StatusPill({ label, status = 'normal' }: StatusPillProps) { + return {label} +} diff --git a/packages/visual-kit/src/WaterLevel.tsx b/packages/visual-kit/src/WaterLevel.tsx new file mode 100644 index 0000000..c744f69 --- /dev/null +++ b/packages/visual-kit/src/WaterLevel.tsx @@ -0,0 +1,22 @@ +type WaterLevelProps = { + label: string + value: number + unit?: string +} + +export function WaterLevel({ label, value, unit = '%' }: WaterLevelProps) { + const clamped = Math.min(100, Math.max(0, value)) + + return ( +
+
+
+ + {clamped} + {unit} + +
+ {label} +
+ ) +} diff --git a/packages/visual-kit/src/index.ts b/packages/visual-kit/src/index.ts new file mode 100644 index 0000000..1d914bb --- /dev/null +++ b/packages/visual-kit/src/index.ts @@ -0,0 +1,7 @@ +export * from './GlowPanel' +export * from './CornerFrame' +export * from './SectionTitle' +export * from './DigitalNumber' +export * from './StatusPill' +export * from './ScrollTable' +export * from './WaterLevel' diff --git a/packages/visual-kit/tsconfig.json b/packages/visual-kit/tsconfig.json new file mode 100644 index 0000000..d0b8519 --- /dev/null +++ b/packages/visual-kit/tsconfig.json @@ -0,0 +1,7 @@ +{ + "extends": "../../tsconfig.base.json", + "compilerOptions": { + "jsx": "react-jsx" + }, + "include": ["src"] +} diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 46ca8a4..1ade988 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -26,6 +26,9 @@ importers: '@dev-screen-starter/screen-core': specifier: workspace:* version: link:../../packages/screen-core + '@dev-screen-starter/visual-kit': + specifier: workspace:* + version: link:../../packages/visual-kit '@vitejs/plugin-react': specifier: ^5.0.4 version: 5.2.0(vite@7.3.3) @@ -66,6 +69,9 @@ importers: '@dev-screen-starter/screen-core': specifier: workspace:* version: link:../../packages/screen-core + '@dev-screen-starter/visual-kit': + specifier: workspace:* + version: link:../../packages/visual-kit '@vitejs/plugin-react': specifier: ^5.0.4 version: 5.2.0(vite@7.3.3) @@ -147,6 +153,19 @@ importers: specifier: ^5.9.2 version: 5.9.3 + packages/visual-kit: + dependencies: + react: + specifier: ^19.1.1 + version: 19.2.6 + devDependencies: + '@types/react': + specifier: ^19.1.16 + version: 19.2.15 + typescript: + specifier: ^5.9.2 + version: 5.9.3 + templates/project-basic: dependencies: '@dev-screen-starter/charts': @@ -161,6 +180,9 @@ importers: '@dev-screen-starter/screen-core': specifier: workspace:* version: link:../../packages/screen-core + '@dev-screen-starter/visual-kit': + specifier: workspace:* + version: link:../../packages/visual-kit '@vitejs/plugin-react': specifier: ^5.0.4 version: 5.2.0(vite@7.3.3) diff --git a/templates/project-basic/package.json b/templates/project-basic/package.json index 48f0517..62e9789 100644 --- a/templates/project-basic/package.json +++ b/templates/project-basic/package.json @@ -13,6 +13,7 @@ "@dev-screen-starter/data": "workspace:*", "@dev-screen-starter/debug": "workspace:*", "@dev-screen-starter/screen-core": "workspace:*", + "@dev-screen-starter/visual-kit": "workspace:*", "@vitejs/plugin-react": "^5.0.4", "echarts": "^6.0.0", "react": "^19.1.1",