@wordpress/block-editor 6.1.12 → 6.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +100 -98
  2. package/build/components/block-list/head.js +27 -0
  3. package/build/components/block-list/head.js.map +1 -0
  4. package/build/components/block-list/index.js +4 -2
  5. package/build/components/block-list/index.js.map +1 -1
  6. package/build/components/iframe/index.js +34 -5
  7. package/build/components/iframe/index.js.map +1 -1
  8. package/build/components/rich-text/use-input-rules.js +5 -2
  9. package/build/components/rich-text/use-input-rules.js.map +1 -1
  10. package/build/components/use-setting/index.js +1 -1
  11. package/build/components/use-setting/index.js.map +1 -1
  12. package/build/components/writing-flow/index.js +27 -14
  13. package/build/components/writing-flow/index.js.map +1 -1
  14. package/build/components/writing-flow/use-select-all.js +36 -34
  15. package/build/components/writing-flow/use-select-all.js.map +1 -1
  16. package/build/components/writing-flow/use-tab-nav.js +8 -0
  17. package/build/components/writing-flow/use-tab-nav.js.map +1 -1
  18. package/build/hooks/duotone.js +5 -2
  19. package/build/hooks/duotone.js.map +1 -1
  20. package/build/hooks/layout.js +5 -2
  21. package/build/hooks/layout.js.map +1 -1
  22. package/build-module/components/block-list/head.js +19 -0
  23. package/build-module/components/block-list/head.js.map +1 -0
  24. package/build-module/components/block-list/index.js +3 -2
  25. package/build-module/components/block-list/index.js.map +1 -1
  26. package/build-module/components/iframe/index.js +34 -5
  27. package/build-module/components/iframe/index.js.map +1 -1
  28. package/build-module/components/rich-text/use-input-rules.js +5 -2
  29. package/build-module/components/rich-text/use-input-rules.js.map +1 -1
  30. package/build-module/components/use-setting/index.js +1 -1
  31. package/build-module/components/use-setting/index.js.map +1 -1
  32. package/build-module/components/writing-flow/index.js +23 -12
  33. package/build-module/components/writing-flow/index.js.map +1 -1
  34. package/build-module/components/writing-flow/use-select-all.js +30 -28
  35. package/build-module/components/writing-flow/use-select-all.js.map +1 -1
  36. package/build-module/components/writing-flow/use-tab-nav.js +8 -0
  37. package/build-module/components/writing-flow/use-tab-nav.js.map +1 -1
  38. package/build-module/hooks/duotone.js +5 -2
  39. package/build-module/hooks/duotone.js.map +1 -1
  40. package/build-module/hooks/layout.js +5 -2
  41. package/build-module/hooks/layout.js.map +1 -1
  42. package/build-style/style-rtl.css +1 -1
  43. package/build-style/style.css +1 -1
  44. package/package.json +23 -23
  45. package/src/components/block-list/head.js +18 -0
  46. package/src/components/block-list/index.js +21 -18
  47. package/src/components/block-list-appender/style.scss +3 -4
  48. package/src/components/iframe/index.js +39 -7
  49. package/src/components/rich-text/use-input-rules.js +4 -2
  50. package/src/components/use-setting/index.js +1 -1
  51. package/src/components/writing-flow/index.js +23 -10
  52. package/src/components/writing-flow/use-select-all.js +33 -35
  53. package/src/components/writing-flow/use-tab-nav.js +8 -0
  54. package/src/hooks/duotone.js +13 -5
  55. package/src/hooks/layout.js +12 -4
package/README.md CHANGED
@@ -78,29 +78,29 @@ registerCoreBlocks();
78
78
 
79
79
  <!-- START TOKEN(Autogenerated API docs) -->
80
80
 
81
- <a name="AlignmentControl" href="#AlignmentControl">#</a> **AlignmentControl**
81
+ ### AlignmentControl
82
82
 
83
83
  Undocumented declaration.
84
84
 
85
- <a name="AlignmentToolbar" href="#AlignmentToolbar">#</a> **AlignmentToolbar**
85
+ ### AlignmentToolbar
86
86
 
87
87
  Undocumented declaration.
88
88
 
89
- <a name="Autocomplete" href="#Autocomplete">#</a> **Autocomplete**
89
+ ### Autocomplete
90
90
 
91
91
  _Related_
92
92
 
93
93
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/autocomplete/README.md>
94
94
 
95
- <a name="BlockAlignmentControl" href="#BlockAlignmentControl">#</a> **BlockAlignmentControl**
95
+ ### BlockAlignmentControl
96
96
 
97
97
  Undocumented declaration.
98
98
 
99
- <a name="BlockAlignmentToolbar" href="#BlockAlignmentToolbar">#</a> **BlockAlignmentToolbar**
99
+ ### BlockAlignmentToolbar
100
100
 
101
101
  Undocumented declaration.
102
102
 
103
- <a name="BlockBreadcrumb" href="#BlockBreadcrumb">#</a> **BlockBreadcrumb**
103
+ ### BlockBreadcrumb
104
104
 
105
105
  Block breadcrumb component, displaying the hierarchy of the current block selection as a breadcrumb.
106
106
 
@@ -113,11 +113,11 @@ _Returns_
113
113
 
114
114
  - `WPElement`: Block Breadcrumb.
115
115
 
116
- <a name="BlockColorsStyleSelector" href="#BlockColorsStyleSelector">#</a> **BlockColorsStyleSelector**
116
+ ### BlockColorsStyleSelector
117
117
 
118
118
  Undocumented declaration.
119
119
 
120
- <a name="BlockContextProvider" href="#BlockContextProvider">#</a> **BlockContextProvider**
120
+ ### BlockContextProvider
121
121
 
122
122
  Component which merges passed value with current consumed block context.
123
123
 
@@ -127,49 +127,49 @@ _Related_
127
127
 
128
128
  _Parameters_
129
129
 
130
- - _props_ `BlockContextProviderProps`:
130
+ - _props_ `BlockContextProviderProps`:
131
131
 
132
- <a name="BlockControls" href="#BlockControls">#</a> **BlockControls**
132
+ ### BlockControls
133
133
 
134
134
  Undocumented declaration.
135
135
 
136
- <a name="BlockEdit" href="#BlockEdit">#</a> **BlockEdit**
136
+ ### BlockEdit
137
137
 
138
138
  Undocumented declaration.
139
139
 
140
- <a name="BlockEditorKeyboardShortcuts" href="#BlockEditorKeyboardShortcuts">#</a> **BlockEditorKeyboardShortcuts**
140
+ ### BlockEditorKeyboardShortcuts
141
141
 
142
142
  Undocumented declaration.
143
143
 
144
- <a name="BlockEditorProvider" href="#BlockEditorProvider">#</a> **BlockEditorProvider**
144
+ ### BlockEditorProvider
145
145
 
146
146
  Undocumented declaration.
147
147
 
148
- <a name="BlockFormatControls" href="#BlockFormatControls">#</a> **BlockFormatControls**
148
+ ### BlockFormatControls
149
149
 
150
150
  Undocumented declaration.
151
151
 
152
- <a name="BlockIcon" href="#BlockIcon">#</a> **BlockIcon**
152
+ ### BlockIcon
153
153
 
154
154
  Undocumented declaration.
155
155
 
156
- <a name="BlockInspector" href="#BlockInspector">#</a> **BlockInspector**
156
+ ### BlockInspector
157
157
 
158
158
  Undocumented declaration.
159
159
 
160
- <a name="BlockList" href="#BlockList">#</a> **BlockList**
160
+ ### BlockList
161
161
 
162
162
  Undocumented declaration.
163
163
 
164
- <a name="BlockMover" href="#BlockMover">#</a> **BlockMover**
164
+ ### BlockMover
165
165
 
166
166
  Undocumented declaration.
167
167
 
168
- <a name="BlockNavigationDropdown" href="#BlockNavigationDropdown">#</a> **BlockNavigationDropdown**
168
+ ### BlockNavigationDropdown
169
169
 
170
170
  Undocumented declaration.
171
171
 
172
- <a name="BlockPreview" href="#BlockPreview">#</a> **BlockPreview**
172
+ ### BlockPreview
173
173
 
174
174
  BlockPreview renders a preview of a block or array of blocks.
175
175
 
@@ -187,15 +187,15 @@ _Returns_
187
187
 
188
188
  - `WPComponent`: The component to be rendered.
189
189
 
190
- <a name="BlockSelectionClearer" href="#BlockSelectionClearer">#</a> **BlockSelectionClearer**
190
+ ### BlockSelectionClearer
191
191
 
192
192
  Undocumented declaration.
193
193
 
194
- <a name="BlockSettingsMenu" href="#BlockSettingsMenu">#</a> **BlockSettingsMenu**
194
+ ### BlockSettingsMenu
195
195
 
196
196
  Undocumented declaration.
197
197
 
198
- <a name="BlockSettingsMenuControls" href="#BlockSettingsMenuControls">#</a> **BlockSettingsMenuControls**
198
+ ### BlockSettingsMenuControls
199
199
 
200
200
  _Related_
201
201
 
@@ -209,7 +209,7 @@ _Returns_
209
209
 
210
210
  - `WPElement`: Element.
211
211
 
212
- <a name="BlockTitle" href="#BlockTitle">#</a> **BlockTitle**
212
+ ### BlockTitle
213
213
 
214
214
  Renders the block's configured title as a string, or empty if the title
215
215
  cannot be determined.
@@ -222,18 +222,18 @@ _Usage_
222
222
 
223
223
  _Parameters_
224
224
 
225
- - _props_ `Object`:
225
+ - _props_ `Object`:
226
226
  - _props.clientId_ `string`: Client ID of block.
227
227
 
228
228
  _Returns_
229
229
 
230
230
  - `?string`: Block title.
231
231
 
232
- <a name="BlockToolbar" href="#BlockToolbar">#</a> **BlockToolbar**
232
+ ### BlockToolbar
233
233
 
234
234
  Undocumented declaration.
235
235
 
236
- <a name="BlockTools" href="#BlockTools">#</a> **BlockTools**
236
+ ### BlockTools
237
237
 
238
238
  Renders block tools (the block toolbar, select/navigation mode toolbar, the
239
239
  insertion point and a slot for the inline rich text toolbar). Must be wrapped
@@ -245,43 +245,43 @@ _Parameters_
245
245
  - _$0.children_ `Object`: The block content and style container.
246
246
  - _$0.\_\_unstableContentRef_ `Object`: Ref holding the content scroll container.
247
247
 
248
- <a name="BlockVerticalAlignmentControl" href="#BlockVerticalAlignmentControl">#</a> **BlockVerticalAlignmentControl**
248
+ ### BlockVerticalAlignmentControl
249
249
 
250
250
  Undocumented declaration.
251
251
 
252
- <a name="BlockVerticalAlignmentToolbar" href="#BlockVerticalAlignmentToolbar">#</a> **BlockVerticalAlignmentToolbar**
252
+ ### BlockVerticalAlignmentToolbar
253
253
 
254
254
  Undocumented declaration.
255
255
 
256
- <a name="ButtonBlockAppender" href="#ButtonBlockAppender">#</a> **ButtonBlockAppender**
256
+ ### ButtonBlockAppender
257
257
 
258
258
  _Related_
259
259
 
260
260
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/button-block-appender/README.md>
261
261
 
262
- <a name="ButtonBlockerAppender" href="#ButtonBlockerAppender">#</a> **ButtonBlockerAppender**
262
+ ### ButtonBlockerAppender
263
263
 
264
- > **Deprecated**
264
+ > **Deprecated**
265
265
 
266
266
  Use `ButtonBlockAppender` instead.
267
267
 
268
- <a name="ColorPalette" href="#ColorPalette">#</a> **ColorPalette**
268
+ ### ColorPalette
269
269
 
270
270
  Undocumented declaration.
271
271
 
272
- <a name="ColorPaletteControl" href="#ColorPaletteControl">#</a> **ColorPaletteControl**
272
+ ### ColorPaletteControl
273
273
 
274
274
  Undocumented declaration.
275
275
 
276
- <a name="ContrastChecker" href="#ContrastChecker">#</a> **ContrastChecker**
276
+ ### ContrastChecker
277
277
 
278
278
  Undocumented declaration.
279
279
 
280
- <a name="CopyHandler" href="#CopyHandler">#</a> **CopyHandler**
280
+ ### CopyHandler
281
281
 
282
282
  Undocumented declaration.
283
283
 
284
- <a name="createCustomColorsHOC" href="#createCustomColorsHOC">#</a> **createCustomColorsHOC**
284
+ ### createCustomColorsHOC
285
285
 
286
286
  A higher-order component factory for creating a 'withCustomColors' HOC, which handles color logic
287
287
  for class generation color value, retrieval and color attribute setting.
@@ -291,12 +291,15 @@ Use this higher-order component to work with a custom set of colors.
291
291
  _Usage_
292
292
 
293
293
  ```jsx
294
- const CUSTOM_COLORS = [ { name: 'Red', slug: 'red', color: '#ff0000' }, { name: 'Blue', slug: 'blue', color: '#0000ff' } ];
294
+ const CUSTOM_COLORS = [
295
+ { name: 'Red', slug: 'red', color: '#ff0000' },
296
+ { name: 'Blue', slug: 'blue', color: '#0000ff' },
297
+ ];
295
298
  const withCustomColors = createCustomColorsHOC( CUSTOM_COLORS );
296
299
  // ...
297
300
  export default compose(
298
- withCustomColors( 'backgroundColor', 'borderColor' ),
299
- MyColorfulComponent,
301
+ withCustomColors( 'backgroundColor', 'borderColor' ),
302
+ MyColorfulComponent
300
303
  );
301
304
  ```
302
305
 
@@ -308,15 +311,15 @@ _Returns_
308
311
 
309
312
  - `Function`: Higher-order component.
310
313
 
311
- <a name="DefaultBlockAppender" href="#DefaultBlockAppender">#</a> **DefaultBlockAppender**
314
+ ### DefaultBlockAppender
312
315
 
313
316
  Undocumented declaration.
314
317
 
315
- <a name="FontSizePicker" href="#FontSizePicker">#</a> **FontSizePicker**
318
+ ### FontSizePicker
316
319
 
317
320
  Undocumented declaration.
318
321
 
319
- <a name="getColorClassName" href="#getColorClassName">#</a> **getColorClassName**
322
+ ### getColorClassName
320
323
 
321
324
  Returns a class based on the context a color is being used and its slug.
322
325
 
@@ -329,7 +332,7 @@ _Returns_
329
332
 
330
333
  - `?string`: String with the class corresponding to the color in the provided context. Returns undefined if either colorContextName or colorSlug are not provided.
331
334
 
332
- <a name="getColorObjectByAttributeValues" href="#getColorObjectByAttributeValues">#</a> **getColorObjectByAttributeValues**
335
+ ### getColorObjectByAttributeValues
333
336
 
334
337
  Provided an array of color objects as set by the theme or by the editor defaults,
335
338
  and the values of the defined color or custom color returns a color object describing the color.
@@ -344,7 +347,7 @@ _Returns_
344
347
 
345
348
  - `?Object`: If definedColor is passed and the name is found in colors, the color object exactly as set by the theme or editor defaults is returned. Otherwise, an object that just sets the color is defined.
346
349
 
347
- <a name="getColorObjectByColorValue" href="#getColorObjectByColorValue">#</a> **getColorObjectByColorValue**
350
+ ### getColorObjectByColorValue
348
351
 
349
352
  Provided an array of color objects as set by the theme or by the editor defaults, and a color value returns the color object matching that value or undefined.
350
353
 
@@ -357,10 +360,10 @@ _Returns_
357
360
 
358
361
  - `?Object`: Color object included in the colors array whose color property equals colorValue. Returns undefined if no color object matches this requirement.
359
362
 
360
- <a name="getFontSize" href="#getFontSize">#</a> **getFontSize**
363
+ ### getFontSize
361
364
 
362
- Returns the font size object based on an array of named font sizes and the namedFontSize and customFontSize values.
363
- If namedFontSize is undefined or not found in fontSizes an object with just the size value based on customFontSize is returned.
365
+ Returns the font size object based on an array of named font sizes and the namedFontSize and customFontSize values.
366
+ If namedFontSize is undefined or not found in fontSizes an object with just the size value based on customFontSize is returned.
364
367
 
365
368
  _Parameters_
366
369
 
@@ -372,7 +375,7 @@ _Returns_
372
375
 
373
376
  - `?Object`: If fontSizeAttribute is set and an equal slug is found in fontSizes it returns the font size object for that slug. Otherwise, an object with just the size value based on customFontSize is returned.
374
377
 
375
- <a name="getFontSizeClass" href="#getFontSizeClass">#</a> **getFontSizeClass**
378
+ ### getFontSizeClass
376
379
 
377
380
  Returns a class based on fontSizeName.
378
381
 
@@ -384,7 +387,7 @@ _Returns_
384
387
 
385
388
  - `string`: String with the class corresponding to the fontSize passed. The class is generated by appending 'has-' followed by fontSizeSlug in kebabCase and ending with '-font-size'.
386
389
 
387
- <a name="getFontSizeObjectByValue" href="#getFontSizeObjectByValue">#</a> **getFontSizeObjectByValue**
390
+ ### getFontSizeObjectByValue
388
391
 
389
392
  Returns the corresponding font size object for a given value.
390
393
 
@@ -397,7 +400,7 @@ _Returns_
397
400
 
398
401
  - `Object`: Font size object.
399
402
 
400
- <a name="getGradientSlugByValue" href="#getGradientSlugByValue">#</a> **getGradientSlugByValue**
403
+ ### getGradientSlugByValue
401
404
 
402
405
  Retrieves the gradient slug per slug.
403
406
 
@@ -410,7 +413,7 @@ _Returns_
410
413
 
411
414
  - `string`: Gradient slug.
412
415
 
413
- <a name="getGradientValueBySlug" href="#getGradientValueBySlug">#</a> **getGradientValueBySlug**
416
+ ### getGradientValueBySlug
414
417
 
415
418
  Retrieves the gradient value per slug.
416
419
 
@@ -423,108 +426,108 @@ _Returns_
423
426
 
424
427
  - `string`: Gradient value.
425
428
 
426
- <a name="InnerBlocks" href="#InnerBlocks">#</a> **InnerBlocks**
429
+ ### InnerBlocks
427
430
 
428
431
  _Related_
429
432
 
430
433
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/inner-blocks/README.md>
431
434
 
432
- <a name="Inserter" href="#Inserter">#</a> **Inserter**
435
+ ### Inserter
433
436
 
434
437
  Undocumented declaration.
435
438
 
436
- <a name="InspectorAdvancedControls" href="#InspectorAdvancedControls">#</a> **InspectorAdvancedControls**
439
+ ### InspectorAdvancedControls
437
440
 
438
441
  _Related_
439
442
 
440
443
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/inspector-advanced-controls/README.md>
441
444
 
442
- <a name="InspectorControls" href="#InspectorControls">#</a> **InspectorControls**
445
+ ### InspectorControls
443
446
 
444
447
  _Related_
445
448
 
446
449
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/inspector-controls/README.md>
447
450
 
448
- <a name="JustifyContentControl" href="#JustifyContentControl">#</a> **JustifyContentControl**
451
+ ### JustifyContentControl
449
452
 
450
453
  Undocumented declaration.
451
454
 
452
- <a name="JustifyToolbar" href="#JustifyToolbar">#</a> **JustifyToolbar**
455
+ ### JustifyToolbar
453
456
 
454
457
  Undocumented declaration.
455
458
 
456
- <a name="LineHeightControl" href="#LineHeightControl">#</a> **LineHeightControl**
459
+ ### LineHeightControl
457
460
 
458
461
  Undocumented declaration.
459
462
 
460
- <a name="MediaPlaceholder" href="#MediaPlaceholder">#</a> **MediaPlaceholder**
463
+ ### MediaPlaceholder
461
464
 
462
465
  _Related_
463
466
 
464
467
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/media-placeholder/README.md>
465
468
 
466
- <a name="MediaReplaceFlow" href="#MediaReplaceFlow">#</a> **MediaReplaceFlow**
469
+ ### MediaReplaceFlow
467
470
 
468
471
  Undocumented declaration.
469
472
 
470
- <a name="MediaUpload" href="#MediaUpload">#</a> **MediaUpload**
473
+ ### MediaUpload
471
474
 
472
475
  _Related_
473
476
 
474
477
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/media-upload/README.md>
475
478
 
476
- <a name="MediaUploadCheck" href="#MediaUploadCheck">#</a> **MediaUploadCheck**
479
+ ### MediaUploadCheck
477
480
 
478
481
  _Related_
479
482
 
480
483
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/media-upload/README.md>
481
484
 
482
- <a name="MultiSelectScrollIntoView" href="#MultiSelectScrollIntoView">#</a> **MultiSelectScrollIntoView**
485
+ ### MultiSelectScrollIntoView
483
486
 
484
- > **Deprecated**
487
+ > **Deprecated**
485
488
 
486
489
  Scrolls the multi block selection end into view if not in view already. This
487
490
  is important to do after selection by keyboard.
488
491
 
489
- <a name="NavigableToolbar" href="#NavigableToolbar">#</a> **NavigableToolbar**
492
+ ### NavigableToolbar
490
493
 
491
494
  Undocumented declaration.
492
495
 
493
- <a name="ObserveTyping" href="#ObserveTyping">#</a> **ObserveTyping**
496
+ ### ObserveTyping
494
497
 
495
498
  _Related_
496
499
 
497
500
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/observe-typing/README.md>
498
501
 
499
- <a name="PanelColorSettings" href="#PanelColorSettings">#</a> **PanelColorSettings**
502
+ ### PanelColorSettings
500
503
 
501
504
  Undocumented declaration.
502
505
 
503
- <a name="PlainText" href="#PlainText">#</a> **PlainText**
506
+ ### PlainText
504
507
 
505
508
  _Related_
506
509
 
507
510
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/plain-text/README.md>
508
511
 
509
- <a name="PreserveScrollInReorder" href="#PreserveScrollInReorder">#</a> **PreserveScrollInReorder**
512
+ ### PreserveScrollInReorder
510
513
 
511
514
  Undocumented declaration.
512
515
 
513
- <a name="RichText" href="#RichText">#</a> **RichText**
516
+ ### RichText
514
517
 
515
518
  _Related_
516
519
 
517
520
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/rich-text/README.md>
518
521
 
519
- <a name="RichTextShortcut" href="#RichTextShortcut">#</a> **RichTextShortcut**
522
+ ### RichTextShortcut
520
523
 
521
524
  Undocumented declaration.
522
525
 
523
- <a name="RichTextToolbarButton" href="#RichTextToolbarButton">#</a> **RichTextToolbarButton**
526
+ ### RichTextToolbarButton
524
527
 
525
528
  Undocumented declaration.
526
529
 
527
- <a name="SETTINGS_DEFAULTS" href="#SETTINGS_DEFAULTS">#</a> **SETTINGS_DEFAULTS**
530
+ ### SETTINGS_DEFAULTS
528
531
 
529
532
  The default editor settings
530
533
 
@@ -552,11 +555,11 @@ _Properties_
552
555
  - _\_\_experimentalBlockPatterns_ `Array`: Array of objects representing the block patterns
553
556
  - _\_\_experimentalBlockPatternCategories_ `Array`: Array of objects representing the block pattern categories
554
557
 
555
- <a name="SkipToSelectedBlock" href="#SkipToSelectedBlock">#</a> **SkipToSelectedBlock**
558
+ ### SkipToSelectedBlock
556
559
 
557
560
  Undocumented declaration.
558
561
 
559
- <a name="store" href="#store">#</a> **store**
562
+ ### store
560
563
 
561
564
  Store definition for the block editor namespace.
562
565
 
@@ -568,7 +571,7 @@ _Type_
568
571
 
569
572
  - `Object`
570
573
 
571
- <a name="storeConfig" href="#storeConfig">#</a> **storeConfig**
574
+ ### storeConfig
572
575
 
573
576
  Block editor data store configuration.
574
577
 
@@ -580,11 +583,11 @@ _Type_
580
583
 
581
584
  - `Object`
582
585
 
583
- <a name="ToolSelector" href="#ToolSelector">#</a> **ToolSelector**
586
+ ### ToolSelector
584
587
 
585
588
  Undocumented declaration.
586
589
 
587
- <a name="transformStyles" href="#transformStyles">#</a> **transformStyles**
590
+ ### transformStyles
588
591
 
589
592
  Applies a series of CSS rule transforms to wrap selectors inside a given class and/or rewrite URLs depending on the parameters passed.
590
593
 
@@ -597,31 +600,31 @@ _Returns_
597
600
 
598
601
  - `Array`: converted rules.
599
602
 
600
- <a name="Typewriter" href="#Typewriter">#</a> **Typewriter**
603
+ ### Typewriter
601
604
 
602
605
  Ensures that the text selection keeps the same vertical distance from the
603
606
  viewport during keyboard events within this component. The vertical distance
604
607
  can vary. It is the last clicked or scrolled to position.
605
608
 
606
- <a name="URLInput" href="#URLInput">#</a> **URLInput**
609
+ ### URLInput
607
610
 
608
611
  _Related_
609
612
 
610
613
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/url-input/README.md>
611
614
 
612
- <a name="URLInputButton" href="#URLInputButton">#</a> **URLInputButton**
615
+ ### URLInputButton
613
616
 
614
617
  _Related_
615
618
 
616
619
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/url-input/README.md>
617
620
 
618
- <a name="URLPopover" href="#URLPopover">#</a> **URLPopover**
621
+ ### URLPopover
619
622
 
620
623
  _Related_
621
624
 
622
625
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/url-popover/README.md>
623
626
 
624
- <a name="useBlockDisplayInformation" href="#useBlockDisplayInformation">#</a> **useBlockDisplayInformation**
627
+ ### useBlockDisplayInformation
625
628
 
626
629
  Hook used to try to find a matching block variation and return
627
630
  the appropriate information for display reasons. In order to
@@ -641,11 +644,11 @@ _Returns_
641
644
 
642
645
  - `?WPBlockDisplayInformation`: Block's display information, or `null` when the block or its type not found.
643
646
 
644
- <a name="useBlockEditContext" href="#useBlockEditContext">#</a> **useBlockEditContext**
647
+ ### useBlockEditContext
645
648
 
646
649
  Undocumented declaration.
647
650
 
648
- <a name="useBlockProps" href="#useBlockProps">#</a> **useBlockProps**
651
+ ### useBlockProps
649
652
 
650
653
  This hook is used to lightly mark an element as a block element. The element
651
654
  should be the outermost element of a block. Call this hook and pass the
@@ -659,13 +662,13 @@ _Parameters_
659
662
 
660
663
  - _props_ `Object`: Optional. Props to pass to the element. Must contain the ref if one is defined.
661
664
  - _options_ `Object`: Options for internal use only.
662
- - _options.\_\_unstableIsHtml_ `boolean`:
665
+ - _options.\_\_unstableIsHtml_ `boolean`:
663
666
 
664
667
  _Returns_
665
668
 
666
669
  - `Object`: Props to pass to the element to mark as a block.
667
670
 
668
- <a name="useSetting" href="#useSetting">#</a> **useSetting**
671
+ ### useSetting
669
672
 
670
673
  Hook that retrieves the editor setting.
671
674
  It works with nested objects using by finding the value at path.
@@ -684,7 +687,7 @@ _Returns_
684
687
 
685
688
  - `any`: Returns the value defined for the setting.
686
689
 
687
- <a name="validateThemeColors" href="#validateThemeColors">#</a> **validateThemeColors**
690
+ ### validateThemeColors
688
691
 
689
692
  Given an array of theme colors checks colors for validity
690
693
 
@@ -696,7 +699,7 @@ _Returns_
696
699
 
697
700
  - `Array`: The array of valid theme colors or the default colors
698
701
 
699
- <a name="validateThemeGradients" href="#validateThemeGradients">#</a> **validateThemeGradients**
702
+ ### validateThemeGradients
700
703
 
701
704
  Given an array of theme gradients checks gradients for validity
702
705
 
@@ -708,17 +711,17 @@ _Returns_
708
711
 
709
712
  - `Array`: The array of valid theme gradients or the default gradients
710
713
 
711
- <a name="Warning" href="#Warning">#</a> **Warning**
714
+ ### Warning
712
715
 
713
716
  _Related_
714
717
 
715
718
  - <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/warning/README.md>
716
719
 
717
- <a name="withColorContext" href="#withColorContext">#</a> **withColorContext**
720
+ ### withColorContext
718
721
 
719
722
  Undocumented declaration.
720
723
 
721
- <a name="withColors" href="#withColors">#</a> **withColors**
724
+ ### withColors
722
725
 
723
726
  A higher-order component, which handles color logic for class generation color value, retrieval and color attribute setting.
724
727
 
@@ -728,8 +731,8 @@ _Usage_
728
731
 
729
732
  ```jsx
730
733
  export default compose(
731
- withColors( 'backgroundColor', { textColor: 'color' } ),
732
- MyColorfulComponent,
734
+ withColors( 'backgroundColor', { textColor: 'color' } ),
735
+ MyColorfulComponent
733
736
  );
734
737
  ```
735
738
 
@@ -741,7 +744,7 @@ _Returns_
741
744
 
742
745
  - `Function`: Higher-order component.
743
746
 
744
- <a name="withFontSizes" href="#withFontSizes">#</a> **withFontSizes**
747
+ ### withFontSizes
745
748
 
746
749
  Higher-order component, which handles font size logic for class generation,
747
750
  font size value retrieval, and font size change handling.
@@ -754,7 +757,7 @@ _Returns_
754
757
 
755
758
  - `Function`: Higher-order component.
756
759
 
757
- <a name="WritingFlow" href="#WritingFlow">#</a> **WritingFlow**
760
+ ### WritingFlow
758
761
 
759
762
  Handles selection and navigation across blocks. This component should be
760
763
  wrapped around BlockList.
@@ -764,7 +767,6 @@ _Parameters_
764
767
  - _props_ `Object`: Component properties.
765
768
  - _props.children_ `WPElement`: Children to be rendered.
766
769
 
767
-
768
770
  <!-- END TOKEN(Autogenerated API docs) -->
769
771
 
770
772
  <br/><br/><p align="center"><img src="https://s.w.org/style/images/codeispoetry.png?1" alt="Code is Poetry." /></p>
@@ -0,0 +1,27 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.Head = Head;
7
+
8
+ var _element = require("@wordpress/element");
9
+
10
+ /**
11
+ * WordPress dependencies
12
+ */
13
+ const context = (0, _element.createContext)();
14
+
15
+ function Head({
16
+ children
17
+ }) {
18
+ const [element, setElement] = (0, _element.useState)();
19
+ return (0, _element.createElement)(context.Provider, {
20
+ value: element
21
+ }, (0, _element.createElement)("div", {
22
+ ref: setElement
23
+ }), children);
24
+ }
25
+
26
+ Head.context = context;
27
+ //# sourceMappingURL=head.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["@wordpress/block-editor/src/components/block-list/head.js"],"names":["context","Head","children","element","setElement"],"mappings":";;;;;;;AAGA;;AAHA;AACA;AACA;AAGA,MAAMA,OAAO,GAAG,6BAAhB;;AAEO,SAASC,IAAT,CAAe;AAAEC,EAAAA;AAAF,CAAf,EAA8B;AACpC,QAAM,CAAEC,OAAF,EAAWC,UAAX,IAA0B,wBAAhC;AACA,SACC,4BAAC,OAAD,CAAS,QAAT;AAAkB,IAAA,KAAK,EAAGD;AAA1B,KACC;AAAK,IAAA,GAAG,EAAGC;AAAX,IADD,EAEGF,QAFH,CADD;AAMA;;AAEDD,IAAI,CAACD,OAAL,GAAeA,OAAf","sourcesContent":["/**\n * WordPress dependencies\n */\nimport { createContext, useState } from '@wordpress/element';\n\nconst context = createContext();\n\nexport function Head( { children } ) {\n\tconst [ element, setElement ] = useState();\n\treturn (\n\t\t<context.Provider value={ element }>\n\t\t\t<div ref={ setElement } />\n\t\t\t{ children }\n\t\t</context.Provider>\n\t);\n}\n\nHead.context = context;\n"]}