Add visual kit components

This commit is contained in:
Mac mini git server 2026-05-29 00:29:53 +08:00
parent d136b9dddc
commit 7207aa914c
20 changed files with 481 additions and 1 deletions

View File

@ -33,6 +33,7 @@ packages/screen-core/ 屏幕适配、舞台、布局基础能力
packages/charts/ ECharts 容器、状态封装、主题工具
packages/data/ HTTP、轮询、mock、数据转换
packages/debug/ 开发调试面板和日志工具
packages/visual-kit/ 大屏视觉装饰和展示组件
templates/project-basic/ 新客户项目模板
doc/ 项目规划和实施文档
```

View File

@ -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",

View File

@ -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",

View File

@ -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: '人工介入' }
]

View File

@ -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() {
<strong>运营态势总览</strong>
</header>
<section className="visual-strip">
<CornerFrame>
<SectionTitle title="运行态" subtitle="visual-kit" />
<div className="visual-status-row">
<StatusPill label="稳定" />
<StatusPill label="预警" status="warning" />
<StatusPill label="异常" status="danger" />
</div>
</CornerFrame>
<DigitalNumber label="综合效率" value="92.6" unit="%" tone="green" />
<WaterLevel label="产能水位" value={76} />
<GlowPanel title="实时告警" tone="amber">
<ScrollTable
columns={[
{ key: 'time', title: '时间', width: '68px' },
{ key: 'area', title: '区域' },
{ key: 'status', title: '状态' }
]}
rows={alertRows}
/>
</GlowPanel>
</section>
<section className="metric-row">
{metrics.map((metric) => (
<MetricCard key={metric.label} {...metric} />

View File

@ -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;
}

View File

@ -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
<GlowPanel title="订单趋势">
<EChart option={createLineOption(data)} />
</GlowPanel>
```
原则:
- `visual-kit` 可以包住 `charts`。
- `charts` 不依赖 `visual-kit`。
- 客户视觉差异较大时,可以复制组件到项目内定制。
## 7. 项目模板
`templates/project-basic` 是新客户项目起点。
创建命令:

View File

@ -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 <name> [title]`:新建项目命令。

View File

@ -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"
}
}

View File

@ -0,0 +1,18 @@
import type { ReactNode } from 'react'
type CornerFrameProps = {
className?: string
children: ReactNode
}
export function CornerFrame({ className = '', children }: CornerFrameProps) {
return (
<div className={`vk-corner-frame ${className}`}>
<span className="corner corner-tl" />
<span className="corner corner-tr" />
<span className="corner corner-bl" />
<span className="corner corner-br" />
{children}
</div>
)
}

View File

@ -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 (
<div className={`vk-digital-number tone-${tone}`}>
<span>{label}</span>
<strong>
{value}
{unit ? <small>{unit}</small> : null}
</strong>
</div>
)
}

View File

@ -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 (
<section className={`vk-glow-panel tone-${tone} ${className}`}>
{title ? <header>{title}</header> : null}
<div className="vk-glow-panel-body">{children}</div>
</section>
)
}

View File

@ -0,0 +1,35 @@
type ScrollTableColumn<T> = {
key: keyof T
title: string
width?: string
}
type ScrollTableProps<T extends Record<string, string | number>> = {
columns: Array<ScrollTableColumn<T>>
rows: T[]
}
export function ScrollTable<T extends Record<string, string | number>>({ columns, rows }: ScrollTableProps<T>) {
return (
<div className="vk-scroll-table">
<div className="vk-scroll-table-head">
{columns.map((column) => (
<span key={String(column.key)} style={{ width: column.width }}>
{column.title}
</span>
))}
</div>
<div className="vk-scroll-table-body">
{rows.map((row, index) => (
<div className="vk-scroll-table-row" key={index}>
{columns.map((column) => (
<span key={String(column.key)} style={{ width: column.width }}>
{row[column.key]}
</span>
))}
</div>
))}
</div>
</div>
)
}

View File

@ -0,0 +1,13 @@
type SectionTitleProps = {
title: string
subtitle?: string
}
export function SectionTitle({ title, subtitle }: SectionTitleProps) {
return (
<div className="vk-section-title">
<strong>{title}</strong>
{subtitle ? <span>{subtitle}</span> : null}
</div>
)
}

View File

@ -0,0 +1,8 @@
type StatusPillProps = {
label: string
status?: 'normal' | 'warning' | 'danger'
}
export function StatusPill({ label, status = 'normal' }: StatusPillProps) {
return <span className={`vk-status-pill status-${status}`}>{label}</span>
}

View File

@ -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 (
<div className="vk-water-level">
<div className="vk-water-level-tank">
<div className="vk-water-level-fill" style={{ height: `${clamped}%` }} />
<strong>
{clamped}
<small>{unit}</small>
</strong>
</div>
<span>{label}</span>
</div>
)
}

View File

@ -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'

View File

@ -0,0 +1,7 @@
{
"extends": "../../tsconfig.base.json",
"compilerOptions": {
"jsx": "react-jsx"
},
"include": ["src"]
}

22
pnpm-lock.yaml generated
View File

@ -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)

View File

@ -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",