uni-use

import { useClipboard, useNetwork, useToast } from '@uni-helper/uni-use'

// 剪贴板
const { text, copy } = useClipboard()
// text 是响应式数据，copy 是异步操作函数
await copy('要复制的内容')

// 网络状态
const { isOnline, networkType } = useNetwork()
// isOnline: Ref<boolean>，网络变化时自动更新

// Toast 提示
const { showToast } = useToast()
showToast({ title: '操作成功', icon: 'success' })

npm install @uni-helper/uni-use @vueuse/core@9
# 或
pnpm add @uni-helper/uni-use @vueuse/core@9

<script setup lang="ts">
import { ref } from 'vue'
import { useClipboard, useNetwork, useStorage, useToast } from '@uni-helper/uni-use'

// 响应式本地存储
const token = useStorage('user_token', '')

// 剪贴板
const { text: clipboardText, copy } = useClipboard()

// 网络状态
const { isOnline, networkType } = useNetwork()

// Toast
const { showToast } = useToast()

const onCopyToken = async () => {
  if (!token.value) {
    showToast({ title: '未登录', icon: 'none' })
    return
  }
  await copy(token.value)
  showToast({ title: '已复制', icon: 'success' })
}
</script>

<template>
  <view class="container">
    <text>网络状态：{{ isOnline ? '在线' : '离线' }}（{{ networkType }}）</text>
    <text>剪贴板内容：{{ clipboardText || '空' }}</text>
    <button @click="onCopyToken">复制 Token</button>
  </view>
</template>

// vite.config.ts
import { fileURLToPath } from 'node:url'
import uni from '@dcloudio/vite-plugin-uni'
import { uniuseAutoImports } from '@uni-helper/uni-use/unplugin'
import AutoImport from 'unplugin-auto-import/vite'

export default defineConfig({
  plugins: [
    uni(),
    AutoImport({
      imports: [
        'vue',
        uniuseAutoImports(), // 自动导入 uni-use 的所有 composables
      ],
      dts: fileURLToPath(
        new URL('./src/auto-imports.d.ts', import.meta.url)
      ),
    }),
  ],
})

<script setup lang="ts">
// 无需 import，自动可用
const { copy } = useClipboard()
const { isOnline } = useNetwork()
</script>

import { useEventBus } from '@uni-helper/uni-use'

// 页面 A：监听事件
const { on } = useEventBus('user-login')
on((data) => {
  console.log('用户已登录', data)
})

// 页面 B：触发事件
const { emit } = useEventBus('user-login')
emit({ userId: 123, name: '张三' })