sproutcore 1.10.3.1 → 1.11.0.rc1

data/lib/frameworks/sproutcore/frameworks/desktop/views/select_field.js

@@ -1,404 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2011 Strobe Inc. and contributors.
-//            Portions ©2008-2011 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-
-
-/**
-  @class
-
-  DEPRECATED. Use SelectView instead.
-
-  SelectFieldView displays browser-native popup menu.  To use this view,
-  you should either bake into the HTML the preset list of options, or
-  you can set the -objects property to an array of items to show.  The
-  value is current value of the select.
-
-  @deprecated
-  @extends SC.FieldView
-  @author Charles Jolley
-  @author Mike Ball
-  @since SproutCore 1.0
-*/
-SC.SelectFieldView = SC.FieldView.extend(
-/** @scope SC.SelectFieldView.prototype */ {
-
-  /**
-    @type Array
-    @default ['objects','nameKey','valueKey']
-    @see SC.View#displayProperties
-  */
-  displayProperties: ['objects','nameKey','valueKey'],
-
-  /**
-    Reflects the value of `isEnabledInPane`.
-
-    @field
-    @type Boolean
-    @default YES
-  */
-  acceptsFirstResponder: function() {
-    return this.get('isEnabledInPane');
-  }.property('isEnabledInPane'),
-
-  /**
-    @type String
-    @default 'select'
-    @see SC.View#tagName
-  */
-  tagName: 'select',
-
-  /**
-    @type Array
-    @default ['sc-select-field-view']
-    @see SC.View#classNames
-  */
-  classNames: ['sc-select-field-view'],
-
-  /**
-    An array of items that will form the menu you want to show.
-
-    @type Array
-    @default []
-  */
-  objects: [],
-
-  /** @private
-    Binding default for an array of objects
-  */
-  objectsBindingDefault: SC.Binding.multiple(),
-
-  /**
-    If you set this to a non-null value, then the name shown for each
-    menu item will be pulled from the object using the named property.
-    if this is null, the collection objects themselves will be used.
-
-    @type String
-    @default null
-  */
-  nameKey: null,
-
-  /**
-    If you set this to a non-null value, then the value of this key will
-    be used to sort the objects.  If this is not set, then nameKey will
-    be used.
-
-    @type String
-    @default null
-  */
-  sortKey: null,
-
-  /**
-     Set this to a non-null value to use a key from the passed set of objects
-     as the value for the options popup.  If you don't set this, then the
-     objects themselves will be used as the value.
-
-     @type String
-     @default null
-  */
-  valueKey: null,
-
-  /**
-    set this to non-null to place an empty option at the top of the menu.
-
-    @type String
-    @default null
-  */
-  emptyName: null,
-
-  /**
-    if true, the empty name will be localized.
-
-    @type Boolean
-    @default NO
-  */
-  localize: NO,
-
-  /** @private
-    if true, it means that the nameKey, valueKey or objects changed
-  */
-  cpDidChange: YES,
-
-  /**
-    if true, it means that no sorting will occur, objects will appear
-    in the same order as in the array
-
-    @type Boolean
-    @default NO
-  */
-  disableSort: NO,
-
-  /**
-    override this to change the enabled/disabled state of menu items as they
-    are built.  Return false if you want the menu item to be disabled.
-
-    @param itemValue the value for the item to validate
-    @param itemName the name of the menu item to validate
-    @returns YES if the item should be enabled, NO otherwise
-  */
-  validateMenuItem: function(itemValue, itemName) {
-    return YES;
-  },
-
-  /**
-    override this method to implement your own sorting of the menu. By
-    default, menu items are sorted using the value shown or the sortKey
-
-    @param objects the unsorted array of objects to display.
-    @returns sorted array of objects
-  */
-  sortObjects: function(objects) {
-    if(!this.get('disableSort')){
-      var nameKey = this.get('sortKey') || this.get('nameKey') ;
-      if(nameKey) objects = objects.sortProperty(nameKey);
-      else{
-        objects = objects.sort(function(a,b) {
-          if (nameKey) {
-            a = a.get ? a.get(nameKey) : a[nameKey] ;
-            b = b.get ? b.get(nameKey) : b[nameKey] ;
-          }
-          return (a<b) ? -1 : ((a>b) ? 1 : 0) ;
-        }) ;
-      }
-    }
-    return objects ;
-  },
-
-  /** @private */
-  render: function(context, firstTime) {
-    // Only re-render if it's the firstTime or if a change is required
-    if (firstTime || this.get('cpDidChange')) {
-      this.set('cpDidChange', NO);
-      // get list of objects.
-      var nameKey = this.get('nameKey') ;
-      var valueKey = this.get('valueKey') ;
-      var objects = this.get('objects') ;
-      var fieldValue = this.get('value') ;
-      var el, selectElement;
-
-      if ( !this.get('isEnabled') ) context.setAttr('disabled','disabled');
-
-      // get the localization flag.
-      var shouldLocalize = this.get('localize');
-
-      // convert fieldValue to guid, if it is an object.
-      if (!valueKey && fieldValue) fieldValue = SC.guidFor(fieldValue) ;
-      if ((fieldValue === null) || (fieldValue === '')) fieldValue = '***' ;
-
-      if (objects) {
-        objects = this.sortObjects(objects) ; // sort'em.
-        // var html = [] ;
-        if(!firstTime){
-          selectElement=this.$input()[0];
-          if (!selectElement) return;
-          selectElement.innerHTML='';
-        }
-
-        var emptyName = this.get('emptyName') ;
-        if (emptyName) {
-          if (shouldLocalize) emptyName = SC.String.loc(emptyName);
-          if(firstTime){
-            context.push('<option value="***">'+emptyName+'</option>',
-                          '<option disabled="disabled"></option>') ;
-          }else{
-            el=document.createElement('option');
-            el.value="***";
-            el.innerHTML=emptyName;
-            selectElement.appendChild(el);
-            el=document.createElement('option');
-            el.disabled="disabled";
-            selectElement.appendChild(el);
-          }
-        }
-
-          // generate option elements.
-        objects.forEach(function(object, index) {
-        if (object) {
-          // either get the name from the object or convert object to string.
-          var name = nameKey ? (object.get ? object.get(nameKey) : object[nameKey]) : object.toString() ;
-
-          // localize name if specified.
-          if(shouldLocalize)
-          {
-            name = SC.String.loc(name);
-          }
-
-          // get the value using the valueKey or the object if no valueKey.
-          // then convert to a string or use _guid if one of available.
-          var value = (valueKey) ? (object.get ? object.get(valueKey) : object[valueKey]) : object ;
-          // if there is no emptyName and no preselected value
-          // then the value should be the value of the first element in the list
-          if (!emptyName && index === 0 && fieldValue === '***') {
-            this.set('value', value);
-          }
-          if (value !== null && value !== undefined) value = (SC.guidFor(value)) ? SC.guidFor(value) : value.toString() ;
-
-          // render HTML
-          var disable = (this.validateMenuItem && this.validateMenuItem(value, name)) ? '' : 'disabled="disabled" ' ;
-          if(firstTime){
-            context.push('<option '+disable+'value="'+value+'">'+name+'</option>') ;
-          } else{
-            el=document.createElement('option');
-            el.value=value;
-            el.innerHTML=name;
-            if(disable.length>0) el.disable="disabled";
-            selectElement.appendChild(el);
-          }
-        // null value means separator.
-        } else {
-          if(firstTime){
-            context.push('<option disabled="disabled"></option>') ;
-          }else{
-            el=document.createElement('option');
-            el.disabled="disabled";
-            selectElement.appendChild(el);
-          }
-        }
-      }, this );
-
-      this.setFieldValue(fieldValue);
-
-      } else {
-        this.set('value',null);
-      }
-    } else {
-      this.$().prop('disabled', !this.get('isEnabled'));
-    }
-  },
-
-  /** @private */
-  _objectsObserver: function() {
-    this.set('cpDidChange', YES);
-  }.observes('objects'),
-
-  /** @private */
-  _objectArrayObserver: function() {
-    this.set('cpDidChange', YES);
-    this.propertyDidChange('objects');
-  }.observes('*objects.[]'),
-
-  /** @private */
-  _nameKeyObserver: function() {
-    this.set('cpDidChange', YES);
-  }.observes('nameKey'),
-
-  /** @private */
-  _valueKeyObserver: function() {
-    this.set('cpDidChange', YES);
-  }.observes('valueKey'),
-
-  /** @private */
-  _isEnabledObserver: function() {
-    this.set('cpDidChange', YES);
-  }.observes('isEnabled'),
-
-  // .......................................
-  // PRIVATE
-  //
-
-  /** @private */
-  $input: function() { return this.$(); },
-
-  /** @private */
-  mouseDown: function(evt) {
-    if (!this.get('isEnabledInPane')) {
-      evt.stop();
-      return YES;
-    } else return sc_super();
-  },
-
-  /** @private */
-  touchStart: function(evt) {
-    return this.mouseDown(evt);
-  },
-
-  /** @private */
-  touchEnd: function(evt) {
-    return this.mouseUp(evt);
-  },
-
-  // when fetching the raw value, convert back to an object if needed...
-  /** @private */
-  getFieldValue: function() {
-    var value = sc_super(); // get raw value...
-    var valueKey = this.get('valueKey') ;
-    var objects = this.get('objects') ;
-    var found = null; // matching object goes here.
-    var object;
-
-    // Handle empty selection.
-    if (value == '***') {
-      value = null ;
-
-    // If no value key was set and there are objects then match back to an
-    // object.
-    } else if (value && objects) {
-      // objects = Array.from(objects) ;
-
-      var loc = (SC.typeOf(objects.length) === SC.T_FUNCTION) ? objects.length() : objects.length;
-
-      while(!found && (--loc >= 0)) {
-        object = objects.objectAt? objects.objectAt(loc) : objects[loc] ;
-        if (object === null || object === undefined) continue; // null means placeholder; just skip
-
-        // get value using valueKey if there is one or use object
-        // map to _guid or toString.
-        if (valueKey) object = (object.get) ? object.get(valueKey) : object[valueKey] ;
-        var ov = (object !== null && object !== undefined) ? (SC.guidFor(object) ? SC.guidFor(object) : object.toString()) : null ;
-
-        // use this object value if it matches.
-        if (value == ov) found = object ;
-      }
-    }
-
-    return (valueKey || found) ? found : value;
-  },
-
-  /** @private */
-  setFieldValue: function(newValue) {
-    if (SC.none(newValue)) {
-      newValue = '***' ;
-    } else {
-      newValue = ((newValue !== null && newValue !== undefined) ? (SC.guidFor(newValue) ? SC.guidFor(newValue) : newValue.toString()) : null );
-    }
-    this.$input().val(newValue);
-    return this ;
-  },
-
-  /** @private */
-  fieldDidFocus: function() {
-    var isFocused = this.get('isFocused');
-    if (!isFocused) this.set('isFocused', true);
-  },
-
-  /** @private */
-  fieldDidBlur: function() {
-    var isFocused = this.get('isFocused');
-    if (isFocused) this.set('isFocused', false);
-  },
-
-  /** @private */
-  _isFocusedObserver: function() {
-    this.$().setClass('focus', this.get('isFocused'));
-  }.observes('isFocused'),
-
-  /** @private */
-  didCreateLayer: function() {
-    var input = this.$input();
-    if (this.get('isEnabled') === false) this.$()[0].disabled = true;
-    SC.Event.add(input, 'blur', this, this.fieldDidBlur);
-    SC.Event.add(input, 'focus',this, this.fieldDidFocus);
-    SC.Event.add(input, 'change',this, this._field_fieldValueDidChange);
-  },
-
-  /** @private */
-  willDestroyLayer: function() {
-    var input = this.$input();
-    SC.Event.remove(input, 'focus', this, this.fieldDidFocus);
-    SC.Event.remove(input, 'blur', this, this.fieldDidBlur);
-    SC.Event.remove(input, 'change',this, this._field_fieldValueDidChange);
-  }
-
-});

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/menu/render_delegates/menu_scroller.js

@@ -1,28 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2011 Strobe Inc. and contributors.
-//            Portions ©2008-2011 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-
-
-SC.BaseTheme.menuScrollerRenderDelegate = SC.RenderDelegate.create({
-  className: 'menu-scroller',
-
-  render: function (dataSource, context) {
-    this.addSizeClassName(dataSource, context);
-    context.addClass({
-      'sc-vertical': YES,
-      disabled: !dataSource.get('isEnabled')
-    });
-    context.push('<span class="scrollArrow ' + (dataSource.get('scrollDown') ? 'arrowDown' : 'arrowUp') + '">&nbsp;</span>');
-  },
-
-  update: function (dataSource, context) {
-    this.addSizeClassName(dataSource, context);
-    context.addClass({
-      'sc-vertical': YES,
-      disabled: !dataSource.get('isEnabled')
-    });
-  }
-});

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/menu/tests/menu/scroll.js

@@ -1,235 +0,0 @@
-// ==========================================================================
-// Project:   SC.MenuScrollView Unit Test
-// Copyright: ©2006-2011 Strobe Inc. and contributors.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-/*globals SC module test ok equals same stop start */
- 
-var view, pane;
-module("Menu Scroll View", {
-  setup: function () {
-    SC.RunLoop.begin();
-
-    var content = ['Dogfish Head',
-                   'Delerium',
-                   'Smuttynose',
-                   'Harpoon',
-                   'Bitburger',
-                   'Goose Island',
-                   'Old Speckled Hen',
-                   'Fuller\'s',
-                   'Anchor',
-                   'Brooklyn',
-                   'Lagunitas',
-                   'Coney Island'];
-
-    view = SC.MenuScrollView.create({
-      layout: { top: 100, left: 20, height: 100, width: 100 },
-      contentView: SC.SourceListView.design({
-        content: content
-      })
-    });
-
-    pane = SC.MainPane.create();
-    pane.appendChild(view);
-    pane.append();
-
-    SC.RunLoop.end();
-  },
-
-  teardown: function () {
-    SC.RunLoop.begin();
-    pane.remove();
-    pane.destroy();
-    SC.RunLoop.end();
-  }
-});
-
-test("menu scroll views cannot scroll horizontally", function () {
-  ok(!view.get('hasHorizontalScroller'),
-     "the horizontal scroller doesn't exist");
-  ok(!view.get('isHorizontalScrollerVisible'),
-     "the horizontal scroller shouldn't be visible");
-});
-
-test("vertical scroll views cannot scroll horizontally", function () {
-  ok(view.get('hasVerticalScroller'),
-     "the vertical scroller should exist");
-});
-
-test("menu scrollers not visible when content doesn't fill the container", function () {
-  SC.RunLoop.begin();
-  view.setPath('contentView.content', []);
-  SC.RunLoop.end();
-
-  equals(view.getPath('verticalScrollerView.isVisible'), NO,
-         "the top vertical scroller shouldn't be visible");
-  equals(view.getPath('verticalScrollerView2.isVisible'), NO,
-         "the bottom vertical scroller shouldn't be visible");
-});
-
-test("initially, only the bottom menu scroller should be visible", function () {
-  equals(view.getPath('verticalScrollerView.isVisible'), NO,
-         "the top scroller shouldn't be visible");
-  equals(view.getPath('verticalScrollerView2.isVisible'), YES,
-         "the bottom scroller should be visible");
-});
-
-// ..........................................................
-// autohidesVerticalScrollers => YES
-//
-
-// Top scroller visibility
-test("when setting `verticalScrollOffset` to anywhere before the scroller thickness, the top scroller will become invisible", function () {
-  view.scrollTo(0, 50);
-
-  ok(view.getPath('verticalScrollerView.isVisible'),
-     "top scroller should be visible");
-
-  view.scrollTo(0, view.getPath('verticalScrollerView.scrollerThickness'));
-  equals(view.get('verticalScrollOffset'), 0,
-         "view should be at 0px scroll offset");
-  ok(!view.getPath('verticalScrollerView.isVisible'),
-     "top scroller should NOT be visible");
-
-  view.scrollTo(0, 50);
-  ok(view.getPath('verticalScrollerView.isVisible'),
-     "top scroller should be visible");
-
-  view.scrollTo(0, view.getPath('verticalScrollerView.scrollerThickness') + 1);
-  ok(view.getPath('verticalScrollerView.isVisible'),
-     "top scroller should be visible");
-
-  view.scrollTo(0, 50);
-  ok(view.getPath('verticalScrollerView.isVisible'),
-     "top scroller should be visible");
-
-  view.scrollTo(0, view.getPath('verticalScrollerView.scrollerThickness') - 1);
-  ok(!view.getPath('verticalScrollerView.isVisible'),
-     "top scroller should NOT be visible");
-});
-
-// Bottom scroller visibility
-test("when setting `verticalScrollOffset` to anywhere before the scroller thickness, the bottom scroller will become invisible", function () {
-  var max = view.get('maximumVerticalScrollOffset');
-  ok(view.getPath('verticalScrollerView2.isVisible'),
-     "bottom scroller should be visible");
-
-  // @ bottom
-  view.scrollTo(0, max);
-  ok(!view.getPath('verticalScrollerView2.isVisible'),
-     "bottom scroller should NOT be visible");
-
-  view.scrollTo(0, 0);
-  ok(view.getPath('verticalScrollerView2.isVisible'),
-     "bottom scroller should be visible");
-
-  // just enough so bottom is invisible
-  view.scrollTo(0, max - view.getPath('verticalScrollerView2.scrollerThickness') - 1);
-  ok(view.getPath('verticalScrollerView2.isVisible'),
-     "bottom scroller should be visible");
-
-  view.scrollTo(0, 0);
-  ok(view.getPath('verticalScrollerView2.isVisible'),
-     "bottom scroller should be visible");
-
-  // exactly enough for bottom to be invisible
-  view.scrollTo(0, max - view.getPath('verticalScrollerView2.scrollerThickness'));
-  ok(!view.getPath('verticalScrollerView2.isVisible'),
-     "bottom scroller should NOT be visible");
-
-  view.scrollTo(0, 0);
-  ok(view.getPath('verticalScrollerView2.isVisible'),
-     "bottom scroller should be visible");
-
-  // more than enough for bottom to be invisible
-  view.scrollTo(0, max - view.getPath('verticalScrollerView2.scrollerThickness') + 1);
-  ok(!view.getPath('verticalScrollerView2.isVisible'),
-     "bottom scroller should NOT be visible");
-});
-
-test("when the top scroller becomes visible, the vertical scroll offset is adjusted by the scroller thickness", function () {
-  view.scrollBy(0, 1);
-
-  var thickness = view.getPath('verticalScrollerView.scrollerThickness');
-
-  // check for adjustment
-  equals(view.get('verticalScrollOffset'),
-         1 + thickness,
-         "the offset should be the scroller thickness + 1");
-
-  // shouldn't adjust this time
-  view.scrollBy(0, 1);
-  equals(view.get('verticalScrollOffset'),
-         2 + thickness,
-         "the offset should be the scroller thickness + 2");
-
-  // shouldn't adjust this time
-  view.scrollBy(0, -1);
-  equals(view.get('verticalScrollOffset'),
-         1 + thickness,
-         "the offset should be the scroller thickness + 1");
-
-  // check for adjustment
-  view.scrollBy(0, -1);
-  equals(view.get('verticalScrollOffset'), 0,
-         "the offset should be 0px");
-});
-
-// ..........................................................
-// autohidesVerticalScrollers => NO
-//
-
-test("when `autohidesVerticalScrollers` is NO, it will hide both when the content doesn't fill the container", function () {
-  view.set('autohidesVerticalScrollers', NO);
-  view.tile();
-
-  SC.RunLoop.begin();
-  view.setPath('contentView.content', []);
-  SC.RunLoop.end();
-
-  equals(view.getPath('verticalScrollerView.isVisible'), NO,
-         "the top vertical scroller shouldn't be visible");
-  equals(view.getPath('verticalScrollerView2.isVisible'), NO,
-         "the bottom vertical scroller shouldn't be visible");
-});
-
-test("when `autohidesVerticalScrollers` is NO, both scrollers will be shown when the content overflows", function () {
-  view.set('autohidesVerticalScrollers', NO);
-  view.tile();
-
-  equals(view.getPath('verticalScrollerView.isVisible'), YES,
-         "the top vertical scroller shouldn't be visible");
-  equals(view.getPath('verticalScrollerView2.isVisible'), YES,
-         "the bottom vertical scroller shouldn't be visible");
-});
-
-// ..........................................................
-// autohidesVerticalScroller  => NO AND
-// autohidesVerticalScrollers => NO
-//
-
-test("when `autohidesVerticalScroller` is NO, it will NOT hide both when the content doesn't fill the container", function () {
-  view.set('autohidesVerticalScroller', NO);
-  view.set('autohidesVerticalScrollers', NO);
-
-  SC.RunLoop.begin();
-  view.setPath('contentView.content', []);
-  SC.RunLoop.end();
-
-  equals(view.getPath('verticalScrollerView.isVisible'), YES,
-         "the top vertical scroller shouldn't be visible");
-  equals(view.getPath('verticalScrollerView2.isVisible'), YES,
-         "the bottom vertical scroller shouldn't be visible");
-});
-
-test("when `autohidesVerticalScroller` is NO, both scrollers will be shown when the content overflows", function () {
-  view.set('autohidesVerticalScroller', NO);
-  view.set('autohidesVerticalScrollers', NO);
-  view.tile();
-
-  equals(view.getPath('verticalScrollerView.isVisible'), YES,
-         "the top vertical scroller shouldn't be visible");
-  equals(view.getPath('verticalScrollerView2.isVisible'), YES,
-         "the bottom vertical scroller shouldn't be visible");
-});