Update block-filters.md

docs/reference-guides/filters/block-filters.md

@@ -294,6 +294,31 @@ Used to filter an individual transform result from block transformation. All of
 
 Called immediately after the default parsing of a block's attributes and before validation to allow a plugin to manipulate attribute values in time for validation and/or the initial values rendering of the block in the editor.
 
+The callback function for this filter accepts 4 parameters:
+- `blockAttributes` (`Object`): The attributes of the block node given its type.
+- `blockType` (`Object`): A block-type definition object.
+- `innerHTML` (`string`): Inner HTML content of the block.
+- `attributea` (`object`): Known attributes of the block.
+
+In the example below, we use the `blocks.getBlockAttributes` filter to lock the position of all paragraph blocks on a page.
+
+```js
+// Our filter function
+function lockParagraphs( blockAttributes, blockType, innterHTML, attributes  ) {
+    if(blockType['name'] === 'core/paragraph') {
+        blockAttributes['lock'] = {move: true}
+    }
+    return blockAttributes;
+}
+
+// Call the filter
+wp.hooks.addFilter(
+    'blocks.getBlockAttributes',
+    'it-residence/lock-paragraphs',
+    lockParagraphs
+);
+```
+
 ### `editor.BlockEdit`
 
 Used to modify the block's `edit` component. It receives the original block `BlockEdit` component and returns a new wrapped component.