https://github.com/bxyfighting/bxystatefulviewcontroller

A view controller category that presents placeholder views based on content, loading, error or empty states.
https://github.com/bxyfighting/bxystatefulviewcontroller

empty error loading objective-c placeholder state state-management uiviewcontroller

Last synced: 9 months ago
JSON representation

A view controller category that presents placeholder views based on content, loading, error or empty states.

• Host: GitHub
• URL: https://github.com/bxyfighting/bxystatefulviewcontroller
• Owner: bxyfighting
• License: mit
• Created: 2017-09-21T15:16:04.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2017-12-15T06:58:26.000Z (about 8 years ago)
• Last Synced: 2025-03-13T17:03:04.873Z (10 months ago)
• Topics: empty, error, loading, objective-c, placeholder, state, state-management, uiviewcontroller
• Language: Objective-C
• Homepage:
• Size: 80.1 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# BXYStatefulViewController

[![CI Status](http://img.shields.io/travis/bxyfighting/BXYStatefulViewController.svg?style=flat)](https://travis-ci.org/bxyfighting/BXYStatefulViewController)

[![Version](https://img.shields.io/cocoapods/v/BXYStatefulViewController.svg?style=flat)](http://cocoapods.org/pods/BXYStatefulViewController)

[![License](https://img.shields.io/cocoapods/l/BXYStatefulViewController.svg?style=flat)](http://cocoapods.org/pods/BXYStatefulViewController)

[![Platform](https://img.shields.io/cocoapods/p/BXYStatefulViewController.svg?style=flat)](http://cocoapods.org/pods/BXYStatefulViewController)

A view controller category that presents placeholder views based on content, loading, error or empty states.

## Overview

In a networked application a view controller typically has the following states that need to be communicated to the user:

* Loading: The content is currently loaded over the network.

* Content: The content is available and presented to the user.

* Empty: There is currently no content available to display.

* Error: An error occurred whilst downloading content.

As trivial as this flow may sound, there are a lot of cases that result in a rather large decision tree.

![Decision Tree](decision_tree.png)

BXYStatefulViewController is a concrete implementation of this particular decision tree.

## Installation

BXYStatefulViewController is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:

```ruby

pod 'BXYStatefulViewController'

```

## Author

bxyfighting, bxyfighting@163.com

## License

BXYStatefulViewController is available under the MIT license. See the LICENSE file for more info.