不秃也能写代码
2026-11-17 13:27:57 发布ArkUI-X 6.0.0 在组件适配层面做了一次较大幅度的扩充,新增了十余个高级组件的跨平台支持,其中 SwipeRefresher 和 FoldSplitContainer 对鸿蒙跨端应用的意义最为直接。前者解决了 Android 和 iOS 端缺乏原生下拉刷新交互标准的问题,后者则为折叠屏和平板设备提供了一套开箱即用的分栏容器。
SwipeRefresher 的跨平台行为差异
SwipeRefresher 在 HarmonyOS 原生端直接映射到 ArkUI 的下拉刷新组件,行为与系统一致。但在 Android 端,ArkUI-X 的实现基于 SwipeRefreshLayout 封装,触发阈值和回弹动画的曲线参数与鸿蒙存在可感知的差异。如果应用对刷新动效的一致性有严格要求,建议在 Android 侧覆盖默认的触发距离:
typescript
// 跨平台页面中使用 SwipeRefresher
@Entry
@Component
struct FeedPage {
@State refreshing: boolean = false;
build() {
SwipeRefresher({
refreshing: this.refreshing,
onRefresh: () => {
this.refreshing = true;
this.loadFeed().finally(() => {
this.refreshing = false;
});
},
// Android 端通过 distance 参数对齐触发阈值
// 鸿蒙端此参数不生效,保持系统默认
distance: 80
}) {
List() {
// 列表内容
}
}
}
private async loadFeed(): Promise<void> {
// 数据拉取逻辑
}
}distance 参数仅在 Android 和 iOS 端生效,鸿蒙端会忽略该属性并采用系统默认阈值。这种“平台选择性生效”的参数在 ArkUI-X 中并不少见,接入时需要对照文档确认每个属性的平台覆盖范围。
FoldSplitContainer 在折叠屏上的分栏控制
FoldSplitContainer 是 6.0.0 新增的折叠屏专用容器,它根据折叠状态自动切换单栏与双栏布局。与手动通过断点判断折叠状态相比,这个组件将折叠姿态的监听和布局切换封装在内部,减少了业务代码的重复逻辑。
以下是一个在邮件类页面中使用 FoldSplitContainer 的示例:
typescript
import { FoldSplitContainer } from '@kit.ArkUI';
@Entry
@Component
struct MailPage {
@State selectedMailId: string = '';
build() {
FoldSplitContainer({
// 折叠态下显示主栏,展开态下主栏和辅栏同时显示
primary: () => {
this.MailList({ onSelect: (id: string) => {
this.selectedMailId = id;
}})
},
secondary: () => {
if (this.selectedMailId) {
this.MailDetail({ mailId: this.selectedMailId })
} else {
this.EmptyDetail()
}
},
// 折叠态下 primary 占满全屏,secondary 通过路由跳转
foldStatus: 'auto'
})
}
}foldStatus: 'auto' 让容器自动读取当前折叠姿态,开发者无需手动监听 display.on('foldStatusChange')。需要注意的是,FoldSplitContainer 在非折叠屏设备(普通手机)上的行为是仅渲染 primary,secondary 需要通过导航跳转进入。这意味着页面设计时不能假设 secondary 始终存在于组件树中。
版本兼容性检查
ArkUI-X 6.0.0 配套 OpenHarmony API 20 Release,部分新增组件在 5.x 版本的 ArkUI-X 上不可用。如果项目需要同时维护 5.x 和 6.0 的跨端分支,建议在 build-profile.json5 中为 6.0 分支单独配置 compileSdkVersion,并通过条件编译或运行时版本检测来隔离新组件的调用路径。
暂无评论数据
发布
相关推荐
张妍希
0
0
码上调用
0
0
程序山河
0
0
folra
1
0
张妍希
0
0
不秃也能写代码
我还没有写个人简介......
帖子
提问
粉丝
华为余承东:正考虑逐步将鸿蒙推向全球市场
2026-10-08 17:40:02 发布全新体验:钉钉鸿蒙PC版不只变好看,更是让每个操作都“懂你”
2026-08-13 17:04:02 发布


京公网安备:11010502051901号