前言
聚焦开源鸿蒙Flutter开发的高频差异化场景，以「轻量精准」为核心，打造5类实用组件，每类组件聚焦专属需求，代码精简无冗余，适配鸿蒙多设备显示与交互习惯，无需复杂拓展，复制即可嵌入项目，高效提升开发效率。聚焦开源鸿蒙 Flutter 开发的高频差异化场景，以「轻量精准」为核心，打造5类实用组件，每类组件聚焦专属需求，代码精简无冗余，适配鸿蒙多设备显示与交互习惯，无需复杂拓展，复制即可嵌入项目，高效提升开发效率。所有组件均经过多机型适配测试，覆盖鸿蒙手机、平板、智慧屏等主流设备，兼顾不同屏幕尺寸与分辨率适配，进一步降低跨设备开发成本。
一、布局组件：鸿蒙均分横向容器
核心需求
实现子组件横向均分排列，自动分配屏幕空间，适配功能按钮组、导航栏等场景，无需手动调整间距与宽度。
核心亮点
- 自动均分：子组件平均分配横向空间，适配不同屏幕宽度；
- 居中对齐：内置居中逻辑，避免组件偏移，视觉协调；
-
灵活拓展：支持任意子组件组合，适配多类横向布局场景;
-
间距可控：新增可选间距参数，可根据业务需求灵活调整子组件间留白，适配更精细的布局设计。
同时在该组件用法示例后补充参数说明：
// 用法示例:
// HarmonyEqualRow(
// children: Text("功能1"), Text("功能2"), Text("功能3"),
// spacing: 8, // 可选参数，控制子组件间横向间距，默认无额外间距
// )
二、交互组件：鸿蒙长按反馈卡片
核心需求
实现带长按反馈的卡片组件，适配需要长按操作的场景（如删除、编辑），贴合鸿蒙交互反馈逻辑，样式简约统一。
核心亮点
- 长按反馈：精准响应长按操作，满足特殊交互需求；
- 风格适配：鸿蒙简约卡片样式，贴合系统视觉；
-
复用性强：嵌套任意子组件即可，适配多类业务场景;
-
反馈增强：新增轻微缩放动画，长按触发时卡片轻微收缩，视觉反馈更清晰，提升交互体验的细腻度。
三、数据展示：鸿蒙数字统计组件
核心需求
快速实现数字统计展示，搭配标题与单位，适配数据统计、数值展示等场景，样式规范统一，提升数据可读性。
核心亮点
- 结构清晰：标题+数字+单位分层展示，数据直观；
- 灵活适配：支持可选单位，适配不同类型数值统计；
-
样式统一：规范字体大小与配色，提升页面整洁度;
-
样式可定制：支持自定义标题、数字的颜色与字体大小，可根据页面主题灵活调整，适配多样化视觉需求。
同时在该组件用法示例后补充定制化用法：
// 定制化用法示例:
// HarmonyNumberStat(
// title:"今日订单",
// number:"128",
// unit:"单",
// titleColor: Colors.blue600,
// numberColor: Colors.black87,
// numberFontSize: 22
// )
四、基础控件：鸿蒙渐变背景容器
核心需求
实现带渐变背景的容器，适配页面头部、重点区域装饰等场景，贴合鸿蒙精致视觉风格，无需复杂样式配置。
核心亮点
- 渐变美观：采用鸿蒙柔和渐变配色，视觉舒适；
- 用法极简：嵌套子组件即可实现渐变背景，无需额外配置；
-
场景适配：适配重点区域装饰，提升页面质感。
-
渐变可自定义：支持传入自定义渐变颜色组与渐变方向，打破固定渐变样式限制，适配更多个性化装饰场景。
同时在该组件用法示例后补充自定义渐变用法：
// 自定义渐变用法示例:
// HarmonyGradientBox(
// gradientColors: Color(0xFFD4FC79), Color(0xFF96E6A1),
// begin: Alignment.topCenter,
// end: Alignment.bottomCenter,
// child: Padding(
// padding: EdgeInsets.all(20),
// child: Text("自定义渐变区域")
// )
// )
五、状态组件：鸿蒙加载中提示
核心需求
快速实现加载中状态展示，适配数据请求、页面加载等场景，带加载动画，提升用户等待体验，贴合鸿蒙设计风格。
核心亮点
- 动画直观：自带加载动画，清晰反馈加载状态；
- 风格统一：鸿蒙主题色搭配，视觉贴合系统；
- 即用即走：无需额外逻辑，直接调用即可实现加载提示。
六、核心开发思路
- 场景精准定位：每个组件聚焦专属高频场景，避免功能冗余，提升适配精准度；
- 贴合鸿蒙特性：从视觉样式到交互逻辑，全方位适配鸿蒙生态，还原原生体验；
- 精简调用成本：核心参数配置，无需复杂拓展，新手也能快速上手复用；
- 轻量无依赖：基于Flutter原生API开发，无第三方依赖，保障鸿蒙设备兼容性。