Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adad184/MMPlaceHolder
A drop in solution to show UIView's size. Only one line code to use it.
https://github.com/adad184/MMPlaceHolder
Last synced: about 1 hour ago
JSON representation
A drop in solution to show UIView's size. Only one line code to use it.
- Host: GitHub
- URL: https://github.com/adad184/MMPlaceHolder
- Owner: adad184
- License: mit
- Created: 2014-08-11T03:19:11.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2015-10-20T01:40:44.000Z (over 8 years ago)
- Last Synced: 2024-06-18T20:19:01.747Z (4 days ago)
- Language: Objective-C
- Size: 2.87 MB
- Stars: 988
- Watchers: 34
- Forks: 137
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-stars - adad184/MMPlaceHolder - A drop in solution to show UIView's size. Only one line code to use it. (Objective-C)
- awesome-rank-1000 - MMPlaceHolder
README
MMPlaceHolder
=============
[]()
[]()
[]()
A drop in solution to set a placeholder or show UIView's size
[中文介绍](http://adad184.com/2014/08/21/kai-yuan-xiang-mu-mmplaceholder/)
you can use it for frame debug
or you can use it for size debug
Installation
============
The preferred way of installation is via [CocoaPods](http://cocoapods.org). Just add
```ruby
pod 'MMPlaceHolder'
```
and run `pod install`. It will install the most recent version of MMPlaceHolder.
If you would like to use the latest code of MMPlaceHolder use:
```ruby
pod 'MMPlaceHolder', :head
```
Usage
===============
simply, you only need one line code.
```objc
[yourView showPlaceHolder];
```
or you can customize youself.
```objc
@interface UIView(MMPlaceHolder)
- (void)showPlaceHolder;
- (void)showPlaceHolderWithAllSubviews;
- (void)showPlaceHolderWithAllSubviews:(NSInteger)maxDepth;
- (void)showPlaceHolderWithLineColor:(UIColor*)lineColor;
- (void)showPlaceHolderWithLineColor:(UIColor*)lineColor backColor:(UIColor*)backColor;
- (void)showPlaceHolderWithLineColor:(UIColor*)lineColor backColor:(UIColor*)backColor arrowSize:(CGFloat)arrowSize;
- (void)showPlaceHolderWithLineColor:(UIColor*)lineColor backColor:(UIColor*)backColor arrowSize:(CGFloat)arrowSize lineWidth:(CGFloat)lineWidth;
- (void)showPlaceHolderWithLineColor:(UIColor*)lineColor backColor:(UIColor*)backColor arrowSize:(CGFloat)arrowSize lineWidth:(CGFloat)lineWidth frameWidth:(CGFloat)frameWidth frameColor:(UIColor*)frameColor;
- (void)hidePlaceHolder;
- (void)hidePlaceHolderWithAllSubviews;
- (void)removePlaceHolder;
- (void)removePlaceHolderWithAllSubviews;
- (MMPlaceHolder *)getPlaceHolder;
@end
```
and you can use the global configuration
```objc
@interface MMPlaceHolderConfig : NSObject
+ (MMPlaceHolderConfig*) defaultConfig;
@property (nonatomic, strong) UIColor *backColor;
@property (nonatomic, assign) CGFloat arrowSize;
@property (nonatomic, strong) UIColor *lineColor;
@property (nonatomic, assign) CGFloat lineWidth;
@property (nonatomic, strong) UIColor *frameColor;
@property (nonatomic, assign) CGFloat frameWidth;
@property (nonatomic, assign) BOOL showArrow;
@property (nonatomic, assign) BOOL showText;
@property (nonatomic, assign) BOOL visible;
@property (nonatomic, assign) BOOL autoDisplay;
@property (nonatomic, strong) NSArray *visibleMemberOfClasses;
@property (nonatomic, strong) NSArray *visibleKindOfClasses;
@end
```
Changelog
===============
v1.9 clean & optimize codes, and draw the frame directly
v1.8 now you can hide the system view and keep the interface clean & tidy
```objc
@property (nonatomic, assign) BOOL autoDisplaySystemView;
```
v1.7 now you can display the specific class while in Autodisplay mode(thx [pull request](https://github.com/adad184/MMPlaceHolder/pull/3) from [@mrdaios](https://github.com/mrdaios))
```objc
@property (nonatomic, strong) NSArray *visibleMemberOfClasses;
@property (nonatomic, strong) NSArray *visibleKindOfClasses;
[MMPlaceHolderConfig defaultConfig].visibleMemberOfClasses = @[UIImageView.class];
[MMPlaceHolderConfig defaultConfig].visibleKindOfClasses = @[UIButton.class];
```
v1.6 now you can control the visibility of frame & arrow & text by
```objc
@property (nonatomic, strong) UIColor *frameColor;
@property (nonatomic, assign) CGFloat frameWidth;
[MMPlaceHolderConfig defaultConfig].showArrow = YES;
[MMPlaceHolderConfig defaultConfig].showText = YES;
```
and modified the function `hidePlaceHolder` & add new function `removePlaceHolder`
```objc
- (void)removePlaceHolder;
- (void)removePlaceHolderWithAllSubviews;
```
most important thing is you can automatic display the placeholder with one line code by
```objc
[MMPlaceHolderConfig defaultConfig].autoDisplay = YES;
```
v1.5 fix hidePlaceHolder bug when subviews shows placeholder
v1.4 add a demo project & now you can config the global visability by
```objc
[MMPlaceHolderConfig defaultConfig].visible = NO;
```
v1.3 now you can add placeholders recursively by
```objc
- (void)showPlaceHolderWithAllSubviews;
- (void)showPlaceHolderWithAllSubviews:(NSInteger)maxDepth;
- (void)hidePlaceHolderWithAllSubviews;
```
v1.2 now you can change default configuration by `[MMPlaceHolderConfig defaultConfig]`
```objc
[MMPlaceHolderConfig defaultConfig].lineColor = [UIColor whiteColor];
[MMPlaceHolderConfig defaultConfig].backColor = [UIColor clearColor];
[MMPlaceHolderConfig defaultConfig].arrowSize = 3;
[MMPlaceHolderConfig defaultConfig].lineWidth = 1;
```
v1.1 now you can get or remove `MMPlaceHolder` by
```objc
- (void)hidePlaceHolder;
- (MMPlaceHolder *)getPlaceHolder;
```
v1.0 you can custom or simply use it by
```objc
- (void)showPlaceHolder;
- (void)showPlaceHolderWithLineColor:(UIColor*)lineColor;
- (void)showPlaceHolderWithLineColor:(UIColor*)lineColor backColor:(UIColor*)backColor;
- (void)showPlaceHolderWithLineColor:(UIColor*)lineColor backColor:(UIColor*)backColor arrowSize:(CGFloat)arrowSize ;
- (void)showPlaceHolderWithLineColor:(UIColor*)lineColor backColor:(UIColor*)backColor arrowSize:(CGFloat)arrowSize lineWidth:(CGFloat)lineWidth;
```