ArkTS 常用 API 总结

25 阅读3分钟

ArkTS 常用 API 总结

快速概览

ArkTS API 是鸿蒙应用开发的核心工具集,涵盖 UI 组件、系统能力、工具类等。

分类:UI 组件 API、系统能力 API、工具类 API、路由导航 API

API 分类体系

UI 组件 API

1. 容器组件

Column - 垂直布局容器

Row - 水平布局容器

Stack - 堆叠容器

Flex - 弹性布局容器

2. 基础组件

Text - 文本显示

Button - 按钮

Image - 图片

Divider - 分割线

3. 列表组件

List - 列表容器

Grid - 网格布局

Swiper - 轮播图

Tabs - 标签页

4. 表单组件

TextInput - 文本输入

Checkbox - 复选框

Radio - 单选按钮

Slider - 滑块

Toggle - 开关

系统能力 API

1. 网络请求 - @ohos.net.http

发送 HTTP 请求

使用场景

· 获取服务器数据

· 提交表单

· 上传/下载文件

· RESTful API 调用

2. 数据存储 - @ohos.data.preferences

轻量级键值对存储

使用场景:

· 保存用户配置

· 缓存少量数据

· 存储登录状态

· 保存应用设置

3. 文件管理 - @ohos.file.fs

文件读写操作

使用场景:

· 保存用户文档

· 缓存大文件

· 日志记录

· 离线数据存储

4. 弹窗提示 - @ohos.promptAction

Toast 提示

对话框

使用场景:

· 操作成功/失败提示

· 确认对话框

· 选择对话框

· 输入对话框

路由导航 API

router - 页面路由

导入路由模块

页面跳转

获取路由参数

使用场景:

· 页面跳转

· 传递参数

· 返回操作

· 页面栈管理

动画 API

属性动画 - animation

基本动画

转场动画 - transition

显式动画 – animateTo

手势 API

点击手势 - TapGesture

长按手势 – LongPressGesture

拖拽手势 – PanGesture

工具类 API

1. 数组常用方法

遍历方法

数组操作方法

数组归并方法

2. Math 数学运算

常用数学方法

常用数学常量

3. Date 日期时间

创建日期对象

获取日期时间

设置日期时间

日期格式化

日期计算

4. String 字符串方法

常用字符串方法

5. JSON 操作

6. 日志输出

7. 定时器

生命周期 API

组件生命周期

页面生命周期

常用场景 API 组合

1. 列表加载更多

2. 下拉刷新

3. 图片预览

4. 表单提交

API 快速查找表

UI 组件

系统能力

工具类 API

学习建议

1. 学习路径

2. 实践建议

· 先掌握常用组件(Column、Row、Text、Button)

· 学会使用 List 和 Grid 处理列表

· 熟悉路由导航和页面跳转

· 掌握网络请求和数据存储

· 逐步学习动画和手势

3. 查阅文档

官方文档:

· 组件参考:developer.harmonyos.com/cn/docs/doc…

· API 参考:developer.harmonyos.com/cn/docs/doc…

总结

API 分层结构

核心原则

· UI 组件: 声明式语法,链式调用

· 系统能力: import 导入,Promise 异步

· 数据驱动: 状态变化自动更新 UI

· 生命周期: 合理利用钩子函数

记忆要点

UI 组件:

· 布局用 Column/Row,列表用 List,表单用 TextInput

系统能力:

· 网络请求:@ohos.net.http

· 数据存储:@ohos.data.preferences

· 页面跳转:@ohos.router

· 提示弹窗:@ohos.promptAction

工具类:

· 数组:map/filter/forEach/reduce 处理数据

· Math:random/floor/ceil 数学计算

· Date:getFullYear/getMonth/getTime 日期处理

· String:split/join/replace/trim 字符串操作

· JSON:stringify/parse 序列化

(转载自CSDN,作者:SWUT胖虎)