diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/changelogs-arkui.md b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/changelogs-arkui.md new file mode 100644 index 0000000000000000000000000000000000000000..9b5c76fb4a0d6aa252f02831a19161143d227a7f --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/changelogs-arkui.md @@ -0,0 +1,189 @@ +# arkui子系统ChangeLog + +## cl.arkui.1 Navigation标题自定义位置变更 + +1. NavigationTitleMode设置为Full、Free或者Mini不带返回键场景。 + + API Version 9:保持左边距 24vp。 + + API Version 10: 左边距发生更改,由24vp更改为0。上边距由居中显示更改为上边距0。 + +2. NavigationTitleMode设置为Mini并且显示返回键。 + + API Version 9: 自定义标题与返回键间距为16vp。 + + API Version 10: 自定义标题栏与返回键间距变更:16vp变更为12vp。 + +3. 自定义Menu场景。 + + API Version 9:右边距为24vp。 + + API Version 10: 右边距由24vp变更为0。 + +**变更影响** + +该变更会导致API Version 10中使用Navigation自定义标题位置发生变化,显示会偏左和偏上。针对API Version 9及以下应用无影响。 + +**适配方法** + +1. 针对NavigationTitleMode.Full、Free模式以及NavigationTitleMode.Mini,添加左间距偏移:$r('sys.float.ohos_id_max_padding_start')。 +实现自定标题的居中效果: .height('100%').alignItems(VerticalAlign.Center) + +2. 针对NavigationTitleMode设置为Mini模式,并且显示返回键场景: 添加左偏移:.margin({left: 4}),居中效果同上。 + +3. 针对自定义Menu适配:添加右边距配置: .margin({right: $r('sys.float.ohos_id_max_padding_end')}) + + +**示例:** +```ts +@Entry +@Component +struct Index { + @State titleMode: NavigationTitleMode = NavigationTitleMode.Free + @State backButton: boolean = false; + @Builder CustomMenu() { + Column() { + Image($r('app.media.icon')).width(24).height(24) + } + } + + @Builder CustomTitle() { + Column() { + Text('Custom title').fontSize(20) + } + } + + build() { + Column() { + Navigation() { + Column() { + Text(`Change current title mode: ${this.titleMode}`) + .onClick(()=>{ + if (this.titleMode == NavigationTitleMode.Free) { + this.titleMode = NavigationTitleMode.Full; + } else if (this.titleMode == NavigationTitleMode.Full) { + this.titleMode = NavigationTitleMode.Mini; + } else { + this.titleMode = NavigationTitleMode.Free; + } + }) + + Text(`Change back button: ${this.backButton}`).onClick(()=>{ + this.backButton = !this.backButton; + }).margin({top: 10}) + }.margin({top: 40}) + }.title(this.CustomTitle) + .titleMode(this.titleMode) + .menus(this.CustomMenu) + .hideBackButton(this.backButton) + } + } +} +``` +API Version 9:NavigationTitleMode.Full自定义标题栏以及自定义Menu显示 + +![Navigation](figures/navigation_full_title_sdk9.png) + +API Version 10: NavigationTitleMode.Full自定义标题栏以及自定义Menu显示 + +![Navigation](figures/navigation_full_title_sdk10.png) + +API Version 9: NavigationTitleMode.Mini带返回键自定义标题栏显示 + +![Navigation](figures/navigation_mini_title_sdk9.png) + +API Version 10: NavigationTitleMode.Mini带返回键自定义标题栏显示 + +![Navigation](figures/navigation_mini_title_sdk10.png) + +API Version 9: NavigationTitleMode.Mini不带返回键标题栏显示 + +![Navigation](figures/navigation_mini_title_no_back_sdk9.png) + +API Version 10: NavigationTitleMode.Mini不带返回键标题栏显示 + +![Navigation](figures/navigation_mini_title_no_back_sdk10.png) + +## cl.arkui.2 NavDestination标题栏变更 + +针对自定义标题: + +1. 带返回键场景。 + + API Version 9:返回键与标题栏间距为16vp,标题栏居中。 + + API Version 10:标题栏与返回键间距变更由16vp变更为12vp,标题栏上偏移该为0。 + +2. 不带返回键场景。 + + API Version 9: 标题栏左间距为24vp,标题栏居中。 + + API Version 10:标题栏左间距变更24vp变更为0,标题栏上偏移该为0。 + +**变更影响** +1. NavDestination标题栏会移到左上 + +**适配方法** + +应用如果要保持之前的显示效果,可以采用如下方案适配: + +1. 针对不带返回键的场景,添加左偏移: margin({left: $r('sys.float.ohos_id_max_padding_start')}), +添加居中效果 .height('100%').alignItems(VerticalAlign.Center) + +2. 针对带返回键场景,添加做偏移:margin({left: 4}),居中实现效果同上。 + +**示例:** +```ts +@Entry +@Component +struct Index { + @Builder NavigationTile() { + Column() { + Text('title').fontColor('#182431').fontSize(30).lineHeight(41) + Text('subTitle').fontColor('#182431').fontSize(14).lineHeight(19).margin(top:2, bottom: 20) + } + } + + build() { + Column() { + Navigation() { + Text('Navigation') + }.title(this.NavigationTitle) + .titleMode(NavigationTitleMode.Free) + .menus([ + {icon: 'common/image/icon.png', value: 'menu1'} + ]) + } + } +} +``` + +API Version 9:带返回键自定义标题页面 + +![NavDstination](figures/navdestination_back_sdk9.png) + +API Version 10: 带返回键自定义标题页面 + +![NavDestination](figures/navdestination_back_sdk10.png) + +API9: 不带返回键自定义标题页面 + +![NavDestination](figures/navdestination_no_back_sdk9.png) + +API10: 不带返回键自定义标题页面 + +![NavDestination](figures/navdestination_no_back_sdk10.png) + +## cl.arkui.3 NavRouter回调OnStateChange变更 + +OnStateChange调用次数修复: + +针对目标显示NavDestination的OnStateChange回调由调用2次,修复为调用1次,调用顺序不受影响。 + +**变更影响** + +利用OnStateChange调用时序处理的应用会受到影响。 + + 更改之前调用时序:目标显示NavRouter触发OnStateChange(true) -> 退出NavRouter触发OnStateChange(false) -> 目标显示Navrouter触发OnStateChange(true) + + 更改之后调用时序:目标显示NavRouter触发OnStateChange(true) -> 退出NavRouter触发OnStateChange(false) \ No newline at end of file diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_back_sdk10.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_back_sdk10.png new file mode 100644 index 0000000000000000000000000000000000000000..3896b4746cdee3600eac10c971cfa8ec3681a651 Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_back_sdk10.png differ diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_back_sdk9.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_back_sdk9.png new file mode 100644 index 0000000000000000000000000000000000000000..be999731abc47506f72700907dd048b6be72c686 Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_back_sdk9.png differ diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_no_back_sdk10.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_no_back_sdk10.png new file mode 100644 index 0000000000000000000000000000000000000000..ec748b4be888003f6fde68c01ffd890cbc1d5575 Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_no_back_sdk10.png differ diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_no_back_sdk9.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_no_back_sdk9.png new file mode 100644 index 0000000000000000000000000000000000000000..491600af811f6f6003451aa26e533551d410d5b4 Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navdestination_no_back_sdk9.png differ diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_full_title_sdk10.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_full_title_sdk10.png new file mode 100644 index 0000000000000000000000000000000000000000..8221aa590f887532dbe9b49d0bfb9c49e2b7b698 Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_full_title_sdk10.png differ diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_full_title_sdk9.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_full_title_sdk9.png new file mode 100644 index 0000000000000000000000000000000000000000..e77493993547cac32d3281681dd455ca636b3023 Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_full_title_sdk9.png differ diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_no_back_sdk10.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_no_back_sdk10.png new file mode 100644 index 0000000000000000000000000000000000000000..30b21b894ba6cbe59b0513adde69249637bb59a3 Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_no_back_sdk10.png differ diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_no_back_sdk9.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_no_back_sdk9.png new file mode 100644 index 0000000000000000000000000000000000000000..60f457a253af7613becbbb179b17c7719cdb1aca Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_no_back_sdk9.png differ diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_sdk10.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_sdk10.png new file mode 100644 index 0000000000000000000000000000000000000000..ffaebf26a6a5a6540b981829a2404305c538867f Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_sdk10.png differ diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_sdk9.png b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_sdk9.png new file mode 100644 index 0000000000000000000000000000000000000000..f1bec7320ce900fdc25d83fa3ac2fb4a26104ad2 Binary files /dev/null and b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.11.5/figures/navigation_mini_title_sdk9.png differ