Skip to content

Commit 965a329

Browse files
committed
Docs updated
1 parent f0bd11a commit 965a329

File tree

3 files changed

+76
-59
lines changed

3 files changed

+76
-59
lines changed

CHANGELOG.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,7 @@
1+
## [1.0.0]
2+
3+
- Minor fixes and first release
4+
15
## [0.1.6]
26

37
- LoadEarlier Widget functionality added

README.md

Lines changed: 68 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,27 @@
11
<p align="center">
2-
<img src="https://media.giphy.com/media/LROJNHp7VquVer90gm/giphy.gif" />
3-
<h1 align="center">💬 Dash Chat</h1>
2+
<img src="https://media.giphy.com/media/ghBkB5BHQgdhamZ2WA/giphy.gif" />
3+
<h1 align="center" style="font-size: 48px;">💬 Dash Chat</h1>
44
<h5 align="center">The most complete Chat UI for flutter</h5>
55
<p align="center">Inspired by <a href="https://github.com/FaridSafi/react-native-gifted-chat">react-native-gifted-chat.</a>
66
Highly customizable and helps developing chat UI faster.
77
</p>
88
</p>
99

10-
### Usage 💻
10+
## Usage 💻
1111

1212
To use this package, add `dash_chat` as a [dependency in your pubspec.yaml file](https://flutter.io/platform-plugins/).
1313

14-
### Features 🔮
14+
## Features 🔮
1515

1616
- Fully customizable components
1717
- Copy messages to clipboard
1818
- Multi-line TextInput
1919
- Touchable links using [flutter_parsed_text](https://pub.dev/packages/flutter_parsed_text)
20-
- Avatar as user's initials - WIP
21-
- Quick Reply messages - WIP
22-
- Load earlier messages -WIP
23-
- Scroll to bottom - WIP
24-
- System message - WIP
25-
- Composer actions (to attach photos, etc.) -WIP
20+
- Avatar as user's initials
21+
- Quick Reply messages
22+
- Load earlier messages
23+
- Scroll to bottom Widget
24+
- Composer actions (to attach photos, etc.) - WIP
2625

2726
### Message object 📦
2827
> example, Chat Message
@@ -59,38 +58,47 @@ ChatMessage(
5958
),
6059
```
6160

62-
### Parameters ⚙️
61+
## Parameters ⚙️
6362

64-
- `messageContainerFlex` (int) - Flex value for the messeage container defaults to 1
65-
- `height` (double) - Height for the Dash chat Widget
66-
- `width` (double) - Width for the Dash chat Widget
67-
- `messages` (List<ChatMessage>) - List of messages to display in the chat
68-
- `text` (String) - [optional parameter] If provided will stop using the default controller
63+
- `messageContainerFlex` (int) - Flex value for the messeage container defaults to `1`
64+
- `height` (double) - Height for the Dash chat Widget.
65+
- `width` (double) - Width for the Dash chat Widget.
66+
- `messages` (List<ChatMessage>) - List of messages to display in the chat.
67+
- `text` (String) - [optional parameter] If provided will stop using the default controller.
6968
- `onTextChange` (Function(String)) - If the text parameter is passed then onTextChange must also be passed.
70-
- `inputDecoration` (InputDecoration) - Used to provide input decoration to the text
71-
- `messageIdGenerator` (String Function) - Usually new message added by the user gets UUID v4 String generater by [uuid](https://pub.dev/packages/uuid)
72-
- `user` (ChatUser) - The current user object
73-
- `onSend` (Function(ChatMessage)) - Callback when sending a message
74-
- `alwaysShowSend` (bool) - Should the send button be always active defaults to false
75-
- `dateFormat` (DateFormat) - Format to use for rendering date default is `yyyy-MM-dd`
76-
- `timeFormat` (DateFormat) - Format to use for rendering time default is `HH:mm:ss`
77-
- `showUserAvatar` (bool) - Should the user avatar be shown
78-
- `showAvatarForEveryMessage` (bool) - Should the avatar be shown for every message defaulst to false
69+
- `inputDecoration` (InputDecoration) - Used to provide input decoration to the text.
70+
- `messageIdGenerator` (String Function) - Usually new message added by the user gets UUID v4 String generater by [uuid](https://pub.dev/packages/uuid).
71+
- `user` (ChatUser) - The current user object.
72+
```dart
73+
DashChat(
74+
user: ChatUser(
75+
name: "Jhon Doe",
76+
uid: "xxxxxxxxx",
77+
avatar: "https://www.wrappixel.com/ampleadmin/assets/images/users/4.jpg",
78+
)
79+
);
80+
```
81+
- `onSend` (Function(ChatMessage)) - Callback when sending a message.
82+
- `alwaysShowSend` (bool) - Should the send button be always active defaults to false.
83+
- `dateFormat` (DateFormat) - Format to use for rendering date default is `yyyy-MM-dd`.
84+
- `timeFormat` (DateFormat) - Format to use for rendering time default is `HH:mm:ss`.
85+
- `showUserAvatar` (bool) - Should the user avatar be shown.
86+
- `showAvatarForEveryMessage` (bool) - Should the avatar be shown for every message defaults to false.
7987
- `onPressAvatar` (Function(ChatUser)) - Callback funtion when avatar is tapped on.
8088
- `onLongPressAvatar` (Function(ChatUser)) - Callback funtion when avatar is long pressed on.
8189
- `onLongPressMessage` (Function(ChatUser)) - Callback funtion when message is long pressed on.
8290
- `inverted` (bool) - Should the messages be shown in reversed order
83-
- `avatarBuilder` (Widget Function(ChatUser)) - Will override the the default avatar
84-
- `messageBuilder` (Widget Function(ChatMessage)) - Will override the the default message widget
85-
- `messageTextBuilder` (Widget Function(String)) - Will override the the default message text widget
91+
- `avatarBuilder` (Widget Function(ChatUser)) - Will override the the default avatar.
92+
- `messageBuilder` (Widget Function(ChatMessage)) - Will override the the default message widget.
93+
- `messageTextBuilder` (Widget Function(String)) - Will override the the default message text widget.
8694
- `messageImageBuilder` (Widget Function(String)) - Will override the the default message imaeg widget
87-
- `messageTimeBuilder` (Widget Function(String)) - Will override the the default message time widget
88-
- `dateBuilder` (Widget Function(String)) - Will override the the default chat view date widget
89-
- `sendButtonBuilder` (Widget Function(Function)) - Will override the the default send button widget
95+
- `messageTimeBuilder` (Widget Function(String)) - Will override the the default message time widget.
96+
- `dateBuilder` (Widget Function(String)) - Will override the the default chat view date widget.
97+
- `sendButtonBuilder` (Widget Function(Function)) - Will override the the default send button widget.
9098
- `chatFooterBuilder` (Widget Function) - A Widget that will be shown below the MessageListView like you can a "tying..." Text Widget at the end.
91-
- `inputFooterBuilder` (Widget Function) - A Widget that will be shown below the ChatInputToolbar
92-
- `maxInputLength` (int) - Main input length of the input text box defaulst to no limit
93-
- `parsePatterns` (List<MatchText>) - Used to parse text to make a linkified text uses [flutter_parsed_text](https://pub.dev/packages/flutter_parsed_text)
99+
- `inputFooterBuilder` (Widget Function) - A Widget that will be shown below the ChatInputToolbar.
100+
- `maxInputLength` (int) - Main input length of the input text box defaulst to no limit.
101+
- `parsePatterns` (List<MatchText>) - Used to parse text to make a linkified text uses [flutter_parsed_text](https://pub.dev/packages/flutter_parsed_text).
94102
```dart
95103
DashChat(
96104
parsePatterns: <MatchText>[
@@ -109,20 +117,21 @@ ChatMessage(
109117
]
110118
);
111119
```
112-
- `messageContainerDecoration` (BoxDecoration) - Provides a custom style to the message container
113-
- `leading` (List<Widget>) - List of Widget to show before the TextField
114-
- `trailing` (List<Widget>) - List of Widget to show after the TextField will remove the send button
115-
- `inputTextStyle` (TextStyle) - Style for the TextField
116-
- `inputContainerStyle` (BoxDecoration) - TextField container style
117-
- `inputMaxLines` (int) - Max length of the input lines default to 1
118-
- `showInputCursor` (bool) - Should the input cursor be shown defaults to true
119-
- `inputCursorWidth` (double) - Width of the text input defaults to 2.0
120-
- `inputCursorColor` (Color) - Color of the input cursor defaults to theme
121-
- `scrollController` (ScrollController) - ScrollController for the MessageListView
122-
- `messageContainerPadding` (EdgeInsetsGeometry) - Padding for the MessageListView
123-
- `onQuickReply` (Funtion(Reply)) - Callback method when the quickReply was tapped on
124-
- `quickReplyStyle` (BoxDecoration) - Container style for the QuickReply Container
125-
- `quickReplyTextStyle` (TextStyle) - QuickReply text style
120+
- `messageContainerDecoration` (BoxDecoration) - Provides a custom style to the message container.
121+
- `leading` (List<Widget\>) - List of Widget to show before the TextField.
122+
- `trailing` (List<Widget\>) - List of Widget to show after the TextField will remove the send button.
123+
- `showTraillingBeforeSend` - Should the trailling widgets be shown before the send button defaults to `true`.
124+
- `inputTextStyle` (TextStyle) - Style for the TextField.
125+
- `inputContainerStyle` (BoxDecoration) - TextField container style.
126+
- `inputMaxLines` (int) - Max length of the input lines default to 1.
127+
- `showInputCursor` (bool) - Should the input cursor be shown defaults to true.
128+
- `inputCursorWidth` (double) - Width of the text input defaults to 2.0.
129+
- `inputCursorColor` (Color) - Color of the input cursor defaults to theme.
130+
- `scrollController` (ScrollController) - ScrollController for the MessageListView.
131+
- `messageContainerPadding` (EdgeInsetsGeometry) - Padding for the MessageListView.
132+
- `onQuickReply` (Funtion(Reply)) - Callback method when the quickReply was tapped on.
133+
- `quickReplyStyle` (BoxDecoration) - Container style for the QuickReply Container.
134+
- `quickReplyTextStyle` (TextStyle) - QuickReply text style.
126135
- `quickReplyBuilder` (Widget Function(Reply)) - Will override the the default QuickReply Widget.
127136
- `scrollToBottom` (bool) - Should the scroll to bottom widget be shown defaults to `true`.
128137
- `scrollToBottomWidget` (Widget Function()) - Overrides the default scrollToBottomWidget with a custom widget.
@@ -131,14 +140,18 @@ ChatMessage(
131140
- `showLoadEarlierWidget` (Widget Function()) - Override the default behaviour of the onScrollToBottom Widget.
132141
- `onLoadEarlier` (Function) - Override the default behaviour of the onLoadEarleir Widget or used as a callback when the listView reaches the top.
133142

134-
### License ⚖️
135-
- [MIT](https://github.com/fayeed/dash_chat/blob/master/LICENSE)
143+
## Credits 👨🏻‍💻
144+
- Transparent Image - [Brian Egan](https://github.com/brianegan)
145+
- uuid - [Yulian Kuncheff](https://github.com/Daegalus)
136146

137-
### API details 📝
147+
## Found this project useful? ❤️
148+
If you found this project useful, then please consider giving it a ⭐️ on Github and sharing it with your friends via social media.
138149

139-
See the [dash_chat.dart](https://github.com/fayeed/dash_chat/blob/master/lib/dash_chat.dart) for more API details
150+
## License ⚖️
151+
- [MIT](https://github.com/fayeed/dash_chat/blob/master/LICENSE)
140152

141-
### Issues and feedback 💭
153+
## API details 📝
154+
See the [dash_chat.dart](https://github.com/fayeed/dash_chat/blob/master/lib/dash_chat.dart) for more API details
142155

143-
Please file [issues](https://github.com/fayeed/dash_chat/issues)
144-
to send feedback or report a bug. Thank you!
156+
## Issues and feedback 💭
157+
If you have any suggestion for including a feature or if something doesn't work, feel free to open a Github [issue](https://github.com/fayeed/dash_chat/issues) for us to have a discussion on it.

pubspec.yaml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
name: dash_chat
2-
description: A new Flutter package project.
3-
version: 0.1.6
4-
author:
5-
homepage:
2+
description: The most complete Chat UI for flutter.
3+
version: 1.0.0
4+
author: "fayeed <fayeed@live.com>"
5+
homepage: https://github.com/fayeed/dash_chat
66

77
environment:
88
sdk: ">=2.2.2 <3.0.0"

0 commit comments

Comments
 (0)