一、为什么需要响应式布局HarmonyOS 应用可运行在手机、平板、2in1 设备甚至折叠屏上屏幕尺寸差异巨大。MeCharts 采用了断点系统Breakpoint System 条件渲染的方式实现一套代码适配多种设备。二、断点系统设计2.1 断点定义MeCharts 定义了五个断点等级exportenumBreakpointTypeEnum{XSxs,// 超小屏折叠屏半屏SMsm,// 小屏手机竖屏MDmd,// 中屏手机横屏/小平板LGlg,// 大屏平板XLxl,// 超大屏2in1/外接显示器}2.2 BreakpointType 工具类这是断点系统的核心工具根据当前断点返回不同的值exportclassBreakpointTypeT{privatexs:T;privatesm:T;privatemd:T;privatelg:T;privatexl:T;publicconstructor(param:BreakpointTypesT){this.xsparam.xs??param.sm;// xs 缺省时降级到 smthis.smparam.sm;this.mdparam.md;this.lgparam.lg;this.xlparam.xl??param.lg;// xl 缺省时降级到 lg}publicgetValue(currentBreakpoint:string):T{if(currentBreakpointBreakpointTypeEnum.XS)returnthis.xs;if(currentBreakpointBreakpointTypeEnum.SM)returnthis.sm;if(currentBreakpointBreakpointTypeEnum.MD)returnthis.md;if(currentBreakpointBreakpointTypeEnum.XL)returnthis.xl;returnthis.lg;// 默认返回 lg}}使用方式非常简洁newBreakpointType({sm:FlexDirection.Row,// 小屏水平排列lg:FlexDirection.Column,// 大屏垂直排列}).getValue(this.globalInfoModel.currentBreakpoint)2.3 全局断点状态断点信息存储在GlobalInfoModel中通过AppStorage全局共享ObservedexportclassGlobalInfoModel{publiccurrentBreakpoint:BreakpointTypeEnumBreakpointTypeEnum.MD;publicnaviIndicatorHeight:number0;publicstatusBarHeight:number0;publicdeviceHeight:number0;publicdeviceWidth:number0;}2.4 断点更新在WindowUtil.registerBreakPoint中监听窗口尺寸变化publicstaticregisterBreakPoint(windowStage:window.WindowStage){windowStage.getMainWindow((err:BusinessError,data:window.Window){// 获取安全区域信息constsystemAvoidArea:window.AvoidAreadata.getWindowAvoidArea(window.AvoidAreaType.TYPE_SYSTEM);globalInfoModel.statusBarHeightpx2vp(systemAvoidArea.topRect.height);constbottomArea:window.AvoidAreadata.getWindowAvoidArea(window.AvoidAreaType.TYPE_NAVIGATION_INDICATOR);globalInfoModel.naviIndicatorHeightpx2vp(bottomArea.bottomRect.height);// 监听窗口尺寸变化data.on(windowSizeChange,()WindowUtil.onWindowSizeChange(data));// 监听安全区域变化data.on(avoidAreaChange,(avoidAreaOption){if(avoidAreaOption.typewindow.AvoidAreaType.TYPE_SYSTEM||avoidAreaOption.typewindow.AvoidAreaType.TYPE_NAVIGATION_INDICATOR){WindowUtil.setAvoidArea(avoidAreaOption.type,avoidAreaOption.area);}});AppStorage.setOrCreate(GlobalInfoModel,globalInfoModel);});}三、响应式 TabBar 实现自定义 TabBar 是响应式布局最典型的应用场景3.1 布局方向响应build(){Flex({direction:newBreakpointType({sm:FlexDirection.ColumnReverse,// 手机底部水平 TabBarmd:FlexDirection.ColumnReverse,lg:FlexDirection.Row,// 平板左侧垂直 TabBar}).getValue(this.globalInfoModel.currentBreakpoint),alignItems:ItemAlign.Center,}){// Tab 项容器Flex({direction:newBreakpointType({sm:FlexDirection.Row,// 手机水平排列 Tab 项md:FlexDirection.Row,lg:FlexDirection.Column,// 平板垂直排列 Tab 项}).getValue(this.globalInfoModel.currentBreakpoint),alignItems:ItemAlign.Center,justifyContent:FlexAlign.SpaceAround,}){ForEach(TABS_LIST,(item:TabBarData){this.TabItemBuilder(item)})}.margin({bottom:newBreakpointType({sm:this.globalInfoModel.naviIndicatorHeight,// 手机底部留出导航条空间md:this.globalInfoModel.naviIndicatorHeight,lg:0,// 平板无需避让}).getValue(this.globalInfoModel.currentBreakpoint),})}.size(newBreakpointTypeSizeOptions({sm:{width:100%,height:CommonConstants.TAB_BAR_HEIGHTthis.globalInfoModel.naviIndicatorHeight},md:{width:100%,height:CommonConstants.TAB_BAR_HEIGHTthis.globalInfoModel.naviIndicatorHeight},lg:{width:CommonConstants.TAB_BAR_WIDTH,height:100%},// 平板窄高条}).getValue(this.globalInfoModel.currentBreakpoint))}3.2 响应式效果设备TabBar 位置排列方向尺寸手机底部水平宽100% 高48vp 底部避让平板左侧垂直宽96vp 高100%四、安全区域避让全屏模式下内容可能被状态栏和导航条遮挡。MeCharts 的避让策略是手动计算 padding。4.1 TopBar 顶部避让.padding({top:this.statusBarHeight,// 状态栏高度bottom:20,left:12,right:12})4.2 页面底部避让子页面通过padding留出导航条空间NavDestination(){// 页面内容}.padding({bottom:this.globalInfoModel.naviIndicatorHeight})4.3 首页内容区底部避让首页内容区需要在 TabBar 高度基础上再加导航条高度Scroll(){// 内容}.height(100%).margin({bottom:CommonConstants.TAB_BAR_HEIGHTthis.globalInfoModel.naviIndicatorHeight})五、px2vp 单位转换HarmonyOS 中存在两种长度单位px物理像素与设备屏幕密度相关vp虚拟像素与密度无关1vp ≈ 1/160 英寸窗口 API 返回的尺寸是 px需要转换为 vpglobalInfoModel.statusBarHeightpx2vp(systemAvoidArea.topRect.height);globalInfoModel.naviIndicatorHeightpx2vp(bottomArea.bottomRect.height);globalInfoModel.deviceHeightpx2vp(properties.windowRect.height);globalInfoModel.deviceWidthpx2vp(properties.windowRect.width);px2vp是 ArkUI 内置的转换函数无需手动计算。六、其他响应式实践6.1 条件渲染对于断点差异较大的场景可以使用条件渲染替代属性切换if(this.globalInfoModel.currentBreakpointBreakpointTypeEnum.LG){// 大屏布局}else{// 小屏布局}6.2 资源限定词HarmonyOS 支持通过资源限定词为不同设备提供不同的资源resources/ base/ # 默认资源 tablet/ # 平板专用资源 2in1/ # 2in1 设备专用资源在代码中统一使用$r(app.media.xxx)引用系统自动根据设备类型选择最匹配的资源。6.3 常量定义MeCharts 将布局相关的常量集中定义在CommonConstants中exportclassCommonConstants{publicstaticTAB_BAR_HEIGHT:number48;publicstaticTAB_BAR_WIDTH:number96;publicstaticSIDE_BAR_WIDTH:number240;publicstaticNAVIGATION_HEIGHT:number56;publicstaticBANNER_ASPECT_SM:number1.28;publicstaticBANNER_ASPECT_MD:number0.53;publicstaticBANNER_ASPECT_LG:number0.53;}不同断点使用不同的横纵比、高度等常量值确保在各种设备上都有良好的视觉效果。七、折叠屏适配折叠屏设备需要在展开/折叠状态间平滑切换。MeCharts 通过监听windowSizeChange事件实现data.on(windowSizeChange,(){WindowUtil.onWindowSizeChange(data);// 此处可加入断点重新计算逻辑});当折叠屏状态变化时窗口尺寸改变触发重新计算断点和布局参数。StorageProp(GlobalInfoModel)的响应式机制确保 UI 自动刷新。八、小结本篇讲解了 MeCharts 的响应式布局体系包括断点系统、BreakpointType 工具类、安全区域避让和单位转换。通过BreakpointTypeT泛型工具一套代码即可适配手机和平板两种形态。下一篇将总结项目全貌并给出扩展建议。
一、为什么需要响应式布局HarmonyOS 应用可运行在手机、平板、2in1 设备甚至折叠屏上屏幕尺寸差异巨大。MeCharts 采用了断点系统Breakpoint System 条件渲染的方式实现一套代码适配多种设备。二、断点系统设计2.1 断点定义MeCharts 定义了五个断点等级exportenumBreakpointTypeEnum{XSxs,// 超小屏折叠屏半屏SMsm,// 小屏手机竖屏MDmd,// 中屏手机横屏/小平板LGlg,// 大屏平板XLxl,// 超大屏2in1/外接显示器}2.2 BreakpointType 工具类这是断点系统的核心工具根据当前断点返回不同的值exportclassBreakpointTypeT{privatexs:T;privatesm:T;privatemd:T;privatelg:T;privatexl:T;publicconstructor(param:BreakpointTypesT){this.xsparam.xs??param.sm;// xs 缺省时降级到 smthis.smparam.sm;this.mdparam.md;this.lgparam.lg;this.xlparam.xl??param.lg;// xl 缺省时降级到 lg}publicgetValue(currentBreakpoint:string):T{if(currentBreakpointBreakpointTypeEnum.XS)returnthis.xs;if(currentBreakpointBreakpointTypeEnum.SM)returnthis.sm;if(currentBreakpointBreakpointTypeEnum.MD)returnthis.md;if(currentBreakpointBreakpointTypeEnum.XL)returnthis.xl;returnthis.lg;// 默认返回 lg}}使用方式非常简洁newBreakpointType({sm:FlexDirection.Row,// 小屏水平排列lg:FlexDirection.Column,// 大屏垂直排列}).getValue(this.globalInfoModel.currentBreakpoint)2.3 全局断点状态断点信息存储在GlobalInfoModel中通过AppStorage全局共享ObservedexportclassGlobalInfoModel{publiccurrentBreakpoint:BreakpointTypeEnumBreakpointTypeEnum.MD;publicnaviIndicatorHeight:number0;publicstatusBarHeight:number0;publicdeviceHeight:number0;publicdeviceWidth:number0;}2.4 断点更新在WindowUtil.registerBreakPoint中监听窗口尺寸变化publicstaticregisterBreakPoint(windowStage:window.WindowStage){windowStage.getMainWindow((err:BusinessError,data:window.Window){// 获取安全区域信息constsystemAvoidArea:window.AvoidAreadata.getWindowAvoidArea(window.AvoidAreaType.TYPE_SYSTEM);globalInfoModel.statusBarHeightpx2vp(systemAvoidArea.topRect.height);constbottomArea:window.AvoidAreadata.getWindowAvoidArea(window.AvoidAreaType.TYPE_NAVIGATION_INDICATOR);globalInfoModel.naviIndicatorHeightpx2vp(bottomArea.bottomRect.height);// 监听窗口尺寸变化data.on(windowSizeChange,()WindowUtil.onWindowSizeChange(data));// 监听安全区域变化data.on(avoidAreaChange,(avoidAreaOption){if(avoidAreaOption.typewindow.AvoidAreaType.TYPE_SYSTEM||avoidAreaOption.typewindow.AvoidAreaType.TYPE_NAVIGATION_INDICATOR){WindowUtil.setAvoidArea(avoidAreaOption.type,avoidAreaOption.area);}});AppStorage.setOrCreate(GlobalInfoModel,globalInfoModel);});}三、响应式 TabBar 实现自定义 TabBar 是响应式布局最典型的应用场景3.1 布局方向响应build(){Flex({direction:newBreakpointType({sm:FlexDirection.ColumnReverse,// 手机底部水平 TabBarmd:FlexDirection.ColumnReverse,lg:FlexDirection.Row,// 平板左侧垂直 TabBar}).getValue(this.globalInfoModel.currentBreakpoint),alignItems:ItemAlign.Center,}){// Tab 项容器Flex({direction:newBreakpointType({sm:FlexDirection.Row,// 手机水平排列 Tab 项md:FlexDirection.Row,lg:FlexDirection.Column,// 平板垂直排列 Tab 项}).getValue(this.globalInfoModel.currentBreakpoint),alignItems:ItemAlign.Center,justifyContent:FlexAlign.SpaceAround,}){ForEach(TABS_LIST,(item:TabBarData){this.TabItemBuilder(item)})}.margin({bottom:newBreakpointType({sm:this.globalInfoModel.naviIndicatorHeight,// 手机底部留出导航条空间md:this.globalInfoModel.naviIndicatorHeight,lg:0,// 平板无需避让}).getValue(this.globalInfoModel.currentBreakpoint),})}.size(newBreakpointTypeSizeOptions({sm:{width:100%,height:CommonConstants.TAB_BAR_HEIGHTthis.globalInfoModel.naviIndicatorHeight},md:{width:100%,height:CommonConstants.TAB_BAR_HEIGHTthis.globalInfoModel.naviIndicatorHeight},lg:{width:CommonConstants.TAB_BAR_WIDTH,height:100%},// 平板窄高条}).getValue(this.globalInfoModel.currentBreakpoint))}3.2 响应式效果设备TabBar 位置排列方向尺寸手机底部水平宽100% 高48vp 底部避让平板左侧垂直宽96vp 高100%四、安全区域避让全屏模式下内容可能被状态栏和导航条遮挡。MeCharts 的避让策略是手动计算 padding。4.1 TopBar 顶部避让.padding({top:this.statusBarHeight,// 状态栏高度bottom:20,left:12,right:12})4.2 页面底部避让子页面通过padding留出导航条空间NavDestination(){// 页面内容}.padding({bottom:this.globalInfoModel.naviIndicatorHeight})4.3 首页内容区底部避让首页内容区需要在 TabBar 高度基础上再加导航条高度Scroll(){// 内容}.height(100%).margin({bottom:CommonConstants.TAB_BAR_HEIGHTthis.globalInfoModel.naviIndicatorHeight})五、px2vp 单位转换HarmonyOS 中存在两种长度单位px物理像素与设备屏幕密度相关vp虚拟像素与密度无关1vp ≈ 1/160 英寸窗口 API 返回的尺寸是 px需要转换为 vpglobalInfoModel.statusBarHeightpx2vp(systemAvoidArea.topRect.height);globalInfoModel.naviIndicatorHeightpx2vp(bottomArea.bottomRect.height);globalInfoModel.deviceHeightpx2vp(properties.windowRect.height);globalInfoModel.deviceWidthpx2vp(properties.windowRect.width);px2vp是 ArkUI 内置的转换函数无需手动计算。六、其他响应式实践6.1 条件渲染对于断点差异较大的场景可以使用条件渲染替代属性切换if(this.globalInfoModel.currentBreakpointBreakpointTypeEnum.LG){// 大屏布局}else{// 小屏布局}6.2 资源限定词HarmonyOS 支持通过资源限定词为不同设备提供不同的资源resources/ base/ # 默认资源 tablet/ # 平板专用资源 2in1/ # 2in1 设备专用资源在代码中统一使用$r(app.media.xxx)引用系统自动根据设备类型选择最匹配的资源。6.3 常量定义MeCharts 将布局相关的常量集中定义在CommonConstants中exportclassCommonConstants{publicstaticTAB_BAR_HEIGHT:number48;publicstaticTAB_BAR_WIDTH:number96;publicstaticSIDE_BAR_WIDTH:number240;publicstaticNAVIGATION_HEIGHT:number56;publicstaticBANNER_ASPECT_SM:number1.28;publicstaticBANNER_ASPECT_MD:number0.53;publicstaticBANNER_ASPECT_LG:number0.53;}不同断点使用不同的横纵比、高度等常量值确保在各种设备上都有良好的视觉效果。七、折叠屏适配折叠屏设备需要在展开/折叠状态间平滑切换。MeCharts 通过监听windowSizeChange事件实现data.on(windowSizeChange,(){WindowUtil.onWindowSizeChange(data);// 此处可加入断点重新计算逻辑});当折叠屏状态变化时窗口尺寸改变触发重新计算断点和布局参数。StorageProp(GlobalInfoModel)的响应式机制确保 UI 自动刷新。八、小结本篇讲解了 MeCharts 的响应式布局体系包括断点系统、BreakpointType 工具类、安全区域避让和单位转换。通过BreakpointTypeT泛型工具一套代码即可适配手机和平板两种形态。下一篇将总结项目全貌并给出扩展建议。
