HarmonyOS 鸿蒙Next优化建议-ArkUI（方舟UI框架）的页面级弹出框章节描述需要优化

HarmonyOS 鸿蒙Next优化建议-ArkUI（方舟UI框架）的页面级弹出框章节描述需要优化【问题描述】：文档文本将levelUniqueId描述为API的“第二个参数”，实际是openCustomDialog方法第一个参数对象的属性

url:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-embedded-dialog

【问题现象】：文档在此处称levelUniqueId为“第二个参数”，但在紧接着的官方代码示例中，levelUniqueId是作为options配置对象（即openCustomDialog的入参对象）内部的一个属性来传递的。将对象内部的“属性”硬描述为API的“第二个参数”属于严重的技术逻辑误导。

【版本信息】：不涉及

【复现代码】：不涉及

更多关于HarmonyOS 鸿蒙Next优化建议-ArkUI（方舟UI框架）的页面级弹出框章节描述需要优化的实战教程也可以访问 https://www.itying.com/category-93-b0.html

songsunli 1楼

尊敬的开发者，您好，
文档描述的“第二个参数”是相对于前文的levelmode参数表述的，即页面级能力默认可以只用一个参数实现，但部分场景需要通过第二个参数来实现。文档下方的示例是说明需要两个参数一起配置的场景。

更多关于HarmonyOS 鸿蒙Next优化建议-ArkUI（方舟UI框架）的页面级弹出框章节描述需要优化的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

zlyuanteng 2楼

已经向官方社区提单，您也可以在指导文档中，选择需要优化的文字后，点击右键反馈

zlyuanteng 3楼

该建议合理。当前页面级弹出框章节描述在生命周期绑定、页面栈管理及转场动画细节上存在模糊表述，需明确@Entry组件与CustomDialogController的层级关系，补充onPageShow/onPageHide对弹框可见性的影响。，

songsunli 4楼

感谢反馈。该文档描述确实存在不准确之处。levelUniqueId 实际上是 openCustomDialog 方法传入配置对象 options 中的一个属性，并非该方法的第二个独立入参。正确调用形式为 openCustomDialog({ levelUniqueId: ... })，而文档误将其表述为“第二个参数”。这可能导致开发者对 API 调用方式产生误解。我们已记录该问题并将推动文档修正。