I'm creating a UITableViewHeaderFooterView from a xib file, and almost everything is working properly.
The problem is that now when I try to change the background color (or if I had one configured in the xib), it will constantly output this message to the console:
Setting the background color on UITableViewHeaderFooterView has been deprecated. Please use contentView.backgroundColor instead.
This means I have two problems:
- If I don't want to see that warning, I must get rid of the background color in the xib file.(This is undesirable because then it means my xib no longer reflects what the view will look like at runtime).
- When I attempt to change the background color via code, I get the
contentView.backgroundColor
suggestion, but when I try to follow that suggestion, nothing happens. (This is because contentView
is nil
.)
Note: There is a similar question here, but that was mainly concerned with muting the message, not finding an alternative solution that resolves both problems above.
Update: To be clear, I want to continue using a xib file for the header view, and want to be able to call dequeueReusableHeaderFooterViewWithIdentifier: so that the table can be efficient in its management of the views.
Here is the best way I've found to solve this:
- Reset the background color of your
UITableViewHeaderFooterView
to Default.
- Add a single view directly underneath the instance of your
UITableViewHeaderFooterView
, and call it Content View. (This is exactly what Apple does with a UITableViewCell
, and we are just mimicking that structure.)
- You can now change the background color of the content view to be whatever you want in the xib file.
- Place any other views
inside
the Content View
.
- Redefine the
contentView
property in an extension method, and add IBOutlet
to its definition. (See code below.)
- Associate the property with the content view you created, just as you would with any IBOutlet.
- You can now change the background color using
contentView.backgroundColor
in code, just as the error message tells you to.
.h file:
@interface ABCHeaderView : UITableViewHeaderFooterView
@end
.m file:
@interface ABCHeaderView ()
@property (nonatomic, readwrite, retain) IBOutlet UIView *contentView;
@end
@implementation ABCHeaderView
@synthesize contentView;
@end
This hierarchy is consistent with Apple's documentation:
If you have custom content to display, create the subviews for your content and add them to the view in the contentView property.
To get rid of the warning you must not set the background color. The problem is when you creating TableHeader in such way, IB does not provide special object for that. Removing background color in source code will excelent solve described problem, just in some clicks.
- Found header .xib in Xcode
- Right click - Open As -> Source code
- Find color key: Cmd-F - "backgr"
- Remove it. In my case it was the line:
<color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/>
Now you can change background like:
override func awakeFromNib() {
backgroundView = UIView()
backgroundView?.backgroundColor = UIColor.whiteColor()
}
This works for me:
-(void)tableView:(UITableView *)tableView willDisplayHeaderView:(UIView *)view forSection:(NSInteger)section
{
UITableViewHeaderFooterView *headerView=(UITableViewHeaderFooterView *)view;
[headerView.backgroundView setBackgroundColor:[[UIColor blackColor]colorWithAlphaComponent:0.4]];
}
Setting the background color on UITableViewHeaderFooterView has been
deprecated. Please use contentView.backgroundColor instead.
This can happen if you design your header in a separate xib file and set the background of the main UIView in there.
To solve that, revert the UIView background color to the default color in InterfaceBuilder, and set the background color within the viewForHeaderInSection:section method.
override func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
let header = tableView.dequeueReusableHeaderFooterView(withIdentifier: "CustomHeaderXibFileName") as! CustomHeader
header.contentView.backgroundColor = UIColor.blueColor
}
As you see, we use header.contentView.backgroundColor
and not header.backgroundColor
(which is what the xib file was actually doing).
Set the contentView.backgroundColor in the willAppear delegate callback:
- (void)tableView:(UITableView *)tableView
willDisplayHeaderView:(UIView *)view
forSection:(NSInteger)section
or
- (void)tableView:(UITableView *)tableView
willDisplayFooterView:(UIView *)view
forSection:(NSInteger)section
How about using code to create a custom Header and place it?
- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSinteger)section {
UIView * myHeader = [[UIView alloc] initWithFrame: CGRectMake(0, 0, 320, 40)];
[myHeader setBackgroundColor:[UIColor grayColor]];
UILabel * TitleLabel = [[UILabel alloc] initWithFrame: CGRectMake(10, 5, 320, 20)];
TitleLabel.text = @"My Title";
[myHeader addSubview:TitleLabel];
return myHeader;
}