快速使用

ReView 组件库快速上手

安装完成后,即可在模板中直接使用 re- 前缀组件。

基础示例

<template>
  <re-config-provider locale="zh-CN">
    <re-button theme="primary" @click="handleClick">按钮</re-button>
    <re-input v-model:value="text" placeholder="请输入" />
    <re-badge :count="5">
      <view>消息</view>
    </re-badge>
  </re-config-provider>
</template>

运行项目

uni-app x 项目不支持 npm CLI 方式开发,所有编译运行均通过 HBuilderX 内置编译器完成。

  1. 用 HBuilderX 3.99+ 打开项目目录
  2. 点击工具栏「运行」选择目标平台:H5、Android / iOS App、微信小程序
  3. 点击「发行」进行打包

数据埋点(reglow-track)

reglow-track 是基于 uni-app x 的跨端埋点采集 SDK,安装后将 uni_modules/reglow-track 放入项目即可。支持 App / H5 / 微信小程序,协议与 Web 版 @reglow/track 同源。

  1. 在 App.uvue(或首个页面的 onLaunch)创建并初始化:
import { createTrack } from '@/uni_modules/reglow-track/utssdk/index.uts'

const track = createTrack({
  appId: 'your-app-id',
  dsnHost: '/api/v1/analytics', // 上报 / 规则地址前缀
  debug: true
})
  1. 页面 onShow 上报 $page_view(开启 autoPageView 时会自动补发上一页 $page_leave):
onShow(() => {
  track.pageView()
})
  1. 业务自定义事件与点击 / 曝光埋点:
track.track('demo.click', { source: 'home' } as UTSJSONObject)
track.trackClick('btn-buy', 'button')
track.trackExposure('card-sku-1', 'card')

遵循 data-track-id / data-track-type 约定可自动携带 elem_id / elem_type。

更多 API、采集协议与治理配置见 Track 数据埋点。

智能客服(reglow-cs-sdk)

reglow-cs-sdk 提供开箱即用的 <re-cs-chat /> 组件与无 UI 核心层 createCsSdk,支持 App / H5 / 微信小程序,聊天协议与 Web 版 @reglow/customer-service 同源。依赖 reglow-review(easycom 复用其 re-icon / re-button / re-empty / re-dialog / re-fab 基础组件)。

  1. 在任意页面直接使用组件(pages.json 已开启 easycom.autoscan):
<re-cs-chat app-id="your-app-id" api-base="/api/v1" visitor-name="微信用户" primary-color="#4f46e5" />
  1. 无 UI 接入(自定义界面):
import { createCsSdk } from '@/uni_modules/reglow-cs-sdk/utssdk/index.uts'

const sdk = createCsSdk({
  appId: 'your-app-id',
  apiBase: '/api/v1',
  onEvent: (event) => {
    // ready / session / stream / done / transfer / agent_online / error ...
  }
})
sdk.init()
sdk.send('你好')

H5 端支持 SSE 实时流式逐字回复;App / 小程序端自动降级为一次性拉取(功能不缺失,仅非实时)。

更多 Props、事件与聊天协议见 CsSdk 智能客服。