README_zh.md

使用网格

介绍

本工程以ArkUI (C-API)的方式实现使用滑块视图容器,演示滑块视图容器组件原生节点的创建、显示效果属性设置、页面切换事件监听与ETS侧对接。

效果预览

swiper_ndk

使用说明

  1. 在主界面可以显示参考的组件示例。

工程目录

entry/src/main
+--- cpp
|   ├── CMakeLists.txt
|   ├── napi_init.cpp
|   ├── NativeEntry.cpp
|   ├── NativeEntry.h
|   └── types
|       └── libentry
|           ├── Index.d.ts
|           └── oh-package.json5
├── ets
|   ├── entryability
|   |   └── EntryAbility.ets
|   ├── entrybackupability
|   |   └── EntryBackupAbility.ets
|   └── pages
|       └── Index.ets  

具体实现

  • 滑块视图容器组件的创建、属性设置和时间监听等,源码参考:NativeEntry.cpp
    • 通过createNode(ARKUI_NODE_SWIPER)创建滑块视图容器节点
    • 通过NODE_SWIPER_PREV_MARGIN等属性修改显示效果
    • 通过OH_ArkUI_SwiperIndicator_Create(ARKUI_SWIPER_INDICATOR_TYPE_DOT)创建圆点导航指示器,并修改显示效果
    • 通过registerNodeEvent监听NODE_SWIPER_EVENT_ON_CHANGE等页面切换事件

相关权限

不涉及。

依赖

不涉及。

约束与限制

1.本示例仅支持在标准系统上运行,支持设备:华为手机。

2.镜像版本号:HarmonyOS 6.0.2 Release及以上。

3.本示例需要使用DevEco Studio 6.0.2 Release (Build Version: 6.0.2.642, built on March 5, 2026)及以上版本才可编译运行。

下载

如需单独下载本工程,执行如下命令:

git init
git config core.sparsecheckout true
echo code/DocsSample/ArkUISample/NdkSwiperSample > .git/info/sparse-checkout
git remote add origin https://gitcode.com/openharmony/applications_app_samples.git
git pull origin master