Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: develop
Pull request Compare This branch is 5 commits behind master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


Readme by Giv Parvaneh ( @givp )

This class was originally written by DK101

It is a very clean and elegant subclass of CCLayer that lets you pass-in an array of layers and it will then create a smooth scroller.
Complete with the "snapping" effect. You can create screens with anything that can be added to a CCLayer.
Also there's an option to change the width of each layer for the "Angry Birds" style preview effect. (In a fact layer contentSize isn't changed, but widthOffset is used for pages (CCLayer) positioning inside the CCScrollLayer)


  1. add both files to your project
  2. in your scene import CCScrollLayer.h
  3. in your scene's init method construct each layer and pass it to the CCScrollLayer class (See CCScrollLayerTestLayer.m for details).

Additions since Giv Parvaneh version

  1. Added ability to swipe above targetedTouchDelegates.
  2. Added touches lengths & screens properties.
  3. Added factory class method.
  4. Code cleanup.
  5. Added current page number indicator (iOS Style Dots) with positioning.
  6. moveToPage is public method.
  7. Standard pages numbering starting from zero: [0;totalScreens-1] instead of [1; totalScreens]
  8. iOS: scroll with only one touch.
  9. Mac Support, more flexible.
  10. Dynamic Pages Control - Add / Remove pages after CCScrollLayer init & onEnter.
  11. marginOffset property - to slowdown scrolling pages out of bounds.


  1. Standard Touch Delegates will still receive touch events after layer starts sliding.
Something went wrong with that request. Please try again.