Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SebastianThiebaud/STTweetLabel
Deprecated - A UILabel with #hashtag @handle and links tappable
https://github.com/SebastianThiebaud/STTweetLabel
Last synced: 1 day ago
JSON representation
Deprecated - A UILabel with #hashtag @handle and links tappable
- Host: GitHub
- URL: https://github.com/SebastianThiebaud/STTweetLabel
- Owner: SebastianThiebaud
- License: mit
- Archived: true
- Created: 2012-12-16T04:47:35.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2016-05-09T13:13:04.000Z (over 8 years ago)
- Last Synced: 2024-10-31T15:38:31.575Z (13 days ago)
- Language: Objective-C
- Homepage:
- Size: 2.42 MB
- Stars: 654
- Watchers: 31
- Forks: 137
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - STTweetLabel - Deprecated - A UILabel with #hashtag @handle and links tappable (etc)
- awesome - STTweetLabel - Deprecated - A UILabel with #hashtag @handle and links tappable (etc)
README
[](http://cocoadocs.org/docsets/STTweetLabel)
[](http://cocoadocs.org/docsets/STTweetLabel)
[](https://travis-ci.org/SebastienThiebaud/STTweetLabel)
[](http://cocoadocs.org/docsets/STTweetLabel)
# STTweetLabel (not supported anymore)
A custom UILabel for iOS with certain words tappable like Twitter (#Hashtag, @Handle and links).
## Installation
Please use CocoaPods and include STTweetLabel in your Podfile.
Important: STTweetLabel 3.0 is based on TextKit and is only compatible with iOS 7 and above.
## Demo
Build and run the project STTweetLabelExample in Xcode to see `STTweetLabel` in action.
## Example Usage
``` objective-c
STTweetLabel *tweetLabel = [[STTweetLabel alloc] initWithFrame:CGRectMake(10.0, 60.0, 300.0, 160.0)];
[tweetLabel setText:@"Hi. This is a new tool for @you! Developed by @SebThiebaud for #iPhone #ObjC... and #iOS7 ;-) My GitHub page: https://t.co/pQXDoiYA"];
[self.view addSubview:tweetLabel];
```
Don't forget to implement the `detectionBlock`. Without implementing this block, you won't be able to detect if somebody has clicked on the hashtag, handle or even a link.
Blocks are easy. All you need to do is add a few lines of code:
``` objective-c
[tweetLabel setDetectionBlock:^(STTweetHotWord hotWord, NSString *string, NSString *protocol, NSRange range) {
// Do something
}];
```
## Properties
- `NSString *text`: The text to display.
- `NSArray *validProtocols`: All valid protocols for link (by default: `@[@"http", @"https"]`).
- `BOOL leftToRight`: Writing direction (by default: `YES`).
- `BOOL textSelectable`: Allows the user to select the text (by default: `YES`).
- `UIColor *selectionColor`: If `BOOL textSelectable` is enabled, it's the color of the selection's background (by default: `[UIColor colorWithWhite:0.9 alpha:1.0]`).
- `NSTextAlignment textAlignment`: Text alignment (by default: `NSTextAlignmentLeft`).
## Methods
**The two following methods refresh the component. That means you should only set the attributes at the initialization of your STTweetLabel instance.**
- `-[STTweetLabel setAttributes:(NSDictionary *)attributes]`: Dictionary with attributes for all text.
- `-[STTweetLabel setAttributes:(NSDictionary *)attributes hotWord:(STTweetHotWord)hotWord]`: Dictionary with attributes for specific STTweetHotWord.
- `-[STTweetLabel suggestedFrameSizeToFitEntireStringConstraintedToWidth:(CGFloat)width`: Returns the CGSize calculated for the text submitted.
## Credits
Inspired by the original Twitter application.
## Contact
Sebastien Thiebaud
- http://github.com/SebastienThiebaud
- http://twitter.com/SebThiebaud
## License
STTweetLabel is available under the MIT license.