signalapp/JSQMessagesViewController
signalapp/JSQMessagesViewController
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
[BREAKGLASS] Append-only mirror of github.com/signalapp/JSQMessagesViewController
748 Commits 22 Branches 47 Tags 17 MiB
Objective-C 99.6%
Ruby 0.4%
a60cf53e71
Go to file
Jesse Squires a60cf53e71 license
2014-05-01 21:27:41 -07:00
JSQMessages.xcodeproj stub out remaining unit tests 2014-04-29 20:16:03 -07:00
JSQMessages.xcworkspace new demo project. refactor and reorganize. remove old code and assets. ref: #172 2014-03-08 17:10:49 -08:00
JSQMessagesDemo change API to avoid using JSQMessage objects. per discussion in #172 2014-04-29 20:06:45 -07:00
JSQMessagesTests begin toolbar content view tests 2014-04-29 20:49:49 -07:00
JSQMessagesViewController fix #257 2014-05-01 20:52:01 -07:00
Screenshots new demo project. refactor and reorganize. remove old code and assets. ref: #172 2014-03-08 17:10:49 -08:00
.gitignore update ignore. use asset catalog in Xcode5. 2013-10-20 15:58:44 -07:00
.travis.yml simplify travis script and schemes 2014-04-24 21:52:57 -07:00
CONTRIBUTING.md contributing.md 2014-04-16 21:35:43 -07:00
JSQMessagesViewController.podspec update pod spec 2014-04-28 23:31:02 -07:00
LICENSE license 2014-05-01 21:27:41 -07:00
Podfile remove DAKeyboardControl 2014-04-06 12:27:40 -07:00
Podfile.lock remove DAKeyboardControl 2014-04-06 12:27:40 -07:00
README.md Update README.md 2014-05-01 21:26:30 -07:00

README.md

JSQMessagesViewController

An elegant messages UI framework for iOS

Build Status Version Status license MIT

Messages Screenshot 1     Messages Screenshot 2

More screenshots here

Features

  • Highly configurable & customizable
  • Data detectors
  • Timestamps
  • Avatars
  • Custom chat bubbles
  • Subtitles
  • Arbitrary message sizes
  • Copy & paste messages
  • Group chat
  • Smooth keyboard animations
  • UIDynamics for springy bubbles
  • Dynamic input text view resizing
  • Smooth animations
  • Universal

Requirements

Installation

pod 'JSQMessagesViewController'

Otherwise, drag the JSQMessagesViewController/ folder to your project. Install JSQSystemSoundPlayer and add the QuartzCore.framework.

NOTE:

This repo was formerly named MessagesTableViewController.

And this pod was formerly named JSMessagesViewController.

Getting Started

  • Demo project

    • There's a fucking sweet demo project: JSQMessages.xcworkspace.
    • Run pod install first.

  • Model

    • Your model objects should conform to the JSQMessageData protocol.
    • However, you may use the provided JSQMessage class.

  • View Controller

    • Subclass JSQMessagesViewController.
    • Implement the required methods in the JSQMessagesCollectionViewDataSource protocol.
    • Implement the required methods in the JSQMessagesCollectionViewDelegateFlowLayout protocol.

  • Customizing

    • The demo project is well-commented. This should help you configure your view however you like.

Documentation

Read the fucking documentation, available here via @CocoaDocs.

Contributing

Please follow these sweet contribution guidelines.

Donate

Support the development of this free, open-source framework! Donate via Square Cash.

Send $1 Just saying thanks!

Send $5 This control is great!

Send $10 This totally saved me time!

Send $25 I want new features!

Send $50 I love this project!

Credits

Created by @jesse_squires, a programming-motherfucker.

About

I initially developed this control to use in Hemoglobe for private messages between users.

As it turns out, messaging is a popular thing that iOS devs and users want. Thus, I am supporting this project in my free time and have added features way beyond what Hemoglobe ever needed.

Check out my work at Hexed Bits.

Apps Using This Control

License

JSQMessagesViewController is released under an MIT License. See LICENSE for details.

Copyright © 2014 Jesse Squires.

Please provide attribution, it is greatly appreciated.