鸿蒙ArkTS实战：象棋坊移动应用开发全解析——从红黑棋韵色彩体系到组件化架构的深度剖析
·
摘要：本文以一个完整的象棋文化展示与棋具管理应用"象棋坊"为案例，深入剖析鸿蒙HarmonyOS ArkTS声明式UI开发范式的核心要点。从以"乌木黑·棋枰红·金徽"三色为核心的东方棋韵色彩体系的接口化定义，到响应式数据流
@Observed/@ObjectLink在多Tab场景下的深度运用，再到自定义模态弹窗体系、条件渲染路由、layoutWeight弹性布局权重等复杂交互模式的完整实现，逐段拆解每一个关键代码块背后的设计思想与技术原理。全文覆盖接口约束、枚举安全、数据建模、状态驱动渲染、组件拆分策略、颜色透明度拼接、ForEach键值策略等20+个技术知识点，适合有一定ArkTS基础、希望深入理解鸿蒙声明式UI架构的开发者进阶阅读。
一、前言：楚河汉界的数字化棋韵
象棋，又称中国象棋，是起源于先秦时期、定型于宋代的两人对弈棋类游戏，至今已有两千余年历史。"马走日，象飞田，车走直路炮翻山"，这些口诀几乎伴随了每一个中国孩子的成长。棋盘之上，楚河汉界分明，红黑双方将帅各守一方，车、马、炮、兵卒在九道纵线与十道横线交织的方寸之间纵横捭阖。象棋不仅是智力的较量，更是中国传统兵家思维与谋略哲学的浓缩载体。
在数字化浪潮席卷全球的今天，将这样一门承载着深厚文化底蕴的传统棋艺以移动应用的形式呈现给现代用户，既是对非物质文化遗产传播方式的一次创新探索，也是对鸿蒙开发技术的一次深度实践。本文所剖析的"象棋坊"应用，正是围绕这一主题构建的一个集棋子名品、棋枰库、棋谱藏书、订单台账与客户评价于一体的综合性移动端展示平台。
在整个应用的开发过程中，我们不仅需要关注UI层面的视觉表现力——如何用代码还原棋子的红黑质感与棋枰的木纹肌理，更需要深入理解ArkTS框架的底层机制：状态管理如何驱动UI刷新、组件间如何高效通信、数据流如何在父子组件间双向传递、自定义弹窗如何优雅地叠加在页面上方。这些问题的答案，都隐藏在接下来的每一行代码之中。本文将从架构总览开始，逐层深入，带你完成一次从"能写"到"写好"的鸿蒙开发进阶之旅。
二、项目架构总览：分层设计与模块化思想
本应用采用经典的单文件声明式架构，所有逻辑集中在同一个ArkTS文件中，通过清晰的分层组织实现高内聚低耦合。整体架构可以划分为以下六个层次：
第一层——类型定义层（第1~132行）：包含XiangqiPalette色彩接口、XiangqiTab枚举、TabMeta标签元数据接口以及全部业务实体接口（PieceItem、BoardItem、ManualItem、XiangqiOrderItem、XiangqiReviewItem）和图表数据元接口（WeekXiangqiMeta、RoleShareMeta、ManualHotMeta、XiangqiTopMeta）。这一层是整个应用的"契约"，所有后续的数据结构都必须严格遵循这些接口定义。
第二层——常量实例层（第23~167行）：将抽象的类型定义具象化为可用的运行时对象，包括COLORS色彩常量、TAB_LIST标签列表、XIANGQI_COL棋位列阵以及四组静态图表数据（WEEK_SOLD周销量、ROLE_SHARE兵种构成、MANUAL_HOT棋谱热度、XIANGQI_TOP棋子销量排行）。
第三层——响应式数据类（第169~245行）：@Observed装饰的XiangqiData类，封装了五组核心业务数据的动态数组，是整个应用的状态中枢。
第四层——工具函数层（第247~300行）：五个纯函数式的颜色映射器（getRoleColor、getBoardColor、getPieceColor、getOrderColor、getReviewTagColor），根据业务规则返回语义化的颜色值。
第五层——主入口与容器组件（第302~521行）：@Entry标记的XiangqiApp根组件，负责全局状态管理、页面骨架搭建、Tab路由分发和弹窗条件渲染。
第六层——子组件体系（第523行至文件末尾）：包括1个标签组件（XiangqiTag）、5个内容组件（分别对应5个Tab页）和4个模态弹窗组件，共同构成完整的功能矩阵。
这种分层设计的优势在于：当需要修改某个功能模块时，开发者可以快速定位到对应的层次进行修改，而不会对其他部分产生连锁反应。例如，如果需要调整配色方案，只需修改第一层的接口定义和第二层的常量实例；如果需要新增一个Tab页面，只需在第五层添加路由分支并在第六层新增对应的内容组件即可。
三、色彩体系设计：接口约束与常量定义
3.1 调色板接口定义
interface XiangqiPalette {
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; // 纯白
ebonyBlack: string; // 乌木黑（棋子/棋枰专用）
chessRed: string; // 棋红（棋子红方专用）
}
这段代码看似简单，却蕴含着深刻的设计思想。首先，使用interface而不是type来定义调色板结构，是因为interface在ArkTS中具有更好的类型推断能力和扩展性。接口中定义了19个颜色字段，覆盖了以下几大语义类别：
- 主色调系列（primary / primaryLight / primaryDark）：以乌木黑
#3A322C为核心，模拟高级棋枰常用的紫檀、乌木本色。三个梯度分别用于常规主色、悬停/次要强调和深色背景区域。 - 强调色系列（accent / accentLight）：棋枰红
#B3362E取自传统大漆的朱砂红与红方棋子配色，用于关键操作按钮和高亮元素；其浅变体金徽色#C9A24B则呼应棋枰边缘铜包角与棋谱封面的烫金装饰。 - 背景色系（bg / cardBg / cardAlt）：米宣纸色
#F2EDE0作为页面底色营造古籍棋谱翻阅感；纯白#FFFFFF作为卡片底色保证内容可读性；浅米#EFE7D8作为交替行背景增强列表视觉节奏。 - 文本色三级灰度（textPrimary / textSecondary / textHint）：从墨黑
#2E2620到灰褐#756B5E再到淡灰#A99F8E，形成清晰的信息层级。 - 功能语义色（success / warning / danger）：青绿
#6E8B5E表示成功/完成，金橙表示提醒/待办，暗红#9E2E20表示危险/超支。 - 主题专属色（ebonyBlack / chessRed）：乌木黑复用主色但语义独立，专指棋枰与黑方棋子；棋红
#B3362E精确对应红方棋子与重要强调。
这种19色的精细划分，使得整个应用的每一个视觉元素都有明确的"色彩归属"，避免了随意使用硬编码颜色值带来的视觉混乱。更重要的是，通过接口约束，任何遗漏字段或类型不匹配都会在编译阶段被TypeScript编译器捕获，实现了"编译期安全"。
3.2 色彩常量实例化
const COLORS: XiangqiPalette = {
primary: '#3A322C',
primaryLight: '#6E6258',
primaryDark: '#241E1A',
accent: '#B3362E',
accentLight: '#C9A24B',
bg: '#F2EDE0',
cardBg: '#FFFFFF',
cardAlt: '#EFE7D8',
textPrimary: '#2E2620',
textSecondary: '#756B5E',
textHint: '#A99F8E',
border: '#E0D7C4',
line: '#F0EBDD',
success: '#6E8B5E',
warning: '#C9A24B',
danger: '#9E2E20',
white: '#FFFFFF',
ebonyBlack: '#3A322C',
chessRed: '#B3362E'
};
这里有一个非常值得注意的细节：COLORS常量的类型被显式标注为XiangqiPalette。这意味着TypeScript编译器会在编译阶段检查COLORS对象是否完整实现了接口定义的所有19个字段。如果遗漏了任何一个颜色字段，或者字段类型不匹配（比如不小心把数字赋给了string类型的字段），编译器会立即报错。这种"编译期安全"是大型项目中极其重要的保障，它能在代码运行之前就消灭掉大量潜在的类型错误。
此外，所有颜色值均采用标准的#RRGGBB六位十六进制格式，而非CSS变量名或语义别名。这种选择在ArkTS生态中是务实的——ArkTS的声明式UI直接支持字符串形式的颜色值，无需额外的运行时解析开销。同时，将所有颜色集中在一个常量对象中管理，使得后续的主题切换（如实现"暗色模式"）只需要替换这个常量对象即可，体现了良好的架构前瞻性。
四、枚举与标签配置：类型安全的页面路由
4.1 Tab枚举定义
enum XiangqiTab {
PIECE = 0,
BOARD = 1,
MANUAL = 2,
ORDER = 3,
REVIEW = 4
}
XiangqiTab枚举定义了应用底部导航栏的五个页面标识，从0到4依次对应：棋子、棋枰、棋谱、订单、客评。使用枚举而非魔术数字（magic number）的好处是多方面的：
第一，类型安全。当我们在代码中编写this.curTab === XiangqiTab.PIECE时，编辑器会提供自动补全和拼写检查，有效避免将PIECE误写成PEICE之类的低级错误。
第二，语义明确。枚举成员名称本身就是最好的文档——任何阅读代码的人都能立刻理解XiangqiTab.REVIEW代表的是"客评"页面，而数字4则需要查阅上下文才能确定含义。
第三，重构友好。如果未来需要调整Tab的顺序（比如把"订单"移到第二个位置），只需修改枚举值的赋值顺序，所有引用该枚举的地方都会自动适配。
4.2 标签元数据配置
interface TabMeta {
key: string;
icon: string;
label: string;
color: string;
}
const TAB_LIST: TabMeta[] = [
{ key: 'piece', icon: '♟️', label: '棋子', color: '#B3362E' },
{ key: 'board', icon: '🪵', label: '棋枰', color: '#6E6258' },
{ key: 'manual', icon: '📜', label: '棋谱', color: '#C9A24B' },
{ key: 'order', icon: '📦', label: '订单', color: '#C9A24B' },
{ key: 'review', icon: '⭐', label: '客评', color: '#9E2E20' }
];
这是一个非常优雅的设计模式：将标签的配置信息（唯一标识key、图标emoji、显示文字label、主题色color）抽象为一个数据数组，而非硬编码在组件的build()方法中。这种"数据驱动UI"的思路，使得后续新增或修改标签时，只需要修改TAB_LIST数组即可，无需触碰任何组件代码。
每个标签还拥有自己的主题色（color字段），这为选中态的视觉表现提供了丰富的个性化空间。例如，"棋子"Tab选中时使用棋枰红高亮，"客评"Tab则使用暗红色，让用户在不同页面间切换时能获得一致的色彩反馈但又各具辨识度。
五、数据模型设计：接口驱动的类型安全
5.1 业务实体接口定义
interface PieceItem {
name: string; // 棋子名称
role: string; // 兵种（将/车/马/炮/士/相/卒等）
side: string; // 所属阵营（红方/黑方）
price: number; // 价格（元）
emoji: string; // 表情图标
}
interface BoardItem {
name: string; // 棋枰名称
wood: string; // 木材（紫檀/金丝楠/楸木等）
level: number; // 品质等级（0-100）
grid: string; // 路数（九路/七路）
emoji: string;
}
interface ManualItem {
name: string; // 棋谱名
style: string; // 流派（当头炮/屏风马/残局等）
level: number; // 研习度
step: string; // 谱数
emoji: string;
}
interface XiangqiOrderItem {
name: string; // 客户名称
region: string; // 所属区域
count: number; // 订购数量（副）
amount: number; // 订单金额（元）
emoji: string;
}
interface XiangqiReviewItem {
name: string; // 评价人
score: number; // 评分（1-5星）
date: string; // 日期
content: string; // 内容
tag: string; // 标签
emoji: string;
}
这里展示了五种业务实体的接口定义。每个接口都精心设计了字段，紧密围绕象棋行业的实际业务场景：
PieceItem（棋子条目）：包含棋子名称（如"镇关将"、"千里马"）、兵种（将、车、马、炮、士、相、卒、帅）、阵营（红方/黑方）、价格和表情图标。其中role字段不仅用于显示，还是后续getRoleColor()颜色映射函数的输入参数。BoardItem（棋枰条目）：记录棋枰名称、木材（紫檀、金丝楠、楸木、花梨、乌木等）、品质等级（数值型，用于进度条可视化）、路数（九路/七路）。level字段是棋枰页面的核心数据维度，直接影响每个棋枰卡片的主题色与进度条长度。ManualItem（棋谱条目）：棋谱名称、流派风格、研习度评级和谱数。level字段同样用于getBoardColor()颜色映射，使得不同研习度的棋谱在视觉上呈现梯度差异。XiangqiOrderItem（订单条目）：记录客户名称、所属区域、订购数量和金额。amount字段是getOrderColor()的颜色映射依据——金额越高颜色越"危险"（暗红），形成直观的业务警示。XiangqiReviewItem（评价条目）：包含评分（1-5星）、日期、评价内容和标签。tag字段是getReviewTagColor()的映射输入，不同类型的评价标签被赋予不同的主题色。
这五组接口构成了整个应用的数据模型基石。值得注意的是，所有接口中的emoji字段虽然不是严格的"业务数据"，但在ArkTS的Text组件中可以直接渲染表情符号，为每个条目提供了轻量级的视觉标识，增强了列表的可读性和趣味性。
5.2 图表数据元接口
interface WeekXiangqiMeta {
day: string; // 星期几
value: number; // 销量
}
interface RoleShareMeta {
name: string; // 兵种名称
count: number; // 数量
color: string; // 主题色
}
interface ManualHotMeta {
name: string; // 棋谱/开局名称
heat: number; // 热度值
color: string; // 主题色
}
interface XiangqiTopMeta {
name: string; // 棋子名
sold: number; // 销量
color: string; // 主题色
}
这四个接口专门服务于应用中的四种图表/排行榜可视化组件。它们的设计遵循了一个共同的范式：名称 + 数值 + 主题色的三元组结构。这种统一的数据形状使得四种图表可以共享同一套渲染逻辑（ForEach + layoutWeight条形图），只是数据源不同而已。
WeekXiangqiMeta用于垂直柱状图（周销量走势），RoleShareMeta/ManualHotMeta/XiangqiTopMeta用于水平条形图（构成/热度/排行）。每种接口都自带color字段，使得每个数据条都可以拥有独立的颜色，而不是强制使用统一的系列色。
六、静态数据集：应用的基础数据源
6.1 图表静态数据
const WEEK_SOLD: WeekXiangqiMeta[] = [
{ day: '周一', value: 42 },
{ day: '周二', value: 55 },
{ day: '周三', value: 48 },
{ day: '周四', value: 66 },
{ day: '周五', value: 72 },
{ day: '周六', value: 95 },
{ day: '周日', value: 84 }
];
这里展示了周销量数据。在实际项目中，这些数据通常来自后端API接口，但本应用作为展示型Demo采用了静态数据的方式。数据的设计颇具巧思——销量从周一到周六逐步攀升（42→55→48→66→72→95），周日略有回落（84），这完全符合棋具零售"工作日平稳、周末高峰、周日略降"的实际规律，让数据看起来真实可信。
const ROLE_SHARE: RoleShareMeta[] = [
{ name: '车', count: 5, color: '#B3362E' },
{ name: '马', count: 4, color: '#3A322C' },
{ name: '炮', count: 3, color: '#C9A24B' },
{ name: '卒', count: 2, color: '#6E8B5E' }
];
兵种构成数据反映了象棋四种主要进攻子力的配置比例。车（5款）居首，作为棋盘上威力最大的棋子，自然品种最丰富；马（4款）次之，强调"马踏八方"的灵动；炮（3款）体现远程牵制的特色；卒（2款）最少，但"小卒过河顶大车"的谚语说明其战略价值不可忽视。
6.2 棋谱热度与排行榜数据
const MANUAL_HOT: ManualHotMeta[] = [
{ name: '当头炮', heat: 97, color: '#B3362E' },
{ name: '屏风马', heat: 95, color: '#3A322C' },
{ name: '仙人指路', heat: 93, color: '#C9A24B' },
{ name: '飞相局', heat: 92, color: '#6E8B5E' },
{ name: '过宫炮', heat: 91, color: '#6E6258' },
{ name: '起马局', heat: 90, color: '#9E2E20' }
];
const XIANGQI_TOP: XiangqiTopMeta[] = [
{ name: '镇关将', sold: 98, color: '#B3362E' },
{ name: '千里马', sold: 93, color: '#3A322C' },
{ name: '霹雳车', sold: 90, color: '#C9A24B' },
{ name: '连环炮', sold: 86, color: '#6E8B5E' },
{ name: '巡城相', sold: 82, color: '#6E6258' },
{ name: '先锋卒', sold: 79, color: '#9E2E20' }
];
棋谱热度数据涵盖了象棋界最受欢迎的六大开局与流派。"当头炮"以97的热度高居榜首，这是初学者最先接触、职业比赛也最常出现的经典开局；"屏风马"以95紧随其后，是应对当头炮最稳健的反制体系。棋子销量TOP6则以拟人化的商品名呈现，"镇关将"（帅/将）作为棋局核心以98的销量遥遥领先，"千里马"（马）、"霹雳车"（车）、"连环炮"（炮）等命名既保留了兵种特征，又增添了商品传播力。
七、响应式数据类：@Observed装饰器的深度运用
@Observed
export class XiangqiData {
pieces: PieceItem[] = [
{ name: '镇关将', role: '将', side: '红方', price: 288, emoji: '♔' },
{ name: '千里马', role: '马', side: '红方', price: 128, emoji: '🐎' },
{ name: '霹雳车', role: '车', side: '黑方', price: 138, emoji: '🏎️' },
{ name: '连环炮', role: '炮', side: '红方', price: 118, emoji: '💥' },
{ name: '护驾士', role: '士', side: '红方', price: 88, emoji: '🛡️' },
{ name: '巡城相', role: '相', side: '黑方', price: 88, emoji: '🏯' },
{ name: '先锋卒', role: '卒', side: '红方', price: 68, emoji: '🗡️' },
{ name: '赤兔马', role: '马', side: '黑方', price: 128, emoji: '🐴' },
{ name: '铁壁车', role: '车', side: '红方', price: 138, emoji: '🛡️' },
{ name: '飞石炮', role: '炮', side: '黑方', price: 118, emoji: '🪨' },
{ name: '坐帐帅', role: '帅', side: '黑方', price: 288, emoji: '♚' },
{ name: '披甲卒', role: '卒', side: '黑方', price: 68, emoji: '⛑️' }
];
boards: BoardItem[] = [
{ name: '檀木棋枰', wood: '紫檀', level: 96, grid: '九路', emoji: '🪵' },
{ name: '楠木棋枰', wood: '金丝楠', level: 95, grid: '九路', emoji: '🌲' },
{ name: '楸木棋枰', wood: '楸木', level: 94, grid: '九路', emoji: '🍂' },
{ name: '花梨棋枰', wood: '花梨', level: 93, grid: '九路', emoji: '🌸' },
{ name: '乌木棋枰', wood: '乌木', level: 95, grid: '九路', emoji: '⚫' },
{ name: '竹面棋枰', wood: '竹片', level: 92, grid: '七路', emoji: '🎋' },
{ name: '红木棋枰', wood: '红酸枝', level: 94, grid: '九路', emoji: '🔴' },
{ name: '枫木棋枰', wood: '枫木', level: 90, grid: '九路', emoji: '🍁' },
{ name: '榆木棋枰', wood: '榆木', level: 91, grid: '九路', emoji: '🌳' },
{ name: '枣木棋枰', wood: '枣木', level: 92, grid: '七路', emoji: '🟤' },
{ name: '松木棋枰', wood: '松木', level: 89, grid: '七路', emoji: '🌲' },
{ name: '杉木棋枰', wood: '杉木', level: 90, grid: '九路', emoji: '🪵' }
];
manuals: ManualItem[] = [
{ name: '橘中秘', style: '当头炮', level: 96, step: '36谱', emoji: '📜' },
{ name: '梅花谱', style: '屏风马', level: 95, step: '42谱', emoji: '🌺' },
{ name: '适情雅趣', style: '残局', level: 94, step: '50谱', emoji: '🏛️' },
{ name: '竹香斋', style: '排局', level: 93, step: '28谱', emoji: '🎋' },
{ name: '百局象棋谱', style: '全局', level: 95, step: '40谱', emoji: '📚' },
{ name: '自出洞来无敌手', style: '快攻', level: 94, step: '30谱', emoji: '⚔️' },
{ name: '烂柯神机', style: '残局', level: 92, step: '26谱', emoji: '🪓' },
{ name: '心武残编', style: '排局', level: 93, step: '32谱', emoji: '🧠' },
{ name: '象棋指要', style: '中局', level: 91, step: '24谱', emoji: '👆' },
{ name: '布局新变', style: '开局', level: 92, step: '38谱', emoji: '🌟' },
{ name: '残局攻守', style: '残局', level: 90, step: '22谱', emoji: '🛡️' },
{ name: '棋经论', style: '总纲', level: 89, step: '16谱', emoji: '📖' }
];
orders: XiangqiOrderItem[] = [
{ name: '棋院联盟', region: '华东', count: 2000, amount: 180000, emoji: '🏛️' },
{ name: '社区棋社', region: '华北', count: 1500, amount: 120000, emoji: '🏘️' },
{ name: '文创买手店', region: '华南', count: 1800, amount: 144000, emoji: '🎁' },
{ name: '文旅街区', region: '西南', count: 1200, amount: 96000, emoji: '🏞️' },
{ name: '学校棋课', region: '华中', count: 1600, amount: 128000, emoji: '🎒' },
{ name: '海外棋会', region: '海外', count: 800, amount: 96000, emoji: '🌏' },
{ name: '茶楼连锁', region: '华东', count: 1400, amount: 112000, emoji: '🍵' },
{ name: '老年活动中心', region: '华北', count: 1000, amount: 80000, emoji: '🧓' },
{ name: '直播带货团', region: '华南', count: 2200, amount: 176000, emoji: '📺' },
{ name: '棋类赛事组', region: '华中', count: 900, amount: 108000, emoji: '🏆' },
{ name: '景区棋亭', region: '西南', count: 1100, amount: 77000, emoji: '⛩️' },
{ name: '私人定制', region: '华东', count: 300, amount: 90000, emoji: '💎' }
];
reviews: XiangqiReviewItem[] = [
{ 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: 5, date: '08-26', content: '上播即爆单，棋枰木纹清晰，镜头质感高级。', tag: '上镜高级', emoji: '📺' },
{ name: '赛事裁判', score: 4, date: '08-25', content: '棋谱印刷清晰，若加大字号更护眼。', tag: '印刷清晰', emoji: '🏆' },
{ name: '景区经理', score: 5, date: '08-24', content: '棋亭配棋成网红打卡点，游客都要上手摸一把。', tag: '成打卡点', emoji: '⛩️' },
{ name: '老棋迷', score: 5, date: '08-23', content: '第二套了，手感比老棋更趁手，天天摆局。', tag: '越用越趁手', emoji: '💎' }
];
}
这是整个应用最核心的数据层代码。@Observed装饰器是ArkTS框架提供的一个关键装饰器，它的作用是将一个普通的类标记为"可观察的"。当一个类被@Observed标记后，该类实例的属性变化会被ArkTS框架自动追踪，任何引用了该实例属性的@ObjectLink或@State变量都会在属性变化时自动触发UI重新渲染。
XiangqiData类封装了五组核心业务数据：
pieces（12枚棋子）：涵盖从"镇关将"（¥288，红方将）到"披甲卒"（¥68，黑方卒）的全价位段产品矩阵，兵种完整覆盖将/帅、士、相、车、马、炮、卒。boards（12张棋枰）：木材涵盖紫檀、金丝楠、楸木、花梨、乌木、竹片、红酸枝等传统与现代材料，品质等级89-96不等，路数分九路与七路两种规格。manuals（12部棋谱）：从《橘中秘》《梅花谱》等传世经典到现代《布局新变》《残局攻守》，覆盖当头炮、屏风马、残局、排局、全局、快攻、中局、开局、总纲等多种风格。orders（12条订单）：客户涵盖棋院、社区棋社、文创买手店、文旅街区、学校、海外棋会、茶楼、老年活动中心、直播团队、赛事组、景区棋亭、私人定制等多元渠道，区域分布华东/华北/华南/华中/西南/海外。reviews（12条评价）：全部4-5星好评，标签涵盖"字口深峻"、"走子顺滑"、"配色雅正"、"落盘声脆"、"品控稳定"等多维度评价维度。
这种将所有业务数据集中在一个@Observed类中的设计，带来了一个重要的架构优势：单一数据源原则（Single Source of Truth）。无论哪个子组件需要访问棋子列表、棋枰数据还是订单信息，它们都通过@ObjectLink引用同一个XiangqiData实例。当任何一个数据发生变化（比如新增了一枚棋子、删除了一张棋枰），所有引用该数据的组件都会自动收到通知并刷新UI，无需手动编写繁琐的事件监听和数据同步逻辑。
八、颜色工具函数：纯函数的设计哲学
function getRoleColor(role: string): string {
if (role === '车') {
return '#B3362E';
} else if (role === '马') {
return '#3A322C';
} else if (role === '炮') {
return '#C9A24B';
}
return '#6E8B5E';
}
function getBoardColor(level: number): string {
if (level >= 95) {
return '#B3362E';
} else if (level >= 92) {
return '#3A322C';
}
return '#C9A24B';
}
function getPieceColor(price: number): string {
if (price >= 200) {
return '#9E2E20';
} else if (price >= 120) {
return '#B3362E';
} else if (price >= 80) {
return '#3A322C';
}
return '#6E8B5E';
}
function getOrderColor(amount: number): string {
if (amount >= 150000) {
return '#9E2E20';
} else if (amount >= 110000) {
return '#B3362E';
} else if (amount >= 80000) {
return '#3A322C';
}
return '#6E8B5E';
}
function getReviewTagColor(tag: string): string {
if (tag === '字口深峻' || tag === '落盘声脆' || tag === '上镜高级' || tag === '成打卡点') {
return '#B3362E';
} else if (tag === '走子顺滑' || tag === '品控稳定' || tag === '越用越趁手') {
return '#3A322C';
} else if (tag === '配色雅正' || tag === '衬托茶台' || tag === '轻便易携') {
return '#6E8B5E';
} else if (tag === '包装考究' || tag === '印刷清晰') {
return '#C9A24B';
}
return '#9E2E20';
}
这五个函数构成了应用的颜色映射层，它们都是纯函数（Pure Function）——相同的输入永远产生相同的输出，没有任何副作用。这种函数式的设计哲学在ArkTS开发中具有多重价值：
第一，可测试性极强。每个函数都可以独立编写单元测试，传入已知输入、断言输出颜色，无需mock任何组件或状态。
第二，逻辑集中且可复用。颜色映射规则分散在多个组件中是维护噩梦——如果要调整"高价棋子"的阈值从200改为220，需要在每个使用处逐一修改。而现在只需改getPieceColor一处。
第三，语义化表达业务规则。函数名本身就是最好的文档——getPieceColor(price)一眼就能看出是根据价格返回棋子卡片的主题色；getReviewTagColor(tag)则是根据评价标签返回标签颜色。
特别值得分析的是getPieceColor的阶梯式阈值设计：价格≥200返回暗红（danger色，暗示"珍藏级"），120-199返回棋枰红，80-119返回乌木黑，<80返回青绿（success色，暗示"入门之选"）。这种将业务语义（价格区间）映射到视觉语义（颜色情感）的模式，是数据可视化中的经典手法。
getBoardColor同样采用了阶梯式阈值：level≥95为棋红（顶级材质，如紫檀、金丝楠、乌木），92-94为乌木黑（优良材质），<92为金徽色（常规材质）。这种颜色编码让用户一眼就能区分棋枰的品质等级。
getReviewTagColor则展示了标签分组染色的策略：将12个评价标签按语义聚为四组——工艺/质感组（字口深峻、落盘声脆、上镜高级、成打卡点）用棋红；手感/耐用组（走子顺滑、品控稳定、越用越趁手）用乌木黑；视觉/搭配组（配色雅正、衬托茶台、轻便易携）用青绿；包装/印刷组（包装考究、印刷清晰）用金徽色。这种分组不仅美观，还隐含了评价维度的分类逻辑。
九、主入口组件：应用骨架与路由管理
9.1 状态声明
@Entry
@Component
struct XiangqiApp {
@State curTab: number = 0;
@State data: XiangqiData = new XiangqiData();
@State showAddPiece: boolean = false;
@State showEditOrder: boolean = false;
@State showDeleteBoard: boolean = false;
@State showDetailManual: boolean = false;
@State delBoardName: string = '';
@State detailManualName: string = '';
@State knightRotate: boolean = false;
@State kingFloat: boolean = false;
XiangqiApp是整个应用的根组件，由@Entry装饰器标记为应用入口，由@Component标记为可复用组件。它声明了11个@State状态变量，可以分为三类：
路由与数据状态（2个）：
curTab：当前选中的Tab索引（0-4），控制底部导航栏的高亮和内容区的切换。data：XiangqiData实例，作为全局唯一的数据源传递给所有子组件。
弹窗显隐状态（4个布尔值 + 2个字符串）：
showAddPiece/showEditOrder/showDeleteBoard/showDetailManual：分别控制四种弹窗的显示/隐藏。delBoardName/detailManualName：传递给删除确认弹窗和详情弹窗的上下文参数（要删除的棋枰名、要查看详情的棋谱名）。
动画交互状态（2个布尔值）：
knightRotate：控制头部马图标的旋转动画（点击切换180°旋转）。kingFloat：控制头部帅/将图标的位移动画（点击切换平移）。
这种细粒度的状态拆分，使得每个UI交互都有独立的状态变量驱动，互不干扰。当需要添加新的弹窗或交互效果时，只需新增一个@State变量即可，不会影响现有逻辑。
9.2 构建方法与页面结构
build()方法是ArkTS声明式UI的核心——它描述了"UI应该长什么样"，框架负责在状态变化时高效地 diff 和更新真实DOM。XiangqiApp的build()方法构建了以下三层结构：
第一层：主内容区（外层Column）。包含两个子区域：
- 顶部Header区域：乌木黑（
primaryDark）背景，包含应用标题"♟️ 象棋坊"、英文副标题"Xiangqi · 楚河汉界 方寸争锋"、右侧操作图标区（马旋转、帅/将浮动、麻将图标），以及下方的12个棋位点缀点（用三种尺寸和颜色的圆形模拟棋枰上的星位或楚河汉界标记）。 - 内容切换区：根据
curTab的值，使用if-else if-else链条件渲染对应的内容组件（PieceContent/BoardContent/ManualContent/XiangqiOrderContent/XiangqiReviewContent）。
第二层：底部导航栏（固定在底部）。使用ForEach遍历TAB_LIST数组渲染5个Tab项，每个Tab项根据是否为当前选中项来决定：文字颜色（主题色 vs 提示色）、字重（Bold vs Normal）、背景色（半透明主题色 vs 透明）、边框（有 vs 无）。点击时更新curTab状态触发切换。
第三层：弹窗叠加层。四个if条件分别控制四种弹窗的渲染，弹窗以绝对定位的方式覆盖在主内容区上方。
9.3 弹窗的条件渲染
if (this.showAddPiece) {
AddPieceModal({
onClose: () => {
this.showAddPiece = false;
}
})
}
if (this.showEditOrder) {
EditXiangqiOrderModal({
onClose: () => {
this.showEditOrder = false;
}
})
}
if (this.showDeleteBoard) {
DeleteBoardModal({
title: this.delBoardName, onClose: () => {
this.showDeleteBoard = false;
}
})
}
if (this.showDetailManual) {
DetailManualModal({
name: this.detailManualName, onClose: () => {
this.showDetailManual = false;
}
})
}
弹窗的渲染采用了条件渲染 + 回调关闭的模式。每个弹窗组件接收一个onClose回调函数，当用户点击弹窗内的"取消"/"确认"/"知道了"等按钮时，调用onClose()将对应的showXxx状态设为false，从而触发弹窗从DOM中移除。
DeleteBoardModal和DetailManualModal额外接收了title/name属性，用于在弹窗内显示具体的操作对象（要删除哪张棋枰、查看哪部棋谱的详情）。这种"状态提升"（Lifting State Up）的模式——将弹窗所需的上下文数据存储在父组件的状态中、通过props传递给弹窗——是React/ArkTS中处理跨组件数据流的经典方案。
十、内容组件体系：@ObjectLink与数据双向绑定
10.1 标签组件 XiangqiTag
@Component
struct XiangqiTag {
@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' })
}
}
XiangqiTag是一个极简但精心设计的标签组件，仅接收两个@Prop属性：text（标签文字）和color（主题色）。它的设计精髓在于颜色透明度的十六进制拼接技巧：
- 背景色使用
this.color + '14'，即在原色hex后面追加14（即8%不透明度的alpha通道），生成类似#B3362E14的8位颜色值。ArkTS原生支持这种8位hex颜色格式，前6位是RGB，后2位是Alpha（00=完全透明，FF=完全不透明）。 - 边框色使用
this.color + '40'（25%不透明度），比背景更明显但不抢眼。
这种"同色系多层透明度叠加"的技法，使得标签在任何背景下都能保持和谐的视觉效果——背景色淡淡的（8%）提供区域感，边框稍深（25%）勾勒轮廓，文字用原色（100%）保证可读性。三者来自同一个color变量，天然协调，永远不会出现"背景是蓝色但文字是红色"的色彩冲突。
10.2 棋子内容组件 PieceContent
@Component
struct PieceContent {
@ObjectLink data: XiangqiData;
onAdd: () => void = () => {};
build() {
Scroll() {
Column() {
// 销量图表卡片
Column() { /* ... */ }
// 棋子名品列表
ForEach(this.data.pieces, (p: PieceItem, i: number) => {
Row() { /* 卡片内容 */ }
}, (p: PieceItem, i: number) => 'pc' + p.name + i)
}
}
.scrollable(ScrollDirection.Vertical)
.scrollBar(BarState.Off)
}
}
PieceContent是棋子Tab页的主体内容组件。它使用了@ObjectLink装饰器来接收父组件传递的XiangqiData实例。@ObjectLink与@Prop的关键区别在于：@ObjectLink建立的是引用关系，而非值的拷贝——当XiangqiData实例的属性（如pieces数组）发生变化时，PieceContent中引用这些属性的部分会自动刷新。这使得数据在父子组件间实现了"双向绑定"的效果。
组件内部由两大部分组成：
第一部分：本周销量图表卡片。顶部有一排装饰性的楚河汉界星位点缀（模拟棋枰上的标记点），下方是标题"📈 本周棋子销量"和副标题"周六95副"。柱状图使用ForEach遍历WEEK_SOLD数据，每根柱子的高度由value决定，颜色由阈值判断决定（≥84用棋枰红，否则用金徽色）。柱子使用borderRadius(8)实现圆角，底部对齐（alignItems(VerticalAlign.Bottom)）模拟真实柱状图的基线对齐效果。
第二部分：棋子名品列表。使用ForEach遍历this.data.pieces数组，每张卡片是一个Row横向布局，包含三个区域：
- 左侧图标区（宽60）：圆形头像区显示emoji，下方有"楚""汉"小字标识阵营。整体背景色由
getPieceColor(p.price)决定并附加极低透明度（0D=5%），边框用33%透明度。 - 中间信息区（
layoutWeight(1)占据剩余空间）：第一行是棋子名（粗体）+ 价格（带颜色），第二行是兵种标签（XiangqiTag）+ 阵营标签（XiangqiTag）+ "阴沉木制"材质提示文字。 - 卡片背景色使用
i % 2 === 0实现斑马纹交替（白色/浅米），增强列表的可读性。
10.3 其他内容组件
BoardContent（棋枰库）：结构与PieceContent类似，但顶部图表替换为"棋子销量TOP6"水平条形图（使用XIANGQI_TOP数据和layoutWeight实现比例条），列表项改为棋枰卡片——左侧显示emoji+品质圆点+金徽点缀，中间显示棋枰名+路数，下方显示"木性"进度条（同样用layoutWeight(c.level)实现比例填充）。右侧有删除图标，点击触发onDel回调。
ManualContent（棋谱藏书）：顶部图表为"棋谱热度"水平条形图（MANUAL_HOT数据），列表项为棋谱卡片——显示棋谱名+谱数+流派+研习度，右侧有详情图标。
XiangqiOrderContent（订单台账）：顶部图表为"兵种构成占比"水平条形图（ROLE_SHARE数据），列表项为订单卡片——显示客户emoji+名称+区域+数量+金额（金额颜色由getOrderColor决定），右侧有编辑图标。
XiangqiReviewContent（客评口碑）：无顶部图表，直接是评价列表。每条评价显示用户emoji+姓名+日期+星级（用⭐.repeat(score)重复渲染）+ 标签（XiangqiTag）+ 评价正文。星级使用repeat()方法根据score值动态生成对应数量的星星字符，简洁而巧妙。
十一、弹窗组件体系：自定义模态对话框
应用包含四个自定义弹窗组件，它们共享一致的结构模式但各有不同的内容和用途：
11.1 新增棋子弹窗 AddPieceModal
弹窗采用全屏遮罩 + 居中卡片的经典模态布局：
- 外层Column：
width('100%') height('100%')，背景色#66000000（40%黑色半透明遮罩），justifyContent(FlexAlign.Center)使内容居中。 - 内层卡片：宽度86%、最大高度78%、圆角18px、白色背景、16px内边距。
- 标题栏："♟️ 定制棋子" + 右侧"✕"关闭按钮，两端对齐。
- 内容区：三行信息展示（字名、兵种、预算），每行使用
cardAlt背景色+圆角的统一样式。 - 操作栏：左"取消"（描边按钮）+ 右"确认定制"（实心主色按钮），右对齐。
11.2 其他弹窗组件
- EditXiangqiOrderModal（修改订单）：结构与AddPieceModal完全对称，内容改为客户/数量/金额三行信息，确认按钮文案为"保存修改"。
- DeleteBoardModal（删除确认）：接收
title属性显示要删除的棋枰名，内容为确认提示文字（"确定撤下「xxx」吗？"），确认按钮使用危险色（danger= 暗红）以警示操作的不可逆性。 - DetailManualModal（棋谱详情）：接收
name属性，内容包含大号emoji+棋谱名展示区、棋谱文化介绍文字、谱式信息和校勘评级，单按钮"知道了"关闭。
四个弹窗的一致性设计（相同的外层遮罩、卡片尺寸、圆角、内边距、标题栏布局）确保了用户在使用不同功能时获得统一的交互体验。差异仅在内容区和按钮文案/颜色上体现各自的功能特性。
十二、关键技术点深度解析
12.1 layoutWeight布局权重的妙用
layoutWeight是ArkTS弹性布局中最强大的属性之一。在本应用中被广泛用于两类场景：
水平条形图：在XIANGQI_TOP、MANUAL_HOT、ROLE_SHARE的渲染中，每行的彩色条使用layoutWeight(dataValue)设置宽度权重，后面的灰色占位条使用layoutWeight(maxValue - dataValue)补足剩余空间。两者之和等于最大值（100或20），从而精确实现按比例分配宽度的效果——无需手动计算像素值，框架自动处理。
列表卡片内部布局：棋子卡片、棋枰卡片等信息区的中间列使用layoutWeight(1)占据所有剩余空间，左右固定宽度的图标区和操作区保持不变。这种"两头固定、中间弹性"的布局模式在移动端UI中极为常见。
12.2 颜色透明度的十六进制拼接
本应用大量使用了hex颜色 + 两位alpha的8位颜色格式，例如：
COLORS.accentLight + '2E'→#C9A24B2E（约18%不透明度，用于按钮背景）COLORS.accentLight + '66'→#C9A24B66（约40%不透明度，用于分割线）COLORS.accent + '55'→#B3362E55（约33%不透明度，用于卡片边框）t.color + '14'→ 如#B3362E14（约8%不透明度，用于标签背景）
这种技法的优势在于：不需要预先定义几十个半透明色变量，而是根据运行时的主题色动态生成任意透明度的衍生色。只要知道基础色和目标透明度，字符串拼接一行搞定。需要注意的是，alpha值的范围是00（全透明）到FF（完全不透明），常用参考值：14≈8%，2E≈18%，40≈25%，55≈33%，66≈40%，80≈50%。
12.3 ForEach的键值生成策略
应用中所有的ForEach循环都精心设计了键值生成函数（key generator）：
// 棋子列表
(p: PieceItem, i: number) => 'pc' + p.name + i
// 棋枰列表
(c: BoardItem, i: number) => 'bd' + c.name + i
// 棋谱列表
(d: ManualItem, i: number) => 'mn' + d.name + i
// 订单列表
(o: XiangqiOrderItem, i: number) => 'od' + o.name + i
// 评价列表
(r: XiangqiReviewItem, i: number) => 'rv' + r.name + i
// Tab栏
(t: TabMeta) => t.key
// 图表数据
(w: WeekXiangqiMeta) => w.day
(t: XiangqiTopMeta) => t.name
(d: ManualHotMeta) => d.name
(s: RoleShareMeta) => s.name
每个键值都采用了**"前缀 + 唯一标识 + 索引"**的三段式命名：
- 前缀（
pc/bd/mn/od/rv）区分不同的ForEach作用域，避免跨列表键值冲突。 - 唯一标识（
p.name/c.name等）保证同一条数据始终映射到同一个键。 - 索引（
i）作为兜底，即使两条数据name相同（理论上不应发生但有防御价值），索引也能保证唯一性。
正确的键值策略对于ArkTS的ForEach性能至关重要——框架通过键值来判断哪些节点是"新增"、哪些是"移动"、哪些是"删除"，从而执行最小量的DOM操作。错误的键值（如使用Math.random()）会导致每次渲染都销毁重建所有节点，造成严重的性能问题。
12.4 @Observed/@ObjectLink响应式机制
本应用的响应式数据流遵循以下路径：
XiangqiData (@Observed 类)
↓ @ObjectLink 引用传递
PieceContent / BoardContent / ManualContent / XiangqiOrderContent / XiangqiReviewContent
↓ 组件内部读取属性
ForEach / Text / 等UI节点
当XiangqiData的某个数组属性发生变化（如pieces.push(newItem)），ArkTS框架的响应式系统会：
- 检测到
@Observed类实例的属性变更。 - 通知所有持有该实例
@ObjectLink引用的组件。 - 这些组件重新执行
build()方法。 - 框架diff新旧虚拟DOM树，只更新实际变化的部分。
这种机制比传统的"手动调用setState/refresh"模式更加声明式和自动化，开发者只需描述"数据是什么样子"，框架负责"如何高效地更新UI"。
12.5 条件渲染与状态驱动UI
应用的Tab切换和弹窗显示/隐藏完全由状态变量驱动，没有使用任何命令式的DOM操作（如appendChild/removeChild）：
- Tab切换：
if (this.curTab === XiangqiTab.PIECE)渲染PieceContent，否则渲染其他组件。curTab的变化由底部Tab栏的onClick事件触发。 - 弹窗显示：
if (this.showAddPiece)渲染AddPieceModal。showAddPiece由"➕铸子"按钮的onClick设为true，由弹窗内部的"取消"/"确认"按钮的onClick通过onClose回调设为false。
这种"状态即UI"（State is UI）的范式是现代前端框架的核心思想——UI是状态的纯函数，给定相同的状态必然产生相同的UI。这使得应用的行为完全可预测、可调试、可测试。
十三、技术要点对比表
| 技术维度 | 本应用实现方案 | 设计意图与优势 |
|---|---|---|
| 状态管理 | @State(11个) + @Observed类 + @ObjectLink引用 |
单一数据源 + 自动响应式更新，避免手动同步 |
| 组件通信 | Props单向数据流 + 回调函数(onClose/onAdd/onDel/onDetail/onEdit) | 父→子通过Props，子→父通过回调，清晰的单向数据流 |
| 路由方案 | if-else if-else条件渲染 + 枚举索引 |
适合Tab数量固定(5个)的场景，简单直接无额外依赖 |
| 弹窗模式 | 条件渲染 + 全屏遮罩 + 居中卡片 + 回调关闭 | 统一的模态交互规范，遮罩阻止背景交互 |
| 列表渲染 | ForEach + 三段式键值('prefix'+name+index) |
高效diff、防冲突、可预测的节点复用 |
| 布局策略 | layoutWeight弹性权重 + 固定像素结合 |
两头固定中间弹性的经典移动端布局 |
| 颜色系统 | 19色接口约束 + hex+alpha透明度拼接 | 编译期类型安全 + 运行时动态透明度 |
| 数据建模 | 5个业务接口 + 4个图表接口 + 纯函数颜色映射 | 类型安全 + 逻辑集中 + 可独立测试 |
| 动画交互 | .rotate() + .translate() + .animation() 声明式动画 |
状态驱动动画，无需手动管理动画生命周期 |
| 斑马纹列表 | i % 2 === 0 ? COLORS.cardBg : COLORS.cardAlt |
偶数行白色、奇数行浅米，增强列表可读性 |
| 业务语义映射 | 价格/等级/标签 → 颜色梯度的纯函数映射 | 用视觉语言直接表达业务等级与分类 |
| Header装饰 | XIANGQI_COL数组 + r%3模式渲染红黑星位 | 数据驱动装饰元素，强化主题辨识度 |
十四、总结与展望
14.1 架构设计总结
"象棋坊"应用虽然是一个单文件Demo，但其内部蕴含的架构思想值得认真总结：
分层清晰，职责分明。从顶部的类型定义层到底部的子组件层，每一层都有明确的单一职责。类型定义层管"契约"，常量实例层管"数据"，响应式类管"状态"，工具函数层管"逻辑"，入口组件管"路由"，子组件管"展示"。这种分层使得无论是添加新功能、修bug、还是做性能优化，都能快速定位到正确的层次。
接口先行，类型安全。所有数据结构都先定义接口，再实现具体数据。TypeScript编译器在编译阶段就能捕获大部分类型错误，大大降低了运行时出错的概率。19色调色板接口、5组业务实体接口、4组图表接口——合计超过10个接口定义，构筑了坚实的类型安全防线。
数据驱动，声明式渲染。UI完全由状态驱动，没有命令式的DOM操作。ForEach遍历数据数组生成列表，if条件根据状态渲染不同组件，@Observed/@ObjectLink自动追踪数据变化并刷新UI。这种范式让代码更接近"描述UI应该是什么样子"而非"如何一步步构建UI"。
14.2 技术亮点回顾
回顾全文，以下几个技术点尤其值得关注和借鉴：
- 19色红黑棋韵色彩体系：以"乌木黑·棋枰红·金徽"为核心的三色系设计，配合精细的透明度梯度（8%/18%/25%/33%/40%），在视觉上完美还原了象棋文化的庄重与雅致。接口约束 + 常量实例化的双层设计，兼顾了类型安全和运行效率。
@Observed+@ObjectLink的深度运用：将全部业务数据封装在一个可观察类中，通过@ObjectLink引用传递给5个子组件，实现了真正的"单一数据源 + 双向绑定"。任何数据变化都会自动级联刷新所有相关UI，无需手动编写事件监听。- 纯函数颜色映射层：5个无副作用的颜色映射函数，将业务规则（兵种、品质等级、价格区间、订单金额、评价标签等）映射到视觉语义（颜色情感）。逻辑集中、可测试、可复用。
layoutWeight驱动的数据可视化：不依赖任何图表库，仅用ArkTS内置的layoutWeight属性就实现了4种精美的条形图/柱状图。这种"零依赖"的数据可视化方案在轻量级应用中极具实用价值。- 统一的弹窗交互规范：4个弹窗共享相同的结构模板（遮罩+居中卡片+标题栏+内容区+操作栏），仅在内容和按钮细节上差异化。这种一致性设计大幅降低了用户的认知负荷。
- 楚河汉界星位装饰：顶部Header中的12个装饰点并非硬编码，而是使用
XIANGQI_COL数组通过r % 3模式动态渲染，红黑白三色交替，既点题又体现了"数据驱动装饰元素"的思路。
14.3 优化建议与展望
尽管本应用在架构和实现上已经相当成熟，但从工程实践的角度，仍有以下几点可以进一步优化：
第一，状态管理的精细化。当前11个@State变量全部集中在根组件中，随着功能增长可能导致"状态爆炸"。建议引入轻量级状态管理方案（如ArkTS的@Provide/@Consume或AppStorage），将弹窗状态下沉到各自的父组件中，根组件只保留全局路由状态。
第二，网络数据对接的准备。当前所有数据均为静态硬编码。XiangqiData类的数组属性已经为未来对接真实后端API留出了清晰的接口——只需将静态初始化改为异步fetch调用，UI层无需任何修改。这种"函数化的封装方式"体现了良好的架构前瞻性。
第三，组件的进一步拆分。当前每个内容组件（如PieceContent）内部同时包含了图表卡片和列表卡片两种UI形态。如果未来需要单独复用"周销量图表"或"棋子列表"，可以考虑将它们拆分为独立的子组件（WeeklySalesChart、PieceList），提升复用性。
第四，无障碍访问（Accessibility）的支持。当前组件未设置accessibilityText等无障碍属性。对于一款面向文化传播的应用，确保视障用户也能通过屏幕阅读器获取棋子与棋谱信息，是产品完善度的重要维度。
第五，国际化（i18n）的预留。虽然"象棋坊"面向中文用户，但如果未来需要推出多语言版本（如面向海外象棋爱好者的英文版），建议将所有硬编码的中文字符串提取到资源文件（string.json）中，通过$r()引用。当前的TAB_LIST、静态数据中的中文字符串都需要做相应改造。
第六，棋局互动的扩展。当前应用以展示和交易管理为主。若后续希望增加真正的对弈功能，可以考虑接入鸿蒙的Canvas或自定义绘制组件，实现棋盘绘制、走子规则校验、AI对战等更核心的象棋玩法。
总而言之，"象棋坊"应用以其精巧的红黑棋韵色彩体系、严谨的类型安全设计、高效的响应式数据流和优雅的组件化架构，为我们提供了一个学习鸿蒙ArkTS声明式UI开发的优秀范本。从"能写出能跑的代码"到"写出架构清晰、可维护、可扩展的代码"，这正是每一位鸿蒙开发者应当追求的成长路径。愿这篇深度解析能为你的进阶之路提供一份有价值的参考。
十五、附录：DevEco Studio 安装与环境搭建
为方便读者将本文分析的"象棋坊"代码真正跑起来，下面补充一份 DevEco Studio 的安装与环境配置简明教程（配图来源于官方文档）。
安装DevEco Studio程序
选择目标安装目录：
设置环境变量，设置完务必重启:
新建一个空白模板：
设置API为24的模板项目：
初始化项目，自动下载相关依赖：
完整代码
interface XiangqiPalette {
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;
ebonyBlack: string;
chessRed: string;
}
const COLORS: XiangqiPalette = {
primary: '#3A322C',
primaryLight: '#6E6258',
primaryDark: '#241E1A',
accent: '#B3362E',
accentLight: '#C9A24B',
bg: '#F2EDE0',
cardBg: '#FFFFFF',
cardAlt: '#EFE7D8',
textPrimary: '#2E2620',
textSecondary: '#756B5E',
textHint: '#A99F8E',
border: '#E0D7C4',
line: '#F0EBDD',
success: '#6E8B5E',
warning: '#C9A24B',
danger: '#9E2E20',
white: '#FFFFFF',
ebonyBlack: '#3A322C',
chessRed: '#B3362E'
};
enum XiangqiTab {
PIECE = 0,
BOARD = 1,
MANUAL = 2,
ORDER = 3,
REVIEW = 4
}
interface TabMeta {
key: string;
icon: string;
label: string;
color: string;
}
const TAB_LIST: TabMeta[] = [
{ key: 'piece', icon: '♟️', label: '棋子', color: '#B3362E' },
{ key: 'board', icon: '🪵', label: '棋枰', color: '#6E6258' },
{ key: 'manual', icon: '📜', label: '棋谱', color: '#C9A24B' },
{ key: 'order', icon: '📦', label: '订单', color: '#C9A24B' },
{ key: 'review', icon: '⭐', label: '客评', color: '#9E2E20' }
];
const XIANGQI_COL: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
interface PieceItem {
name: string;
role: string;
side: string;
price: number;
emoji: string;
}
interface BoardItem {
name: string;
wood: string;
level: number;
grid: string;
emoji: string;
}
interface ManualItem {
name: string;
style: string;
level: number;
step: string;
emoji: string;
}
interface XiangqiOrderItem {
name: string;
region: string;
count: number;
amount: number;
emoji: string;
}
interface XiangqiReviewItem {
name: string;
score: number;
date: string;
content: string;
tag: string;
emoji: string;
}
interface WeekXiangqiMeta {
day: string;
value: number;
}
interface RoleShareMeta {
name: string;
count: number;
color: string;
}
interface ManualHotMeta {
name: string;
heat: number;
color: string;
}
interface XiangqiTopMeta {
name: string;
sold: number;
color: string;
}
const WEEK_SOLD: WeekXiangqiMeta[] = [
{ day: '周一', value: 42 },
{ day: '周二', value: 55 },
{ day: '周三', value: 48 },
{ day: '周四', value: 66 },
{ day: '周五', value: 72 },
{ day: '周六', value: 95 },
{ day: '周日', value: 84 }
];
const ROLE_SHARE: RoleShareMeta[] = [
{ name: '车', count: 5, color: '#B3362E' },
{ name: '马', count: 4, color: '#3A322C' },
{ name: '炮', count: 3, color: '#C9A24B' },
{ name: '卒', count: 2, color: '#6E8B5E' }
];
const MANUAL_HOT: ManualHotMeta[] = [
{ name: '当头炮', heat: 97, color: '#B3362E' },
{ name: '屏风马', heat: 95, color: '#3A322C' },
{ name: '仙人指路', heat: 93, color: '#C9A24B' },
{ name: '飞相局', heat: 92, color: '#6E8B5E' },
{ name: '过宫炮', heat: 91, color: '#6E6258' },
{ name: '起马局', heat: 90, color: '#9E2E20' }
];
const XIANGQI_TOP: XiangqiTopMeta[] = [
{ name: '镇关将', sold: 98, color: '#B3362E' },
{ name: '千里马', sold: 93, color: '#3A322C' },
{ name: '霹雳车', sold: 90, color: '#C9A24B' },
{ name: '连环炮', sold: 86, color: '#6E8B5E' },
{ name: '巡城相', sold: 82, color: '#6E6258' },
{ name: '先锋卒', sold: 79, color: '#9E2E20' }
];
@Observed
export class XiangqiData {
pieces: PieceItem[] = [
{ name: '镇关将', role: '将', side: '红方', price: 288, emoji: '♔' },
{ name: '千里马', role: '马', side: '红方', price: 128, emoji: '🐎' },
{ name: '霹雳车', role: '车', side: '黑方', price: 138, emoji: '🏎️' },
{ name: '连环炮', role: '炮', side: '红方', price: 118, emoji: '💥' },
{ name: '护驾士', role: '士', side: '红方', price: 88, emoji: '🛡️' },
{ name: '巡城相', role: '相', side: '黑方', price: 88, emoji: '🏯' },
{ name: '先锋卒', role: '卒', side: '红方', price: 68, emoji: '🗡️' },
{ name: '赤兔马', role: '马', side: '黑方', price: 128, emoji: '🐴' },
{ name: '铁壁车', role: '车', side: '红方', price: 138, emoji: '🛡️' },
{ name: '飞石炮', role: '炮', side: '黑方', price: 118, emoji: '🪨' },
{ name: '坐帐帅', role: '帅', side: '黑方', price: 288, emoji: '♚' },
{ name: '披甲卒', role: '卒', side: '黑方', price: 68, emoji: '⛑️' }
];
boards: BoardItem[] = [
{ name: '檀木棋枰', wood: '紫檀', level: 96, grid: '九路', emoji: '🪵' },
{ name: '楠木棋枰', wood: '金丝楠', level: 95, grid: '九路', emoji: '🌲' },
{ name: '楸木棋枰', wood: '楸木', level: 94, grid: '九路', emoji: '🍂' },
{ name: '花梨棋枰', wood: '花梨', level: 93, grid: '九路', emoji: '🌸' },
{ name: '乌木棋枰', wood: '乌木', level: 95, grid: '九路', emoji: '⚫' },
{ name: '竹面棋枰', wood: '竹片', level: 92, grid: '七路', emoji: '🎋' },
{ name: '红木棋枰', wood: '红酸枝', level: 94, grid: '九路', emoji: '🔴' },
{ name: '枫木棋枰', wood: '枫木', level: 90, grid: '九路', emoji: '🍁' },
{ name: '榆木棋枰', wood: '榆木', level: 91, grid: '九路', emoji: '🌳' },
{ name: '枣木棋枰', wood: '枣木', level: 92, grid: '七路', emoji: '🟤' },
{ name: '松木棋枰', wood: '松木', level: 89, grid: '七路', emoji: '🌲' },
{ name: '杉木棋枰', wood: '杉木', level: 90, grid: '九路', emoji: '🪵' }
];
manuals: ManualItem[] = [
{ name: '橘中秘', style: '当头炮', level: 96, step: '36谱', emoji: '📜' },
{ name: '梅花谱', style: '屏风马', level: 95, step: '42谱', emoji: '🌺' },
{ name: '适情雅趣', style: '残局', level: 94, step: '50谱', emoji: '🏛️' },
{ name: '竹香斋', style: '排局', level: 93, step: '28谱', emoji: '🎋' },
{ name: '百局象棋谱', style: '全局', level: 95, step: '40谱', emoji: '📚' },
{ name: '自出洞来无敌手', style: '快攻', level: 94, step: '30谱', emoji: '⚔️' },
{ name: '烂柯神机', style: '残局', level: 92, step: '26谱', emoji: '🪓' },
{ name: '心武残编', style: '排局', level: 93, step: '32谱', emoji: '🧠' },
{ name: '象棋指要', style: '中局', level: 91, step: '24谱', emoji: '👆' },
{ name: '布局新变', style: '开局', level: 92, step: '38谱', emoji: '🌟' },
{ name: '残局攻守', style: '残局', level: 90, step: '22谱', emoji: '🛡️' },
{ name: '棋经论', style: '总纲', level: 89, step: '16谱', emoji: '📖' }
];
orders: XiangqiOrderItem[] = [
{ name: '棋院联盟', region: '华东', count: 2000, amount: 180000, emoji: '🏛️' },
{ name: '社区棋社', region: '华北', count: 1500, amount: 120000, emoji: '🏘️' },
{ name: '文创买手店', region: '华南', count: 1800, amount: 144000, emoji: '🎁' },
{ name: '文旅街区', region: '西南', count: 1200, amount: 96000, emoji: '🏞️' },
{ name: '学校棋课', region: '华中', count: 1600, amount: 128000, emoji: '🎒' },
{ name: '海外棋会', region: '海外', count: 800, amount: 96000, emoji: '🌏' },
{ name: '茶楼连锁', region: '华东', count: 1400, amount: 112000, emoji: '🍵' },
{ name: '老年活动中心', region: '华北', count: 1000, amount: 80000, emoji: '🧓' },
{ name: '直播带货团', region: '华南', count: 2200, amount: 176000, emoji: '📺' },
{ name: '棋类赛事组', region: '华中', count: 900, amount: 108000, emoji: '🏆' },
{ name: '景区棋亭', region: '西南', count: 1100, amount: 77000, emoji: '⛩️' },
{ name: '私人定制', region: '华东', count: 300, amount: 90000, emoji: '💎' }
];
reviews: XiangqiReviewItem[] = [
{ 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: 5, date: '08-26', content: '上播即爆单，棋枰木纹清晰，镜头质感高级。', tag: '上镜高级', emoji: '📺' },
{ name: '赛事裁判', score: 4, 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 getRoleColor(role: string): string {
if (role === '车') {
return '#B3362E';
} else if (role === '马') {
return '#3A322C';
} else if (role === '炮') {
return '#C9A24B';
}
return '#6E8B5E';
}
function getBoardColor(level: number): string {
if (level >= 95) {
return '#B3362E';
} else if (level >= 92) {
return '#3A322C';
}
return '#C9A24B';
}
function getPieceColor(price: number): string {
if (price >= 200) {
return '#9E2E20';
} else if (price >= 120) {
return '#B3362E';
} else if (price >= 80) {
return '#3A322C';
}
return '#6E8B5E';
}
function getOrderColor(amount: number): string {
if (amount >= 150000) {
return '#9E2E20';
} else if (amount >= 110000) {
return '#B3362E';
} else if (amount >= 80000) {
return '#3A322C';
}
return '#6E8B5E';
}
function getReviewTagColor(tag: string): string {
if (tag === '字口深峻' || tag === '落盘声脆' || tag === '上镜高级' || tag === '成打卡点') {
return '#B3362E';
} else if (tag === '走子顺滑' || tag === '品控稳定' || tag === '越用越趁手') {
return '#3A322C';
} else if (tag === '配色雅正' || tag === '衬托茶台' || tag === '轻便易携') {
return '#6E8B5E';
} else if (tag === '包装考究' || tag === '印刷清晰') {
return '#C9A24B';
}
return '#9E2E20';
}
@Entry
@Component
struct XiangqiApp {
@State curTab: number = 0;
@State data: XiangqiData = new XiangqiData();
@State showAddPiece: boolean = false;
@State showEditOrder: boolean = false;
@State showDeleteBoard: boolean = false;
@State showDetailManual: boolean = false;
@State delBoardName: string = '';
@State detailManualName: string = '';
@State knightRotate: boolean = false;
@State kingFloat: 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('Xiangqi · 楚河汉界 方寸争锋')
.fontSize(10)
.fontColor(COLORS.accentLight)
.margin({ top: 3 })
}
.alignItems(HorizontalAlign.Start)
.layoutWeight(1)
Row() {
Text('♞')
.fontSize(20)
.onClick(() => {
this.knightRotate = !this.knightRotate;
})
.rotate({ angle: this.knightRotate ? 180 : 0 })
.animation({ duration: 700, curve: Curve.EaseOut })
Text('♔')
.fontSize(16)
.margin({ left: 10 })
.onClick(() => {
this.kingFloat = !this.kingFloat;
})
.translate({ x: this.kingFloat ? 14 : -8, y: this.kingFloat ? -8 : 0 })
.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(XIANGQI_COL, (r: number) => {
Row() {
if (r % 3 === 0) {
Column()
.width(12)
.height(12)
.backgroundColor(COLORS.chessRed)
.borderRadius(6)
.border({ width: 2, color: COLORS.white })
} else if (r % 3 === 1) {
Column()
.width(12)
.height(12)
.backgroundColor(COLORS.ebonyBlack)
.borderRadius(6)
.border({ width: 2, color: COLORS.accentLight })
} else {
Column()
.width(4)
.height(4)
.backgroundColor(COLORS.white)
.borderRadius(2)
}
}
.width(14)
.justifyContent(FlexAlign.Center)
}, (r: number) => 'xiangqi' + 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 === XiangqiTab.PIECE) {
PieceContent({ data: this.data, onAdd: () => {
this.showAddPiece = true;
} })
} else if (this.curTab === XiangqiTab.BOARD) {
BoardContent({ data: this.data, onDel: (n: string) => {
this.delBoardName = n;
this.showDeleteBoard = true;
} })
} else if (this.curTab === XiangqiTab.MANUAL) {
ManualContent({ data: this.data, onDetail: (n: string) => {
this.detailManualName = n;
this.showDetailManual = true;
} })
} else if (this.curTab === XiangqiTab.ORDER) {
XiangqiOrderContent({ data: this.data, onEdit: () => {
this.showEditOrder = true;
} })
} else {
XiangqiReviewContent({ data: this.data })
}
}
.width('100%')
.height('100%')
Column() {
Column()
.width('100%')
.height(3)
.backgroundColor(COLORS.accent)
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(6)
.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.showAddPiece) {
AddPieceModal({
onClose: () => {
this.showAddPiece = false;
}
})
}
if (this.showEditOrder) {
EditXiangqiOrderModal({
onClose: () => {
this.showEditOrder = false;
}
})
}
if (this.showDeleteBoard) {
DeleteBoardModal({
title: this.delBoardName, onClose: () => {
this.showDeleteBoard = false;
}
})
}
if (this.showDetailManual) {
DetailManualModal({
name: this.detailManualName, onClose: () => {
this.showDetailManual = false;
}
})
}
}
}
}
@Component
struct XiangqiTag {
@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 PieceContent {
@ObjectLink data: XiangqiData;
onAdd: () => void = () => {};
build() {
Scroll() {
Column() {
Column() {
Row() {
Column()
.width(12)
.height(12)
.backgroundColor(COLORS.chessRed)
.borderRadius(6)
.border({ width: 2, color: COLORS.white })
Column()
.layoutWeight(1)
.height(2)
.backgroundColor(COLORS.accent + '55')
.margin({ left: 4, right: 4 })
Column()
.width(12)
.height(12)
.backgroundColor(COLORS.ebonyBlack)
.borderRadius(6)
.border({ width: 2, color: COLORS.accentLight })
.margin({ right: 4 })
Column()
.width(4)
.height(4)
.backgroundColor(COLORS.accentLight)
.borderRadius(2)
.margin({ right: 4 })
Column()
.width(12)
.height(12)
.backgroundColor(COLORS.chessRed)
.borderRadius(6)
.border({ width: 2, color: COLORS.white })
Column()
.layoutWeight(1)
.height(2)
.backgroundColor(COLORS.accent + '55')
.margin({ left: 4, right: 4 })
Column()
.width(12)
.height(12)
.backgroundColor(COLORS.ebonyBlack)
.borderRadius(6)
.border({ width: 2, color: COLORS.accentLight })
}
.width('100%')
.margin({ bottom: 10 })
Row() {
Text('📈 本周棋子销量')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('周六95副')
.fontSize(9)
.fontColor(COLORS.primary)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Row() {
ForEach(WEEK_SOLD, (w: WeekXiangqiMeta) => {
Column() {
Text(w.value + '')
.fontSize(8)
.fontColor(w.value >= 84 ? COLORS.accent : COLORS.accentLight)
Column()
.width(16)
.height(w.value)
.backgroundColor(w.value >= 84 ? COLORS.accent : COLORS.accentLight)
.borderRadius(8)
.margin({ top: 4 })
Text(w.day)
.fontSize(9)
.fontColor(COLORS.textSecondary)
.margin({ top: 4 })
}
.layoutWeight(1)
.alignItems(HorizontalAlign.Center)
}, (w: WeekXiangqiMeta) => 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.accent + '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.pieces, (p: PieceItem, i: number) => {
Row() {
Column() {
Column() {
Text(p.emoji)
.fontSize(18)
.textAlign(TextAlign.Center)
}
.width(44)
.height(44)
.justifyContent(FlexAlign.Center)
.alignItems(HorizontalAlign.Center)
.backgroundColor(getPieceColor(p.price) + '14')
.borderRadius(22)
.border({ width: 1, color: getPieceColor(p.price) + '66' })
Row() {
Text('楚')
.fontSize(8)
.fontColor(COLORS.chessRed)
Text('汉')
.fontSize(8)
.fontColor(COLORS.ebonyBlack)
.margin({ left: 4 })
}
.width(30)
.justifyContent(FlexAlign.Center)
.margin({ top: 5 })
}
.width(60)
.padding({ top: 10, bottom: 6 })
.backgroundColor(getPieceColor(p.price) + '0D')
.borderRadius(22)
.border({ width: 1, color: getPieceColor(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(getPieceColor(p.price))
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Row() {
XiangqiTag({ text: p.role + '字', color: getRoleColor(p.role) })
XiangqiTag({ text: p.side, 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: PieceItem, i: number) => 'pc' + 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 BoardContent {
@ObjectLink data: XiangqiData;
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(XIANGQI_TOP, (t: XiangqiTopMeta) => {
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: XiangqiTopMeta) => t.name)
}
.width('100%')
.padding(14)
.backgroundColor(COLORS.cardBg)
.borderRadius(20)
.border({ width: 1, color: COLORS.accent + '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.boards, (c: BoardItem, i: number) => {
Row() {
Column() {
Text(c.emoji)
.fontSize(18)
.textAlign(TextAlign.Center)
Row() {
Column()
.width(10)
.height(10)
.backgroundColor(getBoardColor(c.level))
.borderRadius(5)
.border({ width: 2, color: COLORS.white })
Column()
.width(8)
.height(8)
.backgroundColor(COLORS.accentLight)
.borderRadius(4)
.margin({ left: 4 })
}
.width(28)
.justifyContent(FlexAlign.Center)
.margin({ top: 5 })
}
.width(56)
.padding({ top: 10, bottom: 6 })
.backgroundColor(getBoardColor(c.level) + '0D')
.borderRadius(16)
.border({ width: 1, color: getBoardColor(c.level) + '33' })
Column() {
Row() {
Text(c.name)
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text(c.grid + '格')
.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(getBoardColor(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: BoardItem, i: number) => 'bd' + 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 ManualContent {
@ObjectLink data: XiangqiData;
onDetail: (n: string) => void = () => {};
build() {
Scroll() {
Column() {
Column() {
Row() {
Text('🔥 棋谱热度')
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text('当头炮97')
.fontSize(9)
.fontColor(COLORS.accent)
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
.margin({ bottom: 10 })
ForEach(MANUAL_HOT, (d: ManualHotMeta) => {
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: ManualHotMeta) => d.name)
}
.width('100%')
.padding(14)
.backgroundColor(COLORS.cardBg)
.borderRadius(20)
.border({ width: 1, color: COLORS.accent + '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.manuals, (d: ManualItem, i: number) => {
Row() {
Column() {
Text(d.emoji)
.fontSize(18)
.textAlign(TextAlign.Center)
Column()
.width(14)
.height(14)
.backgroundColor(getBoardColor(d.level))
.borderRadius(7)
.border({ width: 2, color: COLORS.accentLight })
.margin({ top: 5 })
}
.width(56)
.padding({ top: 10, bottom: 6 })
.backgroundColor(getBoardColor(d.level) + '0D')
.borderRadius(16)
.border({ width: 1, color: getBoardColor(d.level) + '33' })
Column() {
Row() {
Text(d.name)
.fontSize(13)
.fontWeight(FontWeight.Bold)
.fontColor(COLORS.textPrimary)
Text(d.step)
.fontSize(9)
.fontColor(getBoardColor(d.level))
.margin({ left: 8 })
}
.width('100%')
.justifyContent(FlexAlign.SpaceBetween)
Row() {
XiangqiTag({ text: d.style, 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: ManualItem, i: number) => 'mn' + 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 XiangqiOrderContent {
@ObjectLink data: XiangqiData;
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(ROLE_SHARE, (s: RoleShareMeta) => {
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: RoleShareMeta) => s.name)
}
.width('100%')
.padding(14)
.backgroundColor(COLORS.cardBg)
.borderRadius(20)
.border({ width: 1, color: COLORS.accent + '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: XiangqiOrderItem, 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: XiangqiOrderItem, 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 XiangqiReviewContent {
@ObjectLink data: XiangqiData;
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: XiangqiReviewItem, 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)
XiangqiTag({ 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: XiangqiReviewItem, i: number) => 'rv' + r.name + i)
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
}
.width('100%')
.constraintSize({ maxHeight: '100%' })
.scrollable(ScrollDirection.Vertical)
.scrollBar(BarState.Off)
}
}
@Component
struct AddPieceModal {
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('¥288')
.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.accent)
.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 EditXiangqiOrderModal {
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('2000 → 2200 副')
.fontSize(11)
.fontColor(COLORS.accent)
}
.width('100%')
.padding(10)
.backgroundColor(COLORS.cardAlt)
.borderRadius(10)
.margin({ top: 8 })
Row() {
Text('金额')
.fontSize(11)
.fontColor(COLORS.textSecondary)
.width(56)
Text('¥198000')
.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.accent)
.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 DeleteBoardModal {
@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 DetailManualModal {
@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('当头炮 · 36谱')
.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.accent)
}
.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.accent)
.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开发者与企业提供一个覆盖软硬件全栈、一站式门户。
更多推荐
5
0- 0
已为社区贡献7条内容
所有评论(0)