Class Index | File Index

Classes


Class TKNavigationController


Extends TKController.

The spatial navigation manager is a pre-insantiated singleton controller that handles the logic for all navigation between controllers. The currently showing controller is the topController, and is the last item of the controllers array, which traces the complete navigation history from the home controller onwards. By implementing the TKNavigationControllerDelegate protocol, the navigation controller's delegate can track as the user navigates between controllers. While the TKController#navigatesTo property should be sufficient to alloe developers to specify what action triggers a navigation to a given controller, the pushController and popController methods also allow a programmatic interaction with the navigation controller.


Defined in: NavigationController.js.

Class Summary
Constructor Attributes Constructor Name and Description
 
Field Summary
Field Attributes Field Name and Description
 
The list of controllers in the navigation stack.
 
The delegate for this navigation controller, an object implementing the TKNavigationControllerDelegate protocol.
<static>  
TKNavigationController.sharedNavigation
 
The controller at the top of the navigation stack of controllers.
Fields borrowed from class TKController:
actions, backButton, becomesActiveTransition, becomesInactiveTransition, id, navigableElements, navigatesTo, outlets, parentController, preloads, scrollableElement, template
Method Summary
Method Attributes Method Name and Description
 
Pops the top topController off the navigation stack, triggering an animated transition of the new top controller using its TKController.becomesActiveTransition property and the TKController.becomesInactiveTransition property of the previous topController
 
pushController(controller)
Pushes a new controller to the top of the navigation stack, triggering an animated transition of the new top controller using its TKController.becomesActiveTransition property and the TKController.becomesInactiveTransition property of the previous topController
Methods borrowed from class TKController:
addNavigableElement, customMetricsForElement, elementWasActivated, elementWasHighlighted, elementWasHovered, elementWasUnhighlighted, elementWasUnhovered, handleEvent, isDescendentOfController, isViewLoaded, keyWasPressed, preferredElementToHighlightInDirection, processView, removeNavigableElement, viewDidAppear, viewDidDisappear, viewDidLoad, viewWasInsertedIntoDocument, viewWillAppear, viewWillDisappear, wantsToHandleKey
Methods borrowed from class TKObject:
addPropertyObserver, callMethodNameAfterDelay, callSuper, notifyPropertyChange, removePropertyObserver
Class Detail
TKNavigationController(data)
Parameters:
{Object} data
A hash of properties to use as this object is initialized.
Since:
TuneKit 1.0
Field Detail
{Array} controllers
The list of controllers in the navigation stack. The controller at the first index is the root-most controller, while the controller at the last index is the top controller.

{Object} delegate
The delegate for this navigation controller, an object implementing the TKNavigationControllerDelegate protocol.

<static> TKNavigationController.sharedNavigation

{TKController} topController
The controller at the top of the navigation stack of controllers.
Method Detail
popController()
Pops the top topController off the navigation stack, triggering an animated transition of the new top controller using its TKController.becomesActiveTransition property and the TKController.becomesInactiveTransition property of the previous topController

pushController(controller)
Pushes a new controller to the top of the navigation stack, triggering an animated transition of the new top controller using its TKController.becomesActiveTransition property and the TKController.becomesInactiveTransition property of the previous topController
Parameters:
{TKController} controller
The controller to push onto the navigation stack.

Copyright © 2009 Apple Inc. All rights reserved.