搜索插件、代码仓与 APP 分类

GitHub 代码仓SebastienBtr/Dash-Chat-2

Dash-Chat-2

Flutter 最完整的聊天 UI。易于使用、高度可定制且功能齐全

Dash-Chat-2 项目封面
星标
252
复刻
164
最近推送(UTC)
2024年7月29日
项目状态
未归档

原始 README

以下为英文项目原文快照,最新内容请访问 GitHub。

The most complete Chat UI for flutter

Easy to use, highly customizable and fully featured

License Pub version Contributors

Features

  • Fully customizable components
  • Multi-line TextInput
  • Touchable links using flutter_parsed_text
  • Markdown support using flutter_markdown
  • Avatar as user's initials or profile picture
  • Quick Reply messages
  • Load earlier messages
  • Scroll to bottom Widget
  • Multiple media support (Audio support: WIP)
  • @ Mention users (or anything else)
  • Typing users
  • Reply to messages - WIP
  • Message status - WIP

You need another feature? you can use the customProperties field of the models, it allows you to pass other data to the library that you can then use inside custom builders to implement any feature you need.

Of course, if you think this feature can be useful to other people, feel free to open an issue/pull-request to discuss including it "natively" in the package.

Basic Usage

import 'package:dash_chat_2/dash_chat_2.dart';
import 'package:flutter/material.dart';

class Basic extends StatefulWidget {
  @override
  _BasicState createState() => _BasicState();
}

class _BasicState extends State<Basic> {
  ChatUser user = ChatUser(
    id: '1',
    firstName: 'Charles',
    lastName: 'Leclerc',
  );

  List<ChatMessage> messages = <ChatMessage>[
    ChatMessage(
      text: 'Hey!',
      user: user,
      createdAt: DateTime.now(),
    ),
  ];

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Basic example'),
      ),
      body: DashChat(
        currentUser: user,
        onSend: (ChatMessage m) {
          setState(() {
            messages.insert(0, m);
          });
        },
        messages: messages,
      ),
    );
  }
}

You can run the example project to see more complex ways of using the package

Parameters of DashChat

  • ChatUser currentUser - required: Basically "you", we need to know who is the current user to put their messages to right side

  • Function(ChatMessage message) onSend - required: Function to call when the user sends a message, that's where you handle the logic to send the message to your backend and append the list of messages

  • List<ChatMessage> messages - required: The list of messages of the channel, you would usually not load all the messages at once but use the onLoadEarlier param of MessageListOptions to trigger a lazy loading

  • InputOptions inputOptions - optional: Options to customize the behaviour and design of the chat input

  • MessageOptions messageOptions - optional: Options to customize the behaviour and design of the messages

  • MessageListOptions messageListOptions - optional: Options to customize the behaviour and design of the overall list of message

  • QuickReplyOptions quickReplyOptions - optional: Options to customize the behaviour and design of the quick replies

  • ScrollToBottomOptions scrollToBottomOptions - optional: Options to customize the behaviour and design of the scroll-to-bottom button

  • readOnly - optional (default to false): Option to make the chat read only, it will hide the input field

  • List<ChatUser> typingUsers - optional: List of users currently typing in the chat

Full documentation

You can browse the full Dart documentation here: Documentation

Found this project useful?

If you found this project useful, then please consider giving it a ⭐️ on Github: https://github.com/SebastienBtr/Dash-Chat-2

Issues and feedback

If you have any suggestions for including a feature or if something doesn't work, feel free to open a Github issue or to open a pull request, you are more than welcome to contribute!

Contributors

SebastienBtr
SebastienBtr

💻 🎨
chuusungmin
chuusungmin

💻
fufesou
fufesou

💻
Nwachi ifeanyichukwu Victor
Nwachi ifeanyichukwu Victor

💻
Kaede Games
Kaede Games

💻
Derek Pitts
Derek Pitts

💻
Alex Fernandez
Alex Fernandez

💻
lawrence
lawrence

💻
Md. Al-Amin
Md. Al-Amin

💻
TPF
TPF

💻

Credits

Thanks to Fayeed who created the v1 of this package: https://github.com/fayeed/dash_chat and made that possible!

SebastienBtr GitHub avatar
GitHub 作者

SebastienBtr ↗

PleekFrance
语言DartHTMLRubySwiftKotlinObjective-C

分类

此仓库发布的插件

使用的依赖

依赖清单 9 项

如何选择适合项目的代码仓?

先按使用场景筛选,再比较项目活跃情况,最后到原始仓库核对使用要求。

  1. 通过仓库名、作者或描述搜索,再按技术分类缩小范围。
  2. 结合星标、复刻与最近推送比较项目;星标反映社区关注,不代表质量保证。
  3. 使用前在 GitHub 核对 README、许可证与 Issues。

来源与维护

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗