new

2026-08-08 06:46:38 +00:00 · 2015-04-02 10:54:56 +08:00
parent f495e95d31
commit c38301d9cc
89 changed files with 733 additions and 16 deletions
@@ -0,0 +1,19 @@
+Copyright (c) 2012-2013 Peter Steinberger <steipete@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
@@ -0,0 +1,57 @@
+PSTCollectionView
+=================
+
+UPDATE: I'm no longer using PSTCollectionView in any project, but will still accept pull requests for improvements.
+
+Open Source, 100% API compatible replacement of UICollectionView for iOS4.3+
+
+**You want to use UICollectionView, but still need to support older versions of iOS? Then you're gonna love this project.**
+Originally I wrote it for [PSPDFKit](http://PSPDFKit.com), my iOS PDF framework that supports text selection and annotations, but this project seemed way too useful for others to keep it for myself :)
+
+**If you want to have PSTCollectionView on iOS4.3/5.x and UICollectionView on iOS6, use PSUICollectionView (basically add PS on any UICollectionView* class to get auto-support for older iOS versions)**
+If you always want to use PSTCollectionView, use PSTCollectionView as class names. (replace the UI with PST)
+
+## Current State
+
+Most features work, including the flow layout with fixed or dynamic cell sizes and supplementary views. If you're not doing something fancy, it should just work.
+PSTCollectionView is also internally designed very closely to UICollectionView and thus a great study if you're wondering how UICollectionView works. See [HowTo](HowTo.md) for helpful details.
+
+## How can I help?
+
+The best way is if you're already using UICollectionView somewhere. Add PSTCollectionView and try it on iOS4/5. Check if everything works, fix bugs until the result matches 1:1 with iOS6. You can also just pick an issue fron the Issue Tracker and start working there.
+
+Or start playing around with one of the WWDC examples and try to make them work with PSTCollectionView. Most of them already do, but just not as perfect.
+
+You could also write a Pinterest-style layout manager. Can't be that hard.
+
+## Animations
+
+Thanks to Sergey Gavrilyuk ([@octogavrix](https://twitter.com/octogavrix)), animations are supported. It's not perfect yet (see LineExample), but it's a great start.
+
+## ARC
+
+PSTCollectionView works with Xcode 4.5.2+ and ARC.
+
+## Dependencies
+
+PSTCollectionView needs the QuartzCore.framework.
+
+## Interoperability
+
+Another goal (at least super useful for debugging) is interoperability between UI/PST classes:
+
+``` objective-c
+UICollectionViewFlowLayout *flowLayout = [UICollectionViewFlowLayout new];
+PSTCollectionView *collectionView = [[PSTCollectionView alloc] initWithFrame:self.view.bounds collectionViewLayout:(PSTCollectionViewFlowLayout *)flowLayout];
+```
+
+(*) Note that for some methods we can't use the _ underscore variants or we risk to get a false-positive on private API use. I've added some runtime hacks to dynamcially add block forwarders for those cases (mainly for UI/PST interoperability)
+
+## Creator
+
+[Peter Steinberger](http://petersteinberger.com) ([@steipete](https://twitter.com/steipete))
+and lots of others! See [Contributors](https://github.com/steipete/PSTCollectionView/graphs/contributors) for a graph. Thanks everyone!
+
+## License
+
+PSTCollectionView is available under the MIT license. See the LICENSE file for more info.