How to set the height of table header in UITableView?

Question

I have gone through Apple docs about UITableView class and delegate reference but couldn't find the way to set the table header height explicitly.

I set Table cell height using following delegate:

-(CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath

and set section header/footer height using following delegates.

-(CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section
-(CGFloat)tableView:(UITableView *)tableView heightForFooterInSection:(NSInteger)section

Could anyone please help me to set the table header/footer height?

Thanks.

it doesn't work if you return 0; but when i return 0.1f it does work for me — igrek, Aug 16 '13 at 15:43

score 68 · Accepted Answer · answered Apr 07 '11 at 12:40

68

Just set the frame property of the tableHeaderView.

answered Apr 07 '11 at 12:40

Roger

15,793
4
51
73

I already do that. I set my image to tableheaderview.I am not able to change table header's height. The thing is HeaderImaze size is 640x88 and it gets rescaled to 320x88 which is wrong so i want to set my table header height to 44 when the specified image resolution width is 640. – Paresh Masani Apr 07 '11 at 12:59
1

Hi Roger, I think your idea should work. I tried to set frame property using "plainTableView.tableHeaderView.frame = CGRectMake(0,0,320,44);" but nothing happens. Please note that my image size if 640x88 and I am assigning it to tableHeaderView. – Paresh Masani Apr 07 '11 at 13:24
Following worked for me. I couldn't change the table height but I reset the image height. if(headerImage.bounds.size.width == 640) [headerImage setFrame: CGRectMake(0, 0, headerImage.bounds.size.width, headerImage.bounds.size.height/2)]; – Paresh Masani Apr 07 '11 at 14:29

score 62 · Answer 2 · answered Sep 28 '12 at 10:11

62

I found a nice hack. Add the below line after modifying the frame propery

self.tableView.tableHeaderView = self.tableView.tableHeaderView;

The trick is (I think) that the UITableView is caching the height (the frame actually) when you assign the view to the tableHeaderView property. The above line just assigns the height again.

answered Sep 28 '12 at 10:11

Cristian Bica

4,067
27
28

However, if you try to animate the change, it only seems to work in the shrinking direction. – Kudit Mar 25 '13 at 19:38
1

Animation or not, this is the fastest solution. Perfect :) – iPhoneNoob Feb 19 '16 at 11:39
1

Can't believe this was the solution! It works for making the header smaller & larger. For Swift I'm doing - tableView.tableHeaderView!.frame = CGRectMake(0, 0, self.view.frame.size.width, 100) tableView.tableHeaderView = self.tableView.tableHeaderView – Michael McKenna Jun 03 '16 at 13:39

score 43 · Answer 3 · edited Nov 26 '18 at 18:20

43

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    sizeHeaderToFit()
}

private func sizeHeaderToFit() {
    let headerView = tableView.tableHeaderView!

    headerView.setNeedsLayout()
    headerView.layoutIfNeeded()

    let height = headerView.systemLayoutSizeFitting(UILayoutFittingCompressedSize).height
    var frame = headerView.frame
    frame.size.height = height
    headerView.frame = frame

    tableView.tableHeaderView = headerView
}

More details can be found here

edited Nov 26 '18 at 18:20

Alessandro Francucci

1,528
17
25

answered Jan 05 '16 at 10:46

Kris

1,538
2
16
27

1

Awesome. Many thanks Kris. Your function still works great in viewDidAppear. It will be better than viewDidLayoutSubviews which is called many times. – truongky Nov 24 '16 at 03:16
1

@truongky No, viewDidLayoutSubviews will work eg on rotation or on window resize (eg iPad split screen), what is desired to be resized after it, viewWill/DidAppear will never update it and it will look wrong. – Nat Oct 02 '18 at 09:44
3

This is resulting in a freeze due to endless layout loops for me as of iOS 12.4 – Trev14 Aug 12 '19 at 22:14

score 10 · Answer 4 · edited Sep 22 '12 at 06:08

10

In case you still need it, have you tried to set the property

self.tableView.tableHeaderView

If you calculate the heigh you need, and set a new view for tableHeaderView:

CGRect frame = self.tableView.tableHeaderView.frame;
frame.size.height = newHeight;

self.tableView.tableHeaderView = [[UIView alloc] initWithFrame:frame];

It should work.

edited Sep 22 '12 at 06:08

biegleux

13,179
11
45
52

answered Sep 17 '12 at 14:17

Fabio

251
4
8

score 7 · Answer 5 · answered Sep 11 '14 at 13:06

7

It works with me only if I set the footer/header of the tableview to nil first:

self.footer = self.searchTableView.tableFooterView;
CGRect frame = self.footer.frame;
frame.size.height = 200;
self.footer.frame = frame;
self.searchTableView.tableFooterView = nil;
self.searchTableView.tableFooterView = self.footer;

Make sure that self.footer is a strong reference to prevent the footer view from being deallocated

answered Sep 11 '14 at 13:06

Hossam Ghareeb

7,063
3
53
64

`self.searchTableView.tableFooterView = self.searchTableView.tableFooterView;` works as well. – superarts.org May 30 '16 at 06:56

Krunal Patel · Answer 6 · 2018-11-26T09:33:02.320

4

Swift 4 - you can manage height with HEIGHT_VIEW,Just add this cods, Its working

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()

    let HEIGHT_VIEW = 60
    tableView.tableFooterView?.frame.size = CGSize(width: tblView.frame.width, height: CGFloat(HEIGHT_VIEW))

    tableView.tableHeaderView?.frame.size = CGSize(width:tblView.frame.width, height: CGFloat(HEIGHT_VIEW))
}

edited Nov 26 '18 at 09:33

answered Nov 28 '17 at 10:05

Krunal Patel

1,649
1
14
22

The best answer – Michał Ziobro Oct 02 '18 at 09:59
4

Good solution, but that "tblView" is a punch in the eye! :'D – Alessandro Francucci Nov 26 '18 at 09:24

score 2 · Answer 7 · answered May 07 '16 at 12:51

Just create Footer Wrapper View using constructor UIView(frame:_) then if you are using xib file for FooterView, create view from xib and add as subView to wrapper view. then assign wrapper to tableView.tableFooterView = fixWrapper .

    let fixWrapper = UIView(frame: CGRectMake(0, 0, UIScreen.mainScreen().bounds.width, 54)) // dont remove
    let footer = UIView.viewFromNib("YourViewXibFileName") as! YourViewClassName
    fixWrapper.addSubview(footer)
    tableView.tableFooterView = fixWrapper
    tableFootterCostView = footer

It works perfectly for me! the point is to create footer view with constructor (frame:_). Even though you create UIView() and assign frame property it may not work.

score 2 · Answer 8 · answered Sep 13 '17 at 01:25

2

If add a view as table header view in IB, set the frame of that view in IB in Tab 5(size inspector)

answered Sep 13 '17 at 01:25

Yllow

326
4
7

score 2 · Answer 9 · answered Aug 07 '19 at 02:36

If you programatically set the tableHeaderView, then just set it inside viewDidLayoutSubviews.

    override func viewDidLayoutSubviews() {
        super.viewDidLayoutSubviews()
        setupTableViewHeader()
    }

    private func setupTableViewHeader() {
        // Something you do to set it up programatically...
        tableView.tableHeaderView = MyHeaderView.instanceFromNib() 
    }

If you didn't set it programatically, you need to do similar to what @Kris answered based on this link

    override func viewDidLayoutSubviews() {
        super.viewDidLayoutSubviews()
        sizeHeaderToFit()
    }

    private func sizeHeaderToFit() {
        if let headerView = tableView.tableHeaderView {
            headerView.setNeedsLayout()
            headerView.layoutIfNeeded()

            let height = headerView.systemLayoutSizeFitting(UIView.layoutFittingCompressedSize).height
            var frame = headerView.frame
            frame.size.height = height
            headerView.frame = frame

            tableView.tableHeaderView = headerView
        }
    }

score 2 · Answer 10 · answered Oct 04 '19 at 12:51

@kris answer is helpful for me anyone want it in Objective-C.

Here is the code

-(void)viewDidLayoutSubviews{
     [super viewDidLayoutSubviews];
     [self sizeHeaderToFit];
}

-(void)sizeHeaderToFit{
     UIView *headerView = self.tableView.tableHeaderView;
     [headerView setNeedsLayout];
     [headerView layoutIfNeeded];
     CGFloat height = [headerView systemLayoutSizeFittingSize:UILayoutFittingCompressedSize].height;
     CGRect frame = headerView.frame;
     frame.size.height = height;
     headerView.frame = frame;
     self.tableView.tableHeaderView = headerView;
}

score 1 · Answer 11 · answered Oct 23 '18 at 06:27

If you are using XIB for tableView's main headerView you can set XIB as a freeform set the Height as you want and unclick Autoresizing's top,bottom blocks and upper,lower arrows.Only horizontal pieces will be selected.Vertical will be unselected as I mentioned above.

score 1 · Answer 12 · answered Feb 06 '19 at 12:59

You can create a UIView with the desired height (the width should be that of the UITableView), and inside it you can place a UIImageView with the picture of the proper dimensions: they won't stretch automatically.

You can also give margin above and below the inner UIImageView, by giving a higher height to the container view.

Additionally, you can assign a Translation transform in order to place the image in the middle of its container header view, for example.

Meilbn · Answer 13 · 2019-10-21T02:19:08.540

-1

If you changed height of tableView's headerView, just reset headerView's frame, then, reset headerView of tableView:

self.headerView.frame = newFrame;
self.tableView.tableHeaderView = self.headerView;

edited Oct 21 '19 at 02:19

answered Feb 28 '18 at 07:15

Meilbn

582
7
8

This does so much more than required. Don't use it for such a simple task. Simple setNeedsLayout is enough in case you're describing. – Nat Oct 01 '18 at 13:57

score -1 · Answer 14 · answered Apr 09 '18 at 10:17

-1

With autolayout you could do something like:

tableView.sectionHeaderHeight = UITableViewAutomaticDimension
tableView.estimatedSectionHeaderHeight = <your-header-height>

or if your headers are of different heights, go ahead and implement:

func tableView(_ tableView: UITableView, heightForHeaderInSection section: Int) -> CGFloat {
    return <your-header-height>
}

answered Apr 09 '18 at 10:17

Matti

427
1
4
13

The OP asked for tableView header, not section header ;) – Climbatize Aug 16 '18 at 05:48

score -1 · Answer 15 · edited Jul 31 '19 at 07:03

-1

In Xcode 10 you can set header and footer of section hight from "Size Inspector" tab

edited Jul 31 '19 at 07:03

mokagio

16,391
3
51
58

answered May 16 '19 at 19:41

NinjaDeveloper

1,620
3
19
51

score -2 · Answer 16 · edited May 08 '18 at 11:27

-2

func tableView(_ tableView: UITableView, heightForHeaderInSection section: Int) -> CGFloat {
}

or you can use like this also

tableView.estimatedSectionHeaderHeight

edited May 08 '18 at 11:27

Yannis

1,682
7
27
45

answered May 08 '18 at 09:24

Mnsd

37
6

We aren't discussing about SEction header. it is about tableView header – Arthur Garza May 18 '18 at 20:20
I use the section header and footer as headers and footers for the table. So this is valid for me and was helpful. I found it easier than the other solutions. – David J Oct 13 '18 at 17:42

score -3 · Answer 17 · answered Apr 07 '11 at 12:52

-3

Use table view default property :

- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section
{
    return 35.0;
}

Thanks

answered Apr 07 '11 at 12:52

Mitesh Khatri

3,935
4
44
67

1

Nope it doesn't work. I tried it. It changes the size for section header/footer only not for table header/footer. Am I missing something? – Paresh Masani Apr 07 '11 at 12:58
45

We aren't discussing about SEction header. it is about tableView header – iSaalis Feb 05 '13 at 06:22

How to set the height of table header in UITableView?

17 Answers17

Linked