Add visual kit components
This commit is contained in:
parent
d136b9dddc
commit
7207aa914c
@ -33,6 +33,7 @@ packages/screen-core/ 屏幕适配、舞台、布局基础能力
|
||||
packages/charts/ ECharts 容器、状态封装、主题工具
|
||||
packages/data/ HTTP、轮询、mock、数据转换
|
||||
packages/debug/ 开发调试面板和日志工具
|
||||
packages/visual-kit/ 大屏视觉装饰和展示组件
|
||||
templates/project-basic/ 新客户项目模板
|
||||
doc/ 项目规划和实施文档
|
||||
```
|
||||
|
||||
@ -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",
|
||||
|
||||
@ -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",
|
||||
|
||||
@ -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: '人工介入' }
|
||||
]
|
||||
|
||||
@ -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} />
|
||||
|
||||
@ -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;
|
||||
}
|
||||
|
||||
@ -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` 是新客户项目起点。
|
||||
|
||||
创建命令:
|
||||
|
||||
@ -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]`:新建项目命令。
|
||||
|
||||
20
packages/visual-kit/package.json
Normal file
20
packages/visual-kit/package.json
Normal 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"
|
||||
}
|
||||
}
|
||||
18
packages/visual-kit/src/CornerFrame.tsx
Normal file
18
packages/visual-kit/src/CornerFrame.tsx
Normal 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>
|
||||
)
|
||||
}
|
||||
18
packages/visual-kit/src/DigitalNumber.tsx
Normal file
18
packages/visual-kit/src/DigitalNumber.tsx
Normal 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>
|
||||
)
|
||||
}
|
||||
17
packages/visual-kit/src/GlowPanel.tsx
Normal file
17
packages/visual-kit/src/GlowPanel.tsx
Normal 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>
|
||||
)
|
||||
}
|
||||
35
packages/visual-kit/src/ScrollTable.tsx
Normal file
35
packages/visual-kit/src/ScrollTable.tsx
Normal 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>
|
||||
)
|
||||
}
|
||||
13
packages/visual-kit/src/SectionTitle.tsx
Normal file
13
packages/visual-kit/src/SectionTitle.tsx
Normal 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>
|
||||
)
|
||||
}
|
||||
8
packages/visual-kit/src/StatusPill.tsx
Normal file
8
packages/visual-kit/src/StatusPill.tsx
Normal 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>
|
||||
}
|
||||
22
packages/visual-kit/src/WaterLevel.tsx
Normal file
22
packages/visual-kit/src/WaterLevel.tsx
Normal 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>
|
||||
)
|
||||
}
|
||||
7
packages/visual-kit/src/index.ts
Normal file
7
packages/visual-kit/src/index.ts
Normal 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'
|
||||
7
packages/visual-kit/tsconfig.json
Normal file
7
packages/visual-kit/tsconfig.json
Normal file
@ -0,0 +1,7 @@
|
||||
{
|
||||
"extends": "../../tsconfig.base.json",
|
||||
"compilerOptions": {
|
||||
"jsx": "react-jsx"
|
||||
},
|
||||
"include": ["src"]
|
||||
}
|
||||
22
pnpm-lock.yaml
generated
22
pnpm-lock.yaml
generated
@ -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)
|
||||
|
||||
@ -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",
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user