Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fphilipe/phfcomposebarview
Compose bar from iOS 7 Messages.app
https://github.com/fphilipe/phfcomposebarview
cocoapod component ios uiview
Last synced: 29 days ago
JSON representation
Compose bar from iOS 7 Messages.app
- Host: GitHub
- URL: https://github.com/fphilipe/phfcomposebarview
- Owner: fphilipe
- License: mit
- Created: 2013-05-07T12:32:18.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2021-02-11T00:26:03.000Z (almost 4 years ago)
- Last Synced: 2024-10-15T03:40:24.168Z (29 days ago)
- Topics: cocoapod, component, ios, uiview
- Language: Objective-C
- Homepage:
- Size: 439 KB
- Stars: 1,180
- Watchers: 48
- Forks: 206
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# PHFComposeBarView
More screenshots: [without text](Screenshots/empty.png) and [with
text](Screenshots/text.png).
***
This is a precise reconstruction of the compose bar from the iOS Messages.app,
mimicking the behaviors and graphics while also allowing you to customize many
aspects of it.
It basically consists of a text view, a placeholder label, a utility
button located to the left of the text view, and a main button located to the
right of the text view.
If you're looking for something that works with iOS 5 and 6 featuring the old
look and feel, have a look at [version
1.1.1](https://github.com/fphilipe/PHFComposeBarView/tree/v1.1.1).
## Features
- title of main button (the one on the right) can be changed
- tint color of main button can be changed
- title of the placeholder can be changed
- placeholder is exposed as a property for further customization
- text view is exposed as a property for further customization
- utility button (the one on the left) can be shown by setting the utility
button image (best results for gray images (~56% white) on transparent
background with up to 50pt side length)
- optional character counter when specifying a max character count (similar to
typing an SMS in Messages.app; the max char count limit is not imposed)
- uses delegation to notify of button presses
- forwards delegation methods from the text view
- automatically grows when text wraps
- posts notifications and sends delegate messages about frame changes before and
after the change so you can adjust your view setup
- by default grows upwards, alternatively downwards
- max height for growth can be specified in terms of points or line numbers
- has a translucent blurred background
## Installation
The prefered way is to use [CococaPods](http://cocoapods.org).
```ruby
pod 'PHFComposeBarView', '~> 2.0.1'
```
If you can't use CocoaPods for some reason (you really should though, it's the
cool kid on the block), then grab the files in `Classes/` and put it in your
project. The code uses ARC, so make sure to turn that on for the files if you're
not already using ARC. There's a dependency on
[`PHFDelegateChain`](https://github.com/fphilipe/PHFDelegateChain), so make sure
to add that to your project, too.
## Usage
The compose bar visible in the demo above was created as follows:
```objectivec
CGRect viewBounds = [[self view] bounds];
CGRect frame = CGRectMake(0.0f,
viewBounds.size.height - PHFComposeBarViewInitialHeight,
viewBounds.size.width,
PHFComposeBarViewInitialHeight);
PHFComposeBarView *composeBarView = [[PHFComposeBarView alloc] initWithFrame:frame];
[composeBarView setMaxCharCount:160];
[composeBarView setMaxLinesCount:5];
[composeBarView setPlaceholder:@"Type something..."];
[composeBarView setUtilityButtonImage:[UIImage imageNamed:@"Camera"]];
[composeBarView setDelegate:self];
```
To get notified of button presses, implement the optional methods from the
`PHFComposeBarViewDelegate` protocol:
```objectivec
- (void)composeBarViewDidPressButton:(PHFComposeBarView *)composeBarView;
- (void)composeBarViewDidPressUtilityButton:(PHFComposeBarView *)composeBarView;
```
To get notified of frame changes, either listen to the notifications
(`PHFComposeBarViewDidChangeFrameNotification` and
`PHFComposeBarViewWillChangeFrameNotification`) or implement the optional
delegate methods:
```objectivec
- (void)composeBarView:(PHFComposeBarView *)composeBarView
willChangeFromFrame:(CGRect)startFrame
toFrame:(CGRect)endFrame
duration:(NSTimeInterval)duration
animationCurve:(UIViewAnimationCurve)animationCurve;
- (void)composeBarView:(PHFComposeBarView *)composeBarView
didChangeFromFrame:(CGRect)startFrame
toFrame:(CGRect)endFrame;
```
Note that all methods from the `UITextViewDelegate` protocol are forwarded, so
you can add your own behavior to the text view such as limiting the text length
etc.
Refer to [`PHFComposeBarView.h`](Classes/PHFComposeBarView.h) for the available
properties and their descriptions.
## Small Print
### License
`PHFComposeBarView` is released under the MIT license.
### Dependencies
- [`PHFDelegateChain`](https://github.com/fphilipe/PHFDelegateChain)
### Author
Philipe Fatio ([@fphilipe](http://twitter.com/fphilipe))
### Sponsors
These people and companies have sponsored the development so far:
- [Liveminds](https://liveminds.com) ([\#64](https://github.com/fphilipe/PHFComposeBarView/pull/64))