From 6ff5d29e1963c6cf87821c32820d3f452ff06332 Mon Sep 17 00:00:00 2001 From: Jon Surrell Date: Tue, 17 Dec 2024 12:54:27 +0100 Subject: [PATCH] Autoformat everything --- .github/ISSUE_TEMPLATE/Bug_report_mobile.md | 24 +- .github/ISSUE_TEMPLATE/Feature_request.md | 5 +- .github/PULL_REQUEST_TEMPLATE.md | 11 +- .github/SUPPORT.md | 9 +- backport-changelog/6.6/6279.md | 2 +- backport-changelog/6.6/6522.md | 6 +- backport-changelog/6.6/6559.md | 8 +- backport-changelog/6.6/6567.md | 4 +- backport-changelog/6.6/6590.md | 6 +- backport-changelog/6.6/6605.md | 2 +- backport-changelog/6.6/6616.md | 10 +- backport-changelog/6.6/6656.md | 2 +- backport-changelog/6.6/6662.md | 4 +- backport-changelog/6.6/6694.md | 2 +- backport-changelog/6.6/6731.md | 2 +- backport-changelog/6.6/6737.md | 2 +- backport-changelog/6.6/6744.md | 2 +- backport-changelog/6.6/6756.md | 4 +- backport-changelog/6.6/6785.md | 2 +- backport-changelog/6.6/6797.md | 2 +- backport-changelog/6.6/6824.md | 2 +- backport-changelog/6.6/6825.md | 2 +- backport-changelog/6.6/6827.md | 2 +- backport-changelog/6.6/6837.md | 4 +- backport-changelog/6.6/6841.md | 2 +- backport-changelog/6.6/6844.md | 2 +- backport-changelog/6.6/6854.md | 2 +- backport-changelog/6.6/6864.md | 4 +- backport-changelog/6.6/6873.md | 2 +- backport-changelog/6.6/6959.md | 3 +- backport-changelog/6.6/6987.md | 2 +- backport-changelog/6.6/6989.md | 2 +- backport-changelog/6.6/7012.md | 2 +- backport-changelog/6.6/7036.md | 2 +- backport-changelog/6.6/7061.md | 2 +- backport-changelog/6.6/7088.md | 3 +- backport-changelog/6.6/7097.md | 2 +- backport-changelog/6.6/7145.md | 2 +- backport-changelog/6.7/6668.md | 2 +- backport-changelog/6.7/6750.md | 2 +- backport-changelog/6.7/6836.md | 2 +- backport-changelog/6.7/6991.md | 2 +- backport-changelog/6.7/7020.md | 2 +- backport-changelog/6.7/7125.md | 4 +- backport-changelog/6.7/7137.md | 6 +- backport-changelog/6.7/7139.md | 4 +- backport-changelog/6.7/7179.md | 6 +- backport-changelog/6.7/7200.md | 2 +- backport-changelog/6.7/7247.md | 2 +- backport-changelog/6.7/7258.md | 2 +- backport-changelog/6.7/7270.md | 2 +- backport-changelog/6.7/7298.md | 2 +- backport-changelog/6.7/7314.md | 2 +- backport-changelog/6.7/7336.md | 2 +- backport-changelog/6.7/7360.md | 2 +- backport-changelog/6.7/7543.md | 2 +- backport-changelog/6.7/7552.md | 2 +- backport-changelog/6.7/7561.md | 2 +- backport-changelog/6.7/7661.md | 4 +- backport-changelog/6.7/7676.md | 2 +- backport-changelog/6.8/6910.md | 10 +- backport-changelog/6.8/7069.md | 8 +- backport-changelog/6.8/7129.md | 4 +- backport-changelog/6.8/7265.md | 4 +- backport-changelog/6.8/7488.md | 2 +- backport-changelog/6.8/7498.md | 2 +- backport-changelog/6.8/7575.md | 2 +- backport-changelog/6.8/7604.md | 6 +- backport-changelog/6.8/7643.md | 4 +- backport-changelog/6.8/7681.md | 2 +- backport-changelog/6.8/7687.md | 4 +- backport-changelog/6.8/7695.md | 10 +- backport-changelog/6.8/7697.md | 2 +- backport-changelog/6.8/7698.md | 2 +- backport-changelog/6.8/7759.md | 3 +- backport-changelog/6.8/7784.md | 2 +- backport-changelog/6.8/7825.md | 2 +- backport-changelog/6.8/7848.md | 2 +- backport-changelog/6.8/7865.md | 2 +- backport-changelog/6.8/7895.md | 2 +- backport-changelog/6.8/7898.md | 2 +- backport-changelog/6.8/7903.md | 2 +- backport-changelog/6.8/7909.md | 2 +- backport-changelog/6.8/7976.md | 2 +- backport-changelog/readme.md | 14 +- lib/README.md | 7 +- lib/experimental/sync/README.md | 76 ++-- packages/api-fetch/README.md | 13 +- .../src/components/block-controls/README.md | 19 +- .../block-heading-level-dropdown/README.md | 5 +- .../src/components/block-popover/README.md | 6 +- .../src/components/block-preview/README.md | 4 +- .../src/components/block-title/README.md | 6 +- .../block-variation-picker/README.md | 4 +- .../src/components/caption/README.md | 4 +- .../src/components/colors/README.md | 1 + .../src/components/contrast-checker/README.md | 2 +- .../src/components/font-family/README.md | 28 +- .../src/components/font-sizes/README.md | 20 +- .../src/components/global-styles/README.md | 1 + .../components/image-size-control/README.md | 2 +- .../src/components/inner-blocks/README.md | 8 +- .../inspector-popover-header/README.md | 27 +- .../letter-spacing-control/README.md | 6 +- .../components/line-height-control/README.md | 4 +- .../components/media-placeholder/README.md | 8 +- .../src/components/media-upload/README.md | 8 +- .../components/navigable-toolbar/README.md | 7 +- .../components/panel-color-settings/README.md | 26 +- .../src/components/plain-text/README.md | 1 - .../publish-date-time-picker/README.md | 9 +- .../components/recursion-provider/README.md | 29 +- .../src/components/rich-text/README.md | 4 +- .../text-decoration-control/README.md | 7 +- .../text-transform-control/README.md | 4 +- .../src/components/url-input/README.md | 3 - .../src/components/writing-flow/readme.md | 10 +- packages/blocks/CHANGELOG.md | 2 +- .../src/alignment-matrix-control/README.md | 44 +-- .../src/angle-picker-control/README.md | 19 +- .../components/src/autocomplete/README.md | 5 +- packages/components/src/badge/README.md | 10 +- .../components/src/base-control/README.md | 47 +-- packages/components/src/box-control/README.md | 113 +++--- packages/components/src/button/README.md | 104 +++-- .../components/src/card/card-body/README.md | 6 +- .../components/src/card/card-footer/README.md | 14 +- .../components/src/card/card-header/README.md | 14 +- packages/components/src/card/card/README.md | 18 +- .../src/circular-option-picker/README.md | 48 +-- .../components/src/clipboard-button/README.md | 8 +- .../components/src/color-palette/README.md | 8 +- .../components/src/color-picker/README.md | 20 +- .../components/src/combobox-control/README.md | 16 +- .../src/custom-select-control/README.md | 4 +- packages/components/src/date-time/README.md | 4 +- packages/components/src/drop-zone/README.md | 2 +- .../components/src/dropdown-menu/README.md | 1 + packages/components/src/dropdown/README.md | 6 +- .../components/src/duotone-picker/README.md | 20 +- .../src/focal-point-picker/README.md | 8 +- .../components/src/font-size-picker/README.md | 4 +- .../components/src/form-file-upload/README.md | 59 +-- .../components/src/gradient-picker/README.md | 127 +++--- packages/components/src/guide/README.md | 2 +- packages/components/src/heading/README.md | 4 +- .../higher-order/navigate-regions/README.md | 1 + .../with-fallback-styles/README.md | 4 +- packages/components/src/icon/README.md | 15 +- .../components/src/input-control/README.md | 2 +- .../src/item-group/item-group/README.md | 16 +- .../components/src/item-group/item/README.md | 6 +- .../bottom-sheet-select-control/README.md | 2 +- .../src/mobile/bottom-sheet/nav-bar/README.md | 2 +- .../mobile/bottom-sheet/sub-sheet/README.md | 4 +- packages/components/src/notice/README.md | 60 +-- .../components/src/number-control/README.md | 12 +- packages/components/src/popover/README.md | 9 +- .../components/src/query-controls/README.md | 33 +- packages/components/src/radio-group/README.md | 32 +- .../components/src/search-control/README.md | 22 +- .../components/src/select-control/README.md | 23 +- packages/components/src/slot-fill/README.md | 1 + packages/components/src/tabs/README.md | 93 ++--- .../components/src/text-control/README.md | 2 +- packages/components/src/text/README.md | 2 +- .../components/src/textarea-control/README.md | 2 +- packages/components/src/theme/README.md | 32 +- .../components/src/toggle-control/README.md | 6 +- .../tools-panel/tools-panel-item/README.md | 3 +- packages/components/src/tree-grid/README.md | 40 +- packages/components/src/tree-select/README.md | 101 ++--- .../components/src/unit-control/README.md | 15 +- .../src/hooks/use-focusable-iframe/README.md | 14 +- packages/core-data/src/entity-types/README.md | 32 +- packages/dataviews/README.md | 364 +++++++++--------- .../components/site-editor-routes/README.md | 22 +- .../local-autosave-monitor/README.md | 1 + .../src/components/post-taxonomies/README.md | 3 +- packages/env/CHANGELOG.md | 4 +- packages/env/README.md | 22 +- packages/interactivity/README.md | 2 - packages/interface/README.md | 16 +- .../legacy-local-storage-data/README.md | 20 +- .../preference-base-option/README.md | 14 +- .../preferences-modal-section/README.md | 1 - .../preferences-modal-tabs/README.md | 4 +- .../components/preferences-modal/README.md | 1 - packages/private-apis/README.md | 8 +- packages/reusable-blocks/README.md | 15 +- packages/scripts/README.md | 7 +- ...ng-the-style-engine-with-block-supports.md | 43 ++- packages/sync/CODE.md | 54 +-- .../assets/fonts/source-serif-pro/LICENSE.md | 15 +- .../docs/basic-concepts/block-library.md | 56 +-- .../basic-concepts/internationalization.md | 6 +- .../docs/basic-concepts/rendering.md | 12 +- platform-docs/docs/basic-concepts/settings.md | 98 ++--- platform-docs/docs/basic-concepts/ui.md | 8 +- .../docs/basic-concepts/undo-redo.md | 61 ++- platform-docs/docs/create-block/attributes.md | 14 +- .../docs/create-block/block-supports.md | 10 +- platform-docs/docs/intro.md | 75 ++-- schemas/CHANGELOG.md | 1 - test/storybook-playwright/README.md | 2 +- 205 files changed, 1528 insertions(+), 1419 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/Bug_report_mobile.md b/.github/ISSUE_TEMPLATE/Bug_report_mobile.md index 8347a6649ea8d6..04a855fabc5893 100644 --- a/.github/ISSUE_TEMPLATE/Bug_report_mobile.md +++ b/.github/ISSUE_TEMPLATE/Bug_report_mobile.md @@ -2,7 +2,6 @@ name: Bug report (Mobile) about: Report a bug with the mobile app version of Gutenberg labels: Mobile App - i.e. Android or iOS - --- ## Description + ## Step-by-step reproduction instructions + ## Expected behaviour + ## Actual behaviour + ## Screenshots or screen recording (optional) + ## WordPress information -- WordPress version: -- Gutenberg version: -- Are all plugins except Gutenberg deactivated? -- Are you using a default theme (e.g. Twenty Twenty-One)? + +- WordPress version: +- Gutenberg version: +- Are all plugins except Gutenberg deactivated? +- Are you using a default theme (e.g. Twenty Twenty-One)? ## Device information -- Device: -- Operating system: -- WordPress app version: + +- Device: +- Operating system: +- WordPress app version: diff --git a/.github/ISSUE_TEMPLATE/Feature_request.md b/.github/ISSUE_TEMPLATE/Feature_request.md index 66bd0943c31b45..f3e3dd8746f66b 100644 --- a/.github/ISSUE_TEMPLATE/Feature_request.md +++ b/.github/ISSUE_TEMPLATE/Feature_request.md @@ -1,11 +1,11 @@ --- name: Feature request about: Propose an idea for a feature or an enhancement -labels: "[Type] Enhancement" - +labels: '[Type] Enhancement' --- ## What problem does this address? + ## What is your proposed solution? + ## What? + ## Why? + ## How? + ## Testing Instructions + ### Testing Instructions for Keyboard + ## Screenshots or screencast -|Before|After| -|-|-| -||| +| Before | After | +| ------------------------------- | ------------------------------ | +| | | diff --git a/.github/SUPPORT.md b/.github/SUPPORT.md index ce1a0a1acffa54..319c0f4aabe9f3 100644 --- a/.github/SUPPORT.md +++ b/.github/SUPPORT.md @@ -1,12 +1,11 @@ - # Gutenberg Project Support Welcome to Gutenberg, a WordPress project. We hope you join us in creating the future platform for publishing; all are welcome here. -* Please see the [Contributing Guidelines](https://github.com/WordPress/gutenberg/blob/HEAD/CONTRIBUTING.md) for additional information on how to contribute. +- Please see the [Contributing Guidelines](https://github.com/WordPress/gutenberg/blob/HEAD/CONTRIBUTING.md) for additional information on how to contribute. -* As with all WordPress projects, we want to ensure a welcoming environment for everyone. With that in mind, all contributors are expected to follow our [Code of Conduct](https://make.wordpress.org/handbook/community-code-of-conduct/). +- As with all WordPress projects, we want to ensure a welcoming environment for everyone. With that in mind, all contributors are expected to follow our [Code of Conduct](https://make.wordpress.org/handbook/community-code-of-conduct/). -* Join us on Slack for real-time communication, it is where maintainers coordinate around the project. To get started using Slack, see: https://make.wordpress.org/chat/ +- Join us on Slack for real-time communication, it is where maintainers coordinate around the project. To get started using Slack, see: https://make.wordpress.org/chat/ -* For general WordPress support with the core editor, see the [WordPress.org support forums](https://wordpress.org/support/forums/) — it is highly active and well maintained. +- For general WordPress support with the core editor, see the [WordPress.org support forums](https://wordpress.org/support/forums/) — it is highly active and well maintained. diff --git a/backport-changelog/6.6/6279.md b/backport-changelog/6.6/6279.md index f372c33d339b8a..af38275382b428 100644 --- a/backport-changelog/6.6/6279.md +++ b/backport-changelog/6.6/6279.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6279 -* https://github.com/WordPress/gutenberg/pull/60063 +- https://github.com/WordPress/gutenberg/pull/60063 diff --git a/backport-changelog/6.6/6522.md b/backport-changelog/6.6/6522.md index 172464cf664de9..fdbfe3cefbbdb0 100644 --- a/backport-changelog/6.6/6522.md +++ b/backport-changelog/6.6/6522.md @@ -1,5 +1,5 @@ https://github.com/WordPress/wordpress-develop/pull/6522 -* https://github.com/WordPress/gutenberg/pull/60106 -* https://github.com/WordPress/gutenberg/pull/60228 -* https://github.com/WordPress/gutenberg/pull/61638 +- https://github.com/WordPress/gutenberg/pull/60106 +- https://github.com/WordPress/gutenberg/pull/60228 +- https://github.com/WordPress/gutenberg/pull/61638 diff --git a/backport-changelog/6.6/6559.md b/backport-changelog/6.6/6559.md index 176a2e04f02574..968a5465f2cc44 100644 --- a/backport-changelog/6.6/6559.md +++ b/backport-changelog/6.6/6559.md @@ -1,6 +1,6 @@ https://github.com/WordPress/wordpress-develop/pull/6559 -* https://github.com/WordPress/gutenberg/pull/60349 -* https://github.com/WordPress/gutenberg/pull/60464 -* https://github.com/WordPress/gutenberg/pull/60491 -* https://github.com/WordPress/gutenberg/pull/61757 +- https://github.com/WordPress/gutenberg/pull/60349 +- https://github.com/WordPress/gutenberg/pull/60464 +- https://github.com/WordPress/gutenberg/pull/60491 +- https://github.com/WordPress/gutenberg/pull/61757 diff --git a/backport-changelog/6.6/6567.md b/backport-changelog/6.6/6567.md index 8f200bed3b5c09..180e5438a55902 100644 --- a/backport-changelog/6.6/6567.md +++ b/backport-changelog/6.6/6567.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/6567 -* https://github.com/WordPress/gutenberg/pull/47271 -* https://github.com/WordPress/gutenberg/pull/61774 +- https://github.com/WordPress/gutenberg/pull/47271 +- https://github.com/WordPress/gutenberg/pull/61774 diff --git a/backport-changelog/6.6/6590.md b/backport-changelog/6.6/6590.md index 47ef89e0db40cb..1fe96f4e07af8d 100644 --- a/backport-changelog/6.6/6590.md +++ b/backport-changelog/6.6/6590.md @@ -1,5 +1,5 @@ https://github.com/WordPress/wordpress-develop/pull/6590 -* https://github.com/WordPress/gutenberg/pull/59531 -* https://github.com/WordPress/gutenberg/pull/61182 -* https://github.com/WordPress/gutenberg/pull/61717 +- https://github.com/WordPress/gutenberg/pull/59531 +- https://github.com/WordPress/gutenberg/pull/61182 +- https://github.com/WordPress/gutenberg/pull/61717 diff --git a/backport-changelog/6.6/6605.md b/backport-changelog/6.6/6605.md index c45a37d77e660b..75de4d7bc91221 100644 --- a/backport-changelog/6.6/6605.md +++ b/backport-changelog/6.6/6605.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6605 -* https://github.com/WordPress/gutenberg/pull/61851 +- https://github.com/WordPress/gutenberg/pull/61851 diff --git a/backport-changelog/6.6/6616.md b/backport-changelog/6.6/6616.md index bb35d6c74493cf..406bbac861be7f 100644 --- a/backport-changelog/6.6/6616.md +++ b/backport-changelog/6.6/6616.md @@ -1,7 +1,7 @@ https://github.com/WordPress/wordpress-develop/pull/6616 -* https://github.com/WordPress/gutenberg/pull/58409 -* https://github.com/WordPress/gutenberg/pull/61328 -* https://github.com/WordPress/gutenberg/pull/61842 -* https://github.com/WordPress/gutenberg/pull/62199 -* https://github.com/WordPress/gutenberg/pull/62252 +- https://github.com/WordPress/gutenberg/pull/58409 +- https://github.com/WordPress/gutenberg/pull/61328 +- https://github.com/WordPress/gutenberg/pull/61842 +- https://github.com/WordPress/gutenberg/pull/62199 +- https://github.com/WordPress/gutenberg/pull/62252 diff --git a/backport-changelog/6.6/6656.md b/backport-changelog/6.6/6656.md index f0bf8900335f49..126a5ded411f2e 100644 --- a/backport-changelog/6.6/6656.md +++ b/backport-changelog/6.6/6656.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6656 -* https://github.com/WordPress/gutenberg/pull/60715 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/60715 diff --git a/backport-changelog/6.6/6662.md b/backport-changelog/6.6/6662.md index 5b25fc99304919..498a605e49425e 100644 --- a/backport-changelog/6.6/6662.md +++ b/backport-changelog/6.6/6662.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/6662 -* https://github.com/WordPress/gutenberg/pull/57908 -* https://github.com/WordPress/gutenberg/pull/62125 +- https://github.com/WordPress/gutenberg/pull/57908 +- https://github.com/WordPress/gutenberg/pull/62125 diff --git a/backport-changelog/6.6/6694.md b/backport-changelog/6.6/6694.md index a9eb5a7f37ef5b..28be2214deb8e4 100644 --- a/backport-changelog/6.6/6694.md +++ b/backport-changelog/6.6/6694.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6694 -* https://github.com/WordPress/gutenberg/pull/60694 +- https://github.com/WordPress/gutenberg/pull/60694 diff --git a/backport-changelog/6.6/6731.md b/backport-changelog/6.6/6731.md index b8671873251659..3660a512008043 100644 --- a/backport-changelog/6.6/6731.md +++ b/backport-changelog/6.6/6731.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6731 -* https://github.com/WordPress/gutenberg/pull/62299 +- https://github.com/WordPress/gutenberg/pull/62299 diff --git a/backport-changelog/6.6/6737.md b/backport-changelog/6.6/6737.md index 84e2234ca4e79a..af2c4377c2ce32 100644 --- a/backport-changelog/6.6/6737.md +++ b/backport-changelog/6.6/6737.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6737 -* https://github.com/WordPress/gutenberg/pull/62305 +- https://github.com/WordPress/gutenberg/pull/62305 diff --git a/backport-changelog/6.6/6744.md b/backport-changelog/6.6/6744.md index 032f5420cb7184..dfdacb840e2c76 100644 --- a/backport-changelog/6.6/6744.md +++ b/backport-changelog/6.6/6744.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6744 -* https://github.com/WordPress/gutenberg/pull/62355 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/62355 diff --git a/backport-changelog/6.6/6756.md b/backport-changelog/6.6/6756.md index 688b258c095faa..a6096991c07044 100644 --- a/backport-changelog/6.6/6756.md +++ b/backport-changelog/6.6/6756.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/6756 -* https://github.com/WordPress/gutenberg/pull/62461 -* https://github.com/WordPress/gutenberg/pull/62495 +- https://github.com/WordPress/gutenberg/pull/62461 +- https://github.com/WordPress/gutenberg/pull/62495 diff --git a/backport-changelog/6.6/6785.md b/backport-changelog/6.6/6785.md index ad26227bf12565..4618c8684c12d8 100644 --- a/backport-changelog/6.6/6785.md +++ b/backport-changelog/6.6/6785.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6785 -* https://github.com/WordPress/gutenberg/pull/62459 +- https://github.com/WordPress/gutenberg/pull/62459 diff --git a/backport-changelog/6.6/6797.md b/backport-changelog/6.6/6797.md index 630b677655ddce..53ce3f42f2341a 100644 --- a/backport-changelog/6.6/6797.md +++ b/backport-changelog/6.6/6797.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6797 -* https://github.com/WordPress/gutenberg/pull/62526 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/62526 diff --git a/backport-changelog/6.6/6824.md b/backport-changelog/6.6/6824.md index 7dc6e090f01498..1583f1384cce0f 100644 --- a/backport-changelog/6.6/6824.md +++ b/backport-changelog/6.6/6824.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6824 -* https://github.com/WordPress/gutenberg/pull/62550 +- https://github.com/WordPress/gutenberg/pull/62550 diff --git a/backport-changelog/6.6/6825.md b/backport-changelog/6.6/6825.md index 73e5f46600d892..1d0bd9db95b9ce 100644 --- a/backport-changelog/6.6/6825.md +++ b/backport-changelog/6.6/6825.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6825 -* https://github.com/WordPress/gutenberg/pull/62552 +- https://github.com/WordPress/gutenberg/pull/62552 diff --git a/backport-changelog/6.6/6827.md b/backport-changelog/6.6/6827.md index bfe177c4cac0e5..6b7bc1c873cfc3 100644 --- a/backport-changelog/6.6/6827.md +++ b/backport-changelog/6.6/6827.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6827 -* https://github.com/WordPress/gutenberg/pull/62465 +- https://github.com/WordPress/gutenberg/pull/62465 diff --git a/backport-changelog/6.6/6837.md b/backport-changelog/6.6/6837.md index 2fffba68b53a10..4c177e0218e4b2 100644 --- a/backport-changelog/6.6/6837.md +++ b/backport-changelog/6.6/6837.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/6837 -* https://github.com/WordPress/gutenberg/pull/62529 -* https://github.com/WordPress/gutenberg/pull/62610 +- https://github.com/WordPress/gutenberg/pull/62529 +- https://github.com/WordPress/gutenberg/pull/62610 diff --git a/backport-changelog/6.6/6841.md b/backport-changelog/6.6/6841.md index 36e715c48f52e0..f17f7ee0d837bc 100644 --- a/backport-changelog/6.6/6841.md +++ b/backport-changelog/6.6/6841.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6841 -* https://github.com/WordPress/gutenberg/pull/62598 +- https://github.com/WordPress/gutenberg/pull/62598 diff --git a/backport-changelog/6.6/6844.md b/backport-changelog/6.6/6844.md index f735d96b9a051c..2fd631ed8dce07 100644 --- a/backport-changelog/6.6/6844.md +++ b/backport-changelog/6.6/6844.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6844 -* https://github.com/WordPress/gutenberg/pull/62640 +- https://github.com/WordPress/gutenberg/pull/62640 diff --git a/backport-changelog/6.6/6854.md b/backport-changelog/6.6/6854.md index 78003f24ca9e41..417a79a3ace541 100644 --- a/backport-changelog/6.6/6854.md +++ b/backport-changelog/6.6/6854.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6854 -* https://github.com/WordPress/gutenberg/pull/62670 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/62670 diff --git a/backport-changelog/6.6/6864.md b/backport-changelog/6.6/6864.md index 10bf9cce4d6576..c31f13e0e97d76 100644 --- a/backport-changelog/6.6/6864.md +++ b/backport-changelog/6.6/6864.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/6864 -* https://github.com/WordPress/gutenberg/pull/62488 -* https://github.com/WordPress/gutenberg/pull/62696 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/62488 +- https://github.com/WordPress/gutenberg/pull/62696 diff --git a/backport-changelog/6.6/6873.md b/backport-changelog/6.6/6873.md index 745966d0dc0407..023be330f1f432 100644 --- a/backport-changelog/6.6/6873.md +++ b/backport-changelog/6.6/6873.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6873 -* https://github.com/WordPress/gutenberg/pull/62712 +- https://github.com/WordPress/gutenberg/pull/62712 diff --git a/backport-changelog/6.6/6959.md b/backport-changelog/6.6/6959.md index 3232414bc22b11..0f661adc849df5 100644 --- a/backport-changelog/6.6/6959.md +++ b/backport-changelog/6.6/6959.md @@ -1,4 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6959 -* https://github.com/WordPress/gutenberg/pull/63071 - +- https://github.com/WordPress/gutenberg/pull/63071 diff --git a/backport-changelog/6.6/6987.md b/backport-changelog/6.6/6987.md index c3bf36f8f9933d..57bf72ebed3595 100644 --- a/backport-changelog/6.6/6987.md +++ b/backport-changelog/6.6/6987.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6987 -* https://github.com/WordPress/gutenberg/pull/63207 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/63207 diff --git a/backport-changelog/6.6/6989.md b/backport-changelog/6.6/6989.md index 3d236938ff74a5..15e512e2b43f8e 100644 --- a/backport-changelog/6.6/6989.md +++ b/backport-changelog/6.6/6989.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6989 -* https://github.com/WordPress/gutenberg/pull/63172 +- https://github.com/WordPress/gutenberg/pull/63172 diff --git a/backport-changelog/6.6/7012.md b/backport-changelog/6.6/7012.md index 265f3dad981e44..61fa5b4b9e3929 100644 --- a/backport-changelog/6.6/7012.md +++ b/backport-changelog/6.6/7012.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7012 -* https://github.com/WordPress/gutenberg/pull/63403 +- https://github.com/WordPress/gutenberg/pull/63403 diff --git a/backport-changelog/6.6/7036.md b/backport-changelog/6.6/7036.md index afc4d16bf011b7..3b195ae2695dc1 100644 --- a/backport-changelog/6.6/7036.md +++ b/backport-changelog/6.6/7036.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7036 -* https://github.com/WordPress/gutenberg/pull/63436 +- https://github.com/WordPress/gutenberg/pull/63436 diff --git a/backport-changelog/6.6/7061.md b/backport-changelog/6.6/7061.md index 307e6575cf38d8..dbba46b9ba1d86 100644 --- a/backport-changelog/6.6/7061.md +++ b/backport-changelog/6.6/7061.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7061 -* https://github.com/WordPress/gutenberg/pull/63726 +- https://github.com/WordPress/gutenberg/pull/63726 diff --git a/backport-changelog/6.6/7088.md b/backport-changelog/6.6/7088.md index 46bd1147464846..a69e69e1fd9f37 100644 --- a/backport-changelog/6.6/7088.md +++ b/backport-changelog/6.6/7088.md @@ -1,4 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7088 -* https://github.com/WordPress/gutenberg/pull/63918 - +- https://github.com/WordPress/gutenberg/pull/63918 diff --git a/backport-changelog/6.6/7097.md b/backport-changelog/6.6/7097.md index e674d5ea76ba6f..0f3fc62358c8b0 100644 --- a/backport-changelog/6.6/7097.md +++ b/backport-changelog/6.6/7097.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7097 -* https://github.com/WordPress/gutenberg/pull/63980 +- https://github.com/WordPress/gutenberg/pull/63980 diff --git a/backport-changelog/6.6/7145.md b/backport-changelog/6.6/7145.md index 386f765cb22fa8..632a99e71c3268 100644 --- a/backport-changelog/6.6/7145.md +++ b/backport-changelog/6.6/7145.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7145 -* https://github.com/WordPress/gutenberg/pull/64076 +- https://github.com/WordPress/gutenberg/pull/64076 diff --git a/backport-changelog/6.7/6668.md b/backport-changelog/6.7/6668.md index 7653dd8d8294ee..f5f272480acfd1 100644 --- a/backport-changelog/6.7/6668.md +++ b/backport-changelog/6.7/6668.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6668 -* https://github.com/WordPress/gutenberg/pull/62092 +- https://github.com/WordPress/gutenberg/pull/62092 diff --git a/backport-changelog/6.7/6750.md b/backport-changelog/6.7/6750.md index 257ebe3a5aa698..a98692e5098c19 100644 --- a/backport-changelog/6.7/6750.md +++ b/backport-changelog/6.7/6750.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6750 -* https://github.com/WordPress/gutenberg/pull/62357 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/62357 diff --git a/backport-changelog/6.7/6836.md b/backport-changelog/6.7/6836.md index feaa0f909f1f6f..d18a102bbcbdf5 100644 --- a/backport-changelog/6.7/6836.md +++ b/backport-changelog/6.7/6836.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6836 -* https://github.com/WordPress/gutenberg/pull/60100 +- https://github.com/WordPress/gutenberg/pull/60100 diff --git a/backport-changelog/6.7/6991.md b/backport-changelog/6.7/6991.md index 4d5f1f85ec7686..54b413b51869fe 100644 --- a/backport-changelog/6.7/6991.md +++ b/backport-changelog/6.7/6991.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/6991 -* https://github.com/WordPress/gutenberg/pull/61382 +- https://github.com/WordPress/gutenberg/pull/61382 diff --git a/backport-changelog/6.7/7020.md b/backport-changelog/6.7/7020.md index 8eacb220d340e5..3e913039a4d909 100644 --- a/backport-changelog/6.7/7020.md +++ b/backport-changelog/6.7/7020.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7020 -* https://github.com/WordPress/gutenberg/pull/63470 +- https://github.com/WordPress/gutenberg/pull/63470 diff --git a/backport-changelog/6.7/7125.md b/backport-changelog/6.7/7125.md index 341e0415cc61a2..89186b70c83986 100644 --- a/backport-changelog/6.7/7125.md +++ b/backport-changelog/6.7/7125.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/7125 -* https://github.com/WordPress/gutenberg/pull/61577 -* https://github.com/WordPress/gutenberg/pull/64610 +- https://github.com/WordPress/gutenberg/pull/61577 +- https://github.com/WordPress/gutenberg/pull/64610 diff --git a/backport-changelog/6.7/7137.md b/backport-changelog/6.7/7137.md index 00771b8bc6c21d..d7678546fc7735 100644 --- a/backport-changelog/6.7/7137.md +++ b/backport-changelog/6.7/7137.md @@ -1,5 +1,5 @@ https://github.com/WordPress/wordpress-develop/pull/7137 -* https://github.com/WordPress/gutenberg/pull/64128 -* https://github.com/WordPress/gutenberg/pull/64192 -* https://github.com/WordPress/gutenberg/pull/64328 +- https://github.com/WordPress/gutenberg/pull/64128 +- https://github.com/WordPress/gutenberg/pull/64192 +- https://github.com/WordPress/gutenberg/pull/64328 diff --git a/backport-changelog/6.7/7139.md b/backport-changelog/6.7/7139.md index b5b0090fbaa563..7b4231c2980511 100644 --- a/backport-changelog/6.7/7139.md +++ b/backport-changelog/6.7/7139.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/7139 -* https://github.com/WordPress/gutenberg/pull/64504 -* https://github.com/WordPress/gutenberg/pull/65280 +- https://github.com/WordPress/gutenberg/pull/64504 +- https://github.com/WordPress/gutenberg/pull/65280 diff --git a/backport-changelog/6.7/7179.md b/backport-changelog/6.7/7179.md index d777eace2cb05e..688b9b60382230 100644 --- a/backport-changelog/6.7/7179.md +++ b/backport-changelog/6.7/7179.md @@ -1,5 +1,5 @@ https://github.com/WordPress/wordpress-develop/pull/7179 -* https://github.com/WordPress/gutenberg/pull/64401 -* https://github.com/WordPress/gutenberg/pull/64459 -* https://github.com/WordPress/gutenberg/pull/64477 +- https://github.com/WordPress/gutenberg/pull/64401 +- https://github.com/WordPress/gutenberg/pull/64459 +- https://github.com/WordPress/gutenberg/pull/64477 diff --git a/backport-changelog/6.7/7200.md b/backport-changelog/6.7/7200.md index 520b3d6054cc18..a6f5c680c93f17 100644 --- a/backport-changelog/6.7/7200.md +++ b/backport-changelog/6.7/7200.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7200 -* https://github.com/WordPress/gutenberg/pull/64511 +- https://github.com/WordPress/gutenberg/pull/64511 diff --git a/backport-changelog/6.7/7247.md b/backport-changelog/6.7/7247.md index d0b1de25872344..d70c3444ddedca 100644 --- a/backport-changelog/6.7/7247.md +++ b/backport-changelog/6.7/7247.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7247 -* https://github.com/WordPress/gutenberg/pull/64790 +- https://github.com/WordPress/gutenberg/pull/64790 diff --git a/backport-changelog/6.7/7258.md b/backport-changelog/6.7/7258.md index 6714b13b70b8d2..ced0e671b5ee6d 100644 --- a/backport-changelog/6.7/7258.md +++ b/backport-changelog/6.7/7258.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7258 -* https://github.com/WordPress/gutenberg/pull/64570 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/64570 diff --git a/backport-changelog/6.7/7270.md b/backport-changelog/6.7/7270.md index 358b0d7c9a9674..501dc620840fe1 100644 --- a/backport-changelog/6.7/7270.md +++ b/backport-changelog/6.7/7270.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7270 -* https://github.com/WordPress/gutenberg/pull/64890 +- https://github.com/WordPress/gutenberg/pull/64890 diff --git a/backport-changelog/6.7/7298.md b/backport-changelog/6.7/7298.md index 4c01ef5d4f46e6..a21fd64fd83490 100644 --- a/backport-changelog/6.7/7298.md +++ b/backport-changelog/6.7/7298.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7298 -* https://github.com/WordPress/gutenberg/pull/65099 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/65099 diff --git a/backport-changelog/6.7/7314.md b/backport-changelog/6.7/7314.md index 7d75cdff0f9075..78036fbc8c1c91 100644 --- a/backport-changelog/6.7/7314.md +++ b/backport-changelog/6.7/7314.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7314 -* https://github.com/WordPress/gutenberg/pull/64167 +- https://github.com/WordPress/gutenberg/pull/64167 diff --git a/backport-changelog/6.7/7336.md b/backport-changelog/6.7/7336.md index 7cb2e26d7eeb95..1a7779a158dce4 100644 --- a/backport-changelog/6.7/7336.md +++ b/backport-changelog/6.7/7336.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7336 -* https://github.com/WordPress/gutenberg/pull/65071 +- https://github.com/WordPress/gutenberg/pull/65071 diff --git a/backport-changelog/6.7/7360.md b/backport-changelog/6.7/7360.md index b2fb8efd624b93..43b38132c4873e 100644 --- a/backport-changelog/6.7/7360.md +++ b/backport-changelog/6.7/7360.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7360 -* https://github.com/WordPress/gutenberg/pull/65460 +- https://github.com/WordPress/gutenberg/pull/65460 diff --git a/backport-changelog/6.7/7543.md b/backport-changelog/6.7/7543.md index 7dcb74354ac813..e9fd5ddeaabd3b 100644 --- a/backport-changelog/6.7/7543.md +++ b/backport-changelog/6.7/7543.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7543 -* https://github.com/WordPress/gutenberg/pull/65958 +- https://github.com/WordPress/gutenberg/pull/65958 diff --git a/backport-changelog/6.7/7552.md b/backport-changelog/6.7/7552.md index d304162b3cae67..aa99f928293394 100644 --- a/backport-changelog/6.7/7552.md +++ b/backport-changelog/6.7/7552.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7552 -* https://github.com/WordPress/gutenberg/pull/66058 +- https://github.com/WordPress/gutenberg/pull/66058 diff --git a/backport-changelog/6.7/7561.md b/backport-changelog/6.7/7561.md index 43fcffa41c02a5..252f0fc461d42d 100644 --- a/backport-changelog/6.7/7561.md +++ b/backport-changelog/6.7/7561.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7561 -* https://github.com/WordPress/gutenberg/pull/66084 +- https://github.com/WordPress/gutenberg/pull/66084 diff --git a/backport-changelog/6.7/7661.md b/backport-changelog/6.7/7661.md index 711d03595162ca..93e758db7a04fe 100644 --- a/backport-changelog/6.7/7661.md +++ b/backport-changelog/6.7/7661.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/7661 -* https://github.com/WordPress/gutenberg/pull/66468 -* https://github.com/WordPress/gutenberg/pull/66543 +- https://github.com/WordPress/gutenberg/pull/66468 +- https://github.com/WordPress/gutenberg/pull/66543 diff --git a/backport-changelog/6.7/7676.md b/backport-changelog/6.7/7676.md index 19d9dc59048457..a54ad8e1a0d4d6 100644 --- a/backport-changelog/6.7/7676.md +++ b/backport-changelog/6.7/7676.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7676 -* https://github.com/WordPress/gutenberg/pull/66359 +- https://github.com/WordPress/gutenberg/pull/66359 diff --git a/backport-changelog/6.8/6910.md b/backport-changelog/6.8/6910.md index 24b59bce87ee60..d77fc4ef966650 100644 --- a/backport-changelog/6.8/6910.md +++ b/backport-changelog/6.8/6910.md @@ -1,7 +1,7 @@ https://github.com/WordPress/wordpress-develop/pull/6910 -* https://github.com/WordPress/gutenberg/pull/59483 -* https://github.com/WordPress/gutenberg/pull/60652 -* https://github.com/WordPress/gutenberg/pull/62777 -* https://github.com/WordPress/gutenberg/pull/63108 -* https://github.com/WordPress/gutenberg/pull/63464 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/59483 +- https://github.com/WordPress/gutenberg/pull/60652 +- https://github.com/WordPress/gutenberg/pull/62777 +- https://github.com/WordPress/gutenberg/pull/63108 +- https://github.com/WordPress/gutenberg/pull/63464 diff --git a/backport-changelog/6.8/7069.md b/backport-changelog/6.8/7069.md index 3e734637ddbb2f..abf353eeec5252 100644 --- a/backport-changelog/6.8/7069.md +++ b/backport-changelog/6.8/7069.md @@ -1,6 +1,6 @@ https://github.com/WordPress/wordpress-develop/pull/7069 -* https://github.com/WordPress/gutenberg/pull/63401 -* https://github.com/WordPress/gutenberg/pull/66918 -* https://github.com/WordPress/gutenberg/pull/67018 -* https://github.com/WordPress/gutenberg/pull/67552 +- https://github.com/WordPress/gutenberg/pull/63401 +- https://github.com/WordPress/gutenberg/pull/66918 +- https://github.com/WordPress/gutenberg/pull/67018 +- https://github.com/WordPress/gutenberg/pull/67552 diff --git a/backport-changelog/6.8/7129.md b/backport-changelog/6.8/7129.md index 301f1abc45d0d7..a084c052346b2b 100644 --- a/backport-changelog/6.8/7129.md +++ b/backport-changelog/6.8/7129.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/7129 -* https://github.com/WordPress/gutenberg/pull/62304 -* https://github.com/WordPress/gutenberg/pull/67879 +- https://github.com/WordPress/gutenberg/pull/62304 +- https://github.com/WordPress/gutenberg/pull/67879 diff --git a/backport-changelog/6.8/7265.md b/backport-changelog/6.8/7265.md index 44ba36053aa0d9..e216aefcb9254a 100644 --- a/backport-changelog/6.8/7265.md +++ b/backport-changelog/6.8/7265.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/7265 -* https://github.com/WordPress/gutenberg/pull/66850 -* https://github.com/WordPress/gutenberg/pull/66947 +- https://github.com/WordPress/gutenberg/pull/66850 +- https://github.com/WordPress/gutenberg/pull/66947 diff --git a/backport-changelog/6.8/7488.md b/backport-changelog/6.8/7488.md index a588bef0e01796..42337004fe98f7 100644 --- a/backport-changelog/6.8/7488.md +++ b/backport-changelog/6.8/7488.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7488 -* https://github.com/WordPress/gutenberg/pull/60622 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/60622 diff --git a/backport-changelog/6.8/7498.md b/backport-changelog/6.8/7498.md index 6c903246166b64..2692f5a3d84fba 100644 --- a/backport-changelog/6.8/7498.md +++ b/backport-changelog/6.8/7498.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7498 -* https://github.com/WordPress/gutenberg/pull/60622 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/60622 diff --git a/backport-changelog/6.8/7575.md b/backport-changelog/6.8/7575.md index f1c6a84da1368e..217ef46f90fde5 100644 --- a/backport-changelog/6.8/7575.md +++ b/backport-changelog/6.8/7575.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7575 -* https://github.com/WordPress/gutenberg/pull/66154 +- https://github.com/WordPress/gutenberg/pull/66154 diff --git a/backport-changelog/6.8/7604.md b/backport-changelog/6.8/7604.md index 0ab47698103409..681cb678bd847b 100644 --- a/backport-changelog/6.8/7604.md +++ b/backport-changelog/6.8/7604.md @@ -1,5 +1,5 @@ https://github.com/WordPress/wordpress-develop/pull/7604 -* https://github.com/WordPress/gutenberg/pull/66285 -* https://github.com/WordPress/gutenberg/pull/66302 -* https://github.com/WordPress/gutenberg/pull/66306 +- https://github.com/WordPress/gutenberg/pull/66285 +- https://github.com/WordPress/gutenberg/pull/66302 +- https://github.com/WordPress/gutenberg/pull/66306 diff --git a/backport-changelog/6.8/7643.md b/backport-changelog/6.8/7643.md index f83aa411f9fff3..325424f6a555c8 100644 --- a/backport-changelog/6.8/7643.md +++ b/backport-changelog/6.8/7643.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/7643 -* https://github.com/WordPress/gutenberg/pull/66432 -* https://github.com/WordPress/gutenberg/pull/66556 +- https://github.com/WordPress/gutenberg/pull/66432 +- https://github.com/WordPress/gutenberg/pull/66556 diff --git a/backport-changelog/6.8/7681.md b/backport-changelog/6.8/7681.md index b8cffc70c68561..9faf056bd0a1af 100644 --- a/backport-changelog/6.8/7681.md +++ b/backport-changelog/6.8/7681.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7681 -* https://github.com/WordPress/gutenberg/pull/66541 +- https://github.com/WordPress/gutenberg/pull/66541 diff --git a/backport-changelog/6.8/7687.md b/backport-changelog/6.8/7687.md index 0b5af190964df1..a5881baac0699d 100644 --- a/backport-changelog/6.8/7687.md +++ b/backport-changelog/6.8/7687.md @@ -1,4 +1,4 @@ https://github.com/WordPress/wordpress-develop/pull/7687 -* https://github.com/WordPress/gutenberg/pull/66488 -* https://github.com/WordPress/gutenberg/pull/67497 +- https://github.com/WordPress/gutenberg/pull/66488 +- https://github.com/WordPress/gutenberg/pull/67497 diff --git a/backport-changelog/6.8/7695.md b/backport-changelog/6.8/7695.md index 08b780e2afb0d7..a6ee69820013ed 100644 --- a/backport-changelog/6.8/7695.md +++ b/backport-changelog/6.8/7695.md @@ -1,7 +1,7 @@ https://github.com/WordPress/wordpress-develop/pull/7695 -* https://github.com/WordPress/gutenberg/pull/66631 -* https://github.com/WordPress/gutenberg/pull/67465 -* https://github.com/WordPress/gutenberg/pull/66579 -* https://github.com/WordPress/gutenberg/pull/66654 -* https://github.com/WordPress/gutenberg/pull/67518 +- https://github.com/WordPress/gutenberg/pull/66631 +- https://github.com/WordPress/gutenberg/pull/67465 +- https://github.com/WordPress/gutenberg/pull/66579 +- https://github.com/WordPress/gutenberg/pull/66654 +- https://github.com/WordPress/gutenberg/pull/67518 diff --git a/backport-changelog/6.8/7697.md b/backport-changelog/6.8/7697.md index e53fbf4bdb8ae5..c4bc34699def07 100644 --- a/backport-changelog/6.8/7697.md +++ b/backport-changelog/6.8/7697.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7697 -* https://github.com/WordPress/gutenberg/pull/66656 +- https://github.com/WordPress/gutenberg/pull/66656 diff --git a/backport-changelog/6.8/7698.md b/backport-changelog/6.8/7698.md index 3ded160e7ec449..0c2957390b71a5 100644 --- a/backport-changelog/6.8/7698.md +++ b/backport-changelog/6.8/7698.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7698 -* https://github.com/WordPress/gutenberg/pull/66662 +- https://github.com/WordPress/gutenberg/pull/66662 diff --git a/backport-changelog/6.8/7759.md b/backport-changelog/6.8/7759.md index a0ad85b06e6b05..d22bf9fab7cd4a 100644 --- a/backport-changelog/6.8/7759.md +++ b/backport-changelog/6.8/7759.md @@ -1,4 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7759 -* https://github.com/WordPress/gutenberg/pull/66896 - +- https://github.com/WordPress/gutenberg/pull/66896 diff --git a/backport-changelog/6.8/7784.md b/backport-changelog/6.8/7784.md index b18dca88112a71..25c4b1c38647b4 100644 --- a/backport-changelog/6.8/7784.md +++ b/backport-changelog/6.8/7784.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7784 -* https://github.com/WordPress/gutenberg/pull/66948 +- https://github.com/WordPress/gutenberg/pull/66948 diff --git a/backport-changelog/6.8/7825.md b/backport-changelog/6.8/7825.md index 42d09c86b7f3ba..20243fd3d396ff 100644 --- a/backport-changelog/6.8/7825.md +++ b/backport-changelog/6.8/7825.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7825 -* https://github.com/WordPress/gutenberg/pull/67061 +- https://github.com/WordPress/gutenberg/pull/67061 diff --git a/backport-changelog/6.8/7848.md b/backport-changelog/6.8/7848.md index 84600eb4847cdb..06f12c3b2a2865 100644 --- a/backport-changelog/6.8/7848.md +++ b/backport-changelog/6.8/7848.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7848 -* https://github.com/WordPress/gutenberg/pull/67154 +- https://github.com/WordPress/gutenberg/pull/67154 diff --git a/backport-changelog/6.8/7865.md b/backport-changelog/6.8/7865.md index f7b23c944dc327..31f6fa32f02adc 100644 --- a/backport-changelog/6.8/7865.md +++ b/backport-changelog/6.8/7865.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7865 -* https://github.com/WordPress/gutenberg/pull/66851 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/66851 diff --git a/backport-changelog/6.8/7895.md b/backport-changelog/6.8/7895.md index 4750ab545ada3b..9be7cbe4e5c6e7 100644 --- a/backport-changelog/6.8/7895.md +++ b/backport-changelog/6.8/7895.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7895 -* https://github.com/WordPress/gutenberg/pull/66459 +- https://github.com/WordPress/gutenberg/pull/66459 diff --git a/backport-changelog/6.8/7898.md b/backport-changelog/6.8/7898.md index d824c5da82ec1b..8ad75fdd00bf2c 100644 --- a/backport-changelog/6.8/7898.md +++ b/backport-changelog/6.8/7898.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7898 -* https://github.com/WordPress/gutenberg/pull/67272 +- https://github.com/WordPress/gutenberg/pull/67272 diff --git a/backport-changelog/6.8/7903.md b/backport-changelog/6.8/7903.md index cb20d8d2dd2b1b..a2449244570ae1 100644 --- a/backport-changelog/6.8/7903.md +++ b/backport-changelog/6.8/7903.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7903 -* https://github.com/WordPress/gutenberg/pull/67199 +- https://github.com/WordPress/gutenberg/pull/67199 diff --git a/backport-changelog/6.8/7909.md b/backport-changelog/6.8/7909.md index 32a441ef296a2d..3dfbb04a79fb14 100644 --- a/backport-changelog/6.8/7909.md +++ b/backport-changelog/6.8/7909.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7909 -* https://github.com/WordPress/gutenberg/pull/67330 +- https://github.com/WordPress/gutenberg/pull/67330 diff --git a/backport-changelog/6.8/7976.md b/backport-changelog/6.8/7976.md index e2942d5e4fbe15..cc0ef6cd65acd4 100644 --- a/backport-changelog/6.8/7976.md +++ b/backport-changelog/6.8/7976.md @@ -1,3 +1,3 @@ https://github.com/WordPress/wordpress-develop/pull/7976 -* https://github.com/WordPress/gutenberg/pull/67716 \ No newline at end of file +- https://github.com/WordPress/gutenberg/pull/67716 diff --git a/backport-changelog/readme.md b/backport-changelog/readme.md index 8066cc6a6fca24..9cbb1227059df7 100644 --- a/backport-changelog/readme.md +++ b/backport-changelog/readme.md @@ -2,7 +2,7 @@ If you've changed or added files to the Gutenberg plugin, you'll need to confirm whether the changes are to be backported to [WordPress Core](https://github.com/WordPress/wordpress-develop), and therefore featured in the next release of WordPress. -On open Gutenberg PRs, changes to certain files are flagged as requiring backporting to WordPress Core, for example, PHP files in `/lib` and PHP unit tests. +On open Gutenberg PRs, changes to certain files are flagged as requiring backporting to WordPress Core, for example, PHP files in `/lib` and PHP unit tests. These changes must have a corresponding Core PR before they can be merged to Gutenberg trunk. @@ -28,17 +28,17 @@ A single Core PR may contain changes from one or multiple Gutenberg PRs. Let's say the next WordPress release is 6.9. You have two Gutenberg PRs — `1111` and `2222` — whose changes are backported in a single Core PR, number `1234`. -First you would create a file named `1234.md` in the `/6.9` folder. +First you would create a file named `1234.md` in the `/6.9` folder. -If the `/6.9` folder doesn't exist, create it. +If the `/6.9` folder doesn't exist, create it. Then you would add the following content to your new file: ```md https://github.com/WordPress/wordpress-develop/pull/1234 -* https://github.com/WordPress/gutenberg/pull/1111 -* https://github.com/WordPress/gutenberg/pull/2222 +- https://github.com/WordPress/gutenberg/pull/1111 +- https://github.com/WordPress/gutenberg/pull/2222 ``` If `1234.md` already exists, you would add the Gutenberg PRs to the list in the existing file. @@ -53,8 +53,8 @@ Some Gutenberg PRs may be flagged as needing a core backport PR when they don't, For individual PRs, there are two Github labels that can be used to exclude a PR from the backport changelog CI check: -- `Backport from WordPress Core` - Indicates that the PR is a backport from WordPress Core and doesn't need a Core PR. -- `No Core Sync Required` - Indicates that any changes do not need to be synced to WordPress Core. +- `Backport from WordPress Core` - Indicates that the PR is a backport from WordPress Core and doesn't need a Core PR. +- `No Core Sync Required` - Indicates that any changes do not need to be synced to WordPress Core. If there are specific file or directory changes that should **never** be flagged as requiring a Core backport PR, you can add it to the list of exceptions in [.github/workflows/check-backport-changelog.yml](https://github.com/WordPress/gutenberg/tree/trunk/.github/workflows/check-backport-changelog.yml). diff --git a/lib/README.md b/lib/README.md index 9ee05efccffe98..b7294aa501af68 100644 --- a/lib/README.md +++ b/lib/README.md @@ -12,9 +12,9 @@ The following documentation is intended to act as a guide only. If you're unsure To make it easier for contributors to identify features that should be merged into Core and those that can be deleted, Gutenberg uses the following file structure for its PHP code: -- `lib/experimental` - Experimental features that exist only in the plugin. They should not be merged into Core. -- `lib/compat/wordpress-X.Y` - Stable features that are intended to be merged into Core in a future `X.Y` release, or that were previously merged to Core in the `X.Y` release and remain in the plugin for backwards compatibility when running the plugin on older versions of WordPress. -- `lib/compat/plugin` - Features for backwards compatibility for the plugin consumers. These files don't need to be merged into Core and should have a timeline for when they should be removed from the plugin. +- `lib/experimental` - Experimental features that exist only in the plugin. They should not be merged into Core. +- `lib/compat/wordpress-X.Y` - Stable features that are intended to be merged into Core in a future `X.Y` release, or that were previously merged to Core in the `X.Y` release and remain in the plugin for backwards compatibility when running the plugin on older versions of WordPress. +- `lib/compat/plugin` - Features for backwards compatibility for the plugin consumers. These files don't need to be merged into Core and should have a timeline for when they should be removed from the plugin. Files at the root of `/lib` are generally considered to contain "evergreen" code. Such code is both fundamental to the proper functioning of the plugin, and also so often updated that versioning it between WordPress releases is not practical. Changes to these files are merged into Core as required. @@ -98,6 +98,7 @@ if ( ! class_exists( 'WP_A_Stable_Class' ) ) { Wrapping code in `class_exists()` and `function_exists()` is usually inappropriate for evergreen code, or any plugin code that we expect to undergo constant change between WordPress releases, because it would prevent the latest versions of the code from being used. For example, the statement `class_exists( 'WP_Theme_JSON' )` would return `true` because the class already exists in Core. The `return` operator is considered an anti-pattern in the context provided below because it [does not halt](https://www.php.net/manual/en/function.return.php#112515) the parsing of the PHP script and can cause [unexpected side effects](https://github.com/WordPress/gutenberg/pull/58429#issuecomment-1916670097): + ```php /** * ANTI-PATTERN diff --git a/lib/experimental/sync/README.md b/lib/experimental/sync/README.md index 83a105adddf7aa..08b476ef911226 100644 --- a/lib/experimental/sync/README.md +++ b/lib/experimental/sync/README.md @@ -8,21 +8,21 @@ Every client communicates with the server via `GET` or `POST`. Clients must have Available operations: -- Subscribe to topics -- Unsubscribe from topics -- Publish a message -- Read pending messages -- Ping the server +- Subscribe to topics +- Unsubscribe from topics +- Publish a message +- Read pending messages +- Ping the server ## Subscribe to topics To subscribe to a set of topics, a client must send a `POST` request with the following parameters: -- `subscriber_id`: Subscriber ID of the client. -- `action`: should be set to `gutenberg_signaling_server`. -- `message`: - - `type`: should be set to `subscribe`. - - `topics`: array of topics that the client is interested in reading messages from, e.g., `[ 'WordPress', 'Drupal' ]`. +- `subscriber_id`: Subscriber ID of the client. +- `action`: should be set to `gutenberg_signaling_server`. +- `message`: + - `type`: should be set to `subscribe`. + - `topics`: array of topics that the client is interested in reading messages from, e.g., `[ 'WordPress', 'Drupal' ]`. If the action is executed successfully by the server, the server will respond with `{"result":"ok"}`. @@ -41,18 +41,18 @@ await ( } ), method: 'POST', } ) - ).text(); +).text(); ``` ## Unsubscribe from topics To unsubscribe from a set of topics, a client must send a `POST` request with the following parameters: -- `subscriber_id`: subscriber ID of the client. -- `action`: should be set to `gutenberg_signaling_server`. -- `message`: - - `type`: should be set as `unsubscribe`. - - `topics`: an array of topics that the client is no longer interested in reading messages from, e.g., `['WordPress', 'Drupal']`. +- `subscriber_id`: subscriber ID of the client. +- `action`: should be set to `gutenberg_signaling_server`. +- `message`: + - `type`: should be set as `unsubscribe`. + - `topics`: an array of topics that the client is no longer interested in reading messages from, e.g., `['WordPress', 'Drupal']`. If the action is executed successfully by the server, the server will respond with `{"result":"ok"}`. @@ -71,19 +71,19 @@ await ( } ), method: 'POST', } ) - ).text(); +).text(); ``` ## Publish a message To publish a message in a specific topic, a client must send a `POST` request with the following parameters: -- `subscriber_id`: subscriber ID of the client. -- `action`: should be set to `gutenberg_signaling_server`. -- `message`: - - `type`: should be set as `publish`. - - `topic`: the topic where the message should be published, e.g., `WordPress`. - - `data`: The data to be broadcasted to every client that subscribed to the topic. The data can be any string and may be encrypted to prevent the server from reading the messages. +- `subscriber_id`: subscriber ID of the client. +- `action`: should be set to `gutenberg_signaling_server`. +- `message`: + - `type`: should be set as `publish`. + - `topic`: the topic where the message should be published, e.g., `WordPress`. + - `data`: The data to be broadcasted to every client that subscribed to the topic. The data can be any string and may be encrypted to prevent the server from reading the messages. If the action is executed successfully by the server, the server will respond with `{"result":"ok"}`. @@ -103,24 +103,24 @@ await ( } ), method: 'POST', } ) - ).text(); +).text(); ``` ## Read pending messages To read pending messages, the client should send a `GET` request with the following parameters: -- `subscriber_id`: Subscriber ID of the client. -- `action`: should be set to `gutenberg_signaling_server`. +- `subscriber_id`: Subscriber ID of the client. +- `action`: should be set to `gutenberg_signaling_server`. The server will respond using the [Event stream format](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#event_stream_format), whose content type is set to `text/event-stream;charset=UTF-8`. The Event stream format defines the following fields: -- `retry`: the reconnection time, in ms. The time after which the client should check again for messages. -- `id`: unique identifier for the server response. -- `event`: one of `message` or `error`. -- `data`: - - If `event` is `message`, data is a JSON encoded string containing an array of messages that the given client has not read yet. Each message is similar to the published message object but includes an additional property named `clients`. This property specifies the number of clients for which the message was sent. Note it does not indicate whether they have already received/requested it. - - If `event` is `error`, data is a description of the error. +- `retry`: the reconnection time, in ms. The time after which the client should check again for messages. +- `id`: unique identifier for the server response. +- `event`: one of `message` or `error`. +- `data`: + - If `event` is `message`, data is a JSON encoded string containing an array of messages that the given client has not read yet. Each message is similar to the published message object but includes an additional property named `clients`. This property specifies the number of clients for which the message was sent. Note it does not indicate whether they have already received/requested it. + - If `event` is `error`, data is a description of the error. If there are no pending messages, the server's response only contains the `retry:` field. If there are pending messages, the server will respond including all the fields. @@ -134,7 +134,7 @@ await ( action: 'gutenberg_signaling_server', } ) ) - ).text(); +).text(); ``` Sample answer from the server when there are no unread messages: @@ -158,10 +158,10 @@ To ensure that the server is listening and to indicate that a client is still al To send a ping, the client should send a `POST` request with the following parameters: -- `subscriber_id`: Subscriber ID of the client. -- `action`: should be set to `gutenberg_signaling_server`. -- `message`: - - `type`: Should be set as `ping`. +- `subscriber_id`: Subscriber ID of the client. +- `action`: should be set to `gutenberg_signaling_server`. +- `message`: + - `type`: Should be set as `ping`. If the action is executed successfully by the server, the server will respond with `{"result":"ok"}`. @@ -179,5 +179,5 @@ await ( } ), method: 'POST', } ) - ).text(); +).text(); ``` diff --git a/packages/api-fetch/README.md b/packages/api-fetch/README.md index 8c17e4ce8bbad6..826a319d79d5f6 100644 --- a/packages/api-fetch/README.md +++ b/packages/api-fetch/README.md @@ -15,6 +15,7 @@ _This package assumes that your code will run in an **ES2015+** environment. If ## Usage ### GET + ```js import apiFetch from '@wordpress/api-fetch'; @@ -24,18 +25,22 @@ apiFetch( { path: '/wp/v2/posts' } ).then( ( posts ) => { ``` ### GET with Query Args + ```js import apiFetch from '@wordpress/api-fetch'; import { addQueryArgs } from '@wordpress/url'; -const queryParams = { include: [1,2,3] }; // Return posts with ID = 1,2,3. +const queryParams = { include: [ 1, 2, 3 ] }; // Return posts with ID = 1,2,3. -apiFetch( { path: addQueryArgs( '/wp/v2/posts', queryParams ) } ).then( ( posts ) => { - console.log( posts ); -} ); +apiFetch( { path: addQueryArgs( '/wp/v2/posts', queryParams ) } ).then( + ( posts ) => { + console.log( posts ); + } +); ``` ### POST + ```js apiFetch( { path: '/wp/v2/posts/1', diff --git a/packages/block-editor/src/components/block-controls/README.md b/packages/block-editor/src/components/block-controls/README.md index 58daea482ef395..0944b007db5efb 100644 --- a/packages/block-editor/src/components/block-controls/README.md +++ b/packages/block-editor/src/components/block-controls/README.md @@ -61,29 +61,28 @@ The component accepts the following props: Group of the block controls. Allows you to create and render multiple groups of block controls. -- Type: `string` -- Default: `default` -- Required: No +- Type: `string` +- Default: `default` +- Required: No ### `controls` -Allows overriding the default `controls` if the `default` group is used. +Allows overriding the default `controls` if the `default` group is used. See [this custom block tutorial page](/docs/getting-started/fundamentals/block-in-the-editor.md) for more details and examples with block controls. -- Type: `array` +- Type: `array` ### `children` Additional control components to be rendered. -- Type: `Element` -- Required: No. - +- Type: `Element` +- Required: No. ### `__experimentalShareWithChildBlocks` Whether the additional block controls should be added to the block toolbars of child blocks. -- Type: `boolean` -- Default: `false` +- Type: `boolean` +- Default: `false` diff --git a/packages/block-editor/src/components/block-heading-level-dropdown/README.md b/packages/block-editor/src/components/block-heading-level-dropdown/README.md index b718bf6b25339d..d965adfce1689b 100644 --- a/packages/block-editor/src/components/block-heading-level-dropdown/README.md +++ b/packages/block-editor/src/components/block-heading-level-dropdown/README.md @@ -6,7 +6,6 @@ Uses ``. ## Usage ```jsx - import { BlockControls, HeadingLevelDropdown } from '@wordpress/block-editor'; const HEADING_LEVELS = [ 0, 1, 2, 3, 4, 5, 6 ]; @@ -16,9 +15,7 @@ const MyHeadingLevelToolbar = () => ( - setAttributes( { tag: newTag } ) - } + onChange={ ( newTag ) => setAttributes( { tag: newTag } ) } /> ); diff --git a/packages/block-editor/src/components/block-popover/README.md b/packages/block-editor/src/components/block-popover/README.md index c50e8c90647f69..3d49fdc5a76f61 100644 --- a/packages/block-editor/src/components/block-popover/README.md +++ b/packages/block-editor/src/components/block-popover/README.md @@ -26,9 +26,9 @@ The client ID of the block representing the bottom position of the popover. This determines whether the block popover always shifts into the viewport or remains at its original position. See FloatingUI for more details on shift. -- Type: `Boolean` -- Required: No -- Default: `true` +- Type: `Boolean` +- Required: No +- Default: `true` ## BlockPopoverInbetween - Private Component diff --git a/packages/block-editor/src/components/block-preview/README.md b/packages/block-editor/src/components/block-preview/README.md index 5cce2e45cb54ff..26c0cb275be678 100644 --- a/packages/block-editor/src/components/block-preview/README.md +++ b/packages/block-editor/src/components/block-preview/README.md @@ -45,9 +45,7 @@ should contain a `css` attribute. See `EditorStyles` for more info. ```jsx ``` diff --git a/packages/block-editor/src/components/block-title/README.md b/packages/block-editor/src/components/block-title/README.md index 20bb01d6ff39db..feb4d032c98e76 100644 --- a/packages/block-editor/src/components/block-title/README.md +++ b/packages/block-editor/src/components/block-title/README.md @@ -6,11 +6,13 @@ It prioritizes contextual titles such as block variation and reusable block labe The component will be empty if a title cannot be determined. - ## Usage ```jsx - + ``` ### Props diff --git a/packages/block-editor/src/components/block-variation-picker/README.md b/packages/block-editor/src/components/block-variation-picker/README.md index 891cd21b1f50c2..cefcfba801c83d 100644 --- a/packages/block-editor/src/components/block-variation-picker/README.md +++ b/packages/block-editor/src/components/block-variation-picker/README.md @@ -18,9 +18,7 @@ Renders the variations of a block. ```jsx import { useSelect } from '@wordpress/data'; -import { - __experimentalBlockVariationPicker as BlockVariationPicker -} from '@wordpress/block-editor'; +import { __experimentalBlockVariationPicker as BlockVariationPicker } from '@wordpress/block-editor'; import { store as blocksStore } from '@wordpress/blocks'; const MyBlockVariationPicker = ( { blockName } ) => { diff --git a/packages/block-editor/src/components/caption/README.md b/packages/block-editor/src/components/caption/README.md index c8cf4ebe8701dd..b500209edeef0d 100644 --- a/packages/block-editor/src/components/caption/README.md +++ b/packages/block-editor/src/components/caption/README.md @@ -21,7 +21,7 @@ const BlockCaption = ( { text, insertBlocksAfter, } ) => ( - + { /// ... - +; ``` ## Props @@ -48,16 +48,16 @@ The component accepts the following props: A function that receives the new font family value. If onChange is called without any parameter, it should reset the value, attending to what reset means in that context, e.g., set the font family to undefined or set the font family a starting value. -- Type: `function` -- Required: Yes +- Type: `function` +- Required: Yes ### fontFamilies A user-provided set of font families. Optional, used in case we want to override the predefined ones coming from presets. -- Type: `Array` -- Required: No +- Type: `Array` +- Required: No The font families are provided as an array of objects with the following schema: @@ -70,24 +70,24 @@ The font families are provided as an array of objects with the following schema: The current font family value. -- Type: `String` -- Required: No -- Default: '' +- Type: `String` +- Required: No +- Default: '' The rest of the props are passed down to the underlying `` instance. #### `__next40pxDefaultSize` -- Type: `boolean` -- Required: No -- Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` Start opting into the larger default height that will become the default size in a future version. #### `__nextHasNoMarginBottom` -- Type: `boolean` -- Required: No -- Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` Start opting into the new margin-free styles that will become the default in a future version. diff --git a/packages/block-editor/src/components/font-sizes/README.md b/packages/block-editor/src/components/font-sizes/README.md index 69354b90f2a351..b47cceb49bbb7c 100644 --- a/packages/block-editor/src/components/font-sizes/README.md +++ b/packages/block-editor/src/components/font-sizes/README.md @@ -6,7 +6,6 @@ There is an equivalent component exposed under @wordpress/components. The differ ## Usage - ```jsx import { FontSizePicker } from '@wordpress/block-editor'; import { useState } from '@wordpress/element'; @@ -49,33 +48,32 @@ const MyFontSizePicker = () => { The component accepts the following props: - ### fallbackFontSize If no value exists, this prop defines the starting position for the font size picker slider. Only relevant if `withSlider` is `true`. -- Type: `Number` -- Required: No +- Type: `Number` +- Required: No ### onChange A function that receives the new font size value. If onChange is called without any parameter, it should reset the value, attending to what reset means in that context, e.g., set the font size to undefined or set the font size a starting value. -- Type: `function` -- Required: Yes +- Type: `function` +- Required: Yes ### value The current font size value. -- Type: `Number` -- Required: No +- Type: `Number` +- Required: No ### withSlider If `true`, the UI will contain a slider, instead of a numeric text input field. If `false`, no slider will be present. -- Type: `Boolean` -- Required: no -- Default: `false` +- Type: `Boolean` +- Required: no +- Default: `false` diff --git a/packages/block-editor/src/components/global-styles/README.md b/packages/block-editor/src/components/global-styles/README.md index 2ddb23cd01f704..0991499613ba96 100644 --- a/packages/block-editor/src/components/global-styles/README.md +++ b/packages/block-editor/src/components/global-styles/README.md @@ -179,6 +179,7 @@ The global styles folder also offers a set of reusable UI components. These comp } } ``` + - `defaultControls`: The default controls are the controls that are used by default to render the UI. They are used to provide the UI components with the necessary information to render the UI. An example value for the default controls for the `ColorPanel` component is: ```js diff --git a/packages/block-editor/src/components/image-size-control/README.md b/packages/block-editor/src/components/image-size-control/README.md index 17e3b1ea85928a..bddbfc8c6e3ab0 100644 --- a/packages/block-editor/src/components/image-size-control/README.md +++ b/packages/block-editor/src/components/image-size-control/README.md @@ -25,7 +25,7 @@ const MyImageSizeControl = () => { imageHeight={ imageHeight } /> ); -} +}; ``` ## Props diff --git a/packages/block-editor/src/components/inner-blocks/README.md b/packages/block-editor/src/components/inner-blocks/README.md index 92d4fdb5739cec..ff8da32c0cadd5 100644 --- a/packages/block-editor/src/components/inner-blocks/README.md +++ b/packages/block-editor/src/components/inner-blocks/README.md @@ -188,8 +188,8 @@ For example, a button block, deeply nested in several levels of block `X` that u ### `defaultBlock` -- **Type:** `Object` -- **Default:** - `undefined` +- **Type:** `Object` +- **Default:** - `undefined` Determines which block type should be inserted by default and any attributes that should be set by default when the block is inserted. Takes an object in the form of `{ name: blockname, attributes: {blockAttributes} }`. @@ -204,5 +204,5 @@ const DEFAULT_BLOCK = { name: 'core/paragraph', attributes: { content: 'Lorem ip ### `directInsert` -- **Type:** `Boolean` -- **Default:** - `undefined`. Determines whether the default block should be inserted directly into the InnerBlocks area by the block appender. +- **Type:** `Boolean` +- **Default:** - `undefined`. Determines whether the default block should be inserted directly into the InnerBlocks area by the block appender. diff --git a/packages/block-editor/src/components/inspector-popover-header/README.md b/packages/block-editor/src/components/inspector-popover-header/README.md index 697bbed72d973e..e6859eb23c018e 100644 --- a/packages/block-editor/src/components/inspector-popover-header/README.md +++ b/packages/block-editor/src/components/inspector-popover-header/README.md @@ -12,10 +12,7 @@ const MyPostDatePopover = () => { return ( ( - ) } @@ -45,32 +42,32 @@ const MyPostDatePopover = () => { Title to display in the header. -- Type: `String` -- Required: Yes +- Type: `String` +- Required: Yes ### actions Array of actions to display in the header as a row of buttons. Each item in the array must be an object and contains: -- `label`: String. Required. The action button's label. -- `icon`: Element. Optional. If specified, an icon button will be shown. -- `onClick`: Function. Optional. Called when the action button is clicked. +- `label`: String. Required. The action button's label. +- `icon`: Element. Optional. If specified, an icon button will be shown. +- `onClick`: Function. Optional. Called when the action button is clicked. -- Type: `Array` -- Required: No +- Type: `Array` +- Required: No ### onClose Called when the user presses the close button. If not provided, no close button will appear. -- Type: `Function` -- Required: No +- Type: `Function` +- Required: No ## help Help text to display at the bottom of the header. -- Type: `String` -- Required: No +- Type: `String` +- Required: No diff --git a/packages/block-editor/src/components/letter-spacing-control/README.md b/packages/block-editor/src/components/letter-spacing-control/README.md index 535ca2ae8cbbff..b3d6b4ea8de725 100644 --- a/packages/block-editor/src/components/letter-spacing-control/README.md +++ b/packages/block-editor/src/components/letter-spacing-control/README.md @@ -2,7 +2,7 @@ The `LetterSpacingControl` component renders a [`UnitControl`](https://github.com/WordPress/gutenberg/blob/trunk/packages/block-editor/src/components/unit-control/README.md) that lets the user enter a numeric value and select a unit, for example px or rem. -This component is used for blocks that display text, commonly inside a +This component is used for blocks that display text, commonly inside a [`ToolsPanelItem`](https://github.com/WordPress/gutenberg/blob/trunk/packages/components/src/tools-panel/tools-panel-item/README.md). ## Development guidelines @@ -48,8 +48,8 @@ Input width to pass through to inner UnitControl. Should be a valid CSS value. #### `__next40pxDefaultSize` -- **Type:** `boolean` -- **Default:** `false` +- **Type:** `boolean` +- **Default:** `false` Start opting into the larger default height that will become the default size in a future version. diff --git a/packages/block-editor/src/components/line-height-control/README.md b/packages/block-editor/src/components/line-height-control/README.md index 2f719b5a7210e6..15bd4607692d5c 100644 --- a/packages/block-editor/src/components/line-height-control/README.md +++ b/packages/block-editor/src/components/line-height-control/README.md @@ -39,8 +39,8 @@ A callback function that handles the application of the line height value. #### `__next40pxDefaultSize` -- **Type:** `boolean` -- **Default:** `false` +- **Type:** `boolean` +- **Default:** `false` Start opting into the larger default height that will become the default size in a future version. diff --git a/packages/block-editor/src/components/media-placeholder/README.md b/packages/block-editor/src/components/media-placeholder/README.md index 68fcf150c4edc4..915f2d806bcb13 100644 --- a/packages/block-editor/src/components/media-placeholder/README.md +++ b/packages/block-editor/src/components/media-placeholder/README.md @@ -66,10 +66,10 @@ This property is similar to the `accept` property. The difference is the format If true, the MediaUpload component auto-opens the picker of the respective platform. -- Type: `Boolean` -- Required: No -- Default: `false` -- Platform: Mobile +- Type: `Boolean` +- Required: No +- Default: `false` +- Platform: Mobile ### className diff --git a/packages/block-editor/src/components/media-upload/README.md b/packages/block-editor/src/components/media-upload/README.md index 27bbc93d8a2b65..ddf7149c7c73fc 100644 --- a/packages/block-editor/src/components/media-upload/README.md +++ b/packages/block-editor/src/components/media-upload/README.md @@ -143,10 +143,10 @@ Only applies if `gallery === true`. If true, the picker of the respective platform auto-opens. -- Type: `Boolean` -- Required: No -- Default: `false` -- Platform: Mobile +- Type: `Boolean` +- Required: No +- Default: `false` +- Platform: Mobile ### gallery diff --git a/packages/block-editor/src/components/navigable-toolbar/README.md b/packages/block-editor/src/components/navigable-toolbar/README.md index 317be48f38faa2..09f10a95a44cfd 100644 --- a/packages/block-editor/src/components/navigable-toolbar/README.md +++ b/packages/block-editor/src/components/navigable-toolbar/README.md @@ -12,7 +12,6 @@ _Note: this prop is deprecated._ Whether to immediately focus when the component mounts. -- Type: `Boolean` -- Required: No -- Default: false - +- Type: `Boolean` +- Required: No +- Default: false diff --git a/packages/block-editor/src/components/panel-color-settings/README.md b/packages/block-editor/src/components/panel-color-settings/README.md index e9f3818fab55c3..e05454b417afd8 100644 --- a/packages/block-editor/src/components/panel-color-settings/README.md +++ b/packages/block-editor/src/components/panel-color-settings/README.md @@ -74,8 +74,8 @@ The component accepts the following props: A user-provided set of color settings. -- Type: `Array` -- Required: No +- Type: `Array` +- Required: No Colors settings are provided as an array of objects with the following schema: @@ -87,16 +87,16 @@ Colors settings are provided as an array of objects with the following schema: Additionally, the following `PanelColorGradientSettings` props are supported and directly passed down to the underlying `PanelColorGradientSettings` instance: -- `className` - added to the underlying `ToolsPanel` instance. -- `colors` - array of colors to be used. -- `gradients` - not recommended to be used since `PanelColorSettings` resets it. -- `disableCustomColors` - whether addition of custom colors is enabled -- `disableCustomGradients` - not recommended to be used since `PanelColorSettings` sets it. -- `children` - displayed below the underlying `PanelColorGradientSettings` instance. -- `settings` - not recommended to be used, since `PanelColorSettings` builds it from the `colorSettings` prop. -- `title` - title of the underlying `ToolsPanel`. -- `showTitle` - whether to show the title of the `ToolsPanel`. -- `__experimentalIsRenderedInSidebar` -- `enableAlpha` - whether to enable setting opacity when specifying a color. +- `className` - added to the underlying `ToolsPanel` instance. +- `colors` - array of colors to be used. +- `gradients` - not recommended to be used since `PanelColorSettings` resets it. +- `disableCustomColors` - whether addition of custom colors is enabled +- `disableCustomGradients` - not recommended to be used since `PanelColorSettings` sets it. +- `children` - displayed below the underlying `PanelColorGradientSettings` instance. +- `settings` - not recommended to be used, since `PanelColorSettings` builds it from the `colorSettings` prop. +- `title` - title of the underlying `ToolsPanel`. +- `showTitle` - whether to show the title of the `ToolsPanel`. +- `__experimentalIsRenderedInSidebar` +- `enableAlpha` - whether to enable setting opacity when specifying a color. Please refer to the `PanelColorGradientSettings` component for more information. diff --git a/packages/block-editor/src/components/plain-text/README.md b/packages/block-editor/src/components/plain-text/README.md index aa15758118afdc..4a21ab287841c1 100644 --- a/packages/block-editor/src/components/plain-text/README.md +++ b/packages/block-editor/src/components/plain-text/README.md @@ -44,4 +44,3 @@ registerBlockType( /* ... */, { }, } ); ``` - diff --git a/packages/block-editor/src/components/publish-date-time-picker/README.md b/packages/block-editor/src/components/publish-date-time-picker/README.md index a7d92250c7cb0f..132c36bd82944f 100644 --- a/packages/block-editor/src/components/publish-date-time-picker/README.md +++ b/packages/block-editor/src/components/publish-date-time-picker/README.md @@ -20,10 +20,7 @@ const MyDateTimePicker = () => { return ( ( - ) } @@ -48,5 +45,5 @@ const MyDateTimePicker = () => { Called when the user presses the close button. -- Type: `Function` -- Required: No +- Type: `Function` +- Required: No diff --git a/packages/block-editor/src/components/recursion-provider/README.md b/packages/block-editor/src/components/recursion-provider/README.md index 37af15d75c1914..81dbc7e7b68aaa 100644 --- a/packages/block-editor/src/components/recursion-provider/README.md +++ b/packages/block-editor/src/components/recursion-provider/README.md @@ -1,8 +1,8 @@ # RecursionProvider -According to Gutenberg's block rendering architecture, any block type capable of recursion should be responsible for handling its own infinite loops. +According to Gutenberg's block rendering architecture, any block type capable of recursion should be responsible for handling its own infinite loops. -To help with detecting infinite loops on the client, the `RecursionProvider` component and the `useHasRecursion()` hook are used to identify if a block has already been rendered. +To help with detecting infinite loops on the client, the `RecursionProvider` component and the `useHasRecursion()` hook are used to identify if a block has already been rendered. ## Usage @@ -54,23 +54,23 @@ The component accepts the following props: Any value that acts as a unique identifier for a block instance. -- Type: `any` -- Required: Yes +- Type: `any` +- Required: Yes ### children Components to be rendered as content. -- Type: `Element` -- Required: Yes. +- Type: `Element` +- Required: Yes. ### blockName Optional block name. -- Type: `String` -- Required: No -- Default: '' +- Type: `String` +- Required: No +- Default: '' # `useHasRecursion()` @@ -88,14 +88,13 @@ The component accepts the following props: Any value that acts as a unique identifier for a block instance. -- Type: `any` -- Required: Yes +- Type: `any` +- Required: Yes ### blockName Optional block name. -- Type: `String` -- Required: No -- Default: '' - +- Type: `String` +- Required: No +- Default: '' diff --git a/packages/block-editor/src/components/rich-text/README.md b/packages/block-editor/src/components/rich-text/README.md index 11ea1c75204dd7..358a0dfe59cc63 100644 --- a/packages/block-editor/src/components/rich-text/README.md +++ b/packages/block-editor/src/components/rich-text/README.md @@ -27,7 +27,7 @@ _Optional._ Placeholder text to show when the field is empty, similar to the ### `disableLineBreaks: Boolean` -_Optional._ Disables inserting line breaks on `Enter` when it is set to `true` +_Optional._ Disables inserting line breaks on `Enter` when it is set to `true` ### `onReplace( blocks: Array ): Function` @@ -113,14 +113,12 @@ registerBlockType( /* ... */, { } ); ``` - ## RichTextToolbarButton Slot to extend the format toolbar. Use it in the edit function of a `registerFormatType` call to surface the format to the UI. ### Example - ```js import { registerFormatType } from '@wordpress/rich-text'; import { RichTextToolbarButton } from '@wordpress/block-editor'; diff --git a/packages/block-editor/src/components/text-decoration-control/README.md b/packages/block-editor/src/components/text-decoration-control/README.md index a606140baa330e..57ecc78fe83d6d 100644 --- a/packages/block-editor/src/components/text-decoration-control/README.md +++ b/packages/block-editor/src/components/text-decoration-control/README.md @@ -7,7 +7,6 @@ This feature is still experimental. “Experimental” means this is an early im ![TextDecorationControl Element in Inspector Control](https://raw.githubusercontent.com/WordPress/gutenberg/HEAD/docs/assets/text-decoration-component.png?raw=true) - ## Usage ```jsx @@ -18,8 +17,8 @@ Then, you can use the component in your block editor UI: ```jsx setAttributes({ textDecoration: newValue })} + value={ textDecorationValue } + onChange={ ( newValue ) => setAttributes( { textDecoration: newValue } ) } /> ``` @@ -37,4 +36,4 @@ The current value of the Text Decoration setting. You may only choose from the ` - **Type:** `Function` -A callback function invoked when the Text Decoration value is changed via an interaction with any of the buttons. Called with the Text Decoration value (`none`, `underline`, `line-through`) as the only argument. \ No newline at end of file +A callback function invoked when the Text Decoration value is changed via an interaction with any of the buttons. Called with the Text Decoration value (`none`, `underline`, `line-through`) as the only argument. diff --git a/packages/block-editor/src/components/text-transform-control/README.md b/packages/block-editor/src/components/text-transform-control/README.md index 2d40cc16ba86f8..00bdc69c1ff2c9 100644 --- a/packages/block-editor/src/components/text-transform-control/README.md +++ b/packages/block-editor/src/components/text-transform-control/README.md @@ -1,7 +1,7 @@ # TextTransformControl The `TextTransformControl` component is responsible for rendering a control element that allows users to select and apply text transformation options to blocks or elements in the Gutenberg editor. It provides an intuitive interface for changing the text appearance by applying different transformations such as `none`, `uppercase`, `lowercase`, `capitalize`. - + ![TextTransformConrol Element in Inspector Control](https://raw.githubusercontent.com/WordPress/gutenberg/HEAD/docs/assets/text-transform-component.png?raw=true) ## Development guidelines @@ -37,4 +37,4 @@ The current value of the Text Transform setting. You may only choose from the `O - **Type:** `Function` -A callback function invoked when the Text Transform value is changed via an interaction with any of the buttons. Called with the Text Transform value (`none`, `uppercase`, `lowercase`, `capitalize`) as the only argument. \ No newline at end of file +A callback function invoked when the Text Transform value is changed via an interaction with any of the buttons. Called with the Text Transform value (`none`, `uppercase`, `lowercase`, `capitalize`) as the only argument. diff --git a/packages/block-editor/src/components/url-input/README.md b/packages/block-editor/src/components/url-input/README.md index 714f7f062990f6..39bbe60a86772c 100644 --- a/packages/block-editor/src/components/url-input/README.md +++ b/packages/block-editor/src/components/url-input/README.md @@ -36,7 +36,6 @@ This prop is passed directly to the `URLInput` component. ## Example - ```js import { registerBlockType } from '@wordpress/blocks'; import { URLInputButton } from '@wordpress/block-editor'; @@ -68,7 +67,6 @@ registerBlockType( /* ... */, { } ); ``` - # `URLInput` Renders the URL input field used by the `URLInputButton` component. It can be used directly to display the input field in different ways such as in a `Popover` or inline. @@ -132,7 +130,6 @@ This prop allows the suggestions list to be programmatically not rendered by pas ## Example - ```js import { registerBlockType } from '@wordpress/blocks'; import { URLInput } from '@wordpress/block-editor'; diff --git a/packages/block-editor/src/components/writing-flow/readme.md b/packages/block-editor/src/components/writing-flow/readme.md index eb8c720ca12e78..e1fcc458918ed7 100644 --- a/packages/block-editor/src/components/writing-flow/readme.md +++ b/packages/block-editor/src/components/writing-flow/readme.md @@ -8,11 +8,11 @@ Selecting across blocks is possible by temporarily setting the `contentEditable` attribute to `true`. This sounds scary, but we prevent all default behaviours except for selection, so don't worry. :) -* For selection by mouse, we make everything editable when the mouse leaves an - editable field. -* For Shift+Click selection, we do it on `mousedown`. -* For keyboard selection we do it when the selection reaches the edge of an - editable field. +- For selection by mouse, we make everything editable when the mouse leaves an + editable field. +- For Shift+Click selection, we do it on `mousedown`. +- For keyboard selection we do it when the selection reaches the edge of an + editable field. In the future, we should consider using the `contentEditable` attribute for arrow key navigation as well. diff --git a/packages/blocks/CHANGELOG.md b/packages/blocks/CHANGELOG.md index 2e5aac914e5784..324cb6c7c73f57 100644 --- a/packages/blocks/CHANGELOG.md +++ b/packages/blocks/CHANGELOG.md @@ -12,7 +12,7 @@ ### Breaking changes -- Normalize `blockType.parent` to be an array. While string values were never supported, they appeared to work with some unintended side-effects that have been fixed by [#66250](https://github.com/WordPress/gutenberg/pull/66250). For that reason, we've added some code that automatically migrates strings to arrays — though it still raises a warning. +- Normalize `blockType.parent` to be an array. While string values were never supported, they appeared to work with some unintended side-effects that have been fixed by [#66250](https://github.com/WordPress/gutenberg/pull/66250). For that reason, we've added some code that automatically migrates strings to arrays — though it still raises a warning. ## 13.10.0 (2024-10-16) diff --git a/packages/components/src/alignment-matrix-control/README.md b/packages/components/src/alignment-matrix-control/README.md index af97e3ae0607cd..aa6d59dc3a3ed3 100644 --- a/packages/components/src/alignment-matrix-control/README.md +++ b/packages/components/src/alignment-matrix-control/README.md @@ -14,53 +14,51 @@ const Example = () => { const [ alignment, setAlignment ] = useState( 'center center' ); return ( - + ); }; ``` + ## Props ### `defaultValue` If provided, sets the default alignment value. - - Type: `"center" | "top left" | "top center" | "top right" | "center left" | "center center" | "center right" | "bottom left" | "bottom center" | "bottom right"` - - Required: No - - Default: `'center center'` +- Type: `"center" | "top left" | "top center" | "top right" | "center left" | "center center" | "center right" | "bottom left" | "bottom center" | "bottom right"` +- Required: No +- Default: `'center center'` ### `label` Accessible label. If provided, sets the `aria-label` attribute of the underlying `grid` widget. - - Type: `string` - - Required: No - - Default: `'Alignment Matrix Control'` +- Type: `string` +- Required: No +- Default: `'Alignment Matrix Control'` ### `onChange` A function that receives the updated alignment value. - - Type: `(newValue: AlignmentMatrixControlValue) => void` - - Required: No +- Type: `(newValue: AlignmentMatrixControlValue) => void` +- Required: No ### `value` The current alignment value. - - Type: `"center" | "top left" | "top center" | "top right" | "center left" | "center center" | "center right" | "bottom left" | "bottom center" | "bottom right"` - - Required: No +- Type: `"center" | "top left" | "top center" | "top right" | "center left" | "center center" | "center right" | "bottom left" | "bottom center" | "bottom right"` +- Required: No ### `width` If provided, sets the width of the control. - - Type: `number` - - Required: No - - Default: `92` +- Type: `number` +- Required: No +- Default: `92` ## Subcomponents @@ -72,14 +70,14 @@ If provided, sets the width of the control. If `true`, disables pointer events on the icon. - - Type: `boolean` - - Required: No - - Default: `true` +- Type: `boolean` +- Required: No +- Default: `true` ##### `value` The current alignment value. - - Type: `"center" | "top left" | "top center" | "top right" | "center left" | "center center" | "center right" | "bottom left" | "bottom center" | "bottom right"` - - Required: No - - Default: `center` +- Type: `"center" | "top left" | "top center" | "top right" | "center left" | "center center" | "center right" | "bottom left" | "bottom center" | "bottom right"` +- Required: No +- Default: `center` diff --git a/packages/components/src/angle-picker-control/README.md b/packages/components/src/angle-picker-control/README.md index d9389c6564338f..1254c0909648a7 100644 --- a/packages/components/src/angle-picker-control/README.md +++ b/packages/components/src/angle-picker-control/README.md @@ -23,34 +23,35 @@ function Example() { ); } ``` + ## Props ### `as` The HTML element or React component to render the component as. - - Type: `"symbol" | "object" | "a" | "abbr" | "address" | "area" | "article" | "aside" | "audio" | "b" | ...` - - Required: No +- Type: `"symbol" | "object" | "a" | "abbr" | "address" | "area" | "article" | "aside" | "audio" | "b" | ...` +- Required: No ### `label` Label to use for the angle picker. - - Type: `string` - - Required: No - - Default: `__( 'Angle' )` +- Type: `string` +- Required: No +- Default: `__( 'Angle' )` ### `onChange` A function that receives the new value of the input. - - Type: `(value: number) => void` - - Required: Yes +- Type: `(value: number) => void` +- Required: Yes ### `value` The current value of the input. The value represents an angle in degrees and should be a value between 0 and 360. - - Type: `string | number` - - Required: Yes +- Type: `string | number` +- Required: Yes diff --git a/packages/components/src/autocomplete/README.md b/packages/components/src/autocomplete/README.md index e2bc93fc476e00..3e2204ce7e6b17 100644 --- a/packages/components/src/autocomplete/README.md +++ b/packages/components/src/autocomplete/README.md @@ -52,8 +52,8 @@ A function that returns nodes to be rendered within the Autocomplete. Whether or not the Autocomplete component is selected, and if its `Popover` should be displayed. -- Required: Yes -- Type: `Boolean` +- Required: Yes +- Type: `Boolean` ## Autocompleters @@ -157,6 +157,7 @@ The `Autocomplete` component is not currently intended to be used as a standalon The block editor provides a separate, wrapped version of `Autocomplete` that supports the addition of custom completers via a filter. To implement your own completer in the block editor you will: + 1. Define the completer 2. Write a callback that will add your completer to the list of existing completers 3. Add a filter to the `editor.Autocomplete.completers` hook that will call your callback diff --git a/packages/components/src/badge/README.md b/packages/components/src/badge/README.md index 0be531ca6f2df8..6cc3a8898b573d 100644 --- a/packages/components/src/badge/README.md +++ b/packages/components/src/badge/README.md @@ -10,13 +10,13 @@ Text to display inside the badge. - - Type: `string` - - Required: Yes +- Type: `string` +- Required: Yes ### `intent` Badge variant. - - Type: `"default" | "info" | "success" | "warning" | "error"` - - Required: No - - Default: `default` +- Type: `"default" | "info" | "success" | "warning" | "error"` +- Required: No +- Default: `default` diff --git a/packages/components/src/base-control/README.md b/packages/components/src/base-control/README.md index 839464b41260b5..2590911d49e03d 100644 --- a/packages/components/src/base-control/README.md +++ b/packages/components/src/base-control/README.md @@ -25,35 +25,35 @@ const MyCustomTextareaControl = ({ children, ...baseProps }) => ( ); ); ``` + ## Props ### `__nextHasNoMarginBottom` Start opting into the new margin-free styles that will become the default in a future version. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `as` The HTML element or React component to render the component as. - - Type: `"symbol" | "object" | "label" | "a" | "abbr" | "address" | "area" | "article" | "aside" | "audio" | "b" | "base" | "bdi" | "bdo" | "big" | "blockquote" | "body" | "br" | "button" | ... 516 more ... | ("view" & FunctionComponent<...>)` - - Required: No +- Type: `"symbol" | "object" | "label" | "a" | "abbr" | "address" | "area" | "article" | "aside" | "audio" | "b" | "base" | "bdi" | "bdo" | "big" | "blockquote" | "body" | "br" | "button" | ... 516 more ... | ("view" & FunctionComponent<...>)` +- Required: No ### `className` - - - Type: `string` - - Required: No +- Type: `string` +- Required: No ### `children` The content to be displayed within the `BaseControl`. - - Type: `ReactNode` - - Required: Yes +- Type: `ReactNode` +- Required: Yes ### `help` @@ -61,16 +61,16 @@ Additional description for the control. Only use for meaningful description or instructions for the control. An element containing the description will be programmatically associated to the BaseControl by the means of an `aria-describedby` attribute. - - Type: `ReactNode` - - Required: No +- Type: `ReactNode` +- Required: No ### `hideLabelFromVision` If true, the label will only be visible to screen readers. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `id` @@ -80,15 +80,15 @@ This is necessary to accessibly associate the label with that element. The recommended way is to use the `useBaseControlProps` hook, which takes care of generating a unique `id` for you. Otherwise, if you choose to pass an explicit `id` to this prop, you are responsible for ensuring the uniqueness of the `id`. - - Type: `string` - - Required: No +- Type: `string` +- Required: No ### `label` If this property is added, a label will be generated using label property as the content. - - Type: `ReactNode` - - Required: No +- Type: `ReactNode` +- Required: No ## Subcomponents @@ -113,18 +113,19 @@ const MyBaseControl = () => ( ); ``` + #### Props ##### `as` The HTML element or React component to render the component as. - - Type: `"symbol" | "object" | "label" | "a" | "abbr" | "address" | "area" | "article" | "aside" | "audio" | ...` - - Required: No +- Type: `"symbol" | "object" | "label" | "a" | "abbr" | "address" | "area" | "article" | "aside" | "audio" | ...` +- Required: No ##### `children` The content to be displayed within the `BaseControl.VisualLabel`. - - Type: `ReactNode` - - Required: Yes +- Type: `ReactNode` +- Required: Yes diff --git a/packages/components/src/box-control/README.md b/packages/components/src/box-control/README.md index da08cafceee42f..aa74866fc9650a 100644 --- a/packages/components/src/box-control/README.md +++ b/packages/components/src/box-control/README.md @@ -12,79 +12,80 @@ import { useState } from 'react'; import { BoxControl } from '@wordpress/components'; function Example() { - const [ values, setValues ] = useState( { - top: '50px', - left: '10%', - right: '10%', - bottom: '50px', - } ); - - return ( - - ); -}; + const [ values, setValues ] = useState( { + top: '50px', + left: '10%', + right: '10%', + bottom: '50px', + } ); + + return ( + + ); +} ``` + ## Props ### `__next40pxDefaultSize` Start opting into the larger default height that will become the default size in a future version. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `allowReset` If this property is true, a button to reset the box control is rendered. - - Type: `boolean` - - Required: No - - Default: `true` +- Type: `boolean` +- Required: No +- Default: `true` ### `id` The id to use as a base for the unique HTML id attribute of the control. - - Type: `string` - - Required: No +- Type: `string` +- Required: No ### `inputProps` Props for the internal `UnitControl` components. - - Type: `UnitControlPassthroughProps` - - Required: No - - Default: `{ - min: 0, - }` +- Type: `UnitControlPassthroughProps` +- Required: No +- Default: `{ + min: 0, +}` ### `label` Heading label for the control. - - Type: `string` - - Required: No - - Default: `__( 'Box Control' )` +- Type: `string` +- Required: No +- Default: `__( 'Box Control' )` ### `onChange` A callback function when an input value changes. - - Type: `(next: BoxControlValue) => void` - - Required: No - - Default: `() => {}` +- Type: `(next: BoxControlValue) => void` +- Required: No +- Default: `() => {}` ### `presets` Available presets to pick from. - - Type: `Preset[]` - - Required: No +- Type: `Preset[]` +- Required: No ### `presetKey` @@ -92,21 +93,21 @@ The key of the preset to apply. If you provide a list of presets, you must provide a preset key to use. The format of preset selected values is going to be `var:preset|${ presetKey }|${ presetSlug }` - - Type: `string` - - Required: No +- Type: `string` +- Required: No ### `resetValues` The `top`, `right`, `bottom`, and `left` box dimension values to use when the control is reset. - - Type: `BoxControlValue` - - Required: No - - Default: `{ - top: undefined, - right: undefined, - bottom: undefined, - left: undefined, - }` +- Type: `BoxControlValue` +- Required: No +- Default: `{ + top: undefined, + right: undefined, + bottom: undefined, + left: undefined, +}` ### `sides` @@ -114,29 +115,29 @@ Collection of sides to allow control of. If omitted or empty, all sides will be Allowed values are "top", "right", "bottom", "left", "vertical", and "horizontal". - - Type: `readonly (keyof BoxControlValue | "horizontal" | "vertical")[]` - - Required: No +- Type: `readonly (keyof BoxControlValue | "horizontal" | "vertical")[]` +- Required: No ### `splitOnAxis` If this property is true, when the box control is unlinked, vertical and horizontal controls can be used instead of updating individual sides. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `units` Available units to select from. - - Type: `WPUnitControlUnit[]` - - Required: No - - Default: `CSS_UNITS` +- Type: `WPUnitControlUnit[]` +- Required: No +- Default: `CSS_UNITS` ### `values` The current values of the control, expressed as an object of `top`, `right`, `bottom`, and `left` values. - - Type: `BoxControlValue` - - Required: No +- Type: `BoxControlValue` +- Required: No diff --git a/packages/components/src/button/README.md b/packages/components/src/button/README.md index 99a6d0f9c24cfb..f379e4e970c0cc 100644 --- a/packages/components/src/button/README.md +++ b/packages/components/src/button/README.md @@ -9,14 +9,12 @@ Lets users take actions and make choices with a single click or tap. ```jsx import { Button } from '@wordpress/components'; const Mybutton = () => ( - + ); ``` + ## Props ### `__next40pxDefaultSize` @@ -24,9 +22,9 @@ const Mybutton = () => ( Start opting into the larger default height that will become the default size in a future version. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `accessibleWhenDisabled` @@ -39,23 +37,23 @@ or by preventing focus from returning to a trigger element. Learn more about the [focusability of disabled controls](https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#focusabilityofdisabledcontrols) in the WAI-ARIA Authoring Practices Guide. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `children` The button's children. - - Type: `ReactNode` - - Required: No +- Type: `ReactNode` +- Required: No ### `description` A visually hidden accessible description for the button. - - Type: `string` - - Required: No +- Type: `string` +- Required: No ### `disabled` @@ -64,30 +62,30 @@ to be rendered, even when an `href` is given. In most cases, it is recommended to also set the `accessibleWhenDisabled` prop to `true`. - - Type: `boolean` - - Required: No +- Type: `boolean` +- Required: No ### `href` If provided, renders `a` instead of `button`. - - Type: `string` - - Required: Yes +- Type: `string` +- Required: Yes ### `icon` If provided, renders an Icon component inside the button. - - Type: `IconType` - - Required: No +- Type: `IconType` +- Required: No ### `iconPosition` If provided with `icon`, sets the position of icon relative to the `text`. - - Type: `"left" | "right"` - - Required: No - - Default: `'left'` +- Type: `"left" | "right"` +- Required: No +- Default: `'left'` ### `iconSize` @@ -95,88 +93,88 @@ If provided with `icon`, sets the icon size. Please refer to the Icon component for more details regarding the default value of its `size` prop. - - Type: `number` - - Required: No +- Type: `number` +- Required: No ### `isBusy` Indicates activity while a action is being performed. - - Type: `boolean` - - Required: No +- Type: `boolean` +- Required: No ### `isDestructive` Renders a red text-based button style to indicate destructive behavior. - - Type: `boolean` - - Required: No +- Type: `boolean` +- Required: No ### `isPressed` Renders a pressed button style. - - Type: `boolean` - - Required: No +- Type: `boolean` +- Required: No ### `label` Sets the `aria-label` of the component, if none is provided. Sets the Tooltip content if `showTooltip` is provided. - - Type: `string` - - Required: No +- Type: `string` +- Required: No ### `shortcut` If provided with `showTooltip`, appends the Shortcut label to the tooltip content. If an object is provided, it should contain `display` and `ariaLabel` keys. - - Type: `string | { display: string; ariaLabel: string; }` - - Required: No +- Type: `string | { display: string; ariaLabel: string; }` +- Required: No ### `showTooltip` If provided, renders a Tooltip component for the button. - - Type: `boolean` - - Required: No +- Type: `boolean` +- Required: No ### `size` The size of the button. -- `'default'`: For normal text-label buttons, unless it is a toggle button. -- `'compact'`: For toggle buttons, icon buttons, and buttons when used in context of either. -- `'small'`: For icon buttons associated with more advanced or auxiliary features. +- `'default'`: For normal text-label buttons, unless it is a toggle button. +- `'compact'`: For toggle buttons, icon buttons, and buttons when used in context of either. +- `'small'`: For icon buttons associated with more advanced or auxiliary features. If the deprecated `isSmall` prop is also defined, this prop will take precedence. - - Type: `"small" | "default" | "compact"` - - Required: No - - Default: `'default'` +- Type: `"small" | "default" | "compact"` +- Required: No +- Default: `'default'` ### `text` If provided, displays the given text inside the button. If the button contains children elements, the text is displayed before them. - - Type: `string` - - Required: No +- Type: `string` +- Required: No ### `tooltipPosition` If provided with `showTooltip`, sets the position of the tooltip. Please refer to the Tooltip component for more details regarding the defaults. - - Type: `"top" | "middle" | "bottom" | "top center" | "top left" | "top right" | "middle center" | "middle left" | "middle right" | "bottom center" | ...` - - Required: No +- Type: `"top" | "middle" | "bottom" | "top center" | "top left" | "top right" | "middle center" | "middle left" | "middle right" | "bottom center" | ...` +- Required: No ### `target` If provided with `href`, sets the `target` attribute to the `a`. - - Type: `string` - - Required: No +- Type: `string` +- Required: No ### `variant` @@ -189,5 +187,5 @@ The accepted values are: 3. `'tertiary'` (the text-based button styles) 4. `'link'` (the link button styles) - - Type: `"link" | "primary" | "secondary" | "tertiary"` - - Required: No +- Type: `"link" | "primary" | "secondary" | "tertiary"` +- Required: No diff --git a/packages/components/src/card/card-body/README.md b/packages/components/src/card/card-body/README.md index 451b4dc8526cf7..5b50948bb0cbd6 100644 --- a/packages/components/src/card/card-body/README.md +++ b/packages/components/src/card/card-body/README.md @@ -36,6 +36,6 @@ Renders with a light gray background color. Determines the amount of padding within the component. -- Required: No -- Default: `medium` -- Allowed values: `xSmall`, `small`, `medium`, `large` +- Required: No +- Default: `medium` +- Allowed values: `xSmall`, `small`, `medium`, `large` diff --git a/packages/components/src/card/card-footer/README.md b/packages/components/src/card/card-footer/README.md index e7f15d846b4fbd..11fce019e33361 100644 --- a/packages/components/src/card/card-footer/README.md +++ b/packages/components/src/card/card-footer/README.md @@ -9,8 +9,8 @@ import { Card, CardFooter } from '@wordpress/components'; const Example = () => ( - ... - ... + ... + ... ); ``` @@ -51,8 +51,8 @@ Note: This component is connected to [`Card`'s Context](/packages/components/src Renders without a border. -- Required: No -- Default: `false` +- Required: No +- Default: `false` ### `isShady`: `boolean` @@ -69,6 +69,6 @@ See the documentation for the `justify` prop for the [`Flex` component](/package Determines the amount of padding within the component. -- Required: No -- Default: `medium` -- Allowed values: `xSmall`, `small`, `medium`, `large` +- Required: No +- Default: `medium` +- Allowed values: `xSmall`, `small`, `medium`, `large` diff --git a/packages/components/src/card/card-header/README.md b/packages/components/src/card/card-header/README.md index 87f2f6178a9c82..d39a4f37c537fb 100644 --- a/packages/components/src/card/card-header/README.md +++ b/packages/components/src/card/card-header/README.md @@ -9,8 +9,8 @@ import { Card, CardHeader } from '@wordpress/components'; const Example = () => ( - ... - ... + ... + ... ); ``` @@ -23,8 +23,8 @@ Note: This component is connected to [`Card`'s Context](/packages/components/src Renders without a border. -- Required: No -- Default: `false` +- Required: No +- Default: `false` ### `isShady`: `boolean` @@ -37,6 +37,6 @@ Renders with a light gray background color. Determines the amount of padding within the component. -- Required: No -- Default: `medium` -- Allowed values: `xSmall`, `small`, `medium`, `large` +- Required: No +- Default: `medium` +- Allowed values: `xSmall`, `small`, `medium`, `large` diff --git a/packages/components/src/card/card/README.md b/packages/components/src/card/card/README.md index 33b71cb74faa83..d9d88c938a0d6f 100644 --- a/packages/components/src/card/card/README.md +++ b/packages/components/src/card/card/README.md @@ -39,30 +39,30 @@ function Example() { Size of the elevation shadow, based on the Style system's elevation system. This may be helpful in highlighting certain content. For more information, check out [`Elevation`](/packages/components/src/elevation/README.md). -- Required: No -- Default: `0` +- Required: No +- Default: `0` ### `isBorderless`: `boolean` Renders without a border. -- Required: No -- Default: `false` +- Required: No +- Default: `false` ### `isRounded`: `boolean` Renders with rounded corners. -- Required: No -- Default: `true` +- Required: No +- Default: `true` ### `size`: `string` Determines the amount of padding within the component. -- Required: No -- Default: `medium` -- Allowed values: `xSmall`, `small`, `medium`, `large` +- Required: No +- Default: `medium` +- Allowed values: `xSmall`, `small`, `medium`, `large` ### Inherited props diff --git a/packages/components/src/circular-option-picker/README.md b/packages/components/src/circular-option-picker/README.md index 1dc230686cae17..eb7e4cbaec57fc 100644 --- a/packages/components/src/circular-option-picker/README.md +++ b/packages/components/src/circular-option-picker/README.md @@ -37,15 +37,15 @@ const Example = () => { ); return ( setCurrentColor( undefined ) } - > - { 'Clear' } - - } - /> + options={ colorOptions } + actions={ + setCurrentColor( undefined ) } + > + { 'Clear' } + + } + /> ); }; ``` @@ -56,7 +56,7 @@ const Example = () => { A CSS class to apply to the wrapper element. -- Required: No +- Required: No ### `actions`: `ReactNode` @@ -64,7 +64,7 @@ The action(s) to be rendered after the options, such as a 'clear' button as seen Usually a `CircularOptionPicker.ButtonAction` or `CircularOptionPicker.DropdownLinkAction` component. -- Required: No +- Required: No ### `options`: `ReactNode` @@ -72,27 +72,27 @@ The options to be rendered, such as color swatches. Usually a `CircularOptionPicker.Option` component. -- Required: No +- Required: No ### `children`: `ReactNode` The child elements. -- Required: No +- Required: No ### `asButtons`: `boolean` Whether the control should present as a set of buttons, each with its own tab stop. -- Required: No -- Default: `false` +- Required: No +- Default: `false` ### `loop`: `boolean` Prevents keyboard interaction from wrapping around. Only used when `asButtons` is not true. -- Required: No -- Default: `true` +- Required: No +- Default: `true` ## Subcomponents @@ -108,13 +108,13 @@ A common use case is a 'clear' button to deselect the currently selected option. A CSS class to apply to the underlying `Button` component. -- Required: No +- Required: No ##### `children`: `ReactNode` The button's children. -- Required: No +- Required: No ##### Inherited props @@ -130,13 +130,13 @@ The button's children. A CSS class to apply to the underlying `Dropdown` component. -- Required: No +- Required: No ##### `linkText`: `string` The text to be displayed on the button. -- Required: Yes +- Required: Yes ##### `dropdownProps`: `object` @@ -144,12 +144,12 @@ The props for the underlying `Dropdown` component. Inherits all of the [`Dropdown` props](/packages/components/src/dropdown/README.md#props), except for `className` and `renderToggle`. -- Required: Yes +- Required: Yes ##### `buttonProps`: `object` Props for the underlying `Button` component. -Inherits all of the [`Button` props](/packages/components/src/button/README.md#props), except for `href`, `target`, and `children`. +Inherits all of the [`Button` props](/packages/components/src/button/README.md#props), except for `href`, `target`, and `children`. -- Required: No +- Required: No diff --git a/packages/components/src/clipboard-button/README.md b/packages/components/src/clipboard-button/README.md index 94bd50b0476a58..d1d860bfb2d8a3 100644 --- a/packages/components/src/clipboard-button/README.md +++ b/packages/components/src/clipboard-button/README.md @@ -37,15 +37,15 @@ The component accepts the following props: The class that will be added to the classes of the underlying ` + ) } { ( props ) => ( - + ) } { ( props ) => ( - + ) } { ( props ) => ( - + ) } { ( props ) => ( - + ) } { ( props ) => ( - + ) } @@ -131,10 +143,22 @@ If there is a need to implement `aria-expanded` elsewhere in the row, cell, or e function TreeMenu() { return ( - + { ( props ) => ( - + ) } diff --git a/packages/components/src/tree-select/README.md b/packages/components/src/tree-select/README.md index 493c83bf993b0c..3a0982f3058bf7 100644 --- a/packages/components/src/tree-select/README.md +++ b/packages/components/src/tree-select/README.md @@ -49,49 +49,50 @@ const MyTreeSelect = () => { ] } /> ); -} +}; ``` + ## Props ### `__next40pxDefaultSize` Start opting into the larger default height that will become the default size in a future version. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `__nextHasNoMarginBottom` Start opting into the new margin-free styles that will become the default in a future version. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `children` As an alternative to the `options` prop, `optgroup`s and `options` can be passed in as `children` for more customizability. - - Type: `ReactNode` - - Required: No +- Type: `ReactNode` +- Required: No ### `disabled` If true, the `input` will be disabled. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `hideLabelFromVision` If true, the label will only be visible to screen readers. - - Type: `boolean` - - Required: No - - Default: `false` +- Type: `boolean` +- Required: No +- Default: `false` ### `help` @@ -99,37 +100,37 @@ Additional description for the control. Only use for meaningful description or instructions for the control. An element containing the description will be programmatically associated to the BaseControl by the means of an `aria-describedby` attribute. - - Type: `ReactNode` - - Required: No +- Type: `ReactNode` +- Required: No ### `label` If this property is added, a label will be generated using label property as the content. - - Type: `ReactNode` - - Required: No +- Type: `ReactNode` +- Required: No ### `labelPosition` The position of the label. - - Type: `"top" | "bottom" | "side" | "edge"` - - Required: No - - Default: `'top'` +- Type: `"top" | "bottom" | "side" | "edge"` +- Required: No +- Default: `'top'` ### `noOptionLabel` If this property is added, an option will be added with this label to represent empty selection. - - Type: `string` - - Required: No +- Type: `string` +- Required: No ### `onChange` A function that receives the value of the new option that is being selected as input. - - Type: `(value: string, extra?: { event?: ChangeEvent; }) => void` - - Required: No +- Type: `(value: string, extra?: { event?: ChangeEvent; }) => void` +- Required: No ### `options` @@ -137,8 +138,8 @@ An array of option property objects to be rendered, each with a `label` and `value` property, as well as any other `