鸿蒙ArkTS实战：古琴坊移动应用开发全解析——从色彩体系到组件化架构的深度剖析
摘要：本文以一个完整的古琴文化展示与交易管理应用"古琴坊"为案例，深入剖析鸿蒙HarmonyOS ArkTS声明式UI开发范式的核心要点。从以"木棕·朱红·徽金"三色为核心的古风色彩体系的接口化定义，到响应式数据流
@Observed/@ObjectLink在多Tab场景下的深度运用，再到自定义模态弹窗体系、条件渲染路由、layoutWeight弹性布局权重等复杂交互模式的完整实现，逐段拆解每一个关键代码块背后的设计思想与技术原理。全文覆盖接口约束、枚举安全、数据建模、状态驱动渲染、组件拆分策略、颜色透明度拼接、ForEach键值策略等20+个技术知识点，适合有一定ArkTS基础、希望深入理解鸿蒙声明式UI架构的开发者进阶阅读。
一、前言：千年琴韵的数字化新生
古琴，又称七弦琴，是中国最古老的弹拨乐器之一，距今已有三千余年历史。它不仅是音乐艺术的载体，更是文人雅士修身养性、寄托情怀的精神符号。"泠泠七弦上，静听松风寒"，白居易笔下的古琴意境，道尽了这件乐器所承载的文化厚度与审美高度。
在数字化浪潮席卷全球的今天，将这样一门承载着深厚文化底蕴的传统艺术以移动应用的形式呈现给现代用户，既是对非物质文化遗产传播方式的一次创新探索，也是对鸿蒙开发技术的一次深度实践。本文所剖析的"古琴坊"应用，正是围绕这一主题构建的一个集古琴陈列、琴弦库、琴徽图谱、订单管理与客户评价于一体的综合性移动端展示平台。
在整个应用的开发过程中，我们不仅需要关注UI层面的视觉表现力——如何用代码还原古琴工艺的温润质感与古典韵味，更需要深入理解ArkTS框架的底层机制：状态管理如何驱动UI刷新、组件间如何高效通信、数据流如何在父子组件间双向传递、自定义弹窗如何优雅地叠加在页面上方。这些问题的答案，都隐藏在接下来的每一行代码之中。本文将从架构总览开始，逐层深入，带你完成一次从"能写"到"写好"的鸿蒙开发进阶之旅。
二、项目架构总览：分层设计与模块化思想
本应用采用经典的单文件声明式架构，所有逻辑集中在一个.ets文件中，通过清晰的分层组织实现高内聚低耦合。整体架构可以划分为以下六个层次：
第一层——类型定义层（第1~131行）：包含GuqinPalette色彩接口、GuqinTab枚举、TabMeta标签元数据接口以及全部业务实体接口（GuqinItem、StringItem、HuiItem、GuqinOrderItem、GuqinReviewItem）和图表数据元接口（WeekGuqinMeta、StyleShareMeta、GuqinHotMeta、GuqinTopMeta）。这一层是整个应用的"契约"，所有后续的数据结构都必须严格遵循这些接口定义。
第二层——常量实例层（第23~167行）：将抽象的类型定义具象化为可用的运行时对象，包括COLORS色彩常量、TAB_LIST标签列表、GUQIN_COL徽位列阵以及四组静态图表数据（WEEK_SOLD周销量、STYLE_SHARE琴式占比、GUQIN_HOT工艺热度、GUQIN_TOP名琴排行）。
第三层——响应式数据类（第169~245行）：@Observed装饰的GuqinData类，封装了五组核心业务数据的动态数组，是整个应用的状态中枢。
第四层——工具函数层（第247~302行）：五个纯函数式的颜色映射器（getStyleColor、getStringColor、getGuqinColor、getOrderColor、getReviewTagColor），根据业务规则返回语义化的颜色值。
第五层——主入口与容器组件（第304~522行）：@Entry标记的GuqinApp根组件，负责全局状态管理、页面骨架搭建、Tab路由分发和弹窗条件渲染。
第六层——子组件体系（第524行至文件末尾）：包括1个标签组件（GuqinTag）、5个内容组件（分别对应5个Tab页）和4个模态弹窗组件，共同构成完整的功能矩阵。
这种分层设计的优势在于：当需要修改某个功能模块时，开发者可以快速定位到对应的层次进行修改，而不会对其他部分产生连锁反应。例如，如果需要调整配色方案，只需修改第一层的接口定义和第二层的常量实例；如果需要新增一个Tab页面，只需在第五层添加路由分支并在第六层新增对应的内容组件即可。
三、色彩体系设计：接口约束与常量定义
3.1 调色板接口定义
interface GuqinPalette {
primary: string; // 主色调——深棕（琴身木色）
primaryLight: string; // 主色浅变体
primaryDark: string; // 主色深变体
accent: string; // 强调色——朱红（漆面色泽）
accentLight: string; // 强调色浅变体——金橙
bg: string; // 页面背景——米宣纸色
cardBg: string; // 卡片背景——纯白
cardAlt: string; // 交替卡片背景——浅米
textPrimary: string; // 一级文本——墨黑
textSecondary: string; // 二级文本——灰褐
textHint: string; // 提示文本——淡灰
border: string; // 边框色
line: string; // 分割线色
success: string; // 成功色——青绿
warning: string; // 警告色——金橙
danger: string; // 危险色——暗红
white: string; // 纯白
woodBrown: string; // 木纹棕（琴材专用）
huiGold: string; // 徽金（琴徽专用）
}
这段代码看似简单，却蕴含着深刻的设计思想。首先，使用interface而不是type来定义调色板结构，是因为interface在ArkTS中具有更好的类型推断能力和扩展性。接口中定义了21个颜色字段，覆盖了以下几大语义类别：
-
主色调系列（primary / primaryLight / primaryDark）：以深棕色
#5A4030为核心，模拟古琴琴身的杉木或桐木本色。三个梯度分别用于常规主色、悬停/次要强调和深色背景区域。 -
强调色系列（accent / accentLight）：朱红色
#A63A2B取自传统大漆的朱砂红，用于关键操作按钮和高亮元素；其浅变体金橙色#C98A4E则呼应琴徽的金箔镶嵌效果。 -
背景色系（bg / cardBg / cardAlt）：米宣纸色
#F2EDE0作为页面底色营造古籍翻阅感；纯白#FFFFFF作为卡片底色保证内容可读性；浅米#EFE6D6作为交替行背景增强列表视觉节奏。 -
文本色三级灰度（textPrimary / textSecondary / textHint）：从墨黑
#33291E到灰褐#7A6A52再到淡灰#AC9F88，形成清晰的信息层级。 -
功能语义色（success / warning / danger）：青绿
#6E8B5E表示成功/完成，金橙表示提醒/待办，暗红#9E2E20表示危险/超支。 -
主题专属色（woodBrown / huiGold）：木纹棕复用主色但语义独立，专指琴材相关元素；徽金
#C9A24B精确对应琴徽的金嵌装饰。
这种21色的精细划分，使得整个应用的每一个视觉元素都有明确的"色彩归属"，避免了随意使用硬编码颜色值带来的视觉混乱。更重要的是，通过接口约束，任何遗漏字段或类型不匹配都会在编译阶段被TypeScript编译器捕获，实现了"编译期安全"。
3.2 色彩常量实例化
const COLORS: GuqinPalette = {
primary: '#5A4030',
primaryLight: '#8A6B52',
primaryDark: '#3A2A1E',
accent: '#A63A2B',
accentLight: '#C98A4E',
bg: '#F2EDE0',
cardBg: '#FFFFFF',
cardAlt: '#EFE6D6',
textPrimary: '#33291E',
textSecondary: '#7A6A52',
textHint: '#AC9F88',
border: '#E2D8C2',
line: '#F0EADC',
success: '#6E8B5E',
warning: '#C98A4E',
danger: '#9E2E20',
white: '#FFFFFF',
woodBrown: '#5A4030',
huiGold: '#C9A24B'
};这里有一个非常值得注意的细节：COLORS常量的类型被显式标注为GuqinPalette。这意味着TypeScript编译器会在编译阶段检查COLORS对象是否完整实现了接口定义的所有21个字段。如果遗漏了任何一个颜色字段，或者字段类型不匹配（比如不小心把数字赋给了string类型的字段），编译器会立即报错。这种"编译期安全"是大型项目中极其重要的保障，它能在代码运行之前就消灭掉大量潜在的类型错误。
此外，所有颜色值均采用标准的#RRGGBB六位十六进制格式，而非CSS变量名或语义别名。这种选择在ArkTS生态中是务实的——ArkTS的声明式UI直接支持字符串形式的颜色值，无需额外的运行时解析开销。同时，将所有颜色集中在一个常量对象中管理，使得后续的主题切换（如实现"暗色模式"）只需要替换这个常量对象即可，体现了良好的架构前瞻性。
四、枚举与标签配置：类型安全的页面路由
4.1 Tab枚举定义
enum GuqinTab {
GUQIN = 0,
STRING = 1,
HUI = 2,
ORDER = 3,
REVIEW = 4
}GuqinTab枚举定义了应用底部导航栏的五个页面标识，从0到4依次对应：古琴列表、琴弦库、琴徽名录、订单台账、客户评价。使用枚举而非魔术数字（magic number）的好处是多方面的：
第一，类型安全。当我们在代码中编写this.curTab === GuqinTab.GUQIN时，编辑器会提供自动补全和拼写检查，有效避免将GUQIN误写成GUQUN之类的低级错误。
第二，语义明确。枚举成员名称本身就是最好的文档——任何阅读代码的人都能立刻理解GuqinTab.REVIEW代表的是"评价"页面，而数字4则需要查阅上下文才能确定含义。
第三，重构友好。如果未来需要调整Tab的顺序（比如把"订单"移到第二个位置），只需修改枚举值的赋值顺序，所有引用该枚举的地方都会自动适配。
4.2 标签元数据配置
interface TabMeta {
key: string;
icon: string;
label: string;
color: string;
}
const TAB_LIST: TabMeta[] = [
{ key: 'guqin', icon: '🎼', label: '古琴', color: '#5A4030' },
{ key: 'string', icon: '🪢', label: '琴弦', color: '#8A6B52' },
{ key: 'hui', icon: '✨', label: '琴徽', color: '#C98A4E' },
{ key: 'order', icon: '📦', label: '订单', color: '#C98A4E' },
{ key: 'review', icon: '⭐', label: '客评', color: '#9E2E20' }
];这是一个非常优雅的设计模式：将标签的配置信息（唯一标识key、图标emoji、显示文字label、主题色color）抽象为一个数据数组，而非硬编码在组件的build()方法中。这种"数据驱动UI"的思路，使得后续新增或修改标签时，只需要修改TAB_LIST数组即可，无需触碰任何组件代码。
每个标签还拥有自己的主题色（color字段），这为选中态的视觉表现提供了丰富的个性化空间。例如，"古琴"Tab选中时使用深棕色高亮，"客评"Tab则使用暗红色，让用户在不同页面间切换时能获得一致的色彩反馈但又各具辨识度。
五、数据模型设计：接口驱动的类型安全
5.1 业务实体接口定义
interface GuqinItem {
name: string; // 琴名
style: string; // 琴式（伏羲式/仲尼式/...）
wood: string; // 面板木材（杉木/桐木/梓木）
price: number; // 价格（元）
emoji: string; // 表情图标
}
interface StringItem {
name: string; // 弦名
material: string; // 材质（蚕丝/冰丝/钢弦）
level: number; // 韧度等级（0-100）
tension: string; // 张力（高张/中张/低张）
emoji: string;
}
interface HuiItem {
name: string; // 徽名（一徽~十三徽）
pos: string; // 位置描述
level: number; // 准度评级
sound: string; // 对应音位（宫商角徵羽...）
emoji: string;
}
interface GuqinOrderItem {
name: string; // 客户名称
region: string; // 所属区域
count: number; // 订购数量
amount: number; // 订单金额
emoji: string;
}
interface GuqinReviewItem {
name: string; // 评价人姓名
score: number; // 评分（1-5星）
date: string; // 评价日期
content: string; // 评价内容
tag: string; // 评价标签
emoji: string;
}
这里展示了五种业务实体的接口定义。每个接口都精心设计了字段，紧密围绕古琴行业的实际业务场景：
-
GuqinItem（古琴条目）：包含琴名（如"九霄环佩"、"玉壶冰"）、琴式（伏羲式、仲尼式、蕉叶式等经典形制）、面板木材（杉木、桐木、梓木）、价格和表情图标。其中style字段不仅用于显示，还是后续getStyleColor()颜色映射函数的输入参数。 -
StringItem（琴弦条目）：记录弦名、材质（蚕丝、冰丝、钢弦等）、韧度等级（数值型，用于进度条可视化）、张力描述。level字段是琴弦页面的核心数据维度，直接影响每根弦的"韧度"进度条长度和颜色。 -
HuiItem（琴徽条目）：古琴琴面上有13个徽位（嵌于琴面的圆点标记），每个徽对应一个泛音音位。接口记录徽名、位置描述、准度评级和对应的传统音名（宫、商、角、徵、羽及变音）。 -
GuqinOrderItem（订单条目）：记录客户名称、所属区域、订购数量和金额。amount字段是getOrderColor()的颜色映射依据——金额越高颜色越"危险"（暗红），形成直观的业务警示。 -
GuqinReviewItem（评价条目）：包含评分（1-5星）、日期、评价内容和标签。tag字段是getReviewTagColor()的映射输入，不同类型的评价标签被赋予不同的主题色。
这五组接口构成了整个应用的数据模型基石。值得注意的是，所有接口中的emoji字段虽然不是严格的"业务数据"，但在ArkTS的Text组件中可以直接渲染表情符号，为每个条目提供了轻量级的视觉标识，增强了列表的可读性和趣味性。
5.2 图表数据元接口
interface WeekGuqinMeta {
day: string; // 星期几
value: number; // 销量
}
interface StyleShareMeta {
name: string; // 琴式名称
count: number; // 数量
color: string; // 主题色
}
interface GuqinHotMeta {
name: string; // 工艺名称
heat: number; // 热度值
color: string; // 主题色
}
interface GuqinTopMeta {
name: string; // 琴名
sold: number; // 销量
color: string; // 主题色
}
这四个接口专门服务于应用中的四种图表/排行榜可视化组件。它们的设计遵循了一个共同的范式：名称 + 数值 + 主题色的三元组结构。这种统一的数据形状使得四种图表可以共享同一套渲染逻辑（ForEach + layoutWeight条形图），只是数据源不同而已。
WeekGuqinMeta用于垂直柱状图（周销量走势），StyleShareMeta/GuqinHotMeta/GuqinTopMeta用于水平条形图（占比/热度/排行）。每种接口都自带color字段，使得每个数据条都可以拥有独立的颜色，而不是强制使用统一的系列色。
六、静态数据集：应用的基础数据源
6.1 图表静态数据
const WEEK_SOLD: WeekGuqinMeta[] = [
{ day: '周一', value: 8 },
{ day: '周二', value: 12 },
{ day: '周三', value: 15 },
{ day: '周四', value: 18 },
{ day: '周五', value: 22 },
{ day: '周六', value: 30 },
{ day: '周日', value: 26 }
];这里展示了周销量数据。在实际项目中，这些数据通常来自后端API接口，但本应用作为展示型Demo采用了静态数据的方式。数据的设计颇具巧思——销量从周一到周六逐步递增（8→12→15→18→22→30），周日略有回落（26），这完全符合零售业"工作日平稳、周末高峰、周日略降"的实际规律，让数据看起来真实可信。
const STYLE_SHARE: StyleShareMeta[] = [
{ name: '伏羲式', count: 5, color: '#5A4030' },
{ name: '仲尼式', count: 4, color: '#8A6B52' },
{ name: '蕉叶式', count: 3, color: '#C98A4E' },
{ name: '落霞式', count: 2, color: '#A63A2B' }
];琴式构成数据反映了古琴界最常见的四种形制及其市场占比。伏羲式（5款）居首，这是历史上最古老也是流传最广的琴式；仲尼式（4款）次之，因儒家圣人孔子（字仲尼）善琴而得名，形制端庄方正；蕉叶式（3款）造型如芭蕉叶般灵动；落霞式（2款）最少，因其制作工艺复杂、造价高昂。
6.2 工艺热度与排行榜数据
const GUQIN_HOT: GuqinHotMeta[] = [
{ name: '选材听音', heat: 97, color: '#5A4030' },
{ name: '开料制形', heat: 95, color: '#8A6B52' },
{ name: '挖槽纳音', heat: 94, color: '#C98A4E' },
{ name: '合琴裹布', heat: 93, color: '#6E8B5E' },
{ name: '灰胎打磨', heat: 92, color: '#A63A2B' },
{ name: '上弦调音', heat: 90, color: '#7A6A52' }
];
const GUQIN_TOP: GuqinTopMeta[] = [
{ name: '九霄环佩', sold: 96, color: '#5A4030' },
{ name: '玉壶冰', sold: 92, color: '#8A6B52' },
{ name: '碧涧流泉', sold: 89, color: '#C98A4E' },
{ name: '沧海龙吟', sold: 85, color: '#6E8B5E' },
{ name: '太古遗音', sold: 81, color: '#A63A2B' },
{ name: '鹤鸣秋月', sold: 77, color: '#7A6A52' }
];制琴工艺热度数据涵盖了古琴制作的六大核心工序，从"选材听音"（97分）到"上弦调音"（90分），热度值递减但差距不大，说明每一道工序在制琴师心中都至关重要。名琴销量TOP6则列出了最受欢迎的六款琴，"九霄环佩"以96的销量遥遥领先——这款琴名源自唐代，是现存最著名的传世古琴之一。
七、响应式数据类：@Observed装饰器的深度运用
@Observed
export class GuqinData {
guqins: GuqinItem[] = [
{ name: '九霄环佩', style: '伏羲式', wood: '杉木', price: 6800, emoji: '🎼' },
{ name: '玉壶冰', style: '仲尼式', wood: '杉木', price: 5800, emoji: '🧊' },
// ... 共12款古琴
];
strings: StringItem[] = [
{ name: '太古丝弦', material: '蚕丝', level: 96, tension: '中张', emoji: '🪢' },
// ... 共12种琴弦
];
huis: HuiItem[] = [
{ name: '一徽', pos: '岳山右', level: 96, sound: '宫音', emoji: '✨' },
// ... 共13个琴徽
];
orders: GuqinOrderItem[] = [
{ name: '雅集琴馆', region: '华东', count: 60, amount: 360000, emoji: '🏛️' },
// ... 共12条订单
];
reviews: GuqinReviewItem[] = [
{ name: '琴馆馆主', score: 5, date: '09-03',
content: '九霄环佩音色清越，徽位取音极准，开箱即能入调。',
tag: '音色清越', emoji: '🏛️' },
// ... 共12条评价
];
}这是整个应用最核心的数据层代码。@Observed装饰器是ArkTS框架提供的一个关键装饰器，它的作用是将一个普通的类标记为"可观察的"。当一个类被@Observed标记后，该类实例的属性变化会被ArkTS框架自动追踪，任何引用了该实例属性的@ObjectLink或@State变量都会在属性变化时自动触发UI重新渲染。
GuqinData类封装了五组核心业务数据：
-
guqins（12款古琴）：涵盖从"九霄环佩"（¥6800，伏羲式杉木面）到"灵机"（¥4600，灵机式桐木面）的全价位段产品矩阵。 -
strings（12种琴弦）：材质涵盖蚕丝、冰丝、钢弦、竹丝、金缠丝等多种传统与现代材料，韧度等级89-96不等。 -
huis（13个琴徽）：从一徽（宫音，岳山右）到十三徽（应钟，岳山左），完整还原了古琴十三徽的标准配置。 -
orders（12条订单）：客户涵盖琴馆、学院、研究会、汉服品牌、影视剧组、海外琴社等多元渠道，区域分布华东/华中/华北/华南/西南/海外。 -
reviews（12条评价）：全部4-5星好评，标签涵盖"音色清越"、"形制端方"、"打磨细腻"、"造型灵秀"等多维度评价维度。
这种将所有业务数据集中在一个@Observed类中的设计，带来了一个重要的架构优势：单一数据源原则（Single Source of Truth）。无论哪个子组件需要访问古琴列表、琴弦数据还是订单信息，它们都通过@ObjectLink引用同一个GuqinData实例。当任何一个数据发生变化（比如新增了一款古琴、删除了一条琴弦），所有引用该数据的组件都会自动收到通知并刷新UI，无需手动编写繁琐的事件监听和数据同步逻辑。
八、颜色工具函数：纯函数的设计哲学
function getStyleColor(style: string): string {
if (style === '伏羲式') return '#5A4030';
else if (style === '仲尼式') return '#8A6B52';
else if (style === '蕉叶式') return '#C98A4E';
else if (style === '落霞式') return '#A63A2B';
return '#6E8B5E'; // 默认 fallback
}
function getStringColor(level: number): string {
if (level >= 95) return '#5A4030';
else if (level >= 92) return '#8A6B52';
return '#C98A4E';
}
function getGuqinColor(price: number): string {
if (price >= 7000) return '#9E2E20'; // 高价 → 暗红
else if (price >= 6000) return '#5A4030';
else if (price >= 5200) return '#8A6B52';
return '#6E8B5E'; // 低价 → 青绿
}
function getOrderColor(amount: number): string {
if (amount >= 300000) return '#9E2E20';
else if (amount >= 200000) return '#5A4030';
else if (amount >= 130000) return '#8A6B52';
return '#6E8B5E';
}
function getReviewTagColor(tag: string): string {
if (tag === '音色清越' || tag === '打磨细腻' || tag === '比例合度' || tag === '上镜出彩')
return '#5A4030';
else if (tag === '形制端方' || tag === '做旧自然' || tag === '一物两用')
return '#8A6B52';
else if (tag === '造型灵秀' || tag === '氛围感好' || tag === '越弹越爱')
return '#6E8B5E';
else if (tag === '包装妥帖' || tag === '张力稳定')
return '#C98A4E';
return '#9E2E20';
}这五个函数构成了应用的颜色映射层，它们都是纯函数（Pure Function）——相同的输入永远产生相同的输出，没有任何副作用。这种函数式的设计哲学在ArkTS开发中具有多重价值：
第一，可测试性极强。每个函数都可以独立编写单元测试，传入已知输入、断言输出颜色，无需mock任何组件或状态。
第二，逻辑集中且可复用。颜色映射规则分散在多个组件中是维护噩梦——如果要调整"高价琴"的阈值从7000改为7500，需要在每个使用处逐一修改。而现在只需改getGuqinColor一处。
第三，语义化表达业务规则。函数名本身就是最好的文档——getGuqinColor(price)一眼就能看出是根据价格返回古琴卡片的主题色；getReviewTagColor(tag)则是根据评价标签返回标签颜色。
特别值得分析的是getGuqinColor的阶梯式阈值设计：价格≥7000返回暗红（danger色，暗示"高端珍品"），6000-6999返回主色棕，5200-5999返回浅棕，<5200返回青绿（success色，暗示"性价比之选"）。这种将业务语义（价格区间）映射到视觉语义（颜色情感）的模式，是数据可视化中的经典手法。
九、主入口组件：应用骨架与路由管理
9.1 状态声明
@Entry
@Component
struct GuqinApp {
@State curTab: number = 0;
@State data: GuqinData = new GuqinData();
@State showAddGuqin: boolean = false;
@State showEditOrder: boolean = false;
@State showDeleteString: boolean = false;
@State showDetailHui: boolean = false;
@State delStringName: string = '';
@State detailHuiName: string = '';
@State noteRotate: boolean = false;
@State starScale: boolean = false;GuqinApp是整个应用的根组件，由@Entry装饰器标记为应用入口，由@Component标记为可复用组件。它声明了11个@State状态变量，可以分为三类：
路由与数据状态（2个）：
-
curTab：当前选中的Tab索引（0-4），控制底部导航栏的高亮和内容区的切换。 -
data：GuqinData实例，作为全局唯一的数据源传递给所有子组件。
弹窗显隐状态（4个布尔值 + 2个字符串）：
-
showAddGuqin/showEditOrder/showDeleteString/showDetailHui：分别控制四种弹窗的显示/隐藏。 -
delStringName/detailHuiName：传递给删除确认弹窗和详情弹窗的上下文参数（要删除的弦名、要查看详情的徽名）。
动画交互状态（2个布尔值）：
-
noteRotate：控制头部音符图标的旋转动画（点击切换90°旋转）。 -
starScale：控制星星图标的缩放动画（点击切换1.6倍放大）。
这种细粒度的状态拆分，使得每个UI交互都有独立的状态变量驱动，互不干扰。当需要添加新的弹窗或交互效果时，只需新增一个@State变量即可，不会影响现有逻辑。
9.2 构建方法与页面结构
build()方法是ArkTS声明式UI的核心——它描述了"UI应该长什么样"，框架负责在状态变化时高效地 diff 和更新真实DOM。GuqinApp的build()方法构建了以下三层结构：
第一层：主内容区（外层Column）。包含两个子区域：
-
顶部Header区域：深棕色（
primaryDark）背景，包含应用标题"🎼 古琴坊"、英文副标题"Guqin · 泠泠七弦 松风入耳"、右侧操作图标区（音符旋转、星星缩放、古琴图标），以及下方的13个琴徽点缀点（用三种尺寸和颜色的圆形模拟琴面上的徽位排列）。 -
内容切换区：根据
curTab的值，使用if-else if-else链条件渲染对应的内容组件（GuqinContent/StringContent/HuiContent/GuqinOrderContent/GuqinReviewContent）。
第二层：底部导航栏（固定在底部）。使用ForEach遍历TAB_LIST数组渲染5个Tab项，每个Tab项根据是否为当前选中项来决定：文字颜色（主题色 vs 提示色）、字重（Bold vs Normal）、背景色（半透明主题色 vs 透明）、边框（有 vs 无）。点击时更新curTab状态触发切换。
第三层：弹窗叠加层。四个if条件分别控制四种弹窗的渲染，弹窗以绝对定位的方式覆盖在主内容区上方。
9.3 弹窗的条件渲染
if (this.showAddGuqin) {
AddGuqinModal({
onClose: () => { this.showAddGuqin = false; }
})
}
if (this.showEditOrder) {
EditGuqinOrderModal({
onClose: () => { this.showEditOrder = false; }
})
}
if (this.showDeleteString) {
DeleteStringModal({
title: this.delStringName,
onClose: () => { this.showDeleteString = false; }
})
}
if (this.showDetailHui) {
DetailHuiModal({
name: this.detailHuiName,
onClose: () => { this.showDetailHui = false; }
})
}弹窗的渲染采用了条件渲染 + 回调关闭的模式。每个弹窗组件接收一个onClose回调函数，当用户点击弹窗内的"取消"/"确认"/"知道了"等按钮时，调用onClose()将对应的showXxx状态设为false，从而触发弹窗从DOM中移除。
DeleteStringModal和DetailHuiModal额外接收了title/name属性，用于在弹窗内显示具体的操作对象（要删除哪根弦、查看哪个徽的详情）。这种"状态提升"（Lifting State Up）的模式——将弹窗所需的上下文数据存储在父组件的状态中、通过props传递给弹窗——是React/ArkTS中处理跨组件数据流的经典方案。
十、内容组件体系：@ObjectLink与数据双向绑定
10.1 标签组件 GuqinTag
@Component
struct GuqinTag {
@Prop text: string;
@Prop color: string;
build() {
Text(this.text)
.fontSize(9)
.fontColor(this.color)
.padding({ left: 7, right: 7, top: 2, bottom: 2 })
.backgroundColor(this.color + '14') // 8% 透明度
.borderRadius(10)
.border({ width: 1, color: this.color + '40' }) // 25% 透明度边框
}
}GuqinTag是一个极简但精心设计的标签组件，仅接收两个@Prop属性：text（标签文字）和color（主题色）。它的设计精髓在于颜色透明度的十六进制拼接技巧：
-
背景色使用
this.color + '14'，即在原色hex后面追加14（即8%不透明度的alpha通道），生成类似#5A403014的8位颜色值。ArkTS原生支持这种8位hex颜色格式，前6位是RGB，后2位是Alpha（00=完全透明，FF=完全不透明）。 -
边框色使用
this.color + '40'（25%不透明度），比背景更明显但不抢眼。
这种"同色系多层透明度叠加"的技法，使得标签在任何背景下都能保持和谐的视觉效果——背景色淡淡的（8%）提供区域感，边框稍深（25%）勾勒轮廓，文字用原色（100%）保证可读性。三者来自同一个color变量，天然协调，永远不会出现"背景是蓝色但文字是红色"的色彩冲突。
10.2 古琴内容组件 GuqinContent
@Component
struct GuqinContent {
@ObjectLink data: GuqinData;
onAdd: () => void = () => {};
build() {
Scroll() {
Column() {
// 销量图表卡片
Column() { /* ... */ }
// 古琴列表
ForEach(this.data.guqins, (p: GuqinItem, i: number) => {
Row() { /* 卡片内容 */ }
}, (p: GuqinItem, i: number) => 'gq' + p.name + i)
}
}
.scrollable(ScrollDirection.Vertical)
.scrollBar(BarState.Off)
}
}GuqinContent是古琴Tab页的主体内容组件。它使用了@ObjectLink装饰器来接收父组件传递的GuqinData实例。@ObjectLink与@Prop的关键区别在于：@ObjectLink建立的是引用关系，而非值的拷贝——当GuqinData实例的属性（如guqins数组）发生变化时，GuqinContent中引用这些属性的部分会自动刷新。这使得数据在父子组件间实现了"双向绑定"的效果。
组件内部由两大部分组成：
第一部分：本周销量图表卡片。顶部有一排装饰性的琴徽点缀（模仿琴面13徽的简化版），下方是标题"📈 本周销量"和副标题"周六30张"。柱状图使用ForEach遍历WEEK_SOLD数据，每根柱子的高度由value决定（乘以系数3.2转换为像素高度），颜色由阈值判断决定（≥26用主色棕，否则用金橙）。柱子使用borderRadius(8)实现圆角，底部对齐（alignItems(VerticalAlign.Bottom)）模拟真实柱状图的基线对齐效果。
第二部分：古琴名器列表。使用ForEach遍历this.data.guqins数组，每张卡片是一个Row横向布局，包含三个区域：
-
左侧图标区（宽60）：圆形头像区显示emoji，下方有三条短横线模拟琴弦纹理。整体背景色由
getGuqinColor(p.price)决定并附加极低透明度（0D=5%），边框用33%透明度。 -
中间信息区（
layoutWeight(1)占据剩余空间）：第一行是琴名（粗体）+ 价格（带颜色），第二行是琴式标签（GuqinTag）+ 木材标签（GuqinTag）+ "七弦十三徽"提示文字。 -
卡片背景色使用
i % 2 === 0实现斑马纹交替（白色/浅米），增强列表的可读性。
10.3 其他内容组件
StringContent（琴弦库）：结构与GuqinContent类似，但顶部图表替换为"名琴销量TOP6"水平条形图（使用GUQIN_TOP数据和layoutWeight实现比例条），列表项改为琴弦卡片——左侧显示emoji+准度圆点+金徽点缀，中间显示弦名+张力，下方显示"韧度"进度条（同样用layoutWeight(c.level)实现比例填充）。右侧有删除图标，点击触发onDel回调。
HuiContent（琴徽名录）：顶部图表为"制琴工艺热度"水平条形图（GUQIN_HOT数据），列表项为琴徽卡片——显示徽名+音位+位置+准度评级，右侧有详情图标。
GuqinOrderContent（订单台账）：顶部图表为"琴式构成占比"水平条形图（STYLE_SHARE数据），列表项为订单卡片——显示客户emoji+名称+区域+数量+金额（金额颜色由getOrderColor决定），右侧有编辑图标。
GuqinReviewContent（客户评价）：无顶部图表，直接是评价列表。每条评价显示用户emoji+姓名+日期+星级（用⭐.repeat(score)重复渲染）+ 标签（GuqinTag）+ 评价正文。星级使用repeat()方法根据score值动态生成对应数量的星星字符，简洁而巧妙。
十一、弹窗组件体系：自定义模态对话框
应用包含四个自定义弹窗组件，它们共享一致的结构模式但各有不同的内容和用途：
11.1 新增古琴弹窗 AddGuqinModal
弹窗采用全屏遮罩 + 居中卡片的经典模态布局：
-
外层Column：
width('100%') height('100%')，背景色#66000000（40%黑色半透明遮罩），justifyContent(FlexAlign.Center)使内容居中。 -
内层卡片：宽度86%、最大高度78%、圆角18px、白色背景、16px内边距。
-
标题栏："🎼 定制古琴" + 右侧"✕"关闭按钮，两端对齐。
-
内容区：三行信息展示（琴名、琴式、预算），每行使用
cardAlt背景色+圆角的统一样式。 -
操作栏：左"取消"（描边按钮）+ 右"确认定制"（实心主色按钮），右对齐。
11.2 其他弹窗组件
-
EditGuqinOrderModal（修改订单）：结构与AddGuqinModal完全对称，内容改为客户/数量/金额三行信息，确认按钮文案为"保存修改"。
-
DeleteStringModal（删除确认）：接收
title属性显示要删除的弦名，内容为确认提示文字（"确定撤下「xxx」吗？"），确认按钮使用危险色（danger= 暗红）以警示操作的不可逆性。 -
DetailHuiModal（琴徽详情）：接收
name属性，内容包含大号emoji+徽名展示区、琴徽文化介绍文字、音位信息和匠人评级，单按钮"知道了"关闭。
四个弹窗的一致性设计（相同的外层遮罩、卡片尺寸、圆角、内边距、标题栏布局）确保了用户在使用不同功能时获得统一的交互体验。差异仅在内容区和按钮文案/颜色上体现各自的功能特性。
十二、关键技术点深度解析
12.1 layoutWeight布局权重的妙用
layoutWeight是ArkTS弹性布局中最强大的属性之一。在本应用中被广泛用于两类场景：
水平条形图：在GUQIN_TOP、GUQIN_HOT、STYLE_SHARE的渲染中，每行的彩色条使用layoutWeight(dataValue)设置宽度权重，后面的灰色占位条使用layoutWeight(maxValue - dataValue)补足剩余空间。两者之和等于最大值（100或20），从而精确实现按比例分配宽度的效果——无需手动计算像素值，框架自动处理。
列表卡片内部布局：古琴卡片、琴弦卡片等信息区的中间列使用layoutWeight(1)占据所有剩余空间，左右固定宽度的图标区和操作区保持不变。这种"两头固定、中间弹性"的布局模式在移动端UI中极为常见。
12.2 颜色透明度的十六进制拼接
本应用大量使用了hex颜色 + 两位alpha的8位颜色格式，例如：
-
COLORS.accentLight + '2E'→#C98A4E2E（约18%不透明度，用于按钮背景） -
COLORS.accentLight + '66'→#C98A4E66（约40%不透明度，用于分割线） -
COLORS.primary + '55'→5A403055（约33%不透明度，用于卡片边框） -
t.color + '14'→ 如#5A403014（约8%不透明度，用于标签背景）
这种技法的优势在于：不需要预先定义几十个半透明色变量，而是根据运行时的主题色动态生成任意透明度的衍生色。只要知道基础色和目标透明度，字符串拼接一行搞定。需要注意的是，alpha值的范围是00（全透明）到FF（完全不透明），常用参考值：14≈8%，2E≈18%，40≈25%，55≈33%，66≈40%，80≈50%。
12.3 ForEach的键值生成策略
应用中所有的ForEach循环都精心设计了键值生成函数（key generator）：
// 古琴列表
(p: GuqinItem, i: number) => 'gq' + p.name + i
// 琴弦列表
(c: StringItem, i: number) => 'st' + c.name + i
// 琴徽列表
(d: HuiItem, i: number) => 'hu' + d.name + i
// 订单列表
(o: GuqinOrderItem, i: number) => 'od' + o.name + i
// 评价列表
(r: GuqinReviewItem, i: number) => 'rv' + r.name + i
// Tab栏
(t: TabMeta) => t.key
// 图表数据
(w: WeekGuqinMeta) => w.day
(t: GuqinTopMeta) => t.name
(d: GuqinHotMeta) => d.name
(s: StyleShareMeta) => s.name每个键值都采用了**"前缀 + 唯一标识 + 索引"**的三段式命名：
-
前缀（
gq/st/hu/od/rv）区分不同的ForEach作用域，避免跨列表键值冲突。 -
唯一标识（
p.name/c.name等）保证同一条数据始终映射到同一个键。 -
索引（
i）作为兜底，即使两条数据name相同（理论上不应发生但有防御价值），索引也能保证唯一性。
正确的键值策略对于ArkTS的ForEach性能至关重要——框架通过键值来判断哪些节点是"新增"、哪些是"移动"、哪些是"删除"，从而执行最小量的DOM操作。错误的键值（如使用Math.random()）会导致每次渲染都销毁重建所有节点，造成严重的性能问题。
12.4 @Observed/@ObjectLink响应式机制
本应用的响应式数据流遵循以下路径：
GuqinData (@Observed 类)
↓ @ObjectLink 引用传递
GuqinContent / StringContent / HuiContent / GuqinOrderContent / GuqinReviewContent
↓ 组件内部读取属性
ForEach / Text / 等UI节点当GuqinData的某个数组属性发生变化（如guqins.push(newItem)），ArkTS框架的响应式系统会：
-
检测到
@Observed类实例的属性变更。 -
通知所有持有该实例
@ObjectLink引用的组件。 -
这些组件重新执行
build()方法。 -
框架diff新旧虚拟DOM树，只更新实际变化的部分。
这种机制比传统的"手动调用setState/refresh"模式更加声明式和自动化，开发者只需描述"数据是什么样子"，框架负责"如何高效地更新UI"。
12.5 条件渲染与状态驱动UI
应用的Tab切换和弹窗显示/隐藏完全由状态变量驱动，没有使用任何命令式的DOM操作（如appendChild/removeChild）：
-
Tab切换：
if (this.curTab === GuqinTab.GUQIN)渲染GuqinContent，否则渲染其他组件。curTab的变化由底部Tab栏的onClick事件触发。 -
弹窗显示：
if (this.showAddGuqin)渲染AddGuqinModal。showAddGuqin由"➕制琴"按钮的onClick设为true，由弹窗内部的"取消"/"确认"按钮的onClick通过onClose回调设为false。
这种"状态即UI"（State is UI）的范式是现代前端框架的核心思想——UI是状态的纯函数，给定相同的状态必然产生相同的UI。这使得应用的行为完全可预测、可调试、可测试。
十三、技术要点对比表
|
技术维度 |
本应用实现方案 |
设计意图与优势 |
|---|---|---|
|
状态管理 |
|
单一数据源 + 自动响应式更新，避免手动同步 |
|
组件通信 |
Props单向数据流 + 回调函数(onClose/onAdd/onDel/onDetail/onEdit) |
父→子通过Props，子→父通过回调，清晰的单向数据流 |
|
路由方案 |
|
适合Tab数量固定(5个)的场景，简单直接无额外依赖 |
|
弹窗模式 |
条件渲染 + 全屏遮罩 + 居中卡片 + 回调关闭 |
统一的模态交互规范，遮罩阻止背景交互 |
|
列表渲染 |
|
高效diff、防冲突、可预测的节点复用 |
|
布局策略 |
|
两头固定中间弹性的经典移动端布局 |
|
颜色系统 |
21色接口约束 + hex+alpha透明度拼接 |
编译期类型安全 + 运行时动态透明度 |
|
数据建模 |
5个业务接口 + 4个图表接口 + 纯函数颜色映射 |
类型安全 + 逻辑集中 + 可独立测试 |
|
动画交互 |
|
状态驱动动画，无需手动管理动画生命周期 |
|
斑马纹列表 |
|
偶数行白色、奇数行浅米，增强列表可读性 |
十四、总结与展望
14.1 架构设计总结
"古琴坊"应用虽然是一个单文件Demo，但其内部蕴含的架构思想值得认真总结：
分层清晰，职责分明。从顶部的类型定义层到底部的子组件层，每一层都有明确的单一职责。类型定义层管"契约"，常量实例层管"数据"，响应式类管"状态"，工具函数层管"逻辑"，入口组件管"路由"，子组件管"展示"。这种分层使得无论是添加新功能、修bug、还是做性能优化，都能快速定位到正确的层次。
接口先行，类型安全。所有数据结构都先定义接口，再实现具体数据。TypeScript编译器在编译阶段就能捕获大部分类型错误，大大降低了运行时出错的概率。21色调色板接口、5组业务实体接口、4组图表接口——合计超过10个接口定义，构筑了坚实的类型安全防线。
数据驱动，声明式渲染。UI完全由状态驱动，没有命令式的DOM操作。ForEach遍历数据数组生成列表，if条件根据状态渲染不同组件，@Observed/@ObjectLink自动追踪数据变化并刷新UI。这种范式让代码更接近"描述UI应该是什么样子"而非"如何一步步构建UI"。
14.2 技术亮点回顾
回顾全文，以下几个技术点尤其值得关注和借鉴：
-
21色古风色彩体系：以"木棕·朱红·徽金"为核心的三色系设计，配合精细的透明度梯度（8%/18%/25%/33%/40%），在视觉上完美还原了古琴文化的温润质感。接口约束 + 常量实例化的双层设计，兼顾了类型安全和运行效率。
-
@Observed+@ObjectLink的深度运用：将全部业务数据封装在一个可观察类中，通过@ObjectLink引用传递给5个子组件，实现了真正的"单一数据源 + 双向绑定"。任何数据变化都会自动级联刷新所有相关UI，无需手动编写事件监听。 -
纯函数颜色映射层：5个无副作用的颜色映射函数，将业务规则（价格区间、韧度等级、评价标签等）映射到视觉语义（颜色情感）。逻辑集中、可测试、可复用。
-
layoutWeight驱动的数据可视化：不依赖任何图表库，仅用ArkTS内置的layoutWeight属性就实现了4种精美的条形图/柱状图。这种"零依赖"的数据可视化方案在轻量级应用中极具实用价值。 -
统一的弹窗交互规范：4个弹窗共享相同的结构模板（遮罩+居中卡片+标题栏+内容区+操作栏），仅在内容和按钮细节上差异化。这种一致性设计大幅降低了用户的认知负荷。
14.3 优化建议与展望
尽管本应用在架构和实现上已经相当成熟，但从工程实践的角度，仍有以下几点可以进一步优化：
第一，状态管理的精细化。当前11个@State变量全部集中在根组件中，随着功能增长可能导致"状态爆炸"。建议引入轻量级状态管理方案（如ArkTS的@Provide/@Consume或AppStorage），将弹窗状态下沉到各自的父组件中，根组件只保留全局路由状态。
第二，网络数据对接的准备。当前所有数据均为静态硬编码。GuqinData类的数组属性已经为未来对接真实后端API留出了清晰的接口——只需将静态初始化改为异步fetch调用，UI层无需任何修改。这种"函数化的封装方式"体现了良好的架构前瞻性。
第三，组件的进一步拆分。当前每个内容组件（如GuqinContent）内部同时包含了图表卡片和列表卡片两种UI形态。如果未来需要单独复用"周销量图表"或"古琴列表"，可以考虑将它们拆分为独立的子组件（WeeklyChart、GuqinList），提升复用性。
第四，无障碍访问（Accessibility）的支持。当前组件未设置accessibilityText等无障碍属性。对于一款面向文化传播的应用，确保视障用户也能通过屏幕阅读器获取古琴信息，是产品完善度的重要维度。
第五，国际化（i18n）的预留。虽然"古琴坊"面向中文用户，但如果未来需要推出多语言版本（如面向海外琴友的英文版），建议将所有硬编码的中文字符串提取到资源文件（string.json）中，通过$r()引用。当前的TAB_LIST、静态数据中的中文字符串都需要做相应改造。
总而言之，"古琴坊"应用以其精巧的古风色彩体系、严谨的类型安全设计、高效的响应式数据流和优雅的组件化架构，为我们提供了一个学习鸿蒙ArkTS声明式UI开发的优秀范本。从"能写出能跑的代码"到"写出架构清晰、可维护、可扩展的代码"，这正是每一位鸿蒙开发者应当追求的成长路径。愿这篇深度解析能为你的进阶之路提供一份有价值的参考。
十五、附录：DevEco Studio 安装与环境搭建
为方便读者将本文分析的"古琴坊"代码真正跑起来，下面补充一份 DevEco Studio 的安装与环境配置简明教程（配图来源于官方文档）。
安装DevEco Studio程序
选择目标安装目录：
设置环境变量，设置完务必重启:
新建一个空白模板：
设置API为24的模板项目：
初始化项目，自动下载相关依赖：
完整代码
interface GuqinPalette {
primary: string;
primaryLight: string;
primaryDark: string;
accent: string;
accentLight: string;
bg: string;
cardBg: string;
cardAlt: string;
textPrimary: string;
textSecondary: string;
textHint: string;
border: string;
line: string;
success: string;
warning: string;
danger: string;
white: string;
woodBrown: string;
huiGold: string;
}
const COLORS: GuqinPalette = {
primary: '#5A4030',
primaryLight: '#8A6B52',
primaryDark: '#3A2A1E',
accent: '#A63A2B',
accentLight: '#C98A4E',
bg: '#F2EDE0',
cardBg: '#FFFFFF',
cardAlt: '#EFE6D6',
textPrimary: '#33291E',
textSecondary: '#7A6A52',
textHint: '#AC9F88',
border: '#E2D8C2',
line: '#F0EADC',
success: '#6E8B5E',
warning: '#C98A4E',
danger: '#9E2E20',
white: '#FFFFFF',
woodBrown: '#5A4030',
huiGold: '#C9A24B'
};
enum GuqinTab {
GUQIN = 0,
STRING = 1,
HUI = 2,
ORDER = 3,
REVIEW = 4
}
interface TabMeta {
key: string;
icon: string;
label: string;
color: string;
}
const TAB_LIST: TabMeta[] = [
{ key: 'guqin', icon: '🎼', label: '古琴', color: '#5A4030' },
{ key: 'string', icon: '🪢', label: '琴弦', color: '#8A6B52' },
{ key: 'hui', icon: '✨', label: '琴徽', color: '#C98A4E' },
{ key: 'order', icon: '📦', label: '订单', color: '#C98A4E' },
{ key: 'review', icon: '⭐', label: '客评', color: '#9E2E20' }
];
const GUQIN_COL: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
interface GuqinItem {
name: string;
style: string;
wood: string;
price: number;
emoji: string;
}
interface StringItem {
name: string;
material: string;
level: number;
tension: string;
emoji: string;
}
interface HuiItem {
name: string;
pos: string;
level: number;
sound: string;
emoji: string;
}
interface GuqinOrderItem {
name: string;
region: string;
count: number;
amount: number;
emoji: string;
}
interface GuqinReviewItem {
name: string;
score: number;
date: string;
content: string;
tag: string;
emoji: string;
}
interface WeekGuqinMeta {
day: string;
value: number;
}
interface StyleShareMeta {
name: string;
count: number;
color: string;
}
interface GuqinHotMeta {
name: string;
heat: number;
color: string;
}
interface GuqinTopMeta {
name: string;
sold: number;
color: string;
}
const WEEK_SOLD: WeekGuqinMeta[] = [
{ day: '周一', value: 8 },
{ day: '周二', value: 12 },
{ day: '周三', value: 15 },
{ day: '周四', value: 18 },
{ day: '周五', value: 22 },
{ day: '周六', value: 30 },
{ day: '周日', value: 26 }
];
const STYLE_SHARE: StyleShareMeta[] = [
{ name: '伏羲式', count: 5, color: '#5A4030' },
{ name: '仲尼式', count: 4, color: '#8A6B52' },
{ name: '蕉叶式', count: 3, color: '#C98A4E' },
{ name: '落霞式', count: 2, color: '#A63A2B' }
];
const GUQIN_HOT: GuqinHotMeta[] = [
{ name: '选材听音', heat: 97, color: '#5A4030' },
{ name: '开料制形', heat: 95, color: '#8A6B52' },
{ name: '挖槽纳音', heat: 94, color: '#C98A4E' },
{ name: '合琴裹布', heat: 93, color: '#6E8B5E' },
{ name: '灰胎打磨', heat: 92, color: '#A63A2B' },
{ name: '上弦调音', heat: 90, color: '#7A6A52' }
];
const GUQIN_TOP: GuqinTopMeta[] = [
{ name: '九霄环佩', sold: 96, color: '#5A4030' },
{ name: '玉壶冰', sold: 92, color: '#8A6B52' },
{ name: '碧涧流泉', sold: 89, color: '#C98A4E' },
{ name: '沧海龙吟', sold: 85, color: '#6E8B5E' },
{ name: '太古遗音', sold: 81, color: '#A63A2B' },
{ name: '鹤鸣秋月', sold: 77, color: '#7A6A52' }
];
@Observed
export class GuqinData {
guqins: GuqinItem[] = [
{ name: '九霄环佩', style: '伏羲式', wood: '杉木', price: 6800, emoji: '🎼' },
{ name: '玉壶冰', style: '仲尼式', wood: '杉木', price: 5800, emoji: '🧊' },
{ name: '碧涧流泉', style: '蕉叶式', wood: '桐木', price: 7200, emoji: '🌊' },
{ name: '沧海龙吟', style: '落霞式', wood: '杉木', price: 6600, emoji: '🐉' },
{ name: '太古遗音', style: '伏羲式', wood: '桐木', price: 6200, emoji: '📜' },
{ name: '鹤鸣秋月', style: '仲尼式', wood: '杉木', price: 5500, emoji: '🦢' },
{ name: '绿绮', style: '神农式', wood: '桐木', price: 5000, emoji: '💚' },
{ name: '焦尾', style: '师旷式', wood: '梓木', price: 7800, emoji: '🔥' },
{ name: '绕梁', style: '列子式', wood: '杉木', price: 5400, emoji: '🌀' },
{ name: '灵机', style: '灵机式', wood: '桐木', price: 4600, emoji: '⚙️' },
{ name: '凤势', style: '凤势式', wood: '杉木', price: 5900, emoji: '🪶' },
{ name: '连珠', style: '连珠式', wood: '桐木', price: 4800, emoji: '📿' }
];
strings: StringItem[] = [
{ name: '太古丝弦', material: '蚕丝', level: 96, tension: '中张', emoji: '🪢' },
{ name: '冰弦', material: '冰丝', level: 95, tension: '高张', emoji: '🧵' },
{ name: '缠丝弦', material: '蚕丝缠弦', level: 94, tension: '低张', emoji: '🕸️' },
{ name: '钢弦一弦', material: '钢弦', level: 93, tension: '高张', emoji: '🔩' },
{ name: '钢弦七弦', material: '钢弦', level: 92, tension: '中张', emoji: '⚙️' },
{ name: '梅花丝弦', material: '蚕丝', level: 95, tension: '中张', emoji: '🌸' },
{ name: '玄丝弦', material: '蚕丝', level: 91, tension: '低张', emoji: '⚫' },
{ name: '云纹钢弦', material: '钢弦', level: 90, tension: '中张', emoji: '☁️' },
{ name: '织锦丝弦', material: '蚕丝', level: 94, tension: '高张', emoji: '🧣' },
{ name: '青竹弦', material: '竹丝', level: 89, tension: '低张', emoji: '🎋' },
{ name: '金丝弦', material: '金缠丝', level: 93, tension: '高张', emoji: '✨' },
{ name: '玉弦', material: '蚕丝', level: 95, tension: '中张', emoji: '💠' }
];
huis: HuiItem[] = [
{ name: '一徽', pos: '岳山右', level: 96, sound: '宫音', emoji: '✨' },
{ name: '二徽', pos: '琴面左', level: 95, sound: '商音', emoji: '🌟' },
{ name: '三徽', pos: '琴面中', level: 95, sound: '角音', emoji: '💫' },
{ name: '四徽', pos: '琴面右', level: 94, sound: '徵音', emoji: '⭐' },
{ name: '五徽', pos: '岳山侧', level: 96, sound: '羽音', emoji: '🌠' },
{ name: '六徽', pos: '琴面左', level: 93, sound: '清角', emoji: '🪐' },
{ name: '七徽', pos: '龙龈左', level: 96, sound: '中吕', emoji: '🌙' },
{ name: '八徽', pos: '琴面右', level: 92, sound: '蕤宾', emoji: '☄️' },
{ name: '九徽', pos: '琴面左', level: 94, sound: '林钟', emoji: '💎' },
{ name: '十徽', pos: '琴面中', level: 92, sound: '夷则', emoji: '🔷' },
{ name: '十一徽', pos: '琴面右', level: 91, sound: '南吕', emoji: '🌌' },
{ name: '十三徽', pos: '岳山左', level: 90, sound: '应钟', emoji: '🪩' }
];
orders: GuqinOrderItem[] = [
{ name: '雅集琴馆', region: '华东', count: 60, amount: 360000, emoji: '🏛️' },
{ name: '国乐学院', region: '华中', count: 45, amount: 270000, emoji: '🎓' },
{ name: '琴学研究会', region: '华北', count: 38, amount: 228000, emoji: '📖' },
{ name: '汉服品牌', region: '华东', count: 50, amount: 240000, emoji: '👘' },
{ name: '影视道具组', region: '华南', count: 25, amount: 175000, emoji: '🎬' },
{ name: '海外琴社', region: '海外', count: 20, amount: 160000, emoji: '🌏' },
{ name: '茶空间连锁', region: '华中', count: 30, amount: 150000, emoji: '🍵' },
{ name: '非遗展馆', region: '西南', count: 35, amount: 210000, emoji: '🏺' },
{ name: '古琴班', region: '华东', count: 55, amount: 275000, emoji: '🎶' },
{ name: '文创买手店', region: '华南', count: 28, amount: 112000, emoji: '🎁' },
{ name: '景区演艺团', region: '西南', count: 32, amount: 160000, emoji: '🏞️' },
{ name: '私人定制', region: '华北', count: 12, amount: 120000, emoji: '💎' }
];
reviews: GuqinReviewItem[] = [
{ name: '琴馆馆主', score: 5, date: '09-03', content: '九霄环佩音色清越，徽位取音极准，开箱即能入调。', tag: '音色清越', emoji: '🏛️' },
{ name: '音乐学院教授', score: 5, date: '09-02', content: '仲尼式形制端方，弦距适中，学生练琴爱不释手。', tag: '形制端方', emoji: '🎓' },
{ name: '琴学会长', score: 5, date: '09-01', content: '灰胎打磨细腻，走手音圆润无燥，大漆光泽内敛。', tag: '打磨细腻', emoji: '📖' },
{ name: '汉服主理', score: 5, date: '08-31', content: '蕉叶式造型灵秀，置于茶席旁拍照极有韵味。', tag: '造型灵秀', emoji: '👘' },
{ name: '道具组组长', score: 5, date: '08-30', content: '剧组取景用琴，木纹做旧自然，镜头感十足。', tag: '做旧自然', emoji: '🎬' },
{ name: '海外琴友', score: 5, date: '08-29', content: '漂洋过海琴面无恙，装裱妥帖，丝弦音色温暖。', tag: '包装妥帖', emoji: '🌏' },
{ name: '茶空间老板', score: 5, date: '08-28', content: '琴声配茶香，客人驻足聆听，氛围感拉满。', tag: '氛围感好', emoji: '🍵' },
{ name: '展馆策展人', score: 4, date: '08-27', content: '琴身比例合度，若配琴匣展示更添仪式感。', tag: '比例合度', emoji: '🏺' },
{ name: '琴课老师', score: 4, date: '08-26', content: '弦张力稳定，若附备弦一根更贴心。', tag: '张力稳定', emoji: '🎶' },
{ name: '买手店主', score: 5, date: '08-25', content: '小琴桌款销量好，客人当摆件也当乐器用。', tag: '一物两用', emoji: '🎁' },
{ name: '演艺团长', score: 5, date: '08-24', content: '舞台灯光下琴漆流光，演出效果超出预期。', tag: '上镜出彩', emoji: '🏞️' },
{ name: '老琴友', score: 5, date: '08-23', content: '第二把了，焦尾式音质厚重，越弹越有味道。', tag: '越弹越爱', emoji: '💎' }
];
}
function getStyleColor(style: string): string {
if (style === '伏羲式') {
return '#5A4030';
} else if (style === '仲尼式') {
return '#8A6B52';
} else if (style === '蕉叶式') {
return '#C98A4E';
} else if (style === '落霞式') {
return '#A63A2B';
}
return '#6E8B5E';
}
function getStringColor(level: number): string {
if (level >= 95) {
return '#5A4030';
} else if (level >= 92) {
return '#8A6B52';
}
return '#C98A4E';
}
function getGuqinColor(price: number): string {
if (price >= 7000) {
return '#9E2E20';
} else if (price >= 6000) {
return '#5A4030';
} else if (price >= 5200) {
return '#8A6B52';
}
return '#6E8B5E';
}
function getOrderColor(amount: number): string {
if (amount >= 300000) {
return '#9E2E20';
} else if (amount >= 200000) {
return '#5A4030';
} else if (amount >= 130000) {
return '#8A6B52';
}
return '#6E8B5E';
}
function getReviewTagColor(tag: string): string {
if (tag === '音色清越' || tag === '打磨细腻' || tag === '比例合度' || tag === '上镜出彩') {
return '#5A4030';
} else if (tag === '形制端方' || tag === '做旧自然' || tag === '一物两用') {
return '#8A6B52';
} else if (tag === '造型灵秀' || tag === '氛围感好' || tag === '越弹越爱') {
return '#6E8B5E';
} else if (tag === '包装妥帖' || tag === '张力稳定') {
return '#C98A4E';
}
return '#9E2E20';
}
@Entry
@Component
struct GuqinApp {
@State curTab: number = 0;
@State data: GuqinData = new GuqinData();
@State showAddGuqin: boolean = false;
@State showEditOrder: boolean = false;
@State showDeleteString: boolean = false;
@State showDetailHui: boolean = false;
@State delStringName: string = '';
@State detailHuiName: string = '';
@State noteRotate: boolean = false;
@State starScale: boolean = false;
@Builder modalOverlay(onClose: () => void) {
Column() {
Text('')
.width(0)
.height(0)
.opacity(0)
Button('')
.width(1)
.height(1)
.opacity(0)
.onClick(() => {
onClose();
})
}
.width(1)
.height(1)
}
build() {
Column() {
Column() {
Column() {
Row() {
Column() {
Text('🎼 古琴坊')
.fontSize(20)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.white)
Text('Guqin · 泠泠七弦 松风入耳')
.fontSize(10)
.fontColor(COLORS.accentLight)
.margin({ top: 3 })
}
.alignItems(HorizontalAlign.Start)
.layoutWeight(1)
Row() {
Text('🎵')
.fontSize(20)
.onClick(() => {
this.noteRotate = !this.noteRotate;
})
.rotate({ angle: this.noteRotate ? 90 : 0 })
.animation({ duration: 700, curve: Curve.EaseOut })
Text('✨')
.fontSize(16)
.margin({ left: 10 })
.onClick(() => {
this.starScale = !this.starScale;
})
.scale({ x: this.starScale ? 1.6 : 1, y: this.starScale ? 1.6 : 1 })
.animation({ duration: 620, curve: Curve.EaseOut })
Text('🪕')
.fontSize(14)
.margin({ left: 6 })
}
.padding({ left: 10, right: 10, top: 6, bottom: 6 })
.backgroundColor(COLORS.accentLight + '2E')
.borderRadius(24)
.border({ width: 1, color: COLORS.accentLight + '80' })
}
.width('100%')
Row() {
ForEach(GUQIN_COL, (r: number) => {
Row() {
if (r % 3 === 0) {
Column()
.width(3)
.height(12)
.backgroundColor(COLORS.woodBrown)
.borderRadius(2)
} else if (r % 3 === 1) {
Column()
.width(9)
.height(9)
.backgroundColor(COLORS.huiGold)
.borderRadius(5)
.border({ width: 1, color: COLORS.white })
} else {
Column()
.width(5)
.height(5)
.backgroundColor(COLORS.white)
.borderRadius(3)
}
}
.width(14)
.justifyContent(FlexAlign.Center)
}, (r: number) => 'guqin' + r)
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ top: 12 })
Row() {
Column()
.layoutWeight(1)
.height(1)
.backgroundColor(COLORS.accentLight + '66')
Text('🎶 七弦为益友 · 两耳是知音 ✨')
.fontSize(9)
.fontColor(COLORS.accentLight)
.margin({ left: 8, right: 8 })
Column()
.layoutWeight(1)
.height(1)
.backgroundColor(COLORS.accentLight + '66')
}
.width('100%')
.margin({ top: 10 })
}
.width('100%')
.padding({ left: 16, right: 16, top: 12, bottom: 12 })
.backgroundColor(COLORS.primaryDark)
if (this.curTab === GuqinTab.GUQIN) {
GuqinContent({ data: this.data, onAdd: () => {
this.showAddGuqin = true;
} })
} else if (this.curTab === GuqinTab.STRING) {
StringContent({ data: this.data, onDel: (n: string) => {
this.delStringName = n;
this.showDeleteString = true;
} })
} else if (this.curTab === GuqinTab.HUI) {
HuiContent({ data: this.data, onDetail: (n: string) => {
this.detailHuiName = n;
this.showDetailHui = true;
} })
} else if (this.curTab === GuqinTab.ORDER) {
GuqinOrderContent({ data: this.data, onEdit: () => {
this.showEditOrder = true;
} })
} else {
GuqinReviewContent({ data: this.data })
}
}
.width('100%')
.height('100%')
Column() {
Column()
.width('100%')
.height(3)
.backgroundColor(COLORS.primary)
Row() {
ForEach(TAB_LIST, (t: TabMeta) => {
Column() {
Text(t.icon)
.fontSize(19)
Text(t.label)
.fontSize(10)
.fontColor(this.curTab === TAB_LIST.indexOf(t) ? t.color : COLORS.textHint)
.fontWeight(this.curTab === TAB_LIST.indexOf(t) ? FontWeight.Bold : FontWeight.Normal)
.margin({ top: 2 })
}
.layoutWeight(1)
.justifyContent(FlexAlign.Center)
.padding({ top: 7, bottom: 7 })
.backgroundColor(this.curTab === TAB_LIST.indexOf(t) ? t.color + '14' : '#00000000')
.borderRadius(10)
.border(this.curTab === TAB_LIST.indexOf(t) ? { width: 1, color: t.color } : { width: 0 })
.onClick(() => {
this.curTab = TAB_LIST.indexOf(t);
})
}, (t: TabMeta) => t.key)
}
.width('100%')
.height(60)
.padding({ left: 8, right: 8 })
.backgroundColor(COLORS.cardBg)
}
.width('100%')
if (this.showAddGuqin) {
AddGuqinModal({
onClose: () => {
this.showAddGuqin = false;
}
})
}
if (this.showEditOrder) {
EditGuqinOrderModal({
onClose: () => {
this.showEditOrder = false;
}
})
}
if (this.showDeleteString) {
DeleteStringModal({
title: this.delStringName, onClose: () => {
this.showDeleteString = false;
}
})
}
if (this.showDetailHui) {
DetailHuiModal({
name: this.detailHuiName, onClose: () => {
this.showDetailHui = false;
}
})
}
}
}
}
@Component
struct GuqinTag {
@Prop text: string;
@Prop color: string;
build() {
Text(this.text)
.fontSize(9)
.fontColor(this.color)
.padding({ left: 7, right: 7, top: 2, bottom: 2 })
.backgroundColor(this.color + '14')
.borderRadius(10)
.border({ width: 1, color: this.color + '40' })
}
}
@Component
struct GuqinContent {
@ObjectLink data: GuqinData;
onAdd: () => void = () => {};
build() {
Scroll() {
Column() {
Column() {
Row() {
Column()
.width(3)
.height(14)
.backgroundColor(COLORS.woodBrown)
.borderRadius(2)
Column()
.layoutWeight(1)
.height(2)
.backgroundColor(COLORS.primary + '55')
.margin({ left: 4, right: 4 })
Column()
.width(9)
.height(9)
.backgroundColor(COLORS.huiGold)
.borderRadius(5)
.border({ width: 1, color: COLORS.white })
.margin({ right: 4 })
Column()
.width(3)
.height(14)
.backgroundColor(COLORS.woodBrown)
.borderRadius(2)
Column()
.layoutWeight(1)
.height(2)
.backgroundColor(COLORS.primary + '55')
.margin({ left: 4, right: 4 })
Column()
.width(3)
.height(14)
.backgroundColor(COLORS.woodBrown)
.borderRadius(2)
}
.width('100%')
.margin({ bottom: 10 })
Row() {
Text('📈 本周古琴销量')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('周六30张')
.fontSize(9)
.fontColor(COLORS.primary)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Row() {
ForEach(WEEK_SOLD, (w: WeekGuqinMeta) => {
Column() {
Text(w.value + '')
.fontSize(8)
.fontColor(w.value >= 26 ? COLORS.primary : COLORS.accentLight)
Column()
.width(16)
.height(w.value)
.backgroundColor(w.value >= 26 ? COLORS.primary : COLORS.accentLight)
.borderRadius(8)
.margin({ top: 4 })
Text(w.day)
.fontSize(9)
.fontColor(COLORS.textSecondary)
.margin({ top: 4 })
}
.layoutWeight(1)
.alignItems(HorizontalAlign.Center)
}, (w: WeekGuqinMeta) => w.day)
}
.width('100%')
.height(150)
.alignItems(VerticalAlign.Bottom)
.margin({ top: 10 })
}
.width('100%')
.padding(14)
.backgroundColor(COLORS.cardBg)
.borderRadius(20)
.border({ width: 1, color: COLORS.primary + '55' })
Column() {
Row() {
Text('🎼 古琴名器')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('点击➕制琴')
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ left: 8 })
Text('➕')
.fontSize(14)
.margin({ left: 8 })
.onClick(() => {
this.onAdd();
})
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ bottom: 10 })
ForEach(this.data.guqins, (p: GuqinItem, i: number) => {
Row() {
Column() {
Column() {
Text(p.emoji)
.fontSize(18)
.textAlign(TextAlign.Center)
}
.width(44)
.height(44)
.justifyContent(FlexAlign.Center)
.alignItems(HorizontalAlign.Center)
.backgroundColor(getGuqinColor(p.price) + '14')
.borderRadius(22)
.border({ width: 1, color: getGuqinColor(p.price) + '66' })
Row() {
Column()
.width(2)
.height(10)
.backgroundColor(getGuqinColor(p.price))
.borderRadius(1)
Column()
.width(2)
.height(10)
.backgroundColor(getGuqinColor(p.price))
.borderRadius(1)
.margin({ left: 2 })
Column()
.width(2)
.height(10)
.backgroundColor(getGuqinColor(p.price))
.borderRadius(1)
.margin({ left: 2 })
}
.width(30)
.justifyContent(FlexAlign.Center)
.margin({ top: 5 })
}
.width(60)
.padding({ top: 10, bottom: 6 })
.backgroundColor(getGuqinColor(p.price) + '0D')
.borderRadius(22)
.border({ width: 1, color: getGuqinColor(p.price) + '33' })
Column() {
Row() {
Text(p.name)
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('¥' + p.price)
.fontSize(10)
.fontWeight(FontWeight.Bold)
.fontColor(getGuqinColor(p.price))
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Row() {
GuqinTag({ text: p.style, color: getStyleColor(p.style) })
GuqinTag({ text: p.wood + '面', color: COLORS.accentLight })
Text('七弦十三徽')
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.Start)
.margin({ top: 6 })
}
.layoutWeight(1)
.alignItems(HorizontalAlign.Start)
.margin({ left: 10 })
}
.width('100%')
.padding(10)
.backgroundColor(i % 2 === 0 ? COLORS.cardBg : COLORS.cardAlt)
.borderRadius(18)
.border({ width: 1, color: COLORS.line })
.margin({ top: 8 })
}, (p: GuqinItem, i: number) => 'gq' + p.name + i)
}
.width('100%')
.margin({ top: 12 })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
.scrollable(ScrollDirection.Vertical)
.scrollBar(BarState.Off)
}
}
@Component
struct StringContent {
@ObjectLink data: GuqinData;
onDel: (n: string) => void = () => {};
build() {
Scroll() {
Column() {
Column() {
Row() {
Text('🏆 名琴销量 TOP6')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('九霄环佩居首')
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ bottom: 10 })
ForEach(GUQIN_TOP, (t: GuqinTopMeta) => {
Row() {
Text(t.name)
.fontSize(10)
.fontColor(COLORS.textPrimary)
.width(90)
Row() {
Column()
.layoutWeight(t.sold)
.height(12)
.backgroundColor(t.color)
.borderRadius(6)
Column()
.layoutWeight(100 - t.sold)
.height(12)
.backgroundColor(COLORS.line)
.borderRadius(6)
}
.layoutWeight(1)
Text(t.sold + '把')
.fontSize(9)
.fontColor(t.color)
.width(40)
.textAlign(TextAlign.End)
}
.width('100%')
.margin({ top: 6 })
}, (t: GuqinTopMeta) => t.name)
}
.width('100%')
.padding(14)
.backgroundColor(COLORS.cardBg)
.borderRadius(20)
.border({ width: 1, color: COLORS.primary + '55' })
Column() {
Row() {
Text('🪢 琴弦库')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('点击🗑去弦')
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ bottom: 10 })
ForEach(this.data.strings, (c: StringItem, i: number) => {
Row() {
Column() {
Text(c.emoji)
.fontSize(18)
.textAlign(TextAlign.Center)
Row() {
Column()
.width(10)
.height(10)
.backgroundColor(getStringColor(c.level))
.borderRadius(5)
.border({ width: 2, color: COLORS.white })
Column()
.width(8)
.height(8)
.backgroundColor(COLORS.huiGold)
.borderRadius(4)
.margin({ left: 4 })
}
.width(28)
.justifyContent(FlexAlign.Center)
.margin({ top: 5 })
}
.width(56)
.padding({ top: 10, bottom: 6 })
.backgroundColor(getStringColor(c.level) + '0D')
.borderRadius(16)
.border({ width: 1, color: getStringColor(c.level) + '33' })
Column() {
Row() {
Text(c.name)
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text(c.tension)
.fontSize(9)
.fontColor(COLORS.textSecondary)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Row() {
Text('韧度')
.fontSize(9)
.fontColor(COLORS.textHint)
Row() {
Column()
.layoutWeight(c.level)
.height(6)
.backgroundColor(getStringColor(c.level))
.borderRadius(3)
Column()
.layoutWeight(100 - c.level)
.height(6)
.backgroundColor(COLORS.line)
.borderRadius(3)
}
.layoutWeight(1)
.margin({ left: 6 })
}
.width('100%')
.margin({ top: 6 })
}
.layoutWeight(1)
.alignItems(HorizontalAlign.Start)
.margin({ left: 10 })
Text('🗑️')
.fontSize(14)
.onClick(() => {
this.onDel(c.name);
})
}
.width('100%')
.padding(10)
.backgroundColor(i % 2 === 0 ? COLORS.cardBg : COLORS.cardAlt)
.borderRadius(18)
.border({ width: 1, color: COLORS.line })
.margin({ top: 8 })
}, (c: StringItem, i: number) => 'st' + c.name + i)
}
.width('100%')
.margin({ top: 12 })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
.scrollable(ScrollDirection.Vertical)
.scrollBar(BarState.Off)
}
}
@Component
struct HuiContent {
@ObjectLink data: GuqinData;
onDetail: (n: string) => void = () => {};
build() {
Scroll() {
Column() {
Column() {
Row() {
Text('🔥 制琴工艺热度')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('选材听音97')
.fontSize(9)
.fontColor(COLORS.primary)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ bottom: 10 })
ForEach(GUQIN_HOT, (d: GuqinHotMeta) => {
Row() {
Text(d.name)
.fontSize(10)
.fontColor(COLORS.textPrimary)
.width(80)
Row() {
Column()
.layoutWeight(d.heat)
.height(14)
.backgroundColor(d.color)
.borderRadius(7)
Column()
.layoutWeight(100 - d.heat)
.height(14)
.backgroundColor(COLORS.line)
.borderRadius(7)
}
.layoutWeight(1)
Text(d.heat + '')
.fontSize(9)
.fontColor(d.color)
.width(32)
.textAlign(TextAlign.End)
}
.width('100%')
.margin({ top: 6 })
}, (d: GuqinHotMeta) => d.name)
}
.width('100%')
.padding(14)
.backgroundColor(COLORS.cardBg)
.borderRadius(20)
.border({ width: 1, color: COLORS.primary + '55' })
Column() {
Row() {
Text('✨ 琴徽名录')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('点击👁️了解')
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ bottom: 10 })
ForEach(this.data.huis, (d: HuiItem, i: number) => {
Row() {
Column() {
Text(d.emoji)
.fontSize(18)
.textAlign(TextAlign.Center)
Column()
.width(14)
.height(14)
.backgroundColor(getStringColor(d.level))
.borderRadius(7)
.border({ width: 2, color: COLORS.huiGold })
.margin({ top: 5 })
}
.width(56)
.padding({ top: 10, bottom: 6 })
.backgroundColor(getStringColor(d.level) + '0D')
.borderRadius(16)
.border({ width: 1, color: getStringColor(d.level) + '33' })
Column() {
Row() {
Text(d.name)
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text(d.sound)
.fontSize(9)
.fontColor(getStringColor(d.level))
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Row() {
GuqinTag({ text: d.pos, color: COLORS.textSecondary })
Text('准度' + d.level)
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.Start)
.margin({ top: 6 })
}
.layoutWeight(1)
.alignItems(HorizontalAlign.Start)
.margin({ left: 10 })
Text('👁️')
.fontSize(14)
.onClick(() => {
this.onDetail(d.name);
})
}
.width('100%')
.padding(10)
.backgroundColor(i % 2 === 0 ? COLORS.cardBg : COLORS.cardAlt)
.borderRadius(18)
.border({ width: 1, color: COLORS.line })
.margin({ top: 8 })
}, (d: HuiItem, i: number) => 'hu' + d.name + i)
}
.width('100%')
.margin({ top: 12 })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
.scrollable(ScrollDirection.Vertical)
.scrollBar(BarState.Off)
}
}
@Component
struct GuqinOrderContent {
@ObjectLink data: GuqinData;
onEdit: () => void = () => {};
build() {
Scroll() {
Column() {
Column() {
Row() {
Text('🧩 琴式构成')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('伏羲式占比最高')
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ bottom: 10 })
ForEach(STYLE_SHARE, (s: StyleShareMeta) => {
Row() {
Column()
.width(8)
.height(8)
.backgroundColor(s.color)
.borderRadius(4)
Text(s.name)
.fontSize(10)
.fontColor(COLORS.textPrimary)
.margin({ left: 6 })
Text('×' + s.count)
.fontSize(9)
.fontColor(COLORS.textSecondary)
.margin({ left: 4 })
Row() {
Column()
.layoutWeight(s.count)
.height(10)
.backgroundColor(s.color)
.borderRadius(5)
Column()
.layoutWeight(20 - s.count)
.height(10)
.backgroundColor(COLORS.line)
.borderRadius(5)
}
.layoutWeight(1)
.margin({ left: 10 })
}
.width('100%')
.margin({ top: 6 })
}, (s: StyleShareMeta) => s.name)
}
.width('100%')
.padding(14)
.backgroundColor(COLORS.cardBg)
.borderRadius(20)
.border({ width: 1, color: COLORS.primary + '55' })
Column() {
Row() {
Text('📦 订单台账')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('点击✏️改单')
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ left: 8 })
Text('✏️')
.fontSize(14)
.margin({ left: 8 })
.onClick(() => {
this.onEdit();
})
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ bottom: 10 })
ForEach(this.data.orders, (o: GuqinOrderItem, i: number) => {
Row() {
Text(o.emoji)
.fontSize(16)
Column() {
Text(o.name)
.fontSize(12)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text(o.region + ' · ' + o.count + '张')
.fontSize(9)
.fontColor(COLORS.textSecondary)
.margin({ top: 2 })
}
.alignItems(HorizontalAlign.Start)
.layoutWeight(1)
.margin({ left: 10 })
Text('¥' + o.amount)
.fontSize(12)
.fontWeight(FontWeight.Bold)
.fontColor(getOrderColor(o.amount))
Text('✏️')
.fontSize(12)
.margin({ left: 10 })
.onClick(() => {
this.onEdit();
})
}
.width('100%')
.padding(10)
.backgroundColor(i % 2 === 0 ? COLORS.cardBg : COLORS.cardAlt)
.borderRadius(18)
.border({ width: 1, color: COLORS.line })
.margin({ top: 8 })
}, (o: GuqinOrderItem, i: number) => 'od' + o.name + i)
}
.width('100%')
.margin({ top: 12 })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
.scrollable(ScrollDirection.Vertical)
.scrollBar(BarState.Off)
}
}
@Component
struct GuqinReviewContent {
@ObjectLink data: GuqinData;
build() {
Scroll() {
Column() {
Row() {
Text('⭐ 客评口碑')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('12条好评 · 平均4.9')
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ bottom: 6 })
ForEach(this.data.reviews, (r: GuqinReviewItem, i: number) => {
Column() {
Row() {
Text(r.emoji)
.fontSize(15)
Column() {
Text(r.name)
.fontSize(12)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text(r.date)
.fontSize(9)
.fontColor(COLORS.textHint)
.margin({ top: 1 })
}
.alignItems(HorizontalAlign.Start)
.layoutWeight(1)
.margin({ left: 8 })
Text('⭐'.repeat(r.score))
.fontSize(10)
.fontColor(COLORS.warning)
GuqinTag({ text: r.tag, color: getReviewTagColor(r.tag) })
}
.width('100%')
Text(r.content)
.fontSize(11)
.fontColor(COLORS.textSecondary)
.lineHeight(16)
.margin({ top: 6 })
}
.width('100%')
.padding(12)
.backgroundColor(i % 2 === 0 ? COLORS.cardBg : COLORS.cardAlt)
.borderRadius(18)
.border({ width: 1, color: COLORS.line })
.margin({ top: 8 })
}, (r: GuqinReviewItem, i: number) => 'rv' + r.name + i)
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
.scrollable(ScrollDirection.Vertical)
.scrollBar(BarState.Off)
}
}
@Component
struct AddGuqinModal {
onClose: () => void = () => {};
build() {
Column() {
Column() {
Row() {
Text('🎼 定制古琴')
.fontSize(16)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('✕')
.fontSize(16)
.fontColor(COLORS.textHint)
.onClick(() => {
this.onClose();
})
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Row() {
Text('琴名')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.width(56)
Text('九霄环佩')
.fontSize(11)
.fontColor(COLORS.textPrimary)
}
.width('100%')
.padding(10)
.backgroundColor(COLORS.cardAlt)
.borderRadius(10)
.margin({ top: 14 })
Row() {
Text('琴式')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.width(56)
Text('伏羲式 · 杉木面 · 七弦十三徽')
.fontSize(11)
.fontColor(COLORS.textPrimary)
}
.width('100%')
.padding(10)
.backgroundColor(COLORS.cardAlt)
.borderRadius(10)
.margin({ top: 8 })
Row() {
Text('预算')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.width(56)
Text('¥6800')
.fontSize(11)
.fontColor(COLORS.primary)
}
.width('100%')
.padding(10)
.backgroundColor(COLORS.cardAlt)
.borderRadius(10)
.margin({ top: 8 })
Row() {
Text('取消')
.fontSize(12)
.fontColor(COLORS.textSecondary)
.padding({ left: 16, right: 16, top: 7, bottom: 7 })
.borderRadius(12)
.border({ width: 1, color: COLORS.border })
.onClick(() => {
this.onClose();
})
Text('确认定制')
.fontSize(12)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.white)
.padding({ left: 16, right: 16, top: 7, bottom: 7 })
.backgroundColor(COLORS.primary)
.borderRadius(12)
.onClick(() => {
this.onClose();
})
}
.width('100%')
.justifyContent(FlexAlign.End)
.margin({ top: 14 })
}
.width('86%')
.padding(16)
.backgroundColor(COLORS.cardBg)
.borderRadius(18)
.constraintSize({ maxHeight: '78%' })
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
.backgroundColor('#66000000')
}
}
@Component
struct EditGuqinOrderModal {
onClose: () => void = () => {};
build() {
Column() {
Column() {
Row() {
Text('✏️ 修改订单')
.fontSize(16)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('✕')
.fontSize(16)
.fontColor(COLORS.textHint)
.onClick(() => {
this.onClose();
})
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Row() {
Text('客户')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.width(56)
Text('雅集琴馆')
.fontSize(11)
.fontColor(COLORS.textPrimary)
}
.width('100%')
.padding(10)
.backgroundColor(COLORS.cardAlt)
.borderRadius(10)
.margin({ top: 14 })
Row() {
Text('数量')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.width(56)
Text('60 → 66 张')
.fontSize(11)
.fontColor(COLORS.primary)
}
.width('100%')
.padding(10)
.backgroundColor(COLORS.cardAlt)
.borderRadius(10)
.margin({ top: 8 })
Row() {
Text('金额')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.width(56)
Text('¥396000')
.fontSize(11)
.fontColor(COLORS.accent)
}
.width('100%')
.padding(10)
.backgroundColor(COLORS.cardAlt)
.borderRadius(10)
.margin({ top: 8 })
Row() {
Text('取消')
.fontSize(12)
.fontColor(COLORS.textSecondary)
.padding({ left: 16, right: 16, top: 7, bottom: 7 })
.borderRadius(12)
.border({ width: 1, color: COLORS.border })
.onClick(() => {
this.onClose();
})
Text('保存修改')
.fontSize(12)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.white)
.padding({ left: 16, right: 16, top: 7, bottom: 7 })
.backgroundColor(COLORS.primary)
.borderRadius(12)
.onClick(() => {
this.onClose();
})
}
.width('100%')
.justifyContent(FlexAlign.End)
.margin({ top: 14 })
}
.width('86%')
.padding(16)
.backgroundColor(COLORS.cardBg)
.borderRadius(18)
.constraintSize({ maxHeight: '78%' })
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
.backgroundColor('#66000000')
}
}
@Component
struct DeleteStringModal {
@Prop title: string;
onClose: () => void = () => {};
build() {
Column() {
Column() {
Text('🗑️ 撤下琴弦')
.fontSize(16)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('确定撤下「' + this.title + '」吗？')
.fontSize(12)
.fontColor(COLORS.textSecondary)
.margin({ top: 10 })
Text('撤下的琴弦将从弦库移除。')
.fontSize(10)
.fontColor(COLORS.textHint)
.margin({ top: 4 })
Row() {
Text('再想想')
.fontSize(12)
.fontColor(COLORS.textSecondary)
.padding({ left: 16, right: 16, top: 7, bottom: 7 })
.borderRadius(12)
.border({ width: 1, color: COLORS.border })
.onClick(() => {
this.onClose();
})
Text('确认撤下')
.fontSize(12)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.white)
.padding({ left: 16, right: 16, top: 7, bottom: 7 })
.backgroundColor(COLORS.danger)
.borderRadius(12)
.onClick(() => {
this.onClose();
})
}
.width('100%')
.justifyContent(FlexAlign.End)
.margin({ top: 16 })
}
.width('86%')
.padding(16)
.backgroundColor(COLORS.cardBg)
.borderRadius(18)
.constraintSize({ maxHeight: '78%' })
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
.backgroundColor('#66000000')
}
}
@Component
struct DetailHuiModal {
@Prop name: string;
onClose: () => void = () => {};
build() {
Column() {
Column() {
Row() {
Text('👁️ 琴徽详情')
.fontSize(16)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('✕')
.fontSize(16)
.fontColor(COLORS.textHint)
.onClick(() => {
this.onClose();
})
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Column() {
Text('✨')
.fontSize(30)
Text(this.name)
.fontSize(14)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
.margin({ top: 6 })
}
.width('100%')
.padding(14)
.backgroundColor(COLORS.cardAlt)
.borderRadius(12)
.margin({ top: 12 })
Text('琴徽以螺钿或玉石嵌于琴面，十三徽分定泛音之位，与岳山、龙龈相望。一至七徽主泛音清亮，八至十三徽渐沉厚，取音须准，分毫之差音即失位。')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.lineHeight(17)
.margin({ top: 10 })
Row() {
Text('音位')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.width(56)
Text('宫音 · 岳山右')
.fontSize(11)
.fontColor(COLORS.textPrimary)
}
.width('100%')
.padding(10)
.backgroundColor(COLORS.cardAlt)
.borderRadius(10)
.margin({ top: 8 })
Row() {
Text('匠人评级')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.width(56)
Text('甲级 · 镶徽廿载')
.fontSize(11)
.fontColor(COLORS.primary)
}
.width('100%')
.padding(10)
.backgroundColor(COLORS.cardAlt)
.borderRadius(10)
.margin({ top: 8 })
Text('知道了')
.fontSize(12)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.white)
.padding({ left: 18, right: 18, top: 7, bottom: 7 })
.backgroundColor(COLORS.primary)
.borderRadius(12)
.margin({ top: 12 })
.onClick(() => {
this.onClose();
})
}
.width('86%')
.padding(16)
.backgroundColor(COLORS.cardBg)
.borderRadius(18)
.constraintSize({ maxHeight: '78%' })
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
.backgroundColor('#66000000')
}
}
作为“人工智能6S店”的官方数字引擎，为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。
更多推荐
0
0- 0
已为社区贡献3条内容
所有评论(0)