Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/HamzaGhazouani/HGPlaceholders
Nice library to show placeholders and Empty States for any UITableView/UICollectionView in your project
https://github.com/HamzaGhazouani/HGPlaceholders
empty empty-state loading placeholder state-management uicollectionview uitableview
Last synced: 3 days ago
JSON representation
Nice library to show placeholders and Empty States for any UITableView/UICollectionView in your project
- Host: GitHub
- URL: https://github.com/HamzaGhazouani/HGPlaceholders
- Owner: HamzaGhazouani
- License: mit
- Created: 2017-07-21T14:56:34.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-01-13T09:38:55.000Z (almost 3 years ago)
- Last Synced: 2024-10-29T17:57:30.150Z (about 1 month ago)
- Topics: empty, empty-state, loading, placeholder, state-management, uicollectionview, uitableview
- Language: Swift
- Homepage:
- Size: 2.25 MB
- Stars: 2,198
- Watchers: 34
- Forks: 159
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - HGPlaceholders - Nice library to show and create placeholders and Empty States for any UITableView/UICollectionView in your project (UI / Table View / Collection View)
- awesome-swift - HGPlaceholders - Nice library to show placeholders and Empty States for any UITableView/UICollectionView in your project. (Libs / UI)
- awesome-swift - HGPlaceholders - Nice library to show placeholders and Empty States for any UITableView/UICollectionView in your project. (Libs / UI)
- awesome-ios-star - HGPlaceholders - Nice library to show and create placeholders and Empty States for any UITableView/UICollectionView in your project (UI / Table View / Collection View)
- fucking-awesome-swift - HGPlaceholders - Nice library to show placeholders and Empty States for any UITableView/UICollectionView in your project. (Libs / UI)
- awesome-ios - HGPlaceholders - Nice library to show placeholders and Empty States for any `UITableView` or `UICollectionView` in your project. [•](https://raw.githubusercontent.com/HamzaGhazouani/HGPlaceholders/master/Screenshots/default.gif) (Content / Table View)
- awesome-swift - HGPlaceholders - Nice library to show placeholders and Empty States for any UITableView/UICollectionView in your project ` 📝 9 months ago` (UI [🔝](#readme))
README
# HGPlaceholders
[](#backers) [](#sponsors) [](https://travis-ci.org/HamzaGhazouani/HGPlaceholders)
[](http://cocoapods.org/pods/HGPlaceholders)
[](http://cocoapods.org/pods/HGPlaceholders)
[]()
[]()
[](http://cocoapods.org/pods/HGPlaceholders)
[](https://twitter.com/GhazouaniHamza)
[](https://codebeat.co/projects/github-com-hamzaghazouani-hgplaceholders-master)
[](http://cocoadocs.org/docsets/HGPlaceholders/)
[](http://clayallsopp.github.io/readme-score?url=https://github.com/hamzaghazouani/hgplaceholders)
## Example
 
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Requirements
- iOS 8.0+
- Xcode 9.2
## You also may like
* **[HGCircularSlider](https://github.com/HamzaGhazouani/HGCircularSlider)** - A custom reusable circular slider control for iOS application.
* **[HGRippleRadarView](https://github.com/HamzaGhazouani/HGRippleRadarView)** - A beautiful radar view to show nearby users with ripple animation, fully customizable
## Installation
HGPlaceholders is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'HGPlaceholders'
```
HGPlaceholders is also available through [Carthage](https://github.com/Carthage/Carthage). To install
it, simply add the following line to your Cartfile:
``` ruby
github "HamzaGhazouani/HGPlaceholders"
```
## Usage
1. Inherit your UITableView class from TableView Or inherit UICollectionView from CollectionView
2. Call the placeholder to show
* `tableView.showLoadingPlaceholder()` or `collectionView.showLoadingPlaceholder()`
* `tableView.showNoResultsPlaceholder()` or `collectionView.showNoResultsPlaceholder()`
* `tableView.showErrorPlaceholder()` or `collectionView.showErrorPlaceholder()`
* `tableView.showNoConnectionPlaceholder()` or `collectionView.showNoConnectionPlaceholder()`
## Customization
If you want to change only images, just set them in your asset with this names (the framework check firstly in the main bundle):
* loading : "hg_default-loading"
* no_connection : "hg_default-no_connection"
* no_results : "hg_default-no_results"
* error : "hg_default-error"
The framework contains different defaults placeholders:
* Basic :
`tableView.placeholdersProvider = .basic` or `collectionView.placeholdersProvider = .basic`
* Default :
`tableView.placeholdersProvider = .default` or `collectionView.placeholdersProvider = .default`
* Default2 :
`tableView.placeholdersProvider = .default2` or `collectionView.placeholdersProvider = .default2`
* Hallowen :
`tableView.placeholdersProvider = .halloween` or `collectionView.placeholdersProvider = .halloween` // for fun :)`
If you want to change the default palceholders for all table views in your project:
```swift
class ProjectNameTableView: TableView {
override func customSetup() {
placeholdersProvider = .basic
}
}
```
```swift
class ProjectNameCollectionView: CollectionView {
override func customSetup() {
placeholdersProvider = .basic
}
}
```
You can also add new placeholders fully customizable, you should keep in mind that the view will take table view frame, and placeholder can have only one action, please check the example project
### Creating a new theme from scratch
```swift
static var summer: PlaceholdersProvider {
var commonStyle = PlaceholderStyle()
commonStyle.backgroundColor = UIColor(red: 1.0, green: 236.0/255, blue: 209.0/255.0, alpha: 1.0)
commonStyle.actionBackgroundColor = .black
commonStyle.actionTitleColor = .white
commonStyle.titleColor = .black
commonStyle.isAnimated = false
commonStyle.titleFont = UIFont(name: "AvenirNextCondensed-HeavyItalic", size: 19)!
commonStyle.subtitleFont = UIFont(name: "AvenirNextCondensed-Italic", size: 19)!
commonStyle.actionTitleFont = UIFont(name: "AvenirNextCondensed-Heavy", size: 19)!
var loadingStyle = commonStyle
loadingStyle.actionBackgroundColor = .clear
loadingStyle.actionTitleColor = .gray
var loadingData: PlaceholderData = .loading
loadingData.image = #imageLiteral(resourceName: "summer-hat")
let loading = Placeholder(data: loadingData, style: loadingStyle, key: .loadingKey)
var errorData: PlaceholderData = .error
errorData.image = #imageLiteral(resourceName: "summer-ball")
let error = Placeholder(data: errorData, style: commonStyle, key: .errorKey)
var noResultsData: PlaceholderData = .noResults
noResultsData.image = #imageLiteral(resourceName: "summer-cocktail")
let noResults = Placeholder(data: noResultsData, style: commonStyle, key: .noResultsKey)
var noConnectionData: PlaceholderData = .noConnection
noConnectionData.image = #imageLiteral(resourceName: "summer-beach-slippers")
let noConnection = Placeholder(data: noConnectionData, style: commonStyle, key: .noConnectionKey)
let placeholdersProvider = PlaceholdersProvider(loading: loading, error: error, noResults: noResults, noConnection: noConnection)
let xibPlaceholder = Placeholder(cellIdentifier: "CustomPlaceholderCell", key: PlaceholderKey.custom(key: "XIB"))
placeholdersProvider.add(placeholders: xibPlaceholder)
return placeholdersProvider
}
```
### Adding a custom placeholder to an existing theme
```swift
private static var starWarsPlaceholder: Placeholder {
var starwarsStyle = PlaceholderStyle()
starwarsStyle.backgroundColor = .black
starwarsStyle.actionBackgroundColor = .clear
starwarsStyle.actionTitleColor = .white
starwarsStyle.titleColor = .white
starwarsStyle.isAnimated = false
var starwarsData = PlaceholderData()
starwarsData.title = NSLocalizedString("\"This is a new day, a\nnew beginning\"", comment: "")
starwarsData.subtitle = NSLocalizedString("Star Wars", comment: "")
starwarsData.image = #imageLiteral(resourceName: "star_wars")
starwarsData.action = NSLocalizedString("OK!", comment: "")
let placeholder = Placeholder(data: starwarsData, style: starwarsStyle, key: PlaceholderKey.custom(key: "starWars"))
return placeholder
}
let provider = PlaceholdersProvider.summer
provider.addPlaceholders(MyUtilityClass.starWarsPlaceholder)
```
## Documentation
Full documentation is available on [CocoaDocs](http://cocoadocs.org/docsets/HGPlaceholders/).
You can also install documentation locally using [jazzy](https://github.com/realm/jazzy).
## Author
Hamza Ghazouani, [email protected]
## License
HGPlaceholders is available under the MIT license. See the LICENSE file for more info.