alibaba/ChatUI - Githubissues

The UI design language and React library for Conversational UI

[![LICENSE](https://img.shields.io/npm/l/@chatui/core?style=flat-square)](https://github.com/alibaba/ChatUI/blob/master/LICENSE) [![NPM version](https://img.shields.io/npm/v/@chatui/core?style=flat-square)](https://www.npmjs.com/package/@chatui/core) [![NPM downloads](https://img.shields.io/npm/dm/@chatui/core?style=flat-square)](https://www.npmjs.com/package/@chatui/core) [![Gzip Size](https://img.badgesize.io/https://unpkg.com/@chatui/core@0.1.0/dist/index.js?compression=gzip)](https://unpkg.com/@chatui/core@0.1.0/dist/index.js) [![Jsdelivr Hits](https://img.shields.io/jsdelivr/npm/hm/@chatui/core?style=flat-square)](https://cdn.jsdelivr.net/npm/@chatui/core)

English | 简体中文

Features

😎 Best Practices: The best practice for chat interaction based on our experience of Alime Chatbot
🛡 TypeScript: Written in TypeScript with predictable static types
📱 Responsive: Responsive design to adapt automatically to whatever device
♿ Accessibility: Accessibility support and get the certification from Accessibility Research Association
🎨 Theming: Powerful theme customization in every detail
🌍 International: Internationalization support for dozens of languages

Environment Support

Modern browsers (support CSS Variables)
Internet Explorer 11 (with polyfills and CSS Variables Polyfill / css-vars-ponyfill)

Edge	Firefox	Chrome	Safari	iOS Safari	Android WebView
16+	31+	49+	9.1+	9.3+	6+

Install

npm install @chatui/core --save

yarn add @chatui/core

Usage

import Chat, { Bubble, useMessages } from '@chatui/core';
import '@chatui/core/dist/index.css';

const App = () => {
  const { messages, appendMsg, setTyping } = useMessages([]);

  function handleSend(type, val) {
    if (type === 'text' && val.trim()) {
      appendMsg({
        type: 'text',
        content: { text: val },
        position: 'right',
      });

      setTyping(true);

      setTimeout(() => {
        appendMsg({
          type: 'text',
          content: { text: 'Bala bala' },
        });
      }, 1000);
    }
  }

  function renderMessageContent(msg) {
    const { content } = msg;
    return <Bubble content={content.text} />;
  }

  return (
    <Chat
      navbar={{ title: 'Assistant' }}
      messages={messages}
      renderMessageContent={renderMessageContent}
      onSend={handleSend}
    />
  );
};

Development

cd demo
npm i
npm run dev

Theme

Visit Customize Theme for detail

Internationalization

Visit i18n for detail

Discussion

License

MIT

alibaba / ChatUI

readme