Get UIScrollView to scroll to the top

Question

How do I make a UIScrollView scroll to the top?

rob mayoff · Accepted Answer · 2014-09-08T21:23:22.253

330

UPDATE FOR iOS 7

[self.scrollView setContentOffset:
    CGPointMake(0, -self.scrollView.contentInset.top) animated:YES];

ORIGINAL

[self.scrollView setContentOffset:CGPointZero animated:YES];

or if you want to preserve the horizontal scroll position and just reset the vertical position:

[self.scrollView setContentOffset:CGPointMake(self.scrollView.contentOffset.x, 0)
    animated:YES];

edited Sep 08 '14 at 21:23

answered Feb 26 '12 at 03:40

rob mayoff

375,296
67
796
848

53

If you're doing this for iOS 7, you may have to take into account the `UIScrollView` `contentInset`, unfortunately. `[self.scrollView setContentOffset:CGPointMake(self.scrollView.contentOffset.x, -self.scrollView.contentInset.top) animated:YES];` does the job for me – runmad Sep 09 '13 at 16:46
11

I was able to scroll to the top, right below the navigation and status bar. `[scrollView setContentOffset:CGPointMake(0, -scrollView.contentInset.top) animated:YES];` It works in iOS 6 & 7 – Amozoss Dec 28 '13 at 23:40
This didn't work for me, probably because I'm doing something crazy with an inverted view in sprite kit. But if anyone else is as crazy as me - and your scrollview is at the bottom by default - this will scroll it to the top: `[scrollView setContentOffset:CGPointMake(0, scrollView.contentSize.height-scrollView.frame.size.height) animated:YES];` – GilesDMiddleton Apr 01 '15 at 16:03
Late-in-the-day comment: you should adjust for the content inset regardless of OS version. iOS 7 happens to use it for allowing scroll content below the status bar but it's always been exposed as a property, so always been potentially used by somebody. – Tommy Feb 29 '16 at 15:14
4

For iOS 11+, Jakub Truhlář's answer below using adjustedContentInset was helpful, at least in my case. – tnev Oct 18 '17 at 22:49

Andrew Schreiber · Answer 2 · 2018-03-14T16:29:24.267

76

Here is a Swift extension that makes it easy:

extension UIScrollView {
    func scrollToTop() {
        let desiredOffset = CGPoint(x: 0, y: -contentInset.top)
        setContentOffset(desiredOffset, animated: true)
   }
}

Usage:

myScrollView.scrollToTop()

edited Mar 14 '18 at 16:29

answered Feb 01 '16 at 00:37

Andrew Schreiber

14,344
6
46
53

score 62 · Answer 3 · edited Oct 08 '18 at 12:36

62

For Swift 4

scrollView.setContentOffset(.zero, animated: true)

edited Oct 08 '18 at 12:36

Massimo Polimeni

4,826
4
27
54

answered Feb 12 '18 at 10:55

Rajasekhar Pasupuleti

1,598
15
22

Definitely the best modern answer. – Jonathan Jun 29 '21 at 20:36

Jakub Truhlář · Answer 4 · 2020-10-13T15:14:55.393

iOS 11 and above

Try to play around with the new adjustedContentInset (It should even work with prefersLargeTitles, safe area etc.)

For example (scroll to the top):

var offset = CGPoint(
    x: -scrollView.contentInset.left, 
    y: -scrollView.contentInset.top)

if #available(iOS 11.0, *) {
    offset = CGPoint(
        x: -scrollView.adjustedContentInset.left, 
        y: -scrollView.adjustedContentInset.top)    
}

scrollView.setContentOffset(offset, animated: true)

score 23 · Answer 5 · edited Aug 27 '13 at 06:43

23

Use setContentOffset:animated:

[scrollView setContentOffset:CGPointZero animated:YES];

edited Aug 27 '13 at 06:43

Jack Humphries

13,056
14
84
125

answered Feb 26 '12 at 03:40

Bryan Chen

45,816
18
112
143

score 18 · Answer 6 · edited Jan 31 '18 at 16:16

18

Answer for Swift 2.0/3.0/4.0 and iOS 7+:

let desiredOffset = CGPoint(x: 0, y: -self.scrollView.contentInset.top)
self.scrollView.setContentOffset(desiredOffset, animated: true)

edited Jan 31 '18 at 16:16

Cœur

37,241
25
195
267

answered Jan 08 '16 at 22:27

worthbak

335
3
8

score 8 · Answer 7 · edited Jan 31 '18 at 16:08

8

In iOS7 I had trouble getting a particular scrollview to go to the top, which worked in iOS6, and used this to set the scrollview to go to the top.

[self.myScroller scrollRectToVisible:CGRectMake(0, 0, 1, 1) animated:NO];

edited Jan 31 '18 at 16:08

Cœur

37,241
25
195
267

answered Sep 22 '13 at 22:11

hoak

125
1
7

I have the same issue in iOS7. Does anyone know how to enable this for a UITableView? – DZenBot Sep 24 '13 at 21:21
1

It's funny how this works when animated is NO, but not when animated is YES. If YES, then it scrolls almost to the topdevgm16 – Matt Becker Nov 13 '13 at 15:17

score 7 · Answer 8 · answered Jun 02 '20 at 09:04

7

In SWIFT 5 Just set content Offset to zero

scrollView.setContentOffset(CGPoint.zero, animated: true)

answered Jun 02 '20 at 09:04

Abdul Karim Khan

4,256
1
26
30

score 4 · Answer 9 · edited May 23 '17 at 10:31

4

Swift 3.0.1 version of rob mayoff's answer :

self.scrollView.setContentOffset(
CGPoint(x: 0,y: -self.scrollView.contentInset.top),
animated: true)

edited May 23 '17 at 10:31

Community

1
1

answered Nov 01 '16 at 16:52

RawKnee

324
3
11

user2898617 · Answer 10 · 2018-05-08T15:40:04.640

I think I have an answer that should be fully compatible with iOS 11 as well as prior versions (for vertical scrolling)

This takes into account the new adjustedContentInset and also accounts for the additional offset required when prefersLargeTitles is enabled on the navigationBar which appears to require an extra 52px offset on top of whatever the default is

This was a little tricky because the adjustedContentInset changes depending on the titleBar state (large title vs small title) so I needed to check and see what the titleBar height was and not apply the 52px offset if its already in the large state. Couldn't find any other method to check the state of the navigationBar so if anyone has a better option than seeing if the height is > 44.0 I'd like to hear it

func scrollToTop(_ scrollView: UIScrollView, animated: Bool = true) {
    if #available(iOS 11.0, *) {
        let expandedBar = (navigationController?.navigationBar.frame.height ?? 64.0 > 44.0)
        let largeTitles = (navigationController?.navigationBar.prefersLargeTitles) ?? false
        let offset: CGFloat = (largeTitles && !expandedBar) ? 52: 0
        scrollView.setContentOffset(CGPoint(x: 0, y: -(scrollView.adjustedContentInset.top + offset)), animated: animated)
    } else {
        scrollView.setContentOffset(CGPoint(x: 0, y: -scrollView.contentInset.top), animated: animated)
    }
}

Inspired by Jakub's solution

score 3 · Answer 11 · answered Sep 25 '18 at 11:05

It's very common when your navigation bar overlaps the small portion of the scrollView content and it looks like content starts not from the top. For fixing it I did 2 things:

Size Inspector - Scroll View - Content Insets --> Change from Automatic to Never.
Size Inspector - Constraints- "Align Top to" (Top Alignment Constraints)- Second item --> Change from Superview.Top to Safe Area.Top and the value(constant field) set to 0

score 2 · Answer 12 · answered May 20 '14 at 18:36

To fully replicate the status bar scrollToTop behavior we not only have to set the contentOffset but also want to make sure the scrollIndicators are displayed. Otherwise the user can quickly get lost.

The only public method to accomplish this is flashScrollIndicators. Unfortunately, calling it once after setting the contentOffset has no effect because it's reset immediately. I found it works when doing the flash each time in scrollViewDidScroll:.

// define arbitrary tag number in a global constants or in the .pch file
#define SCROLLVIEW_IS_SCROLLING_TO_TOP_TAG 19291

- (void)scrollContentToTop {
    [self.scrollView setContentOffset:CGPointMake(self.scrollView.contentOffset.x, -self.scrollView.contentInset.top) animated:YES];

    self.scrollView.tag = SCROLLVIEW_IS_SCROLLING_TO_TOP_TAG;
    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.3 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
        self.scrollView.tag = 0;
    });
}

In your UIScrollViewDelegate (or UITable/UICollectionViewDelegate) implement this:

- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
    if (scrollView.tag == SCROLLVIEW_IS_SCROLLING_TO_TOP_TAG) {
        [scrollView flashScrollIndicators];
    }
}

The hide delay is a bit shorter compared to the status bar scrollToTop behavior but it still looks nice.

Note that I'm abusing the view tag to communicate the "isScrollingToTop" state because I need this across view controllers. If you're using tags for something else you might want to replace this with an iVar or a property.

I haven't tested, but it should throw this on the next runloop if you just use DISPATCH_TIME_NOW instead. Thanks for doing this work, not sure I need it yet, but good to know. — Dan Rosenstark, Jan 07 '17 at 17:58
It's a while ago and I don't remember exactly but I believe this didn't work. Deferring to the next runloop is usually the first thing I try in such cases. — Ortwin Gentz, Jan 09 '17 at 09:26

score 2 · Answer 13 · answered Oct 19 '21 at 21:26

In modern iOS, set the the scroll view's content offset back to its top left adjustedContentInset:

let point = CGPoint(x: -scrollView.adjustedContentInset.left,
                    y: -scrollView.adjustedContentInset.top)
    
scrollView.setContentOffset(point, animated: true)

trndjc · Answer 14 · 2023-02-23T21:09:43.710

iOS 16

For table and collection views, the following always works for me:

let top = CGRect(x: 0, y: 0, width: 1, height: 1)
tableView.scrollRectToVisible(top, animated: true)
collectionView.scrollRectToVisible(top, animated: true)

For scroll views:

let top = CGPoint(x: 0, y: -adjustedContentInset.top)
scrollView.setContentOffset(top, animated: animated)

adjustedContentInset returns the insets applied by the safe area (if any) and any custom insets applied after instantiation. If either safe or custom insets are applied, the content inset of the scroll view when it's at its top will be negative, not zero, which is why this property should be used.

score 0 · Answer 15 · answered Oct 06 '17 at 12:03

Scroll to top for UITableViewController, UICollectionViewController or any UIViewController having UIScrollView

extension UIViewController {

  func scrollToTop(animated: Bool) {
    if let tv = self as? UITableViewController {
        tv.tableView.setContentOffset(CGPoint.zero, animated: animated)
    } else if let cv = self as? UICollectionViewController{
        cv.collectionView?.setContentOffset(CGPoint.zero, animated: animated)
    } else {
        for v in view.subviews {
            if let sv = v as? UIScrollView {
                sv.setContentOffset(CGPoint.zero, animated: animated)
            }
        }
    }
  }
}

score -2 · Answer 16 · edited Dec 03 '20 at 01:44

-2

iOS 2.0+ Mac Catalyst 13.0+

You can try: scrollView.scrollsToTop = true

You can refer it from documentation of developer.apple.com

edited Dec 03 '20 at 01:44

bhucho

3,903
3
16
34

answered Dec 02 '20 at 04:25

Robocon

19
5

Hi and welcome to Stack Overflow! Please take the [tour](https://stackoverflow.com/tour). Thanks for contributing an answer but can you also add an explanation on how it solves the problem? – Jeanne Dark Dec 02 '20 at 07:15
3

Doing this will only enable/disable the scroll-to-top gesture, which is not what the question is about. – Florentin Mar 01 '21 at 10:39

score -3 · Answer 17 · answered Mar 11 '16 at 08:03

-3

I tried all the ways. But nothing worked for me. Finally I did like this.

I added self.view .addSubview(self.scroll) line of code in the viewDidLoad. After started setting up frame for scroll view and added components to scroll view.

It worked for me.

Make sure you added self.view .addSubview(self.scroll) line in the beginning. then you can add UI elements.

answered Mar 11 '16 at 08:03

Narasimha Nallamsetty

1,215
14
16

Please delete this. While it surely made sense at the time, your subview hierarchy issues aren't relevant to this question. – Dan Rosenstark Jan 07 '17 at 17:56
1

@Cristik if your scroll view isn't in the view hierarchy, or your computer is switched off, of course none of this will work. But the OP asked something pretty narrow – Dan Rosenstark Feb 10 '17 at 07:07

Get UIScrollView to scroll to the top

17 Answers17

UPDATE FOR iOS 7

ORIGINAL

iOS 11 and above

Linked