Commit b202a652 authored by drigle's avatar drigle

style: refine sidebar and app canvas palette

parent 8ac9a08d
# UI 架构 # UI 架构
## 2026-09-29 Shell 配色
- AppShell 采用中性灰白内容画布与低饱和深藏蓝 Sidebar。页面画布由 `theme.css` 的 `--background: oklch(97.4% 0.002 255)` 提供;侧栏背景为 `oklch(32% 0.037 255)`。桌面和移动侧栏共用 `--xinyuan-sidebar-*`,选中导航为提亮的蓝色底与白字,侧栏红色 Logo 直接显示、不加底色;页面仍固定浅色,不提供主题切换。
- 内容画布在 AppShell 顶部使用 4% 侧栏蓝色与 `--background` 混合的轻微渐变,至 18rem 淡出到灰白底色;Navbar 和滚动区共用这一层,页面 Card 与 HeroUI 组件保持原有表面 Token。
- 当前导航使用较亮的同色系底色提高与侧栏的区分度,悬停时保持选中底色;普通导航使用略亮于侧栏的同色系悬停色。
- 此调整仅涉及 Shell 视觉层,不改变 Sidebar 路由、通知入口、页面状态或业务数据协议。
## 分层 ## 分层
1. `src/services` 与 `integrityPartyService.js` 负责接口、Record/metadata 映射、Excel、日期和附件协议。 1. `src/services` 与 `integrityPartyService.js` 负责接口、Record/metadata 映射、Excel、日期和附件协议。
......
# 鑫元设计系统实施规范 # 鑫元设计系统实施规范
## 2026-09-29 Shell 配色调整
当前 AppShell 使用低饱和深藏蓝侧栏与中性灰白内容画布。`theme.css` 的 `--background` 和 `--xinyuan-sidebar-*` 是这组配色的唯一来源:侧栏背景 `oklch(32% 0.037 255)`,页面画布为 `oklch(97.4% 0.002 255)`;侧栏文字为近白色,悬停项为稍亮的蓝色,选中项为提亮的蓝色底与白字。品牌主红 `#DA241A` 不变。侧栏红色 Logo 直接显示,不加底色。桌面与移动侧栏共用这些 Token,导航结构、交互及数据状态不变。后续配色调整以本节和实际 Token 为准。
当前选中项底色为 `oklch(46% 0.055 255)`,与深藏蓝侧栏明确区分。普通项悬停使用侧栏同色系;当前项悬停时保留选中底色和白色文字,不被普通悬停色覆盖。
内容画布顶部使用仅限 AppShell 的轻微渐变:`--xinyuan-canvas-top` 从深藏蓝侧栏色与 `--background` 混合 4% 得到,在顶部至 18rem 处过渡回 `--background`。Navbar 与页面滚动区透出同一层背景;Card、Surface、字段和浮层仍按 HeroUI 原有 Token 渲染。
## 适用范围 ## 适用范围
本应用统一采用鑫元 HeroUI / HeroUI Pro 设计系统。品牌主色固定为 `#DA241A`,浅色和深色主题的 HeroUI `accent`、`focus` 与主操作均保持该品牌色;Hover/Pressed 仅使用品牌红的深浅派生,不随主题自动切换为其他色相。 本应用统一采用鑫元 HeroUI / HeroUI Pro 设计系统。品牌主色固定为 `#DA241A`,浅色和深色主题的 HeroUI `accent`、`focus` 与主操作均保持该品牌色;Hover/Pressed 仅使用品牌红的深浅派生,不随主题自动切换为其他色相。
...@@ -10,7 +18,7 @@ ...@@ -10,7 +18,7 @@
- HeroUI 基础 CSS 使用 `@heroui/styles/css`,HeroUI Pro 使用 `@heroui-pro/react/css`;禁止用 `@heroui/styles` JavaScript 入口代替基础 CSS。 - HeroUI 基础 CSS 使用 `@heroui/styles/css`,HeroUI Pro 使用 `@heroui-pro/react/css`;禁止用 `@heroui/styles` JavaScript 入口代替基础 CSS。
- `theme.css` 是本应用 HeroUI 主题权威源;业务样式不得重定义其核心变量。品牌 `accent/focus` 固定为 `#DA241A`,并提供 `primary-50` 至 `primary-950` 的同色相派生层级。 - `theme.css` 是本应用 HeroUI 主题权威源;业务样式不得重定义其核心变量。品牌 `accent/focus` 固定为 `#DA241A`,并提供 `primary-50` 至 `primary-950` 的同色相派生层级。
- `tokens.css` 仅定义 `--rc-*` 扩展、别名、图表色和组件几何。 - `tokens.css` 仅定义 `--rc-*` 扩展、别名、图表色和组件几何。
- 浅色使用 `xy-logo-red.png`,深色使用 `xy-logo-white.png`,禁止使用 RSM 资产或 CSS 反色。 - 当前侧栏直接显示 `xy-logo-red.png`,不加 Logo 底色;深色主题不切换 Logo。
- 应用展示名统一为“党风廉政建设”。 - 应用展示名统一为“党风廉政建设”。
## 组件边界 ## 组件边界
...@@ -66,7 +74,7 @@ ...@@ -66,7 +74,7 @@
- 文件字段按运行时 `multiple` 使用“材料中心 / 本地上传”。材料选择仅保存 `{name,type,size,url}`;本地上传只形成草稿,保存详情时才以 `source_app: incorrupt_party_build` 创建 `am_material`。 - 文件字段按运行时 `multiple` 使用“材料中心 / 本地上传”。材料选择仅保存 `{name,type,size,url}`;本地上传只形成草稿,保存详情时才以 `source_app: incorrupt_party_build` 创建 `am_material`。
# 本轮基准同步(审计项目管理) # 本轮基准同步(审计项目管理)
- Shell 采用固定深色 Sidebar + 浅色内容区,移除主题切换入口。 - Shell 采用低饱和深藏蓝 Sidebar + 中性灰白内容区,移除主题切换入口;配色以“2026-09-29 Shell 配色调整”为准。
- 分页支持 20/50/100 条/页选择,切换容量回到第一页。 - 分页支持 20/50/100 条/页选择,切换容量回到第一页。
- 图表统一通过 `XinyuanEChart`(ECharts)渲染,饼图使用扇区间隙与圆角;普通分类图表(例如模块柱图、排名图)必须通过 `createResolvedXinyuanChartColorMap` 按稳定顺序使用 `XINYUAN_CHART_CATEGORY_PALETTE` 映射,顺序为品牌红深浅 → 暖土色 → 中性灰紫 → 灰蓝,禁止绿色、荧光色和彩虹式跳色。单一指标或不同指标系列使用与基准一致的 `XINYUAN_CHART_SEMANTIC` 语义色,不得把单一指标的每根柱子人为染成不同颜色;单系列统一使用品牌红 `#DA241A`。年度分布柱图保留单一主色,并显示顶部真实数值、紧凑柱宽和规范圆角,单年份数据也要保持视觉平衡。 - 图表统一通过 `XinyuanEChart`(ECharts)渲染,饼图使用扇区间隙与圆角;普通分类图表(例如模块柱图、排名图)必须通过 `createResolvedXinyuanChartColorMap` 按稳定顺序使用 `XINYUAN_CHART_CATEGORY_PALETTE` 映射,顺序为品牌红深浅 → 暖土色 → 中性灰紫 → 灰蓝,禁止绿色、荧光色和彩虹式跳色。单一指标或不同指标系列使用与基准一致的 `XINYUAN_CHART_SEMANTIC` 语义色,不得把单一指标的每根柱子人为染成不同颜色;单系列统一使用品牌红 `#DA241A`。年度分布柱图保留单一主色,并显示顶部真实数值、紧凑柱宽和规范圆角,单年份数据也要保持视觉平衡。
- 饼图 / 环形图是普通图表色板之外的独立例外,仅由共享 `XinyuanEChart` 读取 `--xinyuan-pie-chart-1` 至 `--xinyuan-pie-chart-16`(别名 `--rc-pie-chart-*`)分配扇区颜色。前六个颜色固定为 `#DA241A`、`#3F5F86`、`#8A668F`、`#C28A3D`、`#8A6253`、`#667080`;其余为低饱和灰蓝、灰紫、暖棕和暖灰扩展色。分类 key 先稳定排序并做冲突消解,同一分类在筛选、排序、Tab 切换和浅深主题下保持同色;禁止绿色、青绿色、荧光色、彩虹色和页面级 `itemStyle.color` 覆盖。该例外不改变普通 Bar/Line/Ranking、KPI、品牌主色、布局或业务逻辑。 - 饼图 / 环形图是普通图表色板之外的独立例外,仅由共享 `XinyuanEChart` 读取 `--xinyuan-pie-chart-1` 至 `--xinyuan-pie-chart-16`(别名 `--rc-pie-chart-*`)分配扇区颜色。前六个颜色固定为 `#DA241A`、`#3F5F86`、`#8A668F`、`#C28A3D`、`#8A6253`、`#667080`;其余为低饱和灰蓝、灰紫、暖棕和暖灰扩展色。分类 key 先稳定排序并做冲突消解,同一分类在筛选、排序、Tab 切换和浅深主题下保持同色;禁止绿色、青绿色、荧光色、彩虹色和页面级 `itemStyle.color` 覆盖。该例外不改变普通 Bar/Line/Ranking、KPI、品牌主色、布局或业务逻辑。
......
import xyLogoWhite from '@/assets/identity/xy-logo-white.png'; import xyLogoRed from '@/assets/identity/xy-logo-red.png';
import { APP_NAME } from '@/config/ApplicationConfig'; import { APP_NAME } from '@/config/ApplicationConfig';
import { Sheet } from '@heroui-pro/react'; import { Sheet } from '@heroui-pro/react';
import { Sidebar, useSidebar } from '@heroui-pro/react/sidebar'; import { Sidebar, useSidebar } from '@heroui-pro/react/sidebar';
...@@ -139,7 +139,7 @@ function SidebarContents({ ...@@ -139,7 +139,7 @@ function SidebarContents({
<div className="app-sidebar-brand rc-sidebar-brand"> <div className="app-sidebar-brand rc-sidebar-brand">
<div className="app-sidebar-brand-mark rc-sidebar-brand-mark"> <div className="app-sidebar-brand-mark rc-sidebar-brand-mark">
<img <img
src={xyLogoWhite} src={xyLogoRed}
alt="鑫元" alt="鑫元"
className="rc-sidebar-logo" className="rc-sidebar-logo"
/> />
......
...@@ -400,7 +400,7 @@ ...@@ -400,7 +400,7 @@
.app-shell-content-scroll { .app-shell-content-scroll {
min-width: 0; min-width: 0;
background: var(--rc-bg-canvas); background: transparent;
overscroll-behavior: contain; overscroll-behavior: contain;
} }
...@@ -1180,7 +1180,11 @@ ...@@ -1180,7 +1180,11 @@
overflow: hidden; overflow: hidden;
border: 0; border: 0;
border-radius: 0; border-radius: 0;
background: var(--rc-bg-canvas); background: linear-gradient(
180deg,
var(--xinyuan-canvas-top) 0,
var(--rc-bg-canvas) 18rem
);
} }
.dark .rc-app-main.sidebar__main, .dark .rc-app-main.sidebar__main,
...@@ -1609,7 +1613,7 @@ ...@@ -1609,7 +1613,7 @@
} }
} }
/* Fixed split-shell theme: dark navigation, permanently light content canvas. */ /* Muted navy navigation beside the permanently light content canvas. */
.template-dashboard-shell .app-sidebar-glass, .template-dashboard-shell .app-sidebar-glass,
.rc-mobile-sidebar.app-sidebar-glass { .rc-mobile-sidebar.app-sidebar-glass {
color: var(--rc-sidebar-foreground); color: var(--rc-sidebar-foreground);
...@@ -1641,13 +1645,17 @@ ...@@ -1641,13 +1645,17 @@
color: var(--rc-sidebar-item-selected-foreground) !important; color: var(--rc-sidebar-item-selected-foreground) !important;
} }
.template-dashboard-shell .sidebar__menu-item:hover .sidebar__menu-item-content,
.template-dashboard-shell .template-dashboard-shell
.sidebar__menu-item[data-hovered='true'] .sidebar__menu-item:not([data-current='true']):hover
.sidebar__menu-item-content,
.template-dashboard-shell
.sidebar__menu-item:not([data-current='true'])[data-hovered='true']
.sidebar__menu-item-content, .sidebar__menu-item-content,
.rc-mobile-sidebar .sidebar__menu-item:hover .sidebar__menu-item-content,
.rc-mobile-sidebar .rc-mobile-sidebar
.sidebar__menu-item[data-hovered='true'] .sidebar__menu-item:not([data-current='true']):hover
.sidebar__menu-item-content,
.rc-mobile-sidebar
.sidebar__menu-item:not([data-current='true'])[data-hovered='true']
.sidebar__menu-item-content, .sidebar__menu-item-content,
.app-sidebar-user-trigger.dropdown__trigger:hover, .app-sidebar-user-trigger.dropdown__trigger:hover,
.app-sidebar-user-trigger.dropdown__trigger[data-hovered='true'] { .app-sidebar-user-trigger.dropdown__trigger[data-hovered='true'] {
......
...@@ -15,7 +15,8 @@ ...@@ -15,7 +15,8 @@
--accent-foreground: oklch(99.11% 0 0); --accent-foreground: oklch(99.11% 0 0);
--accent-hover: #C91F17; --accent-hover: #C91F17;
--accent-pressed: #B51B14; --accent-pressed: #B51B14;
--background: oklch(97.02% 0.0000 29.20); --background: oklch(97.4% 0.002 255);
--xinyuan-canvas-top: color-mix(in oklab, var(--xinyuan-sidebar-background) 4%, var(--background));
--border: oklch(90.00% 0.0000 29.20); --border: oklch(90.00% 0.0000 29.20);
--danger: oklch(45.32% 0.1661 27.03); --danger: oklch(45.32% 0.1661 27.03);
--danger-foreground: oklch(99.11% 0 0); --danger-foreground: oklch(99.11% 0 0);
...@@ -54,18 +55,17 @@ ...@@ -54,18 +55,17 @@
--font-sans: var(--font-inter); --font-sans: var(--font-inter);
/* /*
* Xinyuan fixed split-shell contract. * Xinyuan fixed light canvas with a muted navy Sidebar.
* The application canvas always uses this light theme. The Sidebar is the * Navigation colors are kept separate from HeroUI surfaces.
* only persistent dark plane and must consume these semantic tokens.
*/ */
--xinyuan-sidebar-background: oklch(16% 0.020 255); --xinyuan-sidebar-background: oklch(32% 0.037 255);
--xinyuan-sidebar-border: oklch(26% 0.022 255); --xinyuan-sidebar-border: oklch(41% 0.036 255);
--xinyuan-sidebar-foreground: oklch(97% 0.004 255); --xinyuan-sidebar-foreground: oklch(97% 0.005 255);
--xinyuan-sidebar-muted: oklch(76% 0.018 255); --xinyuan-sidebar-muted: oklch(82% 0.018 255);
--xinyuan-sidebar-item-hover: oklch(22% 0.026 255); --xinyuan-sidebar-item-hover: oklch(39% 0.042 255);
--xinyuan-sidebar-item-selected: oklch(28% 0.016 255); --xinyuan-sidebar-item-selected: oklch(46% 0.055 255);
--xinyuan-sidebar-item-selected-foreground: oklch(99% 0.002 255); --xinyuan-sidebar-item-selected-foreground: oklch(99% 0.002 255);
--xinyuan-sidebar-focus: oklch(78% 0.105 29.20); --xinyuan-sidebar-focus: oklch(85% 0.070 255);
/* /*
* ECharts is the required chart renderer for Xinyuan applications. * ECharts is the required chart renderer for Xinyuan applications.
......
...@@ -46,7 +46,7 @@ ...@@ -46,7 +46,7 @@
--rc-text-muted: var(--muted); --rc-text-muted: var(--muted);
--rc-text-empty: color-mix(in oklab, var(--muted) 72%, var(--background)); --rc-text-empty: color-mix(in oklab, var(--muted) 72%, var(--background));
/* Fixed dark Sidebar aliases. The content canvas remains light. */ /* Muted navy Sidebar aliases. The content canvas remains light. */
--rc-sidebar-background: var(--xinyuan-sidebar-background); --rc-sidebar-background: var(--xinyuan-sidebar-background);
--rc-sidebar-border: var(--xinyuan-sidebar-border); --rc-sidebar-border: var(--xinyuan-sidebar-border);
--rc-sidebar-foreground: var(--xinyuan-sidebar-foreground); --rc-sidebar-foreground: var(--xinyuan-sidebar-foreground);
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment