Latest 0.0.1
Homepage https://github.com/ultragtx/GSBookShelf
License BSD GSBookShelf and all code associated with it is distributed under a BSD license, as listed below

Created by Xinrong Guo
Copyright (c) 2012 FoOTOo. All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

Neither the name of the project’s author nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
“AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Platforms ios , requires ARC
Frameworks QuartzCore

An iBooks-inspired bookshelf control.

Supports animated deletion, reordering, and addition.


14.04.08: This project won’t have any update, using UICollectionView with custom layout can be a better solution.


Attention:

  1. This code should be compiled with ARC turned on;

Features:

  1. drag & drop
  2. scroll up/down while draging
  3. add & remove animation
  4. custom header (add a search bar or anything you want)5.
  5. [Update 12.08.26] support orientation change now and the cell has a simple animtaion when orientation change make this more similar to iBooks, to get more info, take a look at the demo

How To:

  1. Just take a look at the demo.
  2. bookView and shelfCell are just UIViews. So you can cutomize them almost whatever you want. But the frame of each view is fixed, if you want to have different size of bookView, you can try adding your content on a transparent UIView.
  3. To enable reusing for bookViews and cells, add the "GSBookView" / "GSBookShelfCell" protocols. (You’d better do this, perfromance will be a lot better).
  4. [NEW 12.04.03] To support oritation change, you should call the reload method and return different values (if necessary) in the delegate method with different orientation.
  5. [NEW 12.04.03] For more information about the data GSBookShelf need for layout, take a look at the "comments.png" (also available in the project).
  6. [NEW 12.05.18] The books are center-aligend when there are more than one books in a row. If you only have one per row, it’s left-aligend, you can set the "cellMargin" to make it center-aligend manually.

WARNING:

  1. [12.08.26] Some of the images came from iBooks (a little change to the color). Just to show how the code works. PLEASE use your own image in your project. Check this and learn how to draw a bookshelf using Photoshop, if you are not good at this.

Known Issue:

  1. Rotation issue part 1 and part 2 (check issue #12 for description)

TODO:

  1. [NEW 12.05.14] Fix issue 12
  2. [NEW 12.05.18] Maybe it’s better to support left-aligend center-aligend and right-aligend.

Contribute:

  • Anyone who contribute to this project can receive a License of AppCode (Send me a e-mail if you want one).

Updates:

  1. [12.08.24] merge to master
  2. [12.08.24] enhance orientation change support
  3. [12.08.24] bug fix when delete one which index is bigger than the visibles
  4. [12.08.26] orientation change with cell animation(like what iBooks do to the shelf when orientation change).
  5. [12.08.26] demo updated
  6. [12.04.11] fix issue #12 part 2, orientation change issue
  7. [13.06.02] use CADisplay link to replace NSTimer in customizing scroll speed of UIScrollView

Demo:

(Be Patient, some gifs’ size > 1M)

image
image
image

Latest podspec

{
    "name": "GSBookShelf",
    "version": "0.0.1",
    "summary": "An iBooks-inspired bookshelf control.Supports animated deletion, reordering, and addition.",
    "homepage": "https://github.com/ultragtx/GSBookShelf",
    "authors": "Xinrong Guo",
    "license": {
        "type": "BSD",
        "text": "      GSBookShelf and all code associated with it is distributed under a BSD license, as listed belownn      Created by Xinrong Guon      Copyright (c) 2012 FoOTOo. All rights reserved.nn      Redistribution and use in source and binary forms, with or withoutn      modification, are permitted provided that the following conditionsn      are met:nn      Redistributions of source code must retain the above copyright notice,n      this list of conditions and the following disclaimer.nn      Redistributions in binary form must reproduce the above copyrightn      notice, this list of conditions and the following disclaimer in then      documentation and/or other materials provided with the distribution.nn      Neither the name of the project's author nor the names of itsn      contributors may be used to endorse or promote products derived fromn      this software without specific prior written permission.nn      THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORSn      "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOTn      LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESSn      FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHTn      HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,n      SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED n      TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, ORn      PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFn      LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGn      NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THISn      SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.n"
    },
    "source": {
        "git": "https://github.com/ultragtx/GSBookShelf.git",
        "commit": "e6d590ceb40a4dd2dfbef34d353ccae60a56ebe8"
    },
    "platforms": {
        "ios": null
    },
    "source_files": [
        "BookShelf/GS*.{h,m}",
        "BookShelf/NSMutableArray+Rearrange.{h,m}"
    ],
    "frameworks": "QuartzCore",
    "requires_arc": true
}

Pin It on Pinterest

Share This