使用导航类组件

查询页面信息

查询页面信息，需要先确保目标节点已作为子节点挂载到页面中，若节点未挂载则操作会失败，例如在aboutToAppear生命周期中查询不到对应信息。页面详细生命周期以及组件挂载生命周期参考页面生命周期。开发者可以根据查询到的页面信息加载不同的页面组件。

本示例仅展示核心功能代码，完整示例请参考NDK使用页面查询接口示例。

1. 查询当前页面名称。

   使用OH_ArkUI_GetNavDestinationName可以查询NavDestination页面名称。router页面名称可以通过OH_ArkUI_GetRouterPageName接口查询。

   收起

   自动换行

   深色代码主题

   复制

   // 获取页面名称
   char pageName[NUM_50];
   int32_t bufferLen = 0;
   OH_ArkUI_GetNavDestinationName(node, pageName, NUM_50, &bufferLen);

   QueryNavigation.h

2. 查询页面跳转参数。

   使用OH_ArkUI_GetNavDestinationParam可以查询NavDestination页面跳转参数。

   收起

   自动换行

   深色代码主题

   复制

   // 获取页面跳转参数
   napi_value param = OH_ArkUI_GetNavDestinationParam(node);
   napi_value nameVal = nullptr;
   napi_get_named_property(env, param, "name", &nameVal);
   size_t len = 0;
   napi_get_value_string_utf8(env, nameVal, nullptr, 0, &len);
   std::unique_ptr<char[]> viewName = std::make_unique<char[]>(len + 1);
   napi_get_value_string_utf8(env, nameVal, viewName.get(), len + 1, &len);
   ArkUI_NodeHandle targetNode = nullptr;
   std::string view = viewName.get();
   if (view == "QueryNavigation") {
       InitNavigationNode(column, pageName);
   } else if (view == "QueryRouter") {
       InitRouterNode(column);
   }
   nativeApi->addChild(node, column);

   QueryNavigation.h

查询页面状态

使用OH_ArkUI_GetNavDestinationState可以查询当前占位组件所属的NavDestination页面状态。router页面可以通过OH_ArkUI_GetRouterPageState接口查询，根据查询结果进行对应的适配，如设置组件visible属性、视频播放状态。

本示例仅展示核心功能代码，完整示例请参考NDK使用页面查询接口示例。

ArkUI_NodeHandle targetNode = nullptr;
OH_ArkUI_NodeUtils_GetAttachedNodeHandleById("navDestinationState", &targetNode);
auto entry = NativeEntry::GetInstance();
entry->ReportError(targetNode, "event clicked");
ArkUI_NavDestinationState state;
OH_ArkUI_GetNavDestinationState(targetNode, &state);
if (state == NUM_8) {
    entry->SetColor(targetNode, 0x80808080);
} else if (state == NUM_9) {
    entry->SetColor(targetNode, 0xFF000000);
}

查询页面栈信息

使用OH_ArkUI_GetNavDestinationIndex可以查询当前占位组件所属NavDestination在栈中的位置。router页面索引可以通过OH_ArkUI_GetRouterPageIndex接口查询。根据返回的页面栈信息，可在应用开发中实现DFX功能，例如性能监控与用户行为分析等参数的收集，用于数据上报和分析。

本示例仅展示核心功能代码，完整示例请参考NDK使用页面查询接口示例。

char navigationId[NUM_50];
int32_t bufferLen = 0;
OH_ArkUI_GetNavigationId(handle, navigationId, NUM_50, &bufferLen);
    
char name[NUM_50];
int32_t nameLen = OH_ArkUI_GetNavDestinationName(handle, name, NUM_50, &nameLen);
    
int32_t index = -1;
OH_ArkUI_GetNavDestinationIndex(handle, &index);
OH_LOG_Print(LOG_APP, LOG_ERROR, 0xFF00, "NAPI",
             "navigation id: %{public}s, name: %{public}s, index: %{public}d, error: %{public}s",
             navigationId, name, index, info.c_str());