Flutter for OpenHarmony 实战:HarmonyOS ArkTS API 24 分割线与间距控制
Flutter 分割线与间距控制技术解析
一、项目背景与功能概述
在 UI 设计中,分割线和间距是构建清晰视觉层次、优化内容布局的基础元素。分割线用于在视觉上分隔不同的内容区域,帮助用户理解页面的信息结构;间距则用于控制元素之间的留白,影响页面的呼吸感和可读性。一个设计良好的应用,其分割线和间距系统一定是规范而统一的,这直接影响着应用的专业度和用户体验。
本项目聚焦于 Flutter 中的分割线组件和间距控制组件的封装与实现,提供了一套功能完善、使用便捷的布局辅助工具。分割线组件支持水平分割线和垂直分割线两种方向,支持自定义厚度、颜色、缩进等属性,特别值得一提的是支持虚线分割线效果,填补了 Flutter 原生组件不支持虚线的空白。间距控制组件则提供了统一的间距管理方案,包括预设尺寸的便捷常量、自定义尺寸的间距组件、以及弹性间距等多种使用方式。
从技术实现角度来看,本项目深入探讨了 Flutter 中 CustomPaint 自定义绘制的实际应用,通过 CustomPainter 实现了虚线效果的绘制。同时,项目也展示了如何设计一套统一的间距系统,通过命名构造函数和静态常量提供多样化的使用方式,既保证了灵活性又确保了一致性。此外,项目还涉及 SizedBox、Expanded、CustomPaint 等多个 Flutter 基础组件的高级用法。这些技术对于构建布局规范、视觉统一的 Flutter 应用具有重要的实践价值。
二、整体架构分析
2.1 架构设计思路
本项目采用工具化组件的架构设计,将分割线和间距这两类布局辅助工具分别封装为独立的组件类。每个组件都提供了多种构造方式和配置选项,以适应不同的使用场景。主页组件则作为展示页面,集中演示各种分割线和间距的用法和效果。
2.2 架构图
2.3 模块职责说明
- 入口层:负责应用初始化和主题配置
- 主页层:展示分割线和间距的各种使用示例,包括基础水平分割线、自定义分割线、虚线分割线、垂直分割线,以及基础间距、垂直间距、预设间距、弹性间距等
- 分割线组件:提供分割线功能,支持水平/垂直方向、实线/虚线样式、自定义厚度、颜色、缩进等属性。虚线效果通过 CustomPainter 自定义绘制实现
- 间距组件:提供间距控制功能,支持固定尺寸间距和弹性间距,支持水平和垂直方向
- 间距工具类:提供一组预定义的间距常量和便捷的静态方法,用于统一管理间距尺寸
三、入口组件与初始化流程
3.1 应用入口与根组件
应用入口函数调用 runApp 启动应用,根组件返回标准的 MaterialApp 配置。主题使用深紫色种子色生成颜色方案,并启用 Material 3 设计规范。
与其他项目类似,根组件配置了应用标题和主题。Material 3 的启用为应用带来了更现代的视觉效果,包括新的组件样式、圆角设计和颜色系统。
3.2 主页组件
主页组件是一个 StatefulWidget,其状态类中没有自定义状态变量,所有展示内容都是静态的。页面主体使用 SingleChildScrollView 包裹,支持垂直滚动。
页面分为两大展示区域:
分割线展示区域:从上到下依次展示:
- 基础水平分割线:默认样式的灰色水平分割线
- 自定义厚度和颜色的分割线:2 像素粗,深紫色
- 带缩进的分割线:左右各缩进 40 像素,蓝色
- 虚线分割线:绿色虚线,虚线宽度 8,间隙 4
- 垂直分割线:在水平排列的两个文本之间插入垂直分割线
间距控制展示区域:从上到下依次展示:
- 基础间距:水平方向的三个色块,使用自定义尺寸的水平间距
- 垂直间距:垂直方向的三个色块,使用自定义尺寸的垂直间距
- 预设间距:使用 xs、sm、md 等预设间距常量的水平排列
- 弹性间距:在 Row 中使用弹性间距自动分配剩余空间
综合示例:一个模拟用户信息卡片的完整示例,综合运用了分割线和间距组件,展示了在实际业务场景中的使用方式。
整体页面内容丰富,通过标题文字、间距和分割线将各个示例清晰地组织起来,便于对比和理解。
四、核心组件逐段深度解析
4.1 分割线组件
分割线组件是一个无状态组件,提供了丰富的配置选项,支持多种分割线样式。
4.1.1 参数设计
组件接收以下可配置参数:
- thickness:分割线厚度,默认为 1.0 像素
- color:分割线颜色,默认为灰色
- indent:起始缩进(水平方向为左侧缩进,垂直方向为顶部缩进),默认为 0
- endIndent:结束缩进(水平方向为右侧缩进,垂直方向为底部缩进),默认为 0
- isVertical:是否为垂直方向,默认为 false(水平)
- height:垂直分割线的高度,默认为无限大
- isDashed:是否为虚线,默认为 false(实线)
- dashWidth:虚线每段的宽度,默认为 4.0 像素
- dashGap:虚线每段之间的间隙,默认为 2.0 像素
参数设计非常全面,覆盖了分割线可能需要的各种配置。
4.1.2 构建逻辑
组件的 build 方法根据 isVertical 参数分为两个分支:水平分割线和垂直分割线。每个分支又根据 isDashed 参数分为实线和虚线两种实现。
垂直分割线:
- 外层使用 SizedBox 限定宽度和高度
- 如果是虚线,使用 CustomPaint 绘制虚线
- 如果是实线,使用 Container 设置宽度和颜色,通过 margin 实现上下缩进
水平分割线:
- 如果是虚线,使用 Container 限定高度,通过 margin 实现左右缩进,内部使用 CustomPaint 绘制虚线
- 如果是实线,直接使用 Flutter 原生的 Divider 组件,配置厚度、颜色、缩进等属性
实线水平分割线优先使用原生 Divider 组件,因为它是 Flutter 框架提供的标准组件,性能和兼容性都有保障。而虚线和垂直分割线则需要自己实现,因为 Flutter 没有提供原生支持。
4.2 虚线绘制器
虚线绘制器继承自 CustomPainter,负责绘制虚线效果。这是分割线组件的核心技术亮点。
4.2.1 绘制参数
绘制器接收以下参数:
- color:虚线颜色
- dashWidth:每段虚线的宽度
- dashGap:虚线之间的间隙
- isVertical:是否垂直方向
4.2.2 绘制逻辑
paint 方法实现了虚线的绘制逻辑:
- 创建画笔:设置颜色、线宽和样式。线宽根据方向决定:垂直方向使用 size.width(即分割线厚度),水平方向使用 size.height
- 计算总长度:垂直方向取高度,水平方向取宽度
- 循环绘制线段:从起点开始,不断绘制一段虚线,然后跳过一段间隙,直到绘制完整个长度
在每次循环中:
- 计算本段的结束位置(start + dashWidth)
- 如果结束位置超出总长度,则截断到总长度
- 根据方向调用 canvas.drawLine 绘制线段
- 更新起始位置为结束位置加上间隙
这种循环绘制的方式是实现虚线效果的标准方法,逻辑清晰,易于理解和调整。
4.2.3 重绘判断
shouldRepaint 方法返回 false,表示绘制器创建后不需要重新绘制。这是因为虚线的样式完全由构造参数决定,一旦创建就不会变化。如果后续需要支持动画虚线等效果,就需要修改这个方法,在参数变化时返回 true 以触发重绘。
4.3 间距组件
间距组件是一个无状态组件,用于在布局中添加指定大小的间距。它本质上是对 SizedBox 的封装,但提供了更友好的 API 和更多的构造方式。
4.3.1 构造函数
组件提供了多个命名构造函数:
- 默认构造函数:通用构造,可配置尺寸、方向、是否弹性、弹性值
- horizontal:水平间距构造,方向设为 Axis.horizontal
- vertical:垂直间距构造,方向设为 Axis.vertical
- flex:弹性间距构造,flex 设为 true,用于在 Row/Column 中占据剩余空间
命名构造函数是 Dart 语言的一个重要特性,它可以为同一个类提供多种语义化的构造方式,让代码更具可读性。
4.3.2 构建逻辑
组件的 build 方法根据 flex 参数分为两种情况:
弹性间距:返回一个 Expanded 组件,包裹一个 SizedBox。Expanded 会占据 Row/Column 中剩余的可用空间,flex 值决定了分配比例。这种间距用于需要自动填充剩余空间的场景。
固定间距:返回一个 SizedBox,根据方向设置宽度或高度。如果是水平方向,设置 width 为 size,height 为 0;如果是垂直方向则相反。
通过灵活使用这两种间距模式,可以应对各种复杂的布局需求。
4.4 间距工具类
间距工具类是一个普通的 Dart 类,不是 Widget。它提供了一组预定义的间距常量和便捷的静态方法,用于统一管理项目中的间距尺寸。
4.4.1 预设常量
类定义了六级预设间距:
- xs:4 像素,最小间距,用于紧密排列的元素之间
- sm:8 像素,小间距,用于相关元素之间
- md:16 像素,中等间距,用于普通内容区块之间
- lg:24 像素,大间距,用于较大的内容区块之间
- xl:32 像素,超大间距,用于页面主要区域之间
- xxl:48 像素,特大间距,用于页面顶级区块之间
这些常量同时设置了 width 和 height,因此既可以用作水平间距,也可以用作垂直间距。
4.4.2 静态方法
类还提供了两个静态方法:
- horizontal:创建指定宽度的水平间距 SizedBox
- vertical:创建指定高度的垂直间距 SizedBox
这些方法提供了比直接使用 SizedBox 更语义化的使用方式,使代码的意图更加清晰。
4.4.3 设计意义
统一的间距系统是设计规范化的重要组成部分。使用预定义的间距常量,而不是到处写魔法数字,可以确保应用各处的间距保持一致和协调,提升整体设计质量。同时,当需要调整间距规范时,只需要修改一处定义,整个应用都会同步更新,大大提高了维护效率。
五、状态管理机制分析
5.1 无状态设计
本项目中的分割线组件和间距组件都是无状态组件(StatelessWidget),它们不维护任何内部状态。组件的所有行为都由传入的参数决定,相同的参数总是产生相同的输出。
间距工具类更是一个纯静态类,连实例都不需要创建,直接通过类名访问常量和方法。
5.2 纯展示组件模式
这些布局辅助组件都属于"纯展示组件",它们的特点是:
- 不维护状态
- 不处理用户交互
- 只负责根据参数渲染 UI
- 没有副作用
纯展示组件是 Flutter 中最基础、最常用的组件类型。它们具有以下优势:
- 性能好:构建逻辑简单,重建开销小
- 易测试:只需要传入不同参数验证输出即可
- 易复用:不依赖特定上下文,可以在任何地方使用
- 可预测:行为完全由参数决定,没有隐藏的内部逻辑
5.3 在布局系统中的角色
分割线和间距组件在 Flutter 的布局系统中扮演着"布局辅助工具"的角色。它们不承载具体的业务内容,而是帮助组织和美化布局结构。
在实际开发中,合理使用分割线和间距可以:
- 清晰地划分内容区域,提升信息架构的可读性
- 建立视觉节奏和层次,引导用户视线流动
- 增加页面留白,提升视觉舒适度
- 统一设计规范,确保应用风格一致
六、关键代码片段与技术点详解
6.1 CustomPaint 绘制虚线
虚线绘制是本项目的核心技术亮点。Flutter 没有提供原生的虚线组件,需要通过 CustomPaint 自己绘制。
while (start < length) {
final end = start + dashWidth;
if (isVertical) {
canvas.drawLine(
Offset(size.width / 2, start),
Offset(size.width / 2, end > length ? length : end),
paint,
);
} else {
canvas.drawLine(
Offset(start, size.height / 2),
Offset(end > length ? length : end, size.height / 2),
paint,
);
}
start = end + dashGap;
}
这段代码的核心思想是循环绘制多段短线段,每段之间留有间隙,从而形成虚线效果。具体步骤:
- 初始化起始位置 start 为 0
- 计算本段的结束位置 end = start + dashWidth
- 如果 end 超出了总长度,则截断到总长度(处理最后一段)
- 绘制从 start 到 end 的线段
- 更新 start = end + dashGap(加上间隙)
- 重复以上步骤直到 start >= length
这种方法虽然简单,但非常实用。通过调整 dashWidth 和 dashGap 的比例,可以创造出不同风格的虚线效果:
- 短虚线:dashWidth 小,dashGap 大,如点线
- 长虚线:dashWidth 大,dashGap 小,如破折线
- 等距虚线:dashWidth = dashGap,标准虚线
6.2 命名构造函数
间距组件使用了多个命名构造函数,这是 Dart 语言的一个优雅特性。
const SpacingWidget.horizontal({
super.key,
this.size = 16.0,
this.direction = Axis.horizontal,
this.flex = false,
this.flexValue = 1,
});
命名构造函数的优势:
- 语义清晰:调用方一眼就能看出构造的是什么类型的间距
- 默认值合理:每个命名构造函数可以设置自己合理的默认值
- 代码自文档化:好的命名可以替代注释,让代码自己说明用途
虽然多个命名构造函数之间有代码重复(参数列表基本相同),但为了 API 的易用性,这种牺牲是值得的。在更复杂的场景下,可以使用重定向构造函数(redirecting constructor)来减少重复。
6.3 弹性间距与 Expanded
弹性间距模式使用 Expanded 包裹 SizedBox,这是一种巧妙的布局技巧:
if (flex) {
return Expanded(
flex: flexValue,
child: SizedBox(
width: direction == Axis.horizontal ? size : 0,
height: direction == Axis.vertical ? size : 0,
),
);
}
Expanded 组件的作用是在 Row、Column 或 Flex 中占据剩余的可用空间。通过将间距包裹在 Expanded 中,间距就不再是固定大小,而是会自动伸缩填充剩余空间。
这种弹性间距在以下场景非常有用:
- 在 Row 中需要将某些元素推到两端,中间用弹性间距填充
- 在多个元素之间按比例分配空间
- 需要自适应不同屏幕尺寸的布局
flex 参数可以控制多个弹性元素之间的空间分配比例。例如,两个 flex 值分别为 1 和 2 的 Expanded,会按照 1:2 的比例分配剩余空间。
6.4 间距系统的设计规范
间距工具类中定义的六级间距(xs、sm、md、lg、xl、xxl)体现了专业的设计系统思想。
class Spacing {
static const SizedBox xs = SizedBox(height: 4, width: 4);
static const SizedBox sm = SizedBox(height: 8, width: 8);
static const SizedBox md = SizedBox(height: 16, width: 16);
static const SizedBox lg = SizedBox(height: 24, width: 24);
static const SizedBox xl = SizedBox(height: 32, width: 32);
static const SizedBox xxl = SizedBox(height: 48, width: 48);
}
统一间距系统的价值:
- 视觉一致性:所有页面的间距使用同一套规范,整体风格统一
- 开发效率:开发者不需要每次纠结用多少像素的间距,直接从预设中选择
- 维护便捷:调整设计规范时只需要修改一处定义
- 协作顺畅:设计师和开发者使用统一的间距语言,沟通成本更低
间距值的选择通常基于 4 像素或 8 像素的栅格系统,确保所有尺寸都是基准单位的整数倍,从而建立和谐的视觉节奏。
七、技术总结与扩展方向
7.1 技术总结
本项目实现了分割线和间距控制两类布局辅助组件,深入展示了 Flutter 中自定义绘制和布局工具的开发技术。
分割线组件全面支持水平/垂直方向和实线/虚线样式,其中虚线效果通过 CustomPainter 自定义绘制实现,解决了 Flutter 原生不支持虚线的问题。组件参数设计完善,包括厚度、颜色、缩进、虚线参数等多种配置,能够满足各种场景下的分割线需求。
间距控制方面,项目提供了两种使用方式:SpacingWidget 组件和 Spacing 工具类。SpacingWidget 支持固定间距和弹性间距两种模式,通过命名构造函数提供清晰的 API。Spacing 工具类则提供了六级预设间距常量和便捷方法,建立了统一的间距系统,有助于提升应用的设计规范性。
在架构设计上,所有组件都采用无状态设计,职责单一,参数明确,具有良好的可预测性和可复用性。组件之间相互独立,各司其职,体现了良好的关注点分离原则。
7.2 扩展方向
本项目的分割线和间距组件还有很多可以扩展和深化的方向:
功能扩展:
- 支持更多分割线样式,如点线、点划线、双划线等
- 添加渐变分割线,支持颜色渐变效果
- 支持带图标的分割线,在线条中间或两侧添加图标或文字
- 支持装饰性分割线,如波浪线、折线等
- 添加间距调试模式,可视化显示页面中的所有间距
增强功能:
- 支持响应式间距,根据屏幕尺寸自动调整间距大小
- 支持间距主题,可通过主题配置全局间距规格
- 添加分割线动画效果,如入场动画、过渡动画
- 支持可拖拽分割线,用于可调整大小的布局
架构优化:
- 建立更完整的设计系统规范,包括颜色、字体、间距、圆角等
- 支持深色模式适配,自动调整分割线颜色
- 添加完整的组件文档和使用示例
- 封装为独立的包(package),方便在多个项目间复用
性能优化:
- 对于虚线绘制,可以考虑使用路径绘制(Path + dashPathEffect)替代循环绘制,提高性能
- 合理使用 const 构造函数,利用编译时优化
- 使用 RepaintBoundary 隔离 CustomPaint 的重绘
工具增强:
- 添加更多布局辅助工具,如 SafeArea 增强、比例布局、定位布局等
- 开发 VS Code/IDE 插件,快速插入间距和分割线代码
- 提供间距检查工具,自动检测不规范的间距使用
总之,本项目为 Flutter 布局辅助工具的开发提供了扎实的技术基础和良好的设计范式。通过深入理解 CustomPaint 绘制机制、组件封装思想和设计系统规范,开发者可以构建出更加专业、更加规范的 Flutter 应用,为用户提供一致、优雅、舒适的视觉体验。

Flutter for OpenHarmony 实战:分割线与间距控制
前言:跨生态开发的新机遇
在移动开发领域,我们总是面临着选择与适配。今天,你的Flutter应用在Android和iOS上跑得正欢,明天可能就需要考虑一个新的平台:HarmonyOS(鸿蒙)。这不是一道选答题,而是很多团队正在面对的现实。
Flutter的优势很明确——写一套代码,就能在两个主要平台上运行,开发体验流畅。而鸿蒙代表的是下一个时代的互联生态,它不仅仅是手机系统,更着眼于未来全场景的体验。将现有的Flutter应用适配到鸿蒙,听起来像是一个“跨界”任务,但它本质上是一次有价值的技术拓展:让产品触达更多用户,也让技术栈覆盖更广。
不过,这条路走起来并不像听起来那么简单。Flutter和鸿蒙,从底层的架构到上层的工具链,都有着各自的设计逻辑。会遇到一些具体的问题:代码如何组织?原有的功能在鸿蒙上如何实现?那些平台特有的能力该怎么调用?更实际的是,从编译打包到上架部署,整个流程都需要重新摸索。
这篇文章想做的,就是把这些我们趟过的路、踩过的坑,清晰地摊开给你看。我们不会只停留在“怎么做”,还会聊到“为什么得这么做”,以及“如果出了问题该往哪想”。这更像是一份实战笔记,源自真实的项目经验,聚焦于那些真正卡住过我们的环节。
无论你是在为一个成熟产品寻找新的落地平台,还是从一开始就希望构建能面向多端的应用,这里的思路和解决方案都能提供直接的参考。理解了两套体系之间的异同,掌握了关键的衔接技术,不仅能完成这次迁移,更能积累起应对未来技术变化的能力。
混合工程结构深度解析
项目目录架构
当Flutter项目集成鸿蒙支持后,典型的项目结构会发生显著变化。以下是经过ohos_flutter插件初始化后的项目结构:
my_flutter_harmony_app/
├── lib/ # Flutter业务代码(基本不变)
│ ├── main.dart # 应用入口
│ ├── components/ # 组件目录
│ │ ├── divider_widget.dart # 分割线组件
│ │ └── spacing_widget.dart # 间距控制组件
│ └── utils/
│ └── platform_utils.dart # 平台工具类
├── pubspec.yaml # Flutter依赖配置
├── ohos/ # 鸿蒙原生层(核心适配区)
│ ├── entry/ # 主模块
│ │ └── src/main/
│ │ ├── ets/ # ArkTS代码
│ │ │ ├── MainAbility/
│ │ │ │ ├── MainAbility.ts # 主Ability
│ │ │ │ └── MainAbilityContext.ts
│ │ │ └── pages/
│ │ │ ├── Index.ets # 主页面
│ │ │ └── Splash.ets # 启动页
│ │ ├── resources/ # 鸿蒙资源文件
│ │ │ ├── base/
│ │ │ │ ├── element/ # 字符串等
│ │ │ │ ├── media/ # 图片资源
│ │ │ │ └── profile/ # 配置文件
│ │ │ └── en_US/ # 英文资源
│ │ └── config.json # 应用核心配置
│ ├── ohos_test/ # 测试模块
│ ├── build-profile.json5 # 构建配置
│ └── oh-package.json5 # 鸿蒙依赖管理
└── README.md
展示效果图片
flutter 实时预览 效果展示
运行到鸿蒙虚拟设备中效果展示
目录
功能代码实现
分割线组件
设计思路
分割线组件是UI布局中常用的元素,用于分隔不同的内容区域,提升界面的层次感和可读性。在本实现中,我们设计了一个功能丰富的分割线组件,支持以下特性:
- 水平和垂直两种方向
- 自定义厚度、颜色
- 支持缩进效果
- 支持虚线样式
核心代码实现
import 'package:flutter/material.dart';
class DividerWidget extends StatelessWidget {
final double thickness;
final Color color;
final double indent;
final double endIndent;
final bool isVertical;
final double height;
final bool isDashed;
final double dashWidth;
final double dashGap;
const DividerWidget({
super.key,
this.thickness = 1.0,
this.color = Colors.grey,
this.indent = 0.0,
this.endIndent = 0.0,
this.isVertical = false,
this.height = double.infinity,
this.isDashed = false,
this.dashWidth = 4.0,
this.dashGap = 2.0,
});
Widget build(BuildContext context) {
if (isVertical) {
return SizedBox(
width: thickness,
height: height,
child: isDashed
? CustomPaint(
painter: _DashedLinePainter(
color: color,
dashWidth: dashWidth,
dashGap: dashGap,
isVertical: true,
),
)
: Container(
margin: EdgeInsets.symmetric(
vertical: indent,
),
width: thickness,
color: color,
),
);
} else {
return isDashed
? Container(
height: thickness,
margin: EdgeInsets.only(
left: indent,
right: endIndent,
),
child: CustomPaint(
painter: _DashedLinePainter(
color: color,
dashWidth: dashWidth,
dashGap: dashGap,
isVertical: false,
),
),
)
: Divider(
thickness: thickness,
color: color,
indent: indent,
endIndent: endIndent,
);
}
}
}
class _DashedLinePainter extends CustomPainter {
final Color color;
final double dashWidth;
final double dashGap;
final bool isVertical;
_DashedLinePainter({
required this.color,
required this.dashWidth,
required this.dashGap,
required this.isVertical,
});
void paint(Canvas canvas, Size size) {
final paint = Paint()
..color = color
..strokeWidth = isVertical ? size.width : size.height
..style = PaintingStyle.stroke;
final length = isVertical ? size.height : size.width;
double start = 0.0;
while (start < length) {
final end = start + dashWidth;
if (isVertical) {
canvas.drawLine(
Offset(size.width / 2, start),
Offset(size.width / 2, end > length ? length : end),
paint,
);
} else {
canvas.drawLine(
Offset(start, size.height / 2),
Offset(end > length ? length : end, size.height / 2),
paint,
);
}
start = end + dashGap;
}
}
bool shouldRepaint(covariant CustomPainter oldDelegate) {
return false;
}
}
代码解析
-
组件参数设计:
thickness:分割线厚度,默认为1.0color:分割线颜色,默认为灰色indent:分割线缩进,水平分割线为左侧缩进,垂直分割线为顶部缩进endIndent:分割线结束缩进,仅对水平分割线有效isVertical:是否为垂直分割线,默认为false(水平分割线)height:垂直分割线的高度,默认为无限大isDashed:是否为虚线,默认为falsedashWidth:虚线线段宽度,默认为4.0dashGap:虚线线段间距,默认为2.0
-
实现逻辑:
- 根据
isVertical参数判断是水平还是垂直分割线 - 根据
isDashed参数判断是实线还是虚线 - 对于虚线,使用
CustomPaint和_DashedLinePainter自定义绘制 - 对于实线,水平分割线使用Flutter内置的
Divider组件,垂直分割线使用Container实现
- 根据
-
虚线绘制:
- 自定义
_DashedLinePainter类继承自CustomPainter - 根据
isVertical参数决定绘制方向 - 使用循环绘制多个线段,实现虚线效果
- 自定义
使用方法
// 基础水平分割线
DividerWidget()
// 自定义厚度和颜色的分割线
DividerWidget(
thickness: 2,
color: Colors.deepPurple,
)
// 带缩进的分割线
DividerWidget(
indent: 40,
endIndent: 40,
color: Colors.blue,
)
// 虚线分割线
DividerWidget(
isDashed: true,
dashWidth: 8,
dashGap: 4,
color: Colors.green,
)
// 垂直分割线
DividerWidget(
isVertical: true,
height: 80,
)
开发注意事项
-
性能优化:
- 对于频繁使用的分割线,建议使用常量构造函数创建
- 虚线分割线使用了
CustomPaint,在列表中使用时要注意性能
-
布局适配:
- 垂直分割线需要指定合适的
height值 - 在Row中使用垂直分割线时,要注意Row的对齐方式
- 垂直分割线需要指定合适的
-
颜色一致性:
- 建议在主题中定义分割线颜色,保持应用内颜色一致
间距控制组件
设计思路
间距控制是UI布局中的重要部分,合理的间距可以提升界面的美观度和可读性。在本实现中,我们设计了一个灵活的间距控制组件,支持以下特性:
- 水平和垂直两种方向
- 固定间距和弹性间距
- 预设常用间距值
核心代码实现
import 'package:flutter/material.dart';
class SpacingWidget extends StatelessWidget {
final double size;
final Axis direction;
final bool flex;
final int flexValue;
const SpacingWidget({
super.key,
this.size = 16.0,
this.direction = Axis.vertical,
this.flex = false,
this.flexValue = 1,
});
const SpacingWidget.horizontal({
super.key,
this.size = 16.0,
this.direction = Axis.horizontal,
this.flex = false,
this.flexValue = 1,
});
const SpacingWidget.vertical({
super.key,
this.size = 16.0,
this.direction = Axis.vertical,
this.flex = false,
this.flexValue = 1,
});
const SpacingWidget.flex({
super.key,
this.size = 0.0,
this.direction = Axis.vertical,
this.flex = true,
this.flexValue = 1,
});
Widget build(BuildContext context) {
if (flex) {
return Expanded(
flex: flexValue,
child: SizedBox(
width: direction == Axis.horizontal ? size : 0,
height: direction == Axis.vertical ? size : 0,
),
);
}
return SizedBox(
width: direction == Axis.horizontal ? size : 0,
height: direction == Axis.vertical ? size : 0,
);
}
}
class Spacing {
static const SizedBox xs = SizedBox(height: 4, width: 4);
static const SizedBox sm = SizedBox(height: 8, width: 8);
static const SizedBox md = SizedBox(height: 16, width: 16);
static const SizedBox lg = SizedBox(height: 24, width: 24);
static const SizedBox xl = SizedBox(height: 32, width: 32);
static const SizedBox xxl = SizedBox(height: 48, width: 48);
static SizedBox horizontal(double size) => SizedBox(width: size);
static SizedBox vertical(double size) => SizedBox(height: size);
}
代码解析
-
组件参数设计:
size:间距大小,默认为16.0direction:间距方向,默认为垂直方向flex:是否为弹性间距,默认为falseflexValue:弹性间距的权重,默认为1
-
构造函数:
- 默认构造函数:创建指定大小和方向的间距
horizontal:创建水平间距的便捷构造函数vertical:创建垂直间距的便捷构造函数flex:创建弹性间距的便捷构造函数
-
Spacing工具类:
- 提供了常用间距的静态常量:xs(4), sm(8), md(16), lg(24), xl(32), xxl(48)
- 提供了创建水平和垂直间距的静态方法
使用方法
// 使用SpacingWidget
SpacingWidget(size: 20)
SpacingWidget.horizontal(size: 16)
SpacingWidget.vertical(size: 12)
SpacingWidget.flex(flexValue: 2)
// 使用Spacing工具类
Spacing.md
Spacing.horizontal(24)
Spacing.vertical(16)
开发注意事项
-
间距规范:
- 建议在项目中统一使用预设的间距值,保持布局一致性
- 可以根据设计系统的要求,调整Spacing工具类中的预设值
-
弹性布局:
- 在Row或Column中使用弹性间距时,要注意其他子组件的布局
- 弹性间距会占据剩余空间,可能影响其他组件的显示
-
性能优化:
- 对于固定间距,建议使用Spacing工具类中的静态常量
- 避免在build方法中频繁创建新的间距组件
组件集成
首页集成
在首页中,我们集成了分割线和间距控制组件,展示了不同样式的分割线和间距效果。
import 'package:flutter/material.dart';
import 'components/divider_widget.dart';
import 'components/spacing_widget.dart';
class MyHomePage extends StatefulWidget {
const MyHomePage({super.key, required this.title});
final String title;
State<MyHomePage> createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
backgroundColor: Theme.of(context).colorScheme.inversePrimary,
title: Text(widget.title),
),
body: SingleChildScrollView(
padding: const EdgeInsets.all(20),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: <Widget>[
// 分割线展示
const Text(
'分割线组件展示',
style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
),
Spacing.md,
// 基础水平分割线
const Text('基础水平分割线'),
Spacing.sm,
Container(
padding: const EdgeInsets.symmetric(vertical: 10),
child: const DividerWidget(),
),
// 自定义厚度和颜色的分割线
const Text('自定义厚度和颜色的分割线'),
Spacing.sm,
Container(
padding: const EdgeInsets.symmetric(vertical: 10),
child: const DividerWidget(
thickness: 2,
color: Colors.deepPurple,
),
),
// 带缩进的分割线
const Text('带缩进的分割线'),
Spacing.sm,
Container(
padding: const EdgeInsets.symmetric(vertical: 10),
child: const DividerWidget(
indent: 40,
endIndent: 40,
color: Colors.blue,
),
),
// 虚线分割线
const Text('虚线分割线'),
Spacing.sm,
Container(
padding: const EdgeInsets.symmetric(vertical: 10),
child: const DividerWidget(
isDashed: true,
dashWidth: 8,
dashGap: 4,
color: Colors.green,
),
),
// 垂直分割线
const Text('垂直分割线'),
Spacing.sm,
Container(
height: 100,
child: Row(
mainAxisAlignment: MainAxisAlignment.center,
children: const [
Text('左侧内容'),
DividerWidget(isVertical: true, height: 80),
Text('右侧内容'),
],
),
),
Spacing.lg,
const DividerWidget(thickness: 1, color: Colors.grey),
Spacing.lg,
// 间距控制展示
const Text(
'间距控制组件展示',
style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
),
Spacing.md,
// 基础间距
const Text('基础间距'),
Spacing.sm,
Row(
children: [
Container(width: 50, height: 50, color: Colors.red),
Spacing.horizontal(16),
Container(width: 50, height: 50, color: Colors.green),
Spacing.horizontal(24),
Container(width: 50, height: 50, color: Colors.blue),
],
),
Spacing.md,
// 垂直间距
const Text('垂直间距'),
Spacing.sm,
Column(
children: [
Container(width: 100, height: 30, color: Colors.red),
Spacing.vertical(12),
Container(width: 100, height: 30, color: Colors.green),
Spacing.vertical(16),
Container(width: 100, height: 30, color: Colors.blue),
],
),
Spacing.md,
// 预设间距
const Text('预设间距'),
Spacing.sm,
Row(
children: [
Container(width: 30, height: 30, color: Colors.red),
Spacing.xs,
Container(width: 30, height: 30, color: Colors.green),
Spacing.sm,
Container(width: 30, height: 30, color: Colors.blue),
Spacing.md,
Container(width: 30, height: 30, color: Colors.yellow),
],
),
Spacing.md,
// 弹性间距
const Text('弹性间距'),
Spacing.sm,
Row(
children: [
Container(width: 50, height: 50, color: Colors.red),
const SpacingWidget.flex(),
Container(width: 50, height: 50, color: Colors.green),
const SpacingWidget.flex(flexValue: 2),
Container(width: 50, height: 50, color: Colors.blue),
],
),
Spacing.xl,
// 综合示例
const Text(
'综合示例',
style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
),
Spacing.md,
Container(
padding: const EdgeInsets.all(16),
decoration: BoxDecoration(
border: Border.all(color: Colors.grey),
borderRadius: BorderRadius.circular(8),
),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
const Text('用户信息', style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold)),
Spacing.sm,
DividerWidget(thickness: 1, color: Colors.grey.shade300),
Spacing.md,
Row(
children: [
Container(width: 60, height: 60, color: Colors.purple),
Spacing.horizontal(16),
Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
const Text('用户名', style: TextStyle(fontSize: 16)),
Spacing.xs,
const Text('用户邮箱', style: TextStyle(fontSize: 14, color: Colors.grey)),
],
),
],
),
Spacing.md,
DividerWidget(thickness: 1, color: Colors.grey.shade300),
Spacing.md,
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
TextButton(onPressed: () {}, child: const Text('编辑')),
TextButton(onPressed: () {}, child: const Text('删除')),
],
),
],
),
),
],
),
),
);
}
}
集成注意事项
-
导入路径:
- 确保正确导入组件文件,路径根据项目结构调整
-
布局结构:
- 使用
SingleChildScrollView确保内容超出屏幕时可以滚动 - 使用
Column和Row组织布局,结合间距组件控制元素间距
- 使用
-
性能优化:
- 对于固定的文本和组件,使用
const关键字 - 避免在build方法中频繁创建新的Widget
- 对于固定的文本和组件,使用
-
适配性:
- 测试不同屏幕尺寸下的显示效果
- 确保在OpenHarmony设备上的显示效果与Flutter预览一致
本次开发中容易遇到的问题
1. 组件导入路径问题
问题描述
在集成组件时,可能会遇到导入路径错误的问题,导致编译失败。
解决方案
- 检查项目结构,确保组件文件路径正确
- 使用相对路径导入组件,如
import 'components/divider_widget.dart'; - 避免使用包名导入,除非组件已经发布为包
注意事项
- 导入路径的大小写要与实际文件路径一致
- 确保组件文件存在于指定路径中
2. 虚线分割线绘制问题
问题描述
在某些设备或Flutter版本上,虚线分割线可能显示不正确,或者性能较差。
解决方案
- 使用
CustomPaint时,确保shouldRepaint方法返回false,避免不必要的重绘 - 对于长列表中的虚线分割线,考虑使用缓存或其他优化方式
- 测试不同设备上的显示效果,确保兼容性
注意事项
- 虚线的
dashWidth和dashGap值不宜过小,否则可能导致显示模糊 - 在低性能设备上,大量使用自定义绘制可能会影响性能
3. 间距控制一致性问题
问题描述
在不同的布局中,间距控制不一致,导致界面美观度下降。
解决方案
- 统一使用Spacing工具类中的预设值
- 在项目中建立间距规范,明确不同场景下使用的间距值
- 使用主题或常量类管理间距值,方便统一调整
注意事项
- 遵循设计系统的间距规范
- 考虑不同屏幕尺寸下的间距适配
4. 弹性布局计算问题
问题描述
在使用弹性间距时,可能会遇到布局计算错误,导致组件显示异常。
解决方案
- 确保在Row或Column中使用弹性间距时,其他子组件的布局是合理的
- 避免在同一个Row或Column中混合使用过多的弹性组件
- 测试不同内容长度下的布局效果
注意事项
- 弹性间距会影响其他组件的布局,使用时要谨慎
- 在复杂布局中,考虑使用Expanded或Flexible组件直接控制
5. 平台适配问题
问题描述
在OpenHarmony设备上,分割线和间距的显示效果可能与Flutter预览不一致。
解决方案
- 测试不同OpenHarmony版本上的显示效果
- 考虑平台差异,必要时进行平台特定的调整
- 使用Flutter的平台检测功能,针对不同平台提供不同的实现
注意事项
- OpenHarmony的渲染引擎可能与Android/iOS有所不同
- 测试是确保跨平台兼容性的关键
总结本次开发中用到的技术点
1. 组件化开发
技术要点
- 将分割线和间距控制逻辑抽离为独立组件
- 使用构造函数参数实现组件的灵活性
- 提供便捷构造函数和工具类,简化使用方式
应用场景
- 分割线组件:用于分隔不同内容区域,如列表项、卡片等
- 间距控制组件:用于控制UI元素之间的间距,提升布局美观度
2. 自定义绘制
技术要点
- 使用
CustomPaint和CustomPainter实现虚线分割线 - 掌握Canvas绘图API,实现自定义图形
- 优化绘制性能,避免不必要的重绘
应用场景
- 虚线分割线:适用于需要特殊样式分割线的场景
- 自定义图形:适用于需要绘制复杂图形的场景
3. 布局控制
技术要点
- 使用
Row和Column组织布局 - 使用
SingleChildScrollView实现滚动布局 - 使用弹性布局实现灵活的空间分配
应用场景
- 页面布局:组织页面中的各个元素
- 列表布局:实现垂直或水平的列表
- 复杂布局:处理包含多种元素的复杂界面
4. 工具类设计
技术要点
- 设计静态工具类,提供常用的间距常量和方法
- 使用常量构造函数,提升性能
- 统一管理间距值,保持布局一致性
应用场景
- 间距管理:统一控制UI元素之间的间距
- 样式管理:统一管理应用中的样式元素
- 工具方法:提供常用的工具方法,简化代码
5. 性能优化
技术要点
- 使用
const关键字创建不可变Widget - 优化自定义绘制性能,避免不必要的重绘
- 合理使用弹性布局,避免布局计算错误
应用场景
- 列表渲染:提升长列表的滚动性能
- 复杂界面:优化包含多个组件的复杂界面
- 动画效果:确保动画流畅运行
6. 跨平台适配
技术要点
- 确保组件在不同平台上的显示效果一致
- 测试OpenHarmony设备上的显示效果
- 考虑平台差异,进行必要的调整
应用场景
- Flutter for OpenHarmony项目:确保在OpenHarmony设备上的兼容性
- 多平台项目:确保在Android、iOS和OpenHarmony上的一致性
7. 代码规范
技术要点
- 遵循Dart代码规范,保持代码风格一致
- 使用有意义的变量和方法命名
- 添加适当的注释,提高代码可读性
应用场景
- 团队开发:确保团队成员之间的代码风格一致
- 代码维护:提高代码的可维护性和可读性
- 开源项目:符合开源社区的代码规范要求
8. 测试与调试
技术要点
- 测试不同场景下的组件显示效果
- 使用Flutter DevTools进行性能分析
- 调试布局问题,确保组件正确显示
应用场景
- 开发阶段:及时发现和解决问题
- 发布前:确保组件在各种场景下的稳定性
- 维护阶段:定位和修复问题
通过本次开发,我们成功实现了Flutter for OpenHarmony的分割线和间距控制组件,掌握了组件化开发、自定义绘制、布局控制等关键技术点。这些技术不仅适用于分割线和间距控制的开发,也是Flutter开发中的通用技术,对于构建高质量的Flutter应用具有重要意义。
在开发过程中,我们遇到了一些问题,如组件导入路径问题、虚线分割线绘制问题、间距控制一致性问题等,但通过分析问题原因,采取相应的解决方案,成功解决了这些问题。
同时,我们也总结了一些开发经验和最佳实践,如统一使用间距工具类、优化自定义绘制性能、确保跨平台兼容性等,这些经验对于后续的Flutter for OpenHarmony开发工作具有参考价值。

flutter_openHarmony(简称 Flutter‑OH)
注意:不是Google官方产物,是OpenHarmony社区TPC组织维护的Flutter引擎移植版本。把Flutter的Dart/Skia引擎做底层改造,让Flutter应用可以直接编译输出 HAP包,跑在OpenHarmony/纯血鸿蒙设备上,不需要依赖Android兼容层。
简单讲:一套Dart/Flutter业务代码,可以同时编译 Android、iOS、OpenHarmony(HAP)。
核心原理
对Flutter Engine做Embedder嵌入适配,对接OpenHarmony Rosen图形管线、UIAbility生命周期,通过MethodChannel实现 Dart ↔ ArkTS双向通信,Flutter自绘UI渲染到鸿蒙Surface,复用方舟编译器、系统权限、分布式能力。
- Dart业务代码几乎不变
- 底层引擎适配鸿蒙图形、线程、生命周期
- 输出产物是标准HAP应用包,可上架鸿蒙应用市场
主要优势
-
存量Flutter项目低成本接入鸿蒙生态
纯Dart业务、纯Widget界面几乎不用改代码即可编译出鸿蒙HAP;只有带Android/iOS原生桥接的插件,才需要做鸿蒙适配替换。已经有成熟Flutter App,想快速覆盖鸿蒙设备,不用全部重写ArkTS。 -
多端UI高度一致性
Flutter自绘渲染,不受各平台控件差异影响,手机、平板、车机界面表现统一;滚动、动画、首页各类动效(轮播、吸顶、骨架屏、入场动画)跨平台表现一致,和你前面问的App首页各种效果可以一套代码全部实现。 -
继承Flutter完整开发体验
保留热重载、DevTools调试、完整Widget组件库;pub.dev海量纯Dart三方库直接复用,是鸿蒙跨端方案里三方库最丰富的方案。提供定制CLI,一条命令完成编译、真机调试、打包HAP。 -
可调用OpenHarmony原生系统能力
支持调用分布式软总线、分布式数据KV、原子化服务、鸿蒙权限体系、硬件能力;Flutter页面和ArkTS原生页面可以混合开发、互相跳转,复杂原生逻辑继续写ArkTS,UI业务交给Flutter实现。 -
全场景设备覆盖
支持OpenHarmony手机、平板、智慧屏、车机等设备,适合需要多终端统一UI的业务。引擎做了懒加载,跟随UIAbility生命周期启停,控制内存占用,减少后台资源消耗。
更多推荐
所有评论(0)