Disambiguate `this` and use the `@this` annotation in `media-editor.js`. This will become way more necessary in other places, but a few examples here show how confusing it can be.

See #26870.



git-svn-id: https://develop.svn.wordpress.org/trunk@26989 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Scott Taylor 2014-01-21 16:29:30 +00:00
parent 5c0a09ce40
commit de01111ae7
1 changed files with 31 additions and 4 deletions

View File

@ -503,6 +503,7 @@
* wp.media.featuredImage
*/
wp.media.featuredImage = {
scott: 'yes',
/**
* Get the featured image post ID
*
@ -543,6 +544,8 @@
* @global wp.media.controller.FeaturedImage
* @global wp.media.view.l10n
*
* @this wp.media.featuredImage
*
* @returns {wp.media.view.MediaFrame.Select} A media workflow.
*/
frame: function() {
@ -556,6 +559,9 @@
});
this._frame.on( 'toolbar:create:featured-image', function( toolbar ) {
/**
* @this wp.media.view.MediaFrame.Select
*/
this.createSelectToolbar( toolbar, {
text: wp.media.view.l10n.setFeaturedImage
});
@ -566,6 +572,8 @@
},
/**
* @global wp.media.view.settings
*
* @this wp.media.controller.FeaturedImage
*/
select: function() {
var settings = wp.media.view.settings,
@ -657,6 +665,8 @@
* @param {string} id A slug used to identify the workflow.
* @param {Object} [options={}]
*
* @this wp.media.editor
*
* @returns {wp.media.view.MediaFrame.Select} A media workflow.
*/
add: function( id, options ) {
@ -684,6 +694,9 @@
$.when.apply( $, selection.map( function( attachment ) {
var display = state.display( attachment ).toJSON();
/**
* @this wp.media.editor
*/
return this.send.attachment( display, attachment.toJSON() );
}, this ) ).done( function() {
wp.media.editor.insert( _.toArray( arguments ).join('\n\n') );
@ -691,10 +704,16 @@
}, this );
workflow.state('gallery-edit').on( 'update', function( selection ) {
/**
* @this wp.media.editor
*/
this.insert( wp.media.gallery.shortcode( selection ).string() );
}, this );
workflow.state('embed').on( 'select', function() {
/**
* @this wp.media.editor
*/
var state = workflow.state(),
type = state.get('type'),
embed = state.props.toJSON();
@ -764,6 +783,9 @@
* Return the workflow specified by id
*
* @param {string} id
*
* @this wp.media.editor
*
* @returns {wp.media.view.MediaFrame} A media workflow.
*/
get: function( id ) {
@ -774,6 +796,8 @@
* Remove the workflow represented by id from the workflow cache
*
* @param {string} id
*
* @this wp.media.editor
*/
remove: function( id ) {
id = this.id( id );
@ -861,6 +885,9 @@
/**
* @param {string} id
* @param {Object} options
*
* @this wp.media.editor
*
* @returns {wp.media.view.MediaFrame}
*/
open: function( id, options ) {
@ -897,8 +924,8 @@
*/
init: function() {
$(document.body).on( 'click', '.insert-media', function( event ) {
var $this = $(this),
editor = $this.data('editor'),
var elem = $( event.currentTarget ),
editor = elem.data('editor'),
options = {
frame: 'post',
state: 'insert',
@ -913,9 +940,9 @@
// above the modal.
//
// See: http://core.trac.wordpress.org/ticket/22445
$this.blur();
elem.blur();
if ( $this.hasClass( 'gallery' ) ) {
if ( elem.hasClass( 'gallery' ) ) {
options.state = 'gallery';
options.title = wp.media.view.l10n.createGalleryTitle;
}