41

How can set the background image, or clear the background, of a search bar, like the note application?

1
  • self.searchBar.setSearchFieldBackgroundImage(UIImage(), for: .normal)
    – AndrewK
    Feb 23, 2022 at 18:22

13 Answers 13

175

A future-proof way:

[searchBar setBackgroundImage:[UIImage new]];
[searchBar setTranslucent:YES];
11
  • 1
    Working on ios 5 & ios 6 as well. Tested on IPad Jan 25, 2013 at 14:36
  • Great, but : [UIImage new] is equivalent to [[UIImage alloc] init]. Your image is never released. > Do [searchBar setBackgroundImage:[[UIImage new]autorelease]];
    – Martin
    May 23, 2013 at 17:38
  • 1
    it's released for you if you use ARC though.
    – Kevlar
    May 29, 2013 at 19:29
  • 8
    Martin no! Use ARC dammit. Unless you need super performant code, even then I'm not convinced ARC wont be better for most situations.
    – powerj1984
    Jun 13, 2013 at 16:47
  • 4
    Confirmed this works with iOS 7
    – RyanG
    Sep 25, 2013 at 20:55
29

mj_ has the answer that i used. i was just going to comment as such but i can't yet. So i'll just post my own answer with my implementation where I add a search bar to the top of a table view with a semi-transparent BG.

DLog(@"    Add search bar to table view"); 

//could be a UIImageView to display an image..?
bg = [[[UIView alloc] initWithFrame:CGRectMake(0, 0, 320, 45)] autorelease];
bg.backgroundColor        = [UIColor blackColor];
UISearchBar *sb           = [[[UISearchBar alloc]initWithFrame:CGRectMake(0, 0, 290, 45)] autorelease];
sb.barStyle               = UIBarStyleBlackTranslucent;
sb.showsCancelButton      = NO;
sb.autocorrectionType     = UITextAutocorrectionTypeNo;
sb.autocapitalizationType = UITextAutocapitalizationTypeNone;
sb.delegate               = self;
[bg addSubview:sb];
table.tableHeaderView     = bg;

for (UIView *subview in sb.subviews) {
    if ([subview isKindOfClass:NSClassFromString(@"UISearchBarBackground")]) {
        [subview removeFromSuperview];
        break;
    }
}   
5
  • 3
    +1 for still being accurate in 2011. I was looking for the last five lines of your example. Cheers!
    – epologee
    Jan 25, 2011 at 21:20
  • if you use an uiimageview to display a backgroundimage and you want to hide the searchbar behind the navigationbar, the image needs to be 44 px height. Or use clipsToBounds = YES, otherwise there will be a 1 px line drawn under the navigationbar.
    – Olof
    Jul 25, 2011 at 9:32
  • I did like this: NSClassFromString([NSString stringWithFormat:@"U%@Sea%@", @"I", @"rchBarBackground"]) in case apple would search for strings naming their private class.. but don't know if it would help(?)
    – hfossli
    Aug 19, 2011 at 13:29
  • 1
    Will Apple reject this code because it's using private class "UISearchBarBackground"?
    – nonamelive
    Dec 25, 2011 at 6:00
  • I used this in an application that was submitted to the app store and it was not rejected.
    – katbyte
    Dec 10, 2012 at 19:45
14

I had problems w/ the answer above. I used the following.

for (UIView *subview in searchBar.subviews) {
    if ([subview isKindOfClass:NSClassFromString(@"UISearchBarBackground")]) {
        [subview removeFromSuperview];
        break;
    }
}
4
  • As of SDK 4.2, this breaks the buttons and fields. Nov 30, 2010 at 4:30
  • I'm wrong, it only does that if you put this code in layoutSubviews. Duh. Nov 30, 2010 at 4:41
  • 3
    Don't forget to set your color after for cycle - [searchBar setBackgroundColor:[UIColor clearColor]];
    – beryllium
    Feb 16, 2012 at 14:04
  • This approach does not work in Xcode 4.4.1 on iOS 5.1.
    – Maksim
    Sep 26, 2012 at 13:06
12

This worked for me (ios4.2+)

// Change the search bar background
-(void)viewWillAppear:(BOOL)animated {
    for (UIView *subview in self.searchBar.subviews) {
        if ([subview isKindOfClass:NSClassFromString(@"UISearchBarBackground")]) {
            UIView *bg = [[UIView alloc] initWithFrame:subview.frame];
            bg.backgroundColor = [UIColor colorWithPatternImage:[UIImage imageNamed:@"search_bar_bg"]];
            [self.searchBar insertSubview:bg aboveSubview:subview];
            [subview removeFromSuperview];
            break;
        }
    }   
}
0
8

I just came up with a solution that works really well. You have to override the UISearchBar and then hide both the Background and Segment Control layers. Then Draw the background.

@ .m

#import "UISearchBar.h" 
#import <QuartzCore/QuartzCore.h>

@implementation UISearchBar(CustomBackground)

- (id)init
    {
        for ( UIView * subview in self.subviews ) 
        {
            if ([subview isKindOfClass:NSClassFromString(@"UISearchBarBackground") ] ) 
                subview.alpha = 0.0;  

            if ([subview isKindOfClass:NSClassFromString(@"UISegmentedControl") ] )
                subview.alpha = 0.0; 
        } 

        return self;
    }

+ (UIImage *) bgImagePortrait
    {
        static UIImage *image = nil;
        if (image == nil)
            image = [[UIImage imageNamed:@"UISearchBarBack.png"] retain ];

        return image;
    }

+ (UIImage *) bgImageLandscape
    {
        static UIImage *image = nil;
        if (image == nil)
            image = [[UIImage imageNamed:@"UISearchBarBack.png"] retain];

        return image;
    }

- (void) drawLayer:(CALayer *)layer inContext:(CGContextRef)contenxt
    {
        if ([self isMemberOfClass:[UISearchBar class]] == NO)
            return; 

        UIImage * image = ( self.frame.size.width > 320 ) ? [UISearchBar bgImageLandscape ] : [UISearchBar bgImagePortrait ];  

        for ( UIView * subview in self.subviews ) {
            if ([subview isKindOfClass:NSClassFromString(@"UISearchBarBackground") ] ) 
                subview.alpha = 0.0; 

            if ([subview isKindOfClass:NSClassFromString(@"UISegmentedControl") ] )
                subview.alpha = 0.0; 
        }

        CGContextTranslateCTM( contenxt , 0 , image.size.height );
        CGContextScaleCTM( contenxt, 1.0, -1.0 );
        CGContextDrawImage( contenxt , CGRectMake( 0 , 0 , image.size.width , image.size.height ), image.CGImage );
    }  

@end

@ .h

#import <Foundation/Foundation.h>
#import <QuartzCore/QuartzCore.h>


@interface UISearchBar(CustomBackground) 

@end

Hope this helps!

2
  • 1
    Doesn't work for me... (ios 4.2)
    – Chris
    May 27, 2011 at 6:23
  • 2
    Also does not work for me on iOS 5
    – jjxtra
    Jan 12, 2012 at 22:55
8

You have two questions here:
1.UISearchBar clear background color:
See my answer here

2.Set background image Solution:(If you are in iOS 5.0 +)

[[UISearchBar appearance]setSearchFieldBackgroundImage:[navBarGradImage resizableImageWithCapInsets:inset2] forState:UIControlStateNormal];

NOTE: You can also try using a transparent image as a background.

Hope this helps.

4

I prefer to just set the alpha to 0 so you can hide/show on demand.

// Hide
[[self.theSearchBar.subviews objectAtIndex:0] setAlpha:0.0];

// Show
[[self.theSearchBar.subviews objectAtIndex:0] setAlpha:1.0];
1
  • This does not work in Xcode 4.4.1.
    – Maksim
    Sep 26, 2012 at 13:04
4

How to set background color in UISearchBar:

#import <QuartzCore/QuartzCore.h>

Then make an outlet connection to search bar (say, objSearchbar), and use these lines :

for (UIView *subview in self.objSearchbar.subviews) 
{
    if ([subview isKindOfClass:NSClassFromString(@"UISearchBarBackground")]) 
    {
        [subview removeFromSuperview];
        break;
    }
}

self.tweetSearchbar.layer.backgroundColor = [UIColor blueColor].CGColor;
1
  • this thing is working fine for me. +1 rated.
    – Nirav Jain
    Jan 8, 2013 at 6:00
4

searchBar.searchBarStyle = UISearchBarStyleMinimal;

2

Look here: UISearchbar background image change

2

with iOS8 sdks apple moved @"UISearchBarBackground" view one level deeper, so have will need to look at subviews of the child-views as bellow,

for (UIView *subview in searchBar.subviews) {
        for(UIView* grandSonView in subview.subviews){
            if ([grandSonView isKindOfClass:NSClassFromString(@"UISearchBarBackground")]) {
                grandSonView.alpha = 0.0f;
            }else if([grandSonView isKindOfClass:NSClassFromString(@"UISearchBarTextField")] ){
                NSLog(@"Keep textfiedld bkg color");
            }else{
                grandSonView.alpha = 0.0f;
            }
        }//for cacheViews
    }//subviews
1

Set background image

    UIImageView *backgroundView = [[UIImageView alloc] initWithFrame:searchBar.bounds];
    backgroundView.image = [UIImage imageNamed:@"xxxx.png"];
    [searchBar insertSubview:backgroundView atIndex:1]; // at index 1 but not 0
    [backgroundView release];
0

One liner:

[[self.theSearchBar.subviews objectAtIndex:0] removeFromSuperview];

Not the answer you're looking for? Browse other questions tagged or ask your own question.