<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[24360] trunk/wp-includes/js: Extract the base views from media.</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta">
<dt>Revision</dt> <dd><a href="http://core.trac.wordpress.org/changeset/24360">24360</a></dd>
<dt>Author</dt> <dd>koopersmith</dd>
<dt>Date</dt> <dd>2013-05-25 21:03:04 +0000 (Sat, 25 May 2013)</dd>
</dl>
<h3>Log Message</h3>
<pre>Extract the base views from media.
See <a href="http://core.trac.wordpress.org/ticket/24424">#24424</a>.</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkwpincludesjsmediaviewsjs">trunk/wp-includes/js/media-views.js</a></li>
<li><a href="#trunkwpincludesjswpbackbonejs">trunk/wp-includes/js/wp-backbone.js</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwpincludesjsmediaviewsjs"></a>
<div class="modfile"><h4>Modified: trunk/wp-includes/js/media-views.js (24359 => 24360)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-includes/js/media-views.js 2013-05-25 20:58:35 UTC (rev 24359)
+++ trunk/wp-includes/js/media-views.js 2013-05-25 21:03:04 UTC (rev 24360)
</span><span class="lines">@@ -843,404 +843,12 @@
</span><span class="cx"> * ========================================================================
</span><span class="cx"> */
</span><span class="cx">
</span><del>- // wp.media.Views
- // -------------
- //
- // A subview manager.
-
- media.Views = function( view, views ) {
- this.view = view;
- this._views = _.isArray( views ) ? { '': views } : views || {};
- };
-
- media.Views.extend = Backbone.Model.extend;
-
- _.extend( media.Views.prototype, {
- // ### Fetch all of the subviews
- //
- // Returns an array of all subviews.
- all: function() {
- return _.flatten( this._views );
- },
-
- // ### Get a selector's subviews
- //
- // Fetches all subviews that match a given `selector`.
- //
- // If no `selector` is provided, it will grab all subviews attached
- // to the view's root.
- get: function( selector ) {
- selector = selector || '';
- return this._views[ selector ];
- },
-
- // ### Get a selector's first subview
- //
- // Fetches the first subview that matches a given `selector`.
- //
- // If no `selector` is provided, it will grab the first subview
- // attached to the view's root.
- //
- // Useful when a selector only has one subview at a time.
- first: function( selector ) {
- var views = this.get( selector );
- return views && views.length ? views[0] : null;
- },
-
- // ### Register subview(s)
- //
- // Registers any number of `views` to a `selector`.
- //
- // When no `selector` is provided, the root selector (the empty string)
- // is used. `views` accepts a `Backbone.View` instance or an array of
- // `Backbone.View` instances.
- //
- // ---
- //
- // Accepts an `options` object, which has a significant effect on the
- // resulting behavior.
- //
- // `options.silent` – *boolean, `false`*
- // > If `options.silent` is true, no DOM modifications will be made.
- //
- // `options.add` – *boolean, `false`*
- // > Use `Views.add()` as a shortcut for setting `options.add` to true.
- //
- // > By default, the provided `views` will replace
- // any existing views associated with the selector. If `options.add`
- // is true, the provided `views` will be added to the existing views.
- //
- // `options.at` – *integer, `undefined`*
- // > When adding, to insert `views` at a specific index, use
- // `options.at`. By default, `views` are added to the end of the array.
- set: function( selector, views, options ) {
- var existing, next;
-
- if ( ! _.isString( selector ) ) {
- options = views;
- views = selector;
- selector = '';
- }
-
- options = options || {};
- views = _.isArray( views ) ? views : [ views ];
- existing = this.get( selector );
- next = views;
-
- if ( existing ) {
- if ( options.add ) {
- if ( _.isUndefined( options.at ) ) {
- next = existing.concat( views );
- } else {
- next = existing;
- next.splice.apply( next, [ options.at, 0 ].concat( views ) );
- }
- } else {
- _.each( next, function( view ) {
- view.__detach = true;
- });
-
- _.each( existing, function( view ) {
- if ( view.__detach )
- view.$el.detach();
- else
- view.dispose();
- });
-
- _.each( next, function( view ) {
- delete view.__detach;
- });
- }
- }
-
- this._views[ selector ] = next;
-
- _.each( views, function( subview ) {
- var constructor = subview.Views || media.Views,
- subviews = subview.views = subview.views || new constructor( subview );
- subviews.parent = this.view;
- subviews.selector = selector;
- }, this );
-
- if ( ! options.silent )
- this._attach( selector, views, _.extend({ ready: this._isReady() }, options ) );
-
- return this;
- },
-
- // ### Add subview(s) to existing subviews
- //
- // An alias to `Views.set()`, which defaults `options.add` to true.
- //
- // Adds any number of `views` to a `selector`.
- //
- // When no `selector` is provided, the root selector (the empty string)
- // is used. `views` accepts a `Backbone.View` instance or an array of
- // `Backbone.View` instances.
- //
- // Use `Views.set()` when setting `options.add` to `false`.
- //
- // Accepts an `options` object. By default, provided `views` will be
- // inserted at the end of the array of existing views. To insert
- // `views` at a specific index, use `options.at`. If `options.silent`
- // is true, no DOM modifications will be made.
- //
- // For more information on the `options` object, see `Views.set()`.
- add: function( selector, views, options ) {
- if ( ! _.isString( selector ) ) {
- options = views;
- views = selector;
- selector = '';
- }
-
- return this.set( selector, views, _.extend({ add: true }, options ) );
- },
-
- // ### Stop tracking subviews
- //
- // Stops tracking `views` registered to a `selector`. If no `views` are
- // set, then all of the `selector`'s subviews will be unregistered and
- // disposed.
- //
- // Accepts an `options` object. If `options.silent` is set, `dispose`
- // will *not* be triggered on the unregistered views.
- unset: function( selector, views, options ) {
- var existing;
-
- if ( ! _.isString( selector ) ) {
- options = views;
- views = selector;
- selector = '';
- }
-
- views = views || [];
-
- if ( existing = this.get( selector ) ) {
- views = _.isArray( views ) ? views : [ views ];
- this._views[ selector ] = views.length ? _.difference( existing, views ) : [];
- }
-
- if ( ! options || ! options.silent )
- _.invoke( views, 'dispose' );
-
- return this;
- },
-
- // ### Detach all subviews
- //
- // Detaches all subviews from the DOM.
- //
- // Helps to preserve all subview events when re-rendering the master
- // view. Used in conjunction with `Views.render()`.
- detach: function() {
- $( _.pluck( this.all(), 'el' ) ).detach();
- return this;
- },
-
- // ### Render all subviews
- //
- // Renders all subviews. Used in conjunction with `Views.detach()`.
- render: function() {
- var options = {
- ready: this._isReady()
- };
-
- _.each( this._views, function( views, selector ) {
- this._attach( selector, views, options );
- }, this );
-
- this.rendered = true;
- return this;
- },
-
- // ### Dispose all subviews
- //
- // Triggers the `dispose()` method on all subviews. Detaches the master
- // view from its parent. Resets the internals of the views manager.
- //
- // Accepts an `options` object. If `options.silent` is set, `unset`
- // will *not* be triggered on the master view's parent.
- dispose: function( options ) {
- if ( ! options || ! options.silent ) {
- if ( this.parent && this.parent.views )
- this.parent.views.unset( this.selector, this.view, { silent: true });
- delete this.parent;
- delete this.selector;
- }
-
- _.invoke( this.all(), 'dispose' );
- this._views = [];
- return this;
- },
-
- // ### Replace a selector's subviews
- //
- // By default, sets the `$target` selector's html to the subview `els`.
- //
- // Can be overridden in subclasses.
- replace: function( $target, els ) {
- $target.html( els );
- return this;
- },
-
- // ### Insert subviews into a selector
- //
- // By default, appends the subview `els` to the end of the `$target`
- // selector. If `options.at` is set, inserts the subview `els` at the
- // provided index.
- //
- // Can be overridden in subclasses.
- insert: function( $target, els, options ) {
- var at = options && options.at,
- $children;
-
- if ( _.isNumber( at ) && ($children = $target.children()).length > at )
- $children.eq( at ).before( els );
- else
- $target.append( els );
-
- return this;
- },
-
- // ### Trigger the ready event
- //
- // **Only use this method if you know what you're doing.**
- // For performance reasons, this method does not check if the view is
- // actually attached to the DOM. It's taking your word for it.
- //
- // Fires the ready event on the current view and all attached subviews.
- ready: function() {
- this.view.trigger('ready');
-
- // Find all attached subviews, and call ready on them.
- _.chain( this.all() ).map( function( view ) {
- return view.views;
- }).flatten().where({ attached: true }).invoke('ready');
- },
-
- // #### Internal. Attaches a series of views to a selector.
- //
- // Checks to see if a matching selector exists, renders the views,
- // performs the proper DOM operation, and then checks if the view is
- // attached to the document.
- _attach: function( selector, views, options ) {
- var $selector = selector ? this.view.$( selector ) : this.view.$el,
- managers;
-
- // Check if we found a location to attach the views.
- if ( ! $selector.length )
- return this;
-
- managers = _.chain( views ).pluck('views').flatten().value();
-
- // Render the views if necessary.
- _.each( managers, function( manager ) {
- if ( manager.rendered )
- return;
-
- manager.view.render();
- manager.rendered = true;
- }, this );
-
- // Insert or replace the views.
- this[ options.add ? 'insert' : 'replace' ]( $selector, _.pluck( views, 'el' ), options );
-
- // Set attached and trigger ready if the current view is already
- // attached to the DOM.
- _.each( managers, function( manager ) {
- manager.attached = true;
-
- if ( options.ready )
- manager.ready();
- }, this );
-
- return this;
- },
-
- // #### Internal. Checks if the current view is in the DOM.
- _isReady: function() {
- var node = this.view.el;
- while ( node ) {
- if ( node === document.body )
- return true;
- node = node.parentNode;
- }
-
- return false;
- }
- });
-
</del><span class="cx"> // wp.media.View
</span><span class="cx"> // -------------
</span><span class="cx"> //
</span><span class="cx"> // The base view class.
</span><del>- media.View = Backbone.View.extend({
- // The constructor for the `Views` manager.
- Views: media.Views,
</del><ins>+ media.View = wp.View;
</ins><span class="cx">
</span><del>- constructor: function( options ) {
- this.views = new this.Views( this, this.views );
- this.on( 'ready', this.ready, this );
-
- if ( options && options.controller )
- this.controller = options.controller;
-
- Backbone.View.apply( this, arguments );
- },
-
- dispose: function() {
- // Undelegating events, removing events from the model, and
- // removing events from the controller mirror the code for
- // `Backbone.View.dispose` in Backbone master.
- this.undelegateEvents();
-
- if ( this.model && this.model.off )
- this.model.off( null, null, this );
-
- if ( this.collection && this.collection.off )
- this.collection.off( null, null, this );
-
- // Unbind controller events.
- if ( this.controller && this.controller.off )
- this.controller.off( null, null, this );
-
- // Recursively dispose child views.
- if ( this.views )
- this.views.dispose();
-
- return this;
- },
-
- remove: function() {
- this.dispose();
- return Backbone.View.prototype.remove.apply( this, arguments );
- },
-
- render: function() {
- var options;
-
- if ( this.prepare )
- options = this.prepare();
-
- this.views.detach();
-
- if ( this.template ) {
- options = options || {};
- this.trigger( 'prepare', options );
- this.$el.html( this.template( options ) );
- }
-
- this.views.render();
- return this;
- },
-
- prepare: function() {
- return this.options;
- },
-
- ready: function() {}
- });
-
</del><span class="cx"> /**
</span><span class="cx"> * wp.media.view.Frame
</span><span class="cx"> */
</span></span></pre></div>
<a id="trunkwpincludesjswpbackbonejs"></a>
<div class="modfile"><h4>Modified: trunk/wp-includes/js/wp-backbone.js (24359 => 24360)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-includes/js/wp-backbone.js 2013-05-25 20:58:35 UTC (rev 24359)
+++ trunk/wp-includes/js/wp-backbone.js 2013-05-25 21:03:04 UTC (rev 24360)
</span><span class="lines">@@ -25,4 +25,402 @@
</span><span class="cx"> };
</span><span class="cx"> });
</span><span class="cx">
</span><ins>+
+ // wp.Subviews
+ // -----------
+ //
+ // A subview manager.
+ wp.Subviews = function( view, views ) {
+ this.view = view;
+ this._views = _.isArray( views ) ? { '': views } : views || {};
+ };
+
+ wp.Subviews.extend = Backbone.Model.extend;
+
+ _.extend( wp.Subviews.prototype, {
+ // ### Fetch all of the subviews
+ //
+ // Returns an array of all subviews.
+ all: function() {
+ return _.flatten( this._views );
+ },
+
+ // ### Get a selector's subviews
+ //
+ // Fetches all subviews that match a given `selector`.
+ //
+ // If no `selector` is provided, it will grab all subviews attached
+ // to the view's root.
+ get: function( selector ) {
+ selector = selector || '';
+ return this._views[ selector ];
+ },
+
+ // ### Get a selector's first subview
+ //
+ // Fetches the first subview that matches a given `selector`.
+ //
+ // If no `selector` is provided, it will grab the first subview
+ // attached to the view's root.
+ //
+ // Useful when a selector only has one subview at a time.
+ first: function( selector ) {
+ var views = this.get( selector );
+ return views && views.length ? views[0] : null;
+ },
+
+ // ### Register subview(s)
+ //
+ // Registers any number of `views` to a `selector`.
+ //
+ // When no `selector` is provided, the root selector (the empty string)
+ // is used. `views` accepts a `Backbone.View` instance or an array of
+ // `Backbone.View` instances.
+ //
+ // ---
+ //
+ // Accepts an `options` object, which has a significant effect on the
+ // resulting behavior.
+ //
+ // `options.silent` – *boolean, `false`*
+ // > If `options.silent` is true, no DOM modifications will be made.
+ //
+ // `options.add` – *boolean, `false`*
+ // > Use `Views.add()` as a shortcut for setting `options.add` to true.
+ //
+ // > By default, the provided `views` will replace
+ // any existing views associated with the selector. If `options.add`
+ // is true, the provided `views` will be added to the existing views.
+ //
+ // `options.at` – *integer, `undefined`*
+ // > When adding, to insert `views` at a specific index, use
+ // `options.at`. By default, `views` are added to the end of the array.
+ set: function( selector, views, options ) {
+ var existing, next;
+
+ if ( ! _.isString( selector ) ) {
+ options = views;
+ views = selector;
+ selector = '';
+ }
+
+ options = options || {};
+ views = _.isArray( views ) ? views : [ views ];
+ existing = this.get( selector );
+ next = views;
+
+ if ( existing ) {
+ if ( options.add ) {
+ if ( _.isUndefined( options.at ) ) {
+ next = existing.concat( views );
+ } else {
+ next = existing;
+ next.splice.apply( next, [ options.at, 0 ].concat( views ) );
+ }
+ } else {
+ _.each( next, function( view ) {
+ view.__detach = true;
+ });
+
+ _.each( existing, function( view ) {
+ if ( view.__detach )
+ view.$el.detach();
+ else
+ view.dispose();
+ });
+
+ _.each( next, function( view ) {
+ delete view.__detach;
+ });
+ }
+ }
+
+ this._views[ selector ] = next;
+
+ _.each( views, function( subview ) {
+ var constructor = subview.Views || wp.Subviews,
+ subviews = subview.views = subview.views || new constructor( subview );
+ subviews.parent = this.view;
+ subviews.selector = selector;
+ }, this );
+
+ if ( ! options.silent )
+ this._attach( selector, views, _.extend({ ready: this._isReady() }, options ) );
+
+ return this;
+ },
+
+ // ### Add subview(s) to existing subviews
+ //
+ // An alias to `Views.set()`, which defaults `options.add` to true.
+ //
+ // Adds any number of `views` to a `selector`.
+ //
+ // When no `selector` is provided, the root selector (the empty string)
+ // is used. `views` accepts a `Backbone.View` instance or an array of
+ // `Backbone.View` instances.
+ //
+ // Use `Views.set()` when setting `options.add` to `false`.
+ //
+ // Accepts an `options` object. By default, provided `views` will be
+ // inserted at the end of the array of existing views. To insert
+ // `views` at a specific index, use `options.at`. If `options.silent`
+ // is true, no DOM modifications will be made.
+ //
+ // For more information on the `options` object, see `Views.set()`.
+ add: function( selector, views, options ) {
+ if ( ! _.isString( selector ) ) {
+ options = views;
+ views = selector;
+ selector = '';
+ }
+
+ return this.set( selector, views, _.extend({ add: true }, options ) );
+ },
+
+ // ### Stop tracking subviews
+ //
+ // Stops tracking `views` registered to a `selector`. If no `views` are
+ // set, then all of the `selector`'s subviews will be unregistered and
+ // disposed.
+ //
+ // Accepts an `options` object. If `options.silent` is set, `dispose`
+ // will *not* be triggered on the unregistered views.
+ unset: function( selector, views, options ) {
+ var existing;
+
+ if ( ! _.isString( selector ) ) {
+ options = views;
+ views = selector;
+ selector = '';
+ }
+
+ views = views || [];
+
+ if ( existing = this.get( selector ) ) {
+ views = _.isArray( views ) ? views : [ views ];
+ this._views[ selector ] = views.length ? _.difference( existing, views ) : [];
+ }
+
+ if ( ! options || ! options.silent )
+ _.invoke( views, 'dispose' );
+
+ return this;
+ },
+
+ // ### Detach all subviews
+ //
+ // Detaches all subviews from the DOM.
+ //
+ // Helps to preserve all subview events when re-rendering the master
+ // view. Used in conjunction with `Views.render()`.
+ detach: function() {
+ $( _.pluck( this.all(), 'el' ) ).detach();
+ return this;
+ },
+
+ // ### Render all subviews
+ //
+ // Renders all subviews. Used in conjunction with `Views.detach()`.
+ render: function() {
+ var options = {
+ ready: this._isReady()
+ };
+
+ _.each( this._views, function( views, selector ) {
+ this._attach( selector, views, options );
+ }, this );
+
+ this.rendered = true;
+ return this;
+ },
+
+ // ### Dispose all subviews
+ //
+ // Triggers the `dispose()` method on all subviews. Detaches the master
+ // view from its parent. Resets the internals of the views manager.
+ //
+ // Accepts an `options` object. If `options.silent` is set, `unset`
+ // will *not* be triggered on the master view's parent.
+ dispose: function( options ) {
+ if ( ! options || ! options.silent ) {
+ if ( this.parent && this.parent.views )
+ this.parent.views.unset( this.selector, this.view, { silent: true });
+ delete this.parent;
+ delete this.selector;
+ }
+
+ _.invoke( this.all(), 'dispose' );
+ this._views = [];
+ return this;
+ },
+
+ // ### Replace a selector's subviews
+ //
+ // By default, sets the `$target` selector's html to the subview `els`.
+ //
+ // Can be overridden in subclasses.
+ replace: function( $target, els ) {
+ $target.html( els );
+ return this;
+ },
+
+ // ### Insert subviews into a selector
+ //
+ // By default, appends the subview `els` to the end of the `$target`
+ // selector. If `options.at` is set, inserts the subview `els` at the
+ // provided index.
+ //
+ // Can be overridden in subclasses.
+ insert: function( $target, els, options ) {
+ var at = options && options.at,
+ $children;
+
+ if ( _.isNumber( at ) && ($children = $target.children()).length > at )
+ $children.eq( at ).before( els );
+ else
+ $target.append( els );
+
+ return this;
+ },
+
+ // ### Trigger the ready event
+ //
+ // **Only use this method if you know what you're doing.**
+ // For performance reasons, this method does not check if the view is
+ // actually attached to the DOM. It's taking your word for it.
+ //
+ // Fires the ready event on the current view and all attached subviews.
+ ready: function() {
+ this.view.trigger('ready');
+
+ // Find all attached subviews, and call ready on them.
+ _.chain( this.all() ).map( function( view ) {
+ return view.views;
+ }).flatten().where({ attached: true }).invoke('ready');
+ },
+
+ // #### Internal. Attaches a series of views to a selector.
+ //
+ // Checks to see if a matching selector exists, renders the views,
+ // performs the proper DOM operation, and then checks if the view is
+ // attached to the document.
+ _attach: function( selector, views, options ) {
+ var $selector = selector ? this.view.$( selector ) : this.view.$el,
+ managers;
+
+ // Check if we found a location to attach the views.
+ if ( ! $selector.length )
+ return this;
+
+ managers = _.chain( views ).pluck('views').flatten().value();
+
+ // Render the views if necessary.
+ _.each( managers, function( manager ) {
+ if ( manager.rendered )
+ return;
+
+ manager.view.render();
+ manager.rendered = true;
+ }, this );
+
+ // Insert or replace the views.
+ this[ options.add ? 'insert' : 'replace' ]( $selector, _.pluck( views, 'el' ), options );
+
+ // Set attached and trigger ready if the current view is already
+ // attached to the DOM.
+ _.each( managers, function( manager ) {
+ manager.attached = true;
+
+ if ( options.ready )
+ manager.ready();
+ }, this );
+
+ return this;
+ },
+
+ // #### Internal. Checks if the current view is in the DOM.
+ _isReady: function() {
+ var node = this.view.el;
+ while ( node ) {
+ if ( node === document.body )
+ return true;
+ node = node.parentNode;
+ }
+
+ return false;
+ }
+ });
+
+
+ // wp.View
+ // -------
+ //
+ // The base view class.
+ wp.View = Backbone.View.extend({
+ // The constructor for the `Views` manager.
+ Subviews: wp.Subviews,
+
+ constructor: function( options ) {
+ this.views = new this.Subviews( this, this.views );
+ this.on( 'ready', this.ready, this );
+
+ if ( options && options.controller )
+ this.controller = options.controller;
+
+ Backbone.View.apply( this, arguments );
+ },
+
+ dispose: function() {
+ // Undelegating events, removing events from the model, and
+ // removing events from the controller mirror the code for
+ // `Backbone.View.dispose` in Backbone master.
+ this.undelegateEvents();
+
+ if ( this.model && this.model.off )
+ this.model.off( null, null, this );
+
+ if ( this.collection && this.collection.off )
+ this.collection.off( null, null, this );
+
+ // Unbind controller events.
+ if ( this.controller && this.controller.off )
+ this.controller.off( null, null, this );
+
+ // Recursively dispose child views.
+ if ( this.views )
+ this.views.dispose();
+
+ return this;
+ },
+
+ remove: function() {
+ this.dispose();
+ return Backbone.View.prototype.remove.apply( this, arguments );
+ },
+
+ render: function() {
+ var options;
+
+ if ( this.prepare )
+ options = this.prepare();
+
+ this.views.detach();
+
+ if ( this.template ) {
+ options = options || {};
+ this.trigger( 'prepare', options );
+ this.$el.html( this.template( options ) );
+ }
+
+ this.views.render();
+ return this;
+ },
+
+ prepare: function() {
+ return this.options;
+ },
+
+ ready: function() {}
+ });
</ins><span class="cx"> }(jQuery));
</span></span></pre>
</div>
</div>
</body>
</html>