# react-jwchat

**Repository Path**: wx_504ae56474/react-jwchat

## Basic Information

- **Project Name**: react-jwchat
- **Description**: react-jwchat是一个基于React实现的web聊天组件。💁‍♂️💁‍♂️💁‍♂️
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://sirosong.github.io/react-jwchat
- **GVP Project**: No

## Statistics

- **Stars**: 498
- **Forks**: 114
- **Created**: 2021-01-08
- **Last Updated**: 2026-09-10

## Categories & Tags

**Categories**: react-extensions

**Tags**: React, 聊天, 在线聊天, TypeScript

## README

# react-jwchat

[![NPM version](https://img.shields.io/npm/v/react-jwchat.svg?style=flat)](https://npmjs.org/package/react-jwchat)
[![NPM downloads](http://img.shields.io/npm/dm/react-jwchat.svg?style=flat)](https://npmjs.org/package/react-jwchat)

![npm type definitions](https://img.shields.io/npm/types/react-jwchat?style=for-the-badge)
![npm](https://img.shields.io/npm/v/react-jwchat?style=for-the-badge&color=yellowgreen)
![npm bundle size](https://img.shields.io/bundlephobia/min/react-jwchat?color=success&style=for-the-badge)
![npm](https://img.shields.io/npm/dw/react-jwchat?style=for-the-badge&color=yellow)
![NPM](https://img.shields.io/npm/l/react-jwchat?color=orange&style=for-the-badge)

react-jwchat 是一个简单的 web 聊天组件。react-jwchat is a simple web chat component.

主要作用是为快速实现在线聊天功能的前端页面。

主要组件（暂时）包含聊天组件、联系人列表组件、单个联系人组件。

**_如果你也喜欢开源，如果你也喜欢这个项目请留下你的 Star 🌟，你们的 🌟 是对作者最大的鼓励，或者留下你的代码我们一起让他变得更好~~~_**

![](https://files.catbox.moe/0xp47m.png)

## Usage

```bash
npm install react-jwchat
# or
yarn add react-jwchat
# or
pnpm add react-jwchat
```

```tsx
import { Chat, IMessage } from "react-jwchat"
// 若打包器不处理依赖内的 css import，手动引入：
// import "react-jwchat/style.css"

export default function App() {
  const [chatList, setChatList] = useState<IMessage[]>([])

  return (
    <Chat
      me={{ id: 1, nickname: "me", avatar: "..." }}
      contact={{ id: 2, nickname: "friend", avatar: "..." }}
      chatList={chatList}
      onSend={(msg) => setChatList([...chatList, msg])}
    />
  )
}
```

## Theming / 主题定制

所有颜色都是 CSS 变量，覆盖同名变量即可换肤。**使用方不需要安装 tailwindcss** —— `react-jwchat/style.css` 是预编译好的普通 CSS，tailwindcss 只是本库的构建期依赖。

```css
@import "react-jwchat/style.css";

:root {
  --color-jw-primary: #7c3aed; /* 发送按钮、图标 hover */
  --color-jw-primary-active: #6d28d9;
  --color-jw-bubble: #ddd6fe; /* 消息气泡 */
}
```

变量会继承，所以挂在任意祖先元素上就能做局部换肤 / 多主题共存，内联样式的优先级最高：

```tsx
<div style={{ "--color-jw-primary": "#7c3aed" } as React.CSSProperties}>
  <Chat ... />
</div>
```

完整变量清单（13 个，含深色模式示例）见 [主题定制文档](https://sirosong.github.io/react-jwchat/theme)。

## Development

```bash
# install dependencies
$ yarn install

# develop library by docs demo
$ yarn start

# build library source code
$ yarn build

# build library source code in watch mode
$ yarn build:watch

# build docs
$ yarn docs:build

# check your project for potential problems
$ yarn doctor
```

## LICENSE

MIT