跳到主要内容

安装与宿主

安装​

npm install @unif/react-native-chat @unif/react-native-design @unif/react-native-icons @callstack/liquid-glass@^0.8.2

图标直接使用 @unif/react-native-icons 的命名组件;ChatAction、SuggestionItem 与 ProcessStep 的 icon 参数传入组件本身。Design 必须采用已支持组件输入的正式版本,最低版本以 package.json 的 peerDependencies 为准。应用还需按 Design 的公开要求配置 Logger、Liquid Glass、Gesture Handler、Reanimated、Safe Area Context 与 SVG 等依赖;已接入 Design 的应用复用现有宿主。

当前 Design peer 为 ^1.19.1,Liquid Glass peer 为 >=0.8.2 <0.9.0。iOS 安装或升级原生依赖后重新执行 pod install 并重建应用。

应用宿主​

import { GestureHandlerRootView } from 'react-native-gesture-handler';
import { SafeAreaProvider } from 'react-native-safe-area-context';
import { ThemeProvider } from '@unif/react-native-design';

<GestureHandlerRootView style={{ flex: 1 }}>
<SafeAreaProvider>
<ThemeProvider>
<YourScreen />
</ThemeProvider>
</SafeAreaProvider>
</GestureHandlerRootView>;

Chat 不需要单独的 Provider,也不创建消息服务。页面或窗口保留挂载时,可由宿主用 Design 的 MotionScope active={visible} 暂停不可见范围的等待圆点、语音波形与加载指示;它不取消业务或语音操作。明暗主题和应用字号由同一个 Design ThemeProvider 提供,组件会消费其公开能力。

页面布局​

MessageList 需要有界高度。由页面或抽屉宿主统一处理键盘避让和安全区,避免重复补偿;Composer 交付输入区高度但不自行抬升键盘。

主聊天展示消息与输入的组合,抽屉输入展示不依赖消息列表的独立输入区。

共同操作​

消息操作、输入扩展操作、附件动作、过程动作与反馈按钮共享 ChatAction。disabled 或 loading 时阻止点击;按钮状态和业务防重复分别由 UI 与消费者处理。

查看完整 TypeScript 类型

以下内容由包根公开类型生成,与当前源码保持一致。

import type { ComponentType } from 'react';

import type { IconProps } from '@unif/react-native-icons';

export interface ChatAction {
id: string;
label: string;
icon?: ComponentType<IconProps>;
disabled?: boolean;
loading?: boolean;
accessibilityHint?: string;
onPress(): void;
}

组件回调交付用户操作,应用负责异步结果与下一次状态更新。草稿、文件上传、Agent / SSE、确认有效性与业务提交留在应用中。

示例与平台验证​

文档站的预览使用真实 Chat 与 Design 组件,在浏览器中可切换明暗主题、示例字号并重置本地状态。示例中的消息和结果记录是本地交互,不连接业务服务。

原生 example 位于仓库 example/。原生键盘、手势、图片加载与设备字体仍需在对应平台验证,浏览器预览不能替代设备验收。