阅读时间:1 分钟
0 字
Hook 总览
这一页只做导航,不展开长篇说明。
如果你想查详细参数、返回值和示例,直接点到对应能力页。
路由与页面
useRouter():统一页面跳转入口,会自动处理普通页、tabBar 页和模块首页跳转useRoute():读取当前页面的路径、页面名、模块名、query 和 metausePageTitle():设置当前页面标题,支持字符串和响应式标题usePageGuard():在页面内做简单登录保护或游客页保护
请求与数据
useList():标准分页列表查询useInfiniteList():无限滚动列表查询useOne():单条详情查询useMany():根据 id 数组批量查询和回填useCustom():读取型自定义 query,请求非资源式接口useCreate():创建型 mutation,适合新增数据useUpdate():更新型 mutation,适合修改数据useDelete():删除型 mutation,适合删除数据useCustomMutation():提交型自定义 mutation,适合命令式动作useInvalidate():让 query 缓存失效、重置或移除useRefetch():主动刷新指定 query
认证与权限
useAuth():读取当前认证状态和用户 token 信息useLogin():执行登录动作,自动写入会话和处理跳转useLogout():执行退出动作,自动清理会话和缓存useCheck():手动校验当前登录态是否有效,也可覆盖默认自动校验useCan():判断当前用户是否拥有某个权限
表单与数据整理
useForm():管理表单值、校验和提交流程useSelect():拉取远程选项,处理搜索、分页和回填useTree():把平铺数据整理成树结构,适合树选择和树展示
弹层
useConfirm():打开确认框并等待用户确认结果useModal():打开模态弹窗,支持异步组件和结果回传useDrawer():打开抽屉弹层,适合筛选器和侧边编辑useOverlayContext():在弹层内容组件里读取 payload、提交结果或主动关闭useOverlayEntries():读取当前 overlay 队列,通常给 overlay host 用
事件
useEvent():主动触发一个业务事件useListener():监听业务事件并在回调里消费它useListenerOnce():只监听一次事件,触发后自动解绑useListenerOnly():注册唯一监听器,适合独占式事件处理
Socket 与 SSE
useSocket():建立页面级或局部级 WebSocket 连接useSocketManager():读取默认或命名的全局 WebSocket 管理器useSocketManagers():一次性读取全部全局 WebSocket 管理器useSSE():建立 SSE 流式连接,适合 AI 输出和单向流useEventSource():更底层的 SSE Hook
设备与原生能力
useAuthorize():统一查询和申请原生权限useLocation():获取定位、选点和打开地图useImagePicker():选择图片并整理成统一文件结构useClipboard():读取或复制剪贴板内容useScanCode():调起扫码能力useShare():发起原生分享usePhoneCall():调起拨号useOpenLocation():直接打开地图导航useUpload():上传文件并跟踪进度useDownload():下载文件并处理保存或打开