Lifecycle API（生命周期）

wevu 生命周期 API 都需要在 setup() 的同步阶段调用。

1. App 生命周期

API	类型入口	说明
onLaunch	DefineAppOptions	小程序 App 启动。
onShow	RuntimeApp	App 进入前台。
onHide	RuntimeApp	App 进入后台。
onError	RuntimeApp	运行时错误回调。
onPageNotFound	RuntimeApp	路由未命中。
onUnhandledRejection	RuntimeApp	未处理 Promise rejection。
onThemeChange	RuntimeApp	系统主题变化。

2. 页面与组件通用生命周期

API	类型入口	说明
onLoad	RuntimeInstance	页面参数加载（页面常用）。
onReady	RuntimeInstance	首次渲染完成。
onShow	RuntimeInstance	页面/组件显示。
onHide	RuntimeInstance	页面/组件隐藏。
onUnload	RuntimeInstance	页面卸载。

3. 组件渲染阶段（Vue 风格）

API	类型入口	说明
onBeforeMount	RuntimeInstance	挂载前。
onMounted	RuntimeInstance	挂载后。
onBeforeUpdate	RuntimeInstance	更新前。
onUpdated	RuntimeInstance	更新后。
onBeforeUnmount	RuntimeInstance	卸载前。
onUnmounted	RuntimeInstance	卸载后。
onActivated	RuntimeInstance	激活（缓存场景）。
onDeactivated	RuntimeInstance	失活（缓存场景）。
onErrorCaptured	RuntimeInstance	捕获子树错误。
onServerPrefetch	RuntimeInstance	兼容 Vue 语义的预取钩子。

4. 小程序特有页面事件

API	类型入口	说明
onPageScroll	PageFeatures	页面滚动。
onPullDownRefresh	PageFeatures	下拉刷新。
onReachBottom	PageFeatures	触底事件。
onRouteDone	PageFeatures	页面路由完成。
onTabItemTap	PageFeatures	Tab 点击。
onResize	PageFeatures	视图尺寸变化。

5. 带返回值的页面钩子

API	类型入口	说明
onShareAppMessage	PageFeatures	自定义转发内容。
onShareTimeline	PageFeatures	自定义朋友圈分享内容。
onAddToFavorites	PageFeatures	添加收藏。
onSaveExitState	PageFeatures	离开时保存状态。

6. 小程序组件扩展生命周期

API	类型入口	说明
onMoved	MiniProgramPageLifetimes	组件节点位置变更。
onError	MiniProgramPageLifetimes	组件或 App 错误（按上下文桥接）。

7. 示例：滚动 + 分享（script setup）

TypeScript

<script setup lang="ts">
import { onPageScroll, onShareAppMessage, onShow, ref } from 'wevu'

// [TS-only] 此示例无专属语法，TS/JS 写法一致。
const scrollTop = ref(0)

onShow(() => {
  console.log('page show')
})

onPageScroll((e) => {
  scrollTop.value = e.scrollTop
})

onShareAppMessage(() => ({
  title: 'wevu 页面分享',
  path: '/pages/index/index',
}))
</script>

<template>
  <view>scrollTop: {{ scrollTop }}</view>
</template>

JavaScript

<script setup>
import { onPageScroll, onShareAppMessage, onShow, ref } from 'wevu'

const scrollTop = ref(0)

onShow(() => {
  console.log('page show')
})

onPageScroll((e) => {
  scrollTop.value = e.scrollTop
})

onShareAppMessage(() => ({
  title: 'wevu 页面分享',
  path: '/pages/index/index',
}))
</script>

<template>
  <view>scrollTop: {{ scrollTop }}</view>
</template>