阅读时间:1 分钟
0 字

API Reference

这一页只做导出索引。

每个 API 后面都附一行中文说明和对应跳转页,适合快速查名字、用途和入口。

App 与配置

API说明跳转
createUni()创建应用 runtime,把路由、请求、鉴权、模块等能力收进同一个应用容器应用生命周期
installUniApp()把创建好的 runtime 安装到 Vue app应用生命周期
setupUniAppLifecycle()把 uni-app 生命周期绑定到 runtime应用生命周期
defineUniConfig()定义传给 createUni() 的运行时配置初始化配置
definePageMeta()定义页面 Route 的辅助方法页面 Route
useUniApp()读取当前已安装的应用 runtime应用生命周期
useDux()useUniApp() 的同层入口,语义上更贴近 Dux runtime应用生命周期
useThemeStore()读取主题偏好 store,管理 system / light / dark 模式主题与 Token
useThemePreference()主题模式的轻量 composable,返回当前主题值和切换动作主题与 Token

路由与页面

API说明跳转
useRouter()统一页面跳转入口,会自动处理普通页和 tabBar 页useRouter
useNavigator()useRouter() 的兼容别名useRouter
useRoute()读取当前页面路径、query、页面名、模块名和 metauseRoute
usePageTitle()设置当前页面标题,支持响应式标题usePageTitle
usePageGuard()页面内做简单登录保护或游客页保护usePageGuard
useModules()读取当前已注册的模块列表模块系统
useActions()读取 action registry,并执行运行时 action扩展机制
useAction()读取并执行单个 action扩展机制

认证与权限

API说明跳转
useAuth()读取当前认证状态、token、用户信息和权限数据useAuth
useLogin()执行登录动作,自动写入会话并处理成功跳转useLogin
useLogout()执行退出动作,自动清理会话和缓存useLogout
useCheck()手动校验当前登录态是否有效,也可配合运行时自动校验useCheck
useCan()判断当前用户是否拥有某个权限useCan
useIsLogin()兼容保留 Hook,建议改用 useAuth() 推导登录态认证与会话
simpleAuthProvider()默认认证 provider,适合 token 型登录协议simpleAuthProvider

请求与数据

API说明跳转
useList()标准分页列表查询useList
useInfiniteList()无限滚动列表查询useInfiniteList
useOne()单条详情查询useOne
useMany()批量 id 查询和回填useMany
useCustom()读取型自定义 queryuseCustom
useCreate()创建型 mutation,适合新增数据useCreate
useUpdate()更新型 mutation,适合编辑数据useUpdate
useDelete()删除型 mutationuseDelete
useCustomMutation()提交型自定义 mutation,适合命令式动作useCustomMutation
useInvalidate()让指定 query 缓存失效、重置或移除useInvalidate
useRefetch()主动刷新指定 queryuseRefetch
getQueryKey()生成统一 query key数据查询
simpleDataProvider()默认数据 provider,统一资源式请求数据查询
createUniNetworkAdapter()基于 @uni-helper/uni-network 的默认 adapter请求配置
createRequestClient()构造底层请求客户端,支持 header、sign、拦截器和 adapter请求配置

表单与弹层

API说明跳转
useForm()管理表单值、校验和提交流程useForm
useSelect()拉取远程选项,处理搜索、分页和回填useSelect
useTree()把平铺数据整理成树结构useTree
useConfirm()打开确认框并等待结果useConfirm
useModal()打开模态弹窗,支持异步组件和结果回传useModal
useDrawer()打开抽屉弹层useDrawer
useOverlayContext()在弹层内部读取 payload、提交结果或主动关闭useOverlayContext
useOverlayEntries()读取当前 overlay 队列useOverlayEntries
useModalForm()useModal() 的兼容别名useModal
useDrawerForm()useDrawer() 的兼容别名useDrawer

事件、实时与设备

API说明跳转
useEvent()主动触发业务事件useEvent
useListener()监听业务事件useListener
useListenerOnce()只监听一次业务事件useListenerOnce
useListenerOnly()注册唯一监听器,适合独占式监听useListenerOnly
useSocket()建立页面级或局部级 WebSocket 连接useSocket
useSocketManager()读取默认或命名的全局 WebSocket 管理器useSocketManager
useSocketManagers()一次性读取全部全局 WebSocket 管理器useSocketManagers
useWebSocketManager()useSocketManager() 的兼容别名useSocketManager
useEventSource()更底层的 SSE 流式连接 HookuseEventSource
useSSE()SSE 简写 Hook,适合 AI 和日志流useSSE
useAuthorize()查询和申请原生权限useAuthorize
useLocation()获取定位、选点和打开地图useLocation
useImagePicker()选择图片并整理成统一文件结构useImagePicker
useClipboard()读取或复制剪贴板内容useClipboard
useScanCode()调起扫码能力useScanCode
useShare()发起原生分享useShare
usePhoneCall()调起拨号usePhoneCall
useOpenLocation()打开地图导航useOpenLocation
useUpload()上传文件并跟踪进度useUpload
useDownload()下载文件并处理保存或打开useDownload

模块、Schema 与底层运行时

API说明跳转
defineUniModule()定义模块入口模块系统
mergeUniModules()合并模块 pages、layouts、actions 和 schema模块系统
mergeUniConfigPatch()合并模块级配置 patch模块系统
createSocketBridge()把 socket 消息桥接成业务事件实战 Recipes
useJsonSchema()JSON Schema 渲染入口Schema 渲染
UniSchemaRenderer底层 Schema 渲染组件Schema 渲染
createSchemaRenderer()创建底层 Schema rendererSchema 渲染
renderSchema()直接渲染 schema 为 VNodeSchema 渲染
registerSchemaComponents()注册 schema 可用组件Schema 渲染
defineSchemaComponents()定义 schema 组件注册表Schema 渲染
createActionRegistry()创建 action registry扩展机制
createEventBus()创建 event bus扩展机制
createHookRegistry()创建 hook registry扩展机制
createMiddlewareRegistry()创建 middleware registry页面运行时
createOverlayRuntime()创建 overlay runtimeOverlay
createRouter()创建 router runtime路由与运行时
createNavigator()创建 navigator runtime路由与运行时
createSessionManager()创建 session manager认证与会话
createSocketManager()创建全局 socket manageruseSocketManager
createUniQueryClient()创建 query client数据查询

常用类型

类型说明跳转
UniPageMeta页面 Route 类型页面 Route
UniNavigationTarget路由跳转目标类型路由与运行时
UniAuthState认证状态类型认证与会话
UniDataResult数据请求结果类型数据查询
UniModuleManifest模块描述类型模块系统
UniModuleMiddleware模块中间件类型页面运行时
UniSchemaNodeSchema 节点类型Schema 协议
UniSchemaBindingsSchema 绑定上下文类型Schema 协议
DuxConfigdux.config.ts 类型应用配置
DuxThemeTokens主题 token 类型主题与 Token
UniThemePreference主题偏好类型,支持 system / light / dark主题与 Token