# 使用导航类组件

NDK提供一系列Navigation和页面路由状态查询接口，开发者可以通过OH\_ArkUI\_GetNavDestinationName、OH\_ArkUI\_GetNavDestinationParam、OH\_ArkUI\_GetNavDestinationState、OH\_ArkUI\_GetNavigationId、OH\_ArkUI\_GetNavDestinationIndex等查询页面的状态、索引、名称等信息，并根据查询结果进行对应的操作，如显示不同的页面信息。

本文提供页面状态查询开发指导，查询之前需要先接入ArkTS页面，具体请参考接入ArkTS页面。

#### 查询页面信息

查询页面信息，需要先确保目标节点已作为子节点挂载到页面中，若节点未挂载则操作会失败，例如在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);
    ```
    
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);
    ```
    

#### 查询页面状态

使用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());
```