Block API: Deprecate property source type

WordPress · Jun 25, 2018 · c3b8354 · c3b8354
1 parent 6694c5e
commit c3b8354
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 0 deletions.
diff --git a/blocks/api/parser.js b/blocks/api/parser.js
@@ -8,6 +8,7 @@ import { castArray, mapValues, omit } from 'lodash';
  * WordPress dependencies
  */
 import { autop } from '@wordpress/autop';
+import deprecated from '@wordpress/deprecated';
 
 /**
  * Internal dependencies
@@ -70,6 +71,12 @@ export function matcherFromSource( sourceConfig ) {
 		case 'attribute':
 			return attr( sourceConfig.selector, sourceConfig.attribute );
 		case 'property':
+			deprecated( '`property` source', {
+				version: '3.3',
+				alternative: 'equivalent `text`, `html`, or `attribute` source, or comment attribute',
+				plugin: 'Gutenberg',
+			} );
+
 			return prop( sourceConfig.selector, sourceConfig.property );
 		case 'html':
 			return html( sourceConfig.selector );

diff --git a/docs/reference/deprecated.md b/docs/reference/deprecated.md
@@ -8,6 +8,7 @@ Gutenberg's deprecation policy is intended to support backwards-compatibility fo
  - `blocks.BlockEdit` filter removed. Please use `editor.BlockEdit` instead.
  - `blocks.BlockListBlock` filter removed. Please use `editor.BlockListBlock` instead.
  - `blocks.MediaUpload` filter removed. Please use `editor.MediaUpload` instead.
+ - `property` source removed. Please use equivalent `text`, `html`, or `attribute` source, or comment attribute instead.
 
 ## 3.2.0