spade 0.0.1 → 0.0.2

data/sproutcore/frameworks/desktop/views/navigation.js

@@ -1,237 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2011 Strobe Inc. and contributors.
-//            Portions ©2008-2010 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-
-SC.TO_LEFT = "TOLEFT"; SC.TO_RIGHT = "TORIGHT";
-
-/** @class
-
-  NavigationView is very loosely based on UINavigationController:
-  that is, it implements a push/pop based API. 
-  
-  NavigationView checks if the view is NavigationBuildable--that is, if it has 
-  
-  Views may specify a topToolbar or bottomToolbar property. These will become the
-  top or bottom toolbars of the NavigationView (which is, incidentally, a WorkspaceView).
-  
-  Of course, this process is animated...
-  
-  @author Alex Iskander
-  @since SproutCore Quilmes
-*/
-
-sc_require("views/workspace");
-SC.NavigationView = SC.WorkspaceView.extend({
-  _views: null,
-  _current: null,
-  navigationContentView: SC.View.extend(),
-  
-  /**
-    Initializes the NavigationView by creating the view stack.
-  */
-  init: function() {
-    sc_super();
-    this._views = [];
-  },
-  
-  /**
-    Creates the navigation content view and places it inside the content view.
-  */
-  createChildViews: function() {
-    sc_super();
-    
-    // get the content
-    var content = this.get("navigationContentView");
-    
-    // instantiate if needed
-    if (content.isClass) content = this.createChildView(content);
-    
-    // set internal values
-    this._defaultContent = this.navigationContentView = content;
-    
-    // append to the content view
-    this.contentView.appendChild(content);
-  },
-  
-  /**
-    @private
-    Changes the content of the navigation, updating toolbars, etc., as needed.
-  */
-  changeNavigationContent: function(view) {
-    var top = null, bottom = null;
-    
-    // find top and bottom toolbars if we are setting it to a view
-    if (view) {
-      top = view.get("topToolbar"); 
-      bottom = view.get("bottomToolbar");
-    }
-    
-    // instantiate top if needed
-    if (top && top.isClass) {
-      view.set("topToolbar", top = top.create());
-    }
-    
-    // and now bottom
-    if (bottom && bottom.isClass) {
-      view.set("bottomToolbar", bottom = bottom.create());
-    }
-    
-    
-    // batch property changes for efficiency
-    this.beginPropertyChanges();
-    
-    // update current, etc. etc.
-    this._current = view;
-    this.set("navigationContentView", view ? view : this._defaultContent);
-    
-    // set the top/bottom appropriately
-    this.set("topToolbar", top);
-    this.set("bottomToolbar", bottom);
-    
-    // and we are done
-    this.endPropertyChanges();
-  },
-  
-  /**
-    Pushes a view into the navigation view stack. The view may have topToolbar and bottomToolbar properties.
-  */
-  push: function(view) {
-    this._currentDirection = this._current ? SC.TO_LEFT : null;
-    
-    // add current view to the stack (if needed)
-    if (this._current) this._views.push(this._current);
-    
-    // update content now...
-    this.changeNavigationContent(view);
-  },
-  
-  /**
-    Pops a view off the navigation view stack.
-  */
-  pop: function() {
-    this._currentDirection = SC.TO_RIGHT;
-    
-    // pop the view
-    var view = this._views.pop();
-    
-    // set new (old) content view
-    this.changeNavigationContent(view);
-  },
-  
-  /**
-    Pops to the specified view on the navigation view stack; the view you pass will become the current view.
-  */
-  popToView: function(toView) {
-    this._currentDirection = SC.TO_RIGHT;
-    var views = this._views,
-        idx = views.length - 1, 
-        view = views[idx];
-    
-    // loop back from end
-    while (view && view !== toView) {
-      this._views.pop();
-      idx--;
-      view = views[idx];
-    }
-    
-    // and change the content
-    this.changeNavigationContent(view);
-  },
-  
-  
-  topToolbarDidChange: function() {
-    var active = this.activeTopToolbar, replacement = this.get("topToolbar");
-    
-    // if we have an active toolbar, set the build direction and build out
-    if (active) {
-      if (this._currentDirection !== null) {
-        active.set("buildDirection", this._currentDirection);
-        this.buildOutChild(active);
-      } else {
-        this.removeChild(active);
-      }
-    }
-    
-    // if we have a new toolbar, set the build direction and build in
-    if (replacement) {
-      if (this._currentDirection !== null) {
-        replacement.set("buildDirection", this._currentDirection);
-        this.buildInChild(replacement);
-      } else {
-        this.appendChild(replacement);
-      }
-    }
-    
-    // update, and queue retiling
-    this.activeTopToolbar = replacement;
-    this.invokeOnce("childDidChange");
-  }.observes("topToolbar"),
-  
-  bottomToolbarDidChange: function() {
-    var active = this.activeBottomToolbar, replacement = this.get("bottomToolbar");
-    
-    if (active) {
-      if (this._currentDirection !== null) {
-        active.set("buildDirection", this._currentDirection);
-        this.buildOutChild(active);
-      } else {
-        this.removeChild(active);
-      }
-    }
-    if (replacement) {
-      if (this._currentDirection !== null) {
-        replacement.set("buildDirection", this._currentDirection);
-        this.buildInChild(replacement);
-      } else {
-        this.appendChild(replacement);
-      }
-    }
-    
-    this.activeBottomToolbar = replacement;
-    this.invokeOnce("childDidChange");
-  }.observes("topToolbar"),
-  
-  contentViewDidChange: function() {
-    var active = this.activeNavigationContentView, replacement = this.get("navigationContentView");
-    
-    // mix in navigationbuilder if needed
-    if (!replacement.isNavigationBuilder) {
-      replacement.mixin(SC.NavigationBuilder);
-    }
-    
-    // tiling really needs to happen _before_ animation
-    // so, we set "pending" and queue tiling.
-    this._pendingBuildOut = active;
-    this._pendingBuildIn = replacement;
-    
-    this.activeNavigationContentView = replacement;
-    this.invokeOnce("childDidChange");
-  }.observes("navigationContentView"),
-  
-  childDidChange: function() {
-    var replacement = this._pendingBuildIn, active = this._pendingBuildOut;
-    if (active) {
-      if (this._currentDirection !== null) {
-        active.set("buildDirection", this._currentDirection);
-        this.contentView.buildOutChild(active);
-      } else {
-        this.contentView.removeChild(active);
-      }
-    }
-
-    this._scws_tile();
-    
-    if (replacement) {
-      if (this._currentDirection !== null) {
-        replacement.set("buildDirection", this._currentDirection);
-        this.contentView.buildInChild(replacement);
-      } else {
-        this.contentView.appendChild(replacement);
-      }
-    }
-  }
-  
-});

data/sproutcore/frameworks/desktop/views/navigation_bar.js

@@ -1,181 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2011 Strobe Inc. and contributors.
-//            Portions ©2008-2009 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-
-sc_require("views/toolbar");
-
-/** @class
-  NavigationBars do Great Things. They transition themselves (fade in/out) and
-  all children (swoosh left/right). They accept isSwipeLeft and isSwipeRight views
-  that handle, well, swiping. In short, they are neat.
-  
-  @extends SC.ToolbarView
-  @since SproutCore 1.0
-*/
-SC.NavigationBarView = SC.ToolbarView.extend(SC.Gesturable, {
-  gestures: ["swipeGesture"],
-  swipeGesture: SC.SwipeGesture,
-
-  
-  init: function() {
-    sc_super();
-    
-    if (!SC.Animatable) {
-      SC.Logger.error(
-        "NavigationBarView requires SC.Animatable. " +
-        "Please make your app or framework require the animation framework. CRASH."
-      );
-    }
-  },
-
-  /**
-    @private
-    Mixies in animatable and the navigation bar transitions.
-  */
-  mixinAnimatable: function() {
-    this.mixin(SC.Animatable);
-    this.transitions = this.navigationTransitions;    
-  },
-  
-  /**
-    The default navigation transitions.
-  */
-  navigationTransitions: { 
-    opacity: {
-      duration: 0.25, action: "didFinishTransition"
-    } 
-  },
-  
-  /**
-    The default style (opacity is 1)
-  */
-  style: {
-    opacity: 1
-  },
-  
-  //
-  // GESTURE SUPPORT
-  //
-  
-  swipe: function(gesture, touch, direction) {
-    var lookingFor = (direction === SC.SWIPE_LEFT) ? "isSwipeLeft" : "isSwipeRight",
-        cv = this.get("childViews"), 
-        child, idx, len = cv.get("length");
-    
-    // loop through the children
-    for (idx = 0; idx < len; idx++) {
-      child = cv[idx];
-      
-      // see if this is the view we are looking for
-      if (child.get(lookingFor)) {
-        // just give it touch responder and end right away, just like ScrollView. Good times, eh?
-        touch.makeTouchResponder(child);
-        touch.end();
-        return;
-      }
-    }
-    
-  },
-  
-  //
-  // BUILD IN/OUT
-  //
-  
-  // for various reasons, including the fact that mixing in init  is VERY BAD, we do this lazily.
-  resetBuild: function() {
-    if (!this.isAnimatable) this.mixinAnimatable();
-  },
-  
-  // callback
-  didFinishTransition: function() {
-    if (this.isBuildingIn) {
-      // and please continue
-      this.buildInDidFinish();
-    } else if (this.isBuildingOut) this.buildOutDidFinish();
-  },
-  
-  preBuildIn: function() {
-    // first, fade this view out
-    this.disableAnimation();
-    this.adjust("opacity", 0).updateLayout();
-    this.enableAnimation();
-    
-    // now, loop over child views
-    var cv = this.get("childViews"), child, idx, len = cv.get("length");
-    for (idx = 0; idx < len; idx++) {
-      child = cv[idx];
-      
-      // if the child disables navigation transitions, skip
-      if (child.disableNavigationTransition) continue;
-      
-      // make sure the navigation stuff is mixed in as needed
-      if (!child._nv_mixedIn) this.mixinNavigationChild(child);
-      
-      // now, set the initial state, which is either to the left or to the right 100px.
-      child.disableAnimation();
-      child.transform(this.buildDirection === SC.TO_LEFT ? 100  : -100);
-      child.enableAnimation();
-    }
-  },
-  
-  buildIn: function() {
-    // first, we do the precursor
-    this.preBuildIn();
-    
-    // then, we queue the actual animation
-    this.invokeLater("startBuildIn", 10);
-  },
-  
-  startBuildIn: function() {
-    this.adjust("opacity", 1);
-
-    // get our frame, because we use it when computing child frames.
-    var cv = this.get("childViews"), child, idx, len = cv.get("length");
-    for (idx = 0; idx < len; idx++) {
-      child = cv[idx];
-      if (child.disableNavigationTransition) continue;
-      child.transform(0);
-    }
-  },
-
-  buildOut: function() {
-    this.adjust("opacity", 0);
-    
-    var cv = this.get("childViews"), child, idx, len = cv.get("length");
-    for (idx = 0; idx < len; idx++) {
-      child = cv[idx];
-      if (child.disableNavigationTransition) continue;
-      if (!child._nv_mixedIn) this.mixinNavigationChild(child);
-      child.transform(this.buildDirection === SC.TO_LEFT ? -100  : 100);
-    }
-  },
-  
-  /* CHILD VIEWS */
-  mixinNavigationChild: function(child) {
-    if (child.isAnimatable) return;
-    
-    // mix in animatable
-    child.mixin(SC.Animatable);
-    
-    // mix in the transitions (and the "natural" layout)
-    child.mixin({
-      transitions: {
-        transform: {timing: SC.Animatable.TRANSITION_EASE_IN_OUT, duration: 0.25}
-      },
-      naturalLayout: child.get("layout"),
-      transform: function(pos) {
-        if (SC.platform.supportsCSS3DTransforms) {
-          this.adjust("transform", "translate3d(" + pos + "px,0px,0px)");
-        } else {
-          this.adjust("transform", "translate(" + pos + "px,0px)");          
-        }
-      }
-    });
-    
-    // and mark as having mixed in.
-    child._nv_mixedIn = YES;
-  }
-});

data/sproutcore/frameworks/desktop/views/popup_button.js

@@ -1,299 +0,0 @@
-sc_require('views/button');
-
-/**
-  Describes the time after which "click and hold" behavior will replace the
-  standard "click and release" behavior.
-*/
-
-
-/** @class
-
-  SC.PopupButtonView displays a pop-up menu when clicked, from which the user
-  can select an item.
-
-  To use, create the SC.PopupButtonView as you would a standard SC.ButtonView,
-  then set the menu property to an instance of SC.MenuPane. For example:
-
-{{{
-SC.PopupButtonView.design({
-  layout: { width: 200, height: 18 },
-  menuBinding: 'MyApp.menuController.menuPane'
-});
-}}}
-
-  You would then have your MyApp.menuController return an instance of the menu
-  to display.
-
-  @extends SC.ButtonView
-  @author Santosh Shanbhogue
-  @author Tom Dale
-  @copyright 2008-2011, Strobe Inc. and contributors.
-  @version 1.0
-*/
-SC.PopupButtonView = SC.ButtonView.extend(
-/** @scope SC.PopupButtonView.prototype */ {
-  classNames: ['sc-popup-button'],
-
-  // ..........................................................
-  // PROPERTIES
-  //
-
-  /**
-    The prefer matrix to use when displaying the menu.
-
-    @property
-  */
-  preferMatrix: null,
-
-  /**
-    The SC.MenuPane that should be displayed when the button is clicked.
-
-    @type {SC.MenuPane}
-    @default null
-  */
-  menu: null,
-  
-  /**
-    If YES and the menu is a class, this will cause a task that will instantiate the menu
-    to be added to SC.backgroundTaskQueue.
-  */
-  shouldLoadInBackground: NO,
-
-  // ..........................................................
-  // INTERNAL SUPPORT
-  //
-  
-  /**
-    @private
-    If necessary, adds the loading of the menu to the background task queue.
-  */
-  init: function() {
-    sc_super();
-    this._setupMenu();
-    if (this.get('shouldLoadInBackground')) {
-      SC.backgroundTaskQueue.push(SC.PopupButtonMenuLoader.create({ popupButton: this }));
-    }
-  },
-  
-  /**
-    @private
-    Sets up binding on the menu, removing any old ones if necessary.
-  */
-  _setupMenu: function() {
-    var menu = this.get('instantiatedMenu');
-    
-    // clear existing bindings
-    if (this.isActiveBinding) this.isActiveBinding.disconnect();
-    this.isActiveBinding = null;
-    
-    // if there is a menu
-    if (menu && !menu.isClass) {
-      this.isActiveBinding = this.bind('isActive', menu, 'isVisibleInWindow');
-    }
-  },
-  
-  /**
-    Setup the bindings for menu...
-  */
-  _popup_menuDidChange: function() {
-    this._setupMenu();
-  }.observes('menu'),
-
-  /** @private
-    isActive is NO, but when the menu is instantiated, it is bound to the menu's isVisibleInWindow property.
-  */
-  isActive: NO,
-  
-  /**
-    @private
-    Instantiates the menu if it is not already instantiated.
-  */
-  _instantiateMenu: function() {
-    // get menu
-    var menu = this.get('menu');
-    
-    // if it is already instantiated or does not exist, we cannot do anything
-    if (!menu || !menu.isClass) return;
-    
-    // create
-    this.menu = menu.create();
-    
-    // setup
-    this._setupMenu();
-  },
-  
-  acceptsFirstResponder: YES,
-  
-  /**
-    The guaranteed-instantiated menu.
-  */
-  instantiatedMenu: function() {
-    // get the menu
-    var menu = this.get('menu');
-    
-    // if it is a class, we need to instantiate it
-    if (menu && menu.isClass) {
-      // do so
-      this._instantiateMenu();
-      
-      // get the new version of the local
-      menu = this.get('menu');
-    }
-    
-    // return
-    return menu;
-  }.property('menu').cacheable(),
-
-  /** @private
-    Displays the menu.
-
-    @param {SC.Event} evt
-  */
-  action: function(evt)
-  {
-    var menu = this.get('instantiatedMenu') ;
-
-    if (!menu) {
-      //@ if (debug)
-      SC.Logger.warn("SC.PopupButton - Unable to show menu because the menu property is set to %@.".fmt(menu));
-      //@ endif
-      return NO ;
-    }
-
-    menu.popup(this, this.get('preferMatrix')) ;
-    return YES;
-  },
-
-  /** @private
-    On mouse down, we set the state of the button, save some state for further
-    processing, then call the button's action method.
-
-    @param {SC.Event} evt
-    @returns {Boolean}
-  */
-  mouseDown: function(evt) {
-    // If disabled, handle mouse down but ignore it.
-    if (!this.get('isEnabled')) return YES ;
-
-    this._isMouseDown = YES;
-
-    this._action() ;
-
-    // Store the current timestamp. We register the timestamp at the end of
-    // the runloop so that the menu has been rendered, in case that operation
-    // takes more than a few hundred milliseconds.
-
-    // One mouseUp, we'll use this value to determine how long the mouse was
-    // pressed.
-    this.invokeLast(this._recordMouseDownTimestamp);
-
-    this.becomeFirstResponder();
-
-    return YES ;
-  },
-
-  /** @private
-    Records the current timestamp. This is invoked at the end of the runloop
-    by mouseDown. We use this value to determine the delay between mouseDown
-    and mouseUp.
-  */
-  _recordMouseDownTimestamp: function() {
-    this._menuRenderedTimestamp = new Date().getTime();
-  },
-
-  /** @private
-    Because we responded YES to the mouseDown event, we have responsibility
-    for handling the corresponding mouseUp event.
-
-    However, the user may click on this button, then drag the mouse down to a
-    menu item, and release the mouse over the menu item. We therefore need to
-    delegate any mouseUp events to the menu's menu item, if one is selected.
-
-    We also need to differentiate between a single click and a click and hold.
-    If the user clicks and holds, we want to close the menu when they release.
-    Otherwise, we should wait until they click on the menu's modal pane before
-    removing our active state.
-
-    @param {SC.Event} evt
-    @returns {Boolean}
-  */
-  mouseUp: function(evt) {
-    var timestamp = new Date().getTime(),
-        previousTimestamp = this._menuRenderedTimestamp,
-        menu = this.get('instantiatedMenu'),
-        touch = SC.platform.touch,
-        targetMenuItem;
-
-    if (menu) {
-      // Get the menu item the user is currently hovering their mouse over
-      targetMenuItem = menu.getPath('rootMenu.targetMenuItem');
-
-      if (targetMenuItem) {
-        // Have the menu item perform its action.
-        // If the menu returns NO, it had no action to
-        // perform, so we should close the menu immediately.
-        if (!targetMenuItem.performAction()) menu.remove();
-      } else {
-        // If the user waits more than certain amount of time between
-        // mouseDown and mouseUp, we can assume that they are clicking and
-        // dragging to the menu item, and we should close the menu if they
-        //mouseup anywhere not inside the menu.
-        if (!touch && (timestamp - previousTimestamp > SC.ButtonView.CLICK_AND_HOLD_DELAY)) {
-          menu.remove();
-        }
-      }
-    }
-
-    // Reset state.
-    this._isMouseDown = NO;
-    sc_super();
-    return YES;
-  },
-
-  /** @private
-    Overrides ButtonView's mouseExited method to remove the behavior where the
-    active state is removed on mouse exit. We want the button to remain active
-    as long as the menu is visible.
-
-    @param {SC.Event} evt
-    @returns {Boolean}
-  */
-  mouseExited: function(evt) {
-    return YES;
-  },
-
-  /** @private
-    Overrides performKeyEquivalent method to pass any keyboard shortcuts to
-    the menu.
-
-    @param {String} charCode string corresponding to shortcut pressed (e.g.,
-    alt_shift_z)
-    @param {SC.Event} evt
-  */
-  performKeyEquivalent: function( charCode, evt )
-  {
-    if (!this.get('isEnabled')) return NO ;
-    var menu = this.get('instantiatedMenu') ;
-
-    return (!!menu && menu.performKeyEquivalent(charCode, evt, YES)) ;
-  },
-
-  /** @private */
-  acceptsFirstResponder: function() {
-    if(!SC.SAFARI_FOCUS_BEHAVIOR) return this.get('isEnabled');
-    else return NO;
-  }.property('isEnabled')
-
-});
-
-/**
-  @private
-  Handles lazy instantiation of popup button menu.
-*/
-SC.PopupButtonMenuLoader = SC.Task.extend({
-  popupButton: null,
-  run: function() {
-    if (this.popupButton) this.popupButton._instantiateMenu();
-  }
-});
-