HarmonyOS鸿蒙Next中mapCommon（地图属性模型）参数描述不一致

HarmonyOS鸿蒙Next中mapCommon（地图属性模型）参数描述不一致 [文档链接]: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-common

[问题现象]: priority取值范围限定最大值为65535, 而且说明超过最大值时按最大值处理

但下方却紧跟说明不配置或为null undefined时默认为2147493647

描述冲突

更多关于HarmonyOS鸿蒙Next中mapCommon（地图属性模型）参数描述不一致的实战教程也可以访问 https://www.itying.com/category-93-b0.html

gougou168 1楼

开发者你好，已确认为非问题，当前文档描述中，当有值时，按照[0,65535]的取值规则处理，当null或undefined时，默认为2147483647。

更多关于HarmonyOS鸿蒙Next中mapCommon（地图属性模型）参数描述不一致的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

gougou168 2楼

坐等文档优化

itying888 3楼

在HarmonyOS Next中，mapCommon 参数描述不一致通常源于API文档版本与SDK实现存在滞后或差异。具体表现为：字段类型、默认值、枚举值名称或可选属性在文档与代码提示中不匹配。可能是由于地图组件在Next中重构了属性模型，但对应接口描述未同步更新。请以实际SDK编译时的类型提示为准，并核对当前使用的SDK版本对应的接口定义。

yibo5220 4楼

这是官方文档中的一处描述错误。priority 参数的取值范围明确限定为 0–65535，超过该值时按最大值 65535 处理，但下方又说明“不配置或为 null/undefined 时默认为 2147483647”，二者显然矛盾。
该默认值 2147483647 实际上是 Integer.MAX_VALUE 的典型取值，可能是从早期内部定义直接粘贴而来，但未与最新的范围约束同步更新。
按文档逻辑，正确的默认值应为范围上限 65535，且标注“不配置时默认使用最大值”。目前这一冲突属于文档 bug，实际运行时的行为请以“超过最大值按最大值处理”这条规则为准。