A community-driven replacement for JSQMessagesViewController https://messagekit.github.io
Swift 5.3 in Xcode 12 added support for assets in Swift Packages. You can just add MessageKit package to your project by entering it's repository URL
https://github.com/MessageKit/MessageKit
Older versions of Swift and Xcode don't support MessageKit via SPM.
For iOS 12 or CocoaPods please use version 3.8.0
For iOS 11 please use version 3.3.0
For iOS 9 and iOS 10 please use version 3.1.1
Each default cell is a subclass of MessageContentCell
which has 7 parts. From top down we have a: cellTopLabel
, messageTopLabel
, messageContainerView
, messageBottomLabel
, cellBottomLabel
with the avatarView
and accessoryView
on either side respectively. Above we see the basic TextMessageCell
which uses a MessageLabel
as its main content.
This structure will allow you to create a layout that suits your needs as you can customize the size, appearance and padding of each. If you need something more advanced you can implement a custom cell, which we show how to do in the Example project.
The InputBarAccessoryView
, 3rd party dependency from InputBarAccessoryView is a flexible and robust way of creating any kind of input layout you wish. Check the repo and examples there for more info.
Please have a look at the Quick Start guide and the FAQs.
We recommend you start by looking at the Example project or write a question with the "messagekit" tag on Stack Overflow. You can also look at previous issues here on GitHub with the "Question" tag.
For more on how to use the MessageInputBar, see the dependency it is based on InputBarAccessoryView. You can also see this short guide
The type of cell rendered for a given message is based on the MessageKind
public enum MessageKind {
case text(String) // TextMessageCell
case attributedText(NSAttributedString) // TextMessageCell
case photo(MediaItem) // MediaMessageCell
case video(MediaItem) // MediaMessageCell
case location(LocationItem) // LocationMessageCell
case emoji(String) // TextMessageCell
case audio(AudioItem) // AudioMessageCell
case contact(ContactItem) // ContactMessageCell
case linkPreview(LinkItem) // LinkPreviewMessageCell
/// A custom message.
/// - Note: Using this case requires that you implement the following methods and handle this case:
/// - MessagesDataSource: customCell(for message: MessageType, at indexPath: IndexPath, in messagesCollectionView: MessagesCollectionView) -> UICollectionViewCell
/// - MessagesLayoutDelegate: customCellSizeCalculator(for message: MessageType, at indexPath: IndexPath, in messagesCollectionView: MessagesCollectionView) -> CellSizeCalculator
case custom(Any?)
}
If you choose to use the .custom
kind you are responsible for all of the cells layout. Any UICollectionViewCell
can be returned for custom cells which means any of the styling you provide from the MessageDisplayDelegate
will not effect your custom cell. Even if you subclass your cell from MessageContentCell
.
Read more about custom cells
Read more about the cases on the Quick Start guide.
Great! Look over these things first.
Check out the Releases to see what we are working on next.
Have a question or an issue about MessageKit? Create an issue!
Interested in contributing to MessageKit? Click here to join our Slack.
Add your app to the list of apps using this library and make a pull request.
Please provide attribution, it is greatly appreciated.
Many thanks to the contributors of this project.
MessageKit is released under the MIT License.
Inspired by JSQMessagesViewController :point_left: :100:
link |
Stars: 5172 |
Last commit: 5 days ago |
iOS 12 has been around for a while, but with upcoming WWDC, we are ready to let this version go and rest in peace forever. The same could be said about CocoaPods - what used to be the major and most important thing on iOS for developing apps with 3rd party libraries - has been replaced by natively supported way called Swift Package Manager.
Sit tibi terra levis.
See MIGRATION_GUIDE.md for migration to the new V4.
maintainPositionOnKeyboardFrameChangedMoved
in favor of maintainPositionOnInputBarHeightChanged
which better describes the intended use of this property #1704 by @martinpucikmessageContainerMaxWidth
cd4f75b by @martinpucik
MessageSizeCalculator.messageContainerMaxWidth(for message: MessageType) -> CGFloat
now has IndexPath argument
MessageSizeCalculator.messageContainerMaxWidth(for message: MessageType, at indexPath: IndexPath) -> CGFloat
messageContainerSize
cd4f75b by @martinpucik
MessageSizeCalculator.messageContainerSize(for message: MessageType) -> CGSize
now has IndexPath argument
MessageSizeCalculator.messageContainerSize(for message: MessageType, at indexPath: IndexPath) -> CGSize
MessagesLayoutDelegate
for setting message avatar size ddfc814 by @martinpucikMessageInputBarKind
enum for customizing messageInputBar
inside inputContainerView
#1707 by @martinpucikSwiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics