{"id":18270470,"url":"https://github.com/BitSuites/BPBarButtonItem","last_synced_at":"2025-04-05T01:30:37.609Z","repository":{"id":56903119,"uuid":"9726266","full_name":"BitSuites/BPBarButtonItem","owner":"BitSuites","description":"DEPRECATED - A tool for making awesome looking custom UIBarButtonItems on the fly.","archived":false,"fork":false,"pushed_at":"2017-05-10T19:54:29.000Z","size":388,"stargazers_count":373,"open_issues_count":0,"forks_count":27,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-03-04T09:38:39.789Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BitSuites.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-04-28T06:20:56.000Z","updated_at":"2024-12-08T12:44:47.000Z","dependencies_parsed_at":"2022-08-20T18:50:55.887Z","dependency_job_id":null,"html_url":"https://github.com/BitSuites/BPBarButtonItem","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitSuites%2FBPBarButtonItem","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitSuites%2FBPBarButtonItem/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitSuites%2FBPBarButtonItem/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitSuites%2FBPBarButtonItem/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BitSuites","download_url":"https://codeload.github.com/BitSuites/BPBarButtonItem/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247276022,"owners_count":20912285,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T11:38:39.671Z","updated_at":"2025-04-05T01:30:37.186Z","avatar_url":"https://github.com/BitSuites.png","language":"Objective-C","readme":"DEPRECATED BPBarButtonItem\n===============\n\nNOTE - This code has been deperecated since it isn't applicable to apps built for iOS 7 and after.\n\nBPBarButtonItem is a tool for making awesome looking custom UIBarButtonItems on the fly. BPBarButtonItem is *NOT* a subclass of `UIBarButtonItem` but an `NSObject` which creates skinned plain `UIBarButtonItem`s for use however you want. BPBarButtonItem can also be used to skin `UIBarButtonItem`s which have already been created, like in a nib or Storyboard. Generated buttons have support for both orientation styles, and automatically show up properly for back buttons.\n\n![BPBarButtonItem Screenshot 1][sshot1]\u003cbr\u003e\n\u003cbr\u003e\n![BPBarButtonItem Screenshot 2][sshot2]\u003cbr\u003e\n\u003cbr\u003e\n![BPBarButtonItem Screenshot 3][sshot3]\u003cbr\u003e\n\u003cbr\u003e\n![BPBarButtonItem Screenshot 4][sshot4]\u003cbr\u003e\n\u003cbr\u003e\n![BPBarButtonItem Screenshot 5][sshot5]\u003cbr\u003e\n\u003cbr\u003e\n![BPBarButtonItem Screenshot 6][sshot6]\u003cbr\u003e\n\n## Installation\n\n### From [CocoaPods](http://cocoapods.org/?q=bpbarbuttonitem)\n\n\tpod 'BPBarButtonItem'\n\n### From Source\n\n* Drag the `BPBarButtonItem/` folder to your project (make sure you copy all files/folders)\n* `#import \"BPBarButtonItem.h\"`\n\n## How to Use\n\nThere are 3 main ways to use BPBarButtonItem:\n\n### Creating a brand new button in code\n\nThis will allow you to create a brand new `UIBarButtonItem` on the fly. You can use any of the predefined styles or set your own tint color.\n\n````objective-c\nself.navigationItem.rightBarButtonItem = [BPBarButtonItem barButtonItemWithStyle:BPBarButtonItemStyleAction title:@\"Action\" target:self  action:@selector(buttonAction:)];\n````\n```objective-c\nself.navigationItem.rightBarButtonItem = [BPBarButtonItem barButtonItemWithTintColor:[UIColor redColor] title:@\"Red\" target:self action:@selector(buttonAction:)];\n```\n\n### Styling an existing button (often from a nib or Storyboard)\n\nThis will style any existing `UIBarButtonItem`. The title, action, and any other attributes are not modified. This works from an `IBOutlet` or by accessing the `navigationItem`'s right and left button properties directly.\n\n```objective-c\n[BPBarButtonItem customizeBarButtonItem:self.navigationItem.rightBarButtonItem withStyle:BPBarButtonItemStyleStandardDark];\n```\n```objective-c\n[BPBarButtonItem customizeBarButtonItem:self.navigationItem.rightBarButtonItem withTintColor:[UIColor colorWithRed:0.048 green:0.169 blue:0.458 alpha:1.000]];\n```\n\n### Styling ALL the buttons using an Appearance Proxy\n\nWant to style all the buttons in your app to be consistent, but don't want to set them all individually? Setting the default button style is almost identical to styling an existing button, except you pass in `nil` for the button item. You'll generally want to do this as part of your `application:didFinishLaunchingWithOptions:` method.\n\n```objective-c\n[BPBarButtonItem customizeBarButtonItem:nil withStyle:BPBarButtonItemStyleStandardDark];\n```\n\nNote that with the Appearance Proxy method, you can still override individual buttons using the existing button styling method above.\n\nYou can also get complex and pass in a specific Appearance Proxy as well. For example, this may be used to stylize buttons in a `UINavigationBar` but not those in a `UIToolbar`.\n\n```objective-c\n[BPBarButtonItem customizeBarButtonItem:[UIBarButtonItem appearanceWhenContainedIn:[UINavigationBar class], nil] withStyle:BPBarButtonItemStyleStandardLight];\n```\n\n### Styling Segmented Controls\n\nYou can style a `UISegmentedControl` directly or using an Appearance Proxy. The syntax is similar to UIBarButtonItems as shown above.\n\n```objective-c\n[BPBarButtonItem customizeSegmentedControl:mySegmentedControl withStyle:BPBarButtonItemStyleStandardDark];\n```\n\n```objective-c\n[BPBarButtonItem customizeSegmentedControl:nil withStyle:BPBarButtonItemStyleStandardDark];\n```\n\n## Things BPBarButtonItem Can't Do\n\nBPBarButtonItem makes standard, plain-old `UIBarButtonItem`s, and as such they have the same limitations. You can't use them outside of a navigation bar or a toolbar. If you're looking for a nicely styled `UIButton` alternative, check out [BButton](https://github.com/mattlawer/BButton).\n\n## License\n\n[MIT License](http://opensource.org/licenses/MIT)\n\nCopyright (c) 2013 Cory Imdieke\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n## Contact and Attribution\n\nAttribution is nice, but not necessary.\u003cbr\u003e\nhttps://twitter.com/CoryImdieke\n\nThanks to Brian Gilham for help with the design details.\u003cbr\u003e\nhttps://twitter.com/bgilham\n\n[sshot1]:https://raw.github.com/BitSuites/BPBarButtonItem/master/Screenshots/screenshot-1.png\n[sshot2]:https://raw.github.com/BitSuites/BPBarButtonItem/master/Screenshots/screenshot-2.png\n[sshot3]:https://raw.github.com/BitSuites/BPBarButtonItem/master/Screenshots/screenshot-3.png\n[sshot4]:https://raw.github.com/BitSuites/BPBarButtonItem/master/Screenshots/screenshot-4.png\n[sshot5]:https://raw.github.com/BitSuites/BPBarButtonItem/master/Screenshots/screenshot-5.png\n[sshot6]:https://raw.github.com/BitSuites/BPBarButtonItem/master/Screenshots/screenshot-6.png\n","funding_links":[],"categories":["etc"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBitSuites%2FBPBarButtonItem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBitSuites%2FBPBarButtonItem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBitSuites%2FBPBarButtonItem/lists"}