An iTunes-style navigation bar for Mac OS X 10.5 or above, created by Alex Rozanski.
PXNavigationBar is licensed under the New BSD License
What is this?
PXNavigationBar is a control used for navigating through hierarchical content, and is modelled on the iTunes navigation bar, as seen below:
(The screenshot was taken from the podcasts window in iTunes)
As you can see, the control is comprised of three parts: the title of the current item in the center, a back button on the left, and two navigation buttons on the right.
How the control works
PXNavigationBar works as follows:
- Each level in the navigation hierarchy is represented by a
PXNavigationLevelinstance holds an array of
PXNavigationItems which represent individual items in that level.
PXNavigationLevels are pushed and popped off the navigation bar's stack when needed to be.
- Each navigation level has a pointer to the "currently selected" navigation item; this is the item which is displayed by the navigation bar.
- Pressing the back button pops the current navigation level off the stack
- Pressing the left or right navigation buttons navigates either left or right in the array of items in the currently displayed level.
Using the code
There are only a few steps involved.
- Download the source, and copy the following files into your Xcode project:
- The images in the
- To create the control in Interface Builder, drag a custom
NSViewobject from the Library to your window/view. In the Identity Inspector change the class name from
PXNavigationBar. The bar can take any width but ensure that the height is 28 pixels.
- Make sure to
#import "PXNavigationBar.h"for files that require it (the other header files are imported from this main header), and ensure that the object which is the delegate for the navigation bar conforms to the
There is also an example project bundled with the source to see how the control is used.
Documentation is available for
PXNavigationBar, downloadable from the downloads page. Provided in the ZIP file is a folder containing HTML documentation, or a docset which can be opened in Xcode and which is then searchable from the Xcode Developer Documentation.
If you feel that any areas of the documentation are lacking or missing, please feel free to let me know, which will be much appreciated.
PXNavigationBar is licensed under the BSD 3-Clause License, as detailed below (adapted from the OSI http://opensource.org/licenses/BSD-3-Clause):
Copyright © 2010, Alex Rozanski
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.