Class: SC.SplitView

Extends SC.View.

SC.SplitView arranges multiple views side-by-side or on top of each other.

By default, SC.SplitView sets size and position properties on the child views, leaving it up to the child view to adjust itself. For good default behavior, mix SC.SplitChild into your child views.

SplitView can resize its children to fit (the default behavior), or resize itself to fit its children--allowing you to build column- based file browsers and the like. As one child (a divider, most likely) is moved, SplitView can move additional children to get them out of the way.

Setting Up SplitViews

You can set up a split view like any other view in SproutCore:

SplitView.design({
  childViews: ['leftPanel', 'rightPanel'],

  leftPanel: SC.View.design(SC.SplitChild, {
    minimumSize: 200
  }),

  rightPanel: SC.View.design(SC.SplitChild, {
    // it is usually the right panel you want to resize
    // as the SplitView resizes:
    autoResizeStyle: SC.RESIZE_AUTOMATIC
  })
})

Dividers

Dividers are automatically added between every child view.

You can specify what dividers to create in two ways:

• Set splitDividerView to change the default divider view class to use.

• Override splitViewDividerBetween(splitView, view1, view2), either in your subclass of SC.SplitView or in a delegate, and return the divider view instance that should go between the two views.

As far as SplitView is concerned, dividers are actually just ordinary child views. They usually have an autoResizeStyle of SC.FIXED_SIZE, and usually mixin SC.SplitThumb to relay mouse and touch events to the SplitView. To prevent adding dividers between dividers and views or dividers and dividers, SC.SplitView marks all dividers with an isSplitDivider property.

If you do not want to use split dividers at all, or wish to set them up manually in your childViews array, set splitDividerView to null.

Defined in: split.js

Field Summary

Instance Methods

• adjustPositionForChild(child, position)
• createChildViews()
• didAddChild()
• didRemoveChild()
• getPositionForChild(child)
• scheduleTiling()
• splitViewAdjustPositionForChild(splitView, child, position)
• splitViewConstrainSizeForChild(splitView, child, position)
• splitViewDividerBetween(splitView, view1, view2)
• splitViewGetPositionForChild(splitView, child)
• splitViewGetSizeForChild(splitView, child)
• splitViewLayoutChildren(splitView)
• splitViewResizeChildrenToFit(splitView, contentSize)
• splitViewSetPositionForChild(splitView, child, position)
• splitViewSetSizeForChild(splitView, child, position)
• splitViewShouldResizeChildToFit(splitView, child)
• tileIfNeeded()