[ Index ] |
PHP Cross Reference of WordPress Trunk (Updated Daily) |
[Source view] [Print] [Project Stats]
Checks if the block is experimental based on the metadata loaded from block.json.
File Size: | 64680 lines (2161 kb) |
Included or required: | 0 times |
Referenced: | 0 times |
Includes or requires: | 0 files |
matcher(match) X-Ref |
No description |
__webpack_require__(moduleId) X-Ref |
No description |
initBlock(block) X-Ref |
Function to register an individual block. return: {WPBlockType | undefined} The block, if it has been successfully registered; param: {Object} block The block to be registered. |
ArchivesEdit({attributes,setAttributes}) X-Ref |
No description |
r(e) X-Ref |
No description |
getAvatarSizes(sizes) X-Ref |
No description |
useDefaultAvatar() X-Ref |
No description |
useCommentAvatar({commentId}) X-Ref |
No description |
useUserAvatar({userId,postId,postType}) X-Ref |
No description |
UserControl({value,onChange}) X-Ref |
No description |
Edit(props) X-Ref |
No description |
memize(fn, options) X-Ref |
Accepts a function to be memoized, and returns a new memoized function, with optional options. return: {((...args: Parameters<F>) => ReturnType<F>) & MemizeMemoizedFunction} Memoized function. param: {F} fn Function to memoize. param: {MemizeOptions} [options] Options object. |
memoized() X-Ref |
No description |
getClassNames(html, existingClassNames, allowResponsive = true) X-Ref |
Returns class names with any relevant responsive aspect ratio names. return: {string} Deduped class names. param: {string} html The preview HTML that possibly contains an iframe with width and height set. param: {string} existingClassNames Any existing class names. param: {boolean} allowResponsive If the responsive class names should be added, or removed. |
fallback(url, onReplace) X-Ref |
Fallback behaviour for unembeddable URLs. Creates a paragraph block containing a link to the URL, and calls `onReplace`. param: {string} url The URL that could not be embedded. param: {Function} onReplace Function to call with the created fallback block. |
useCanEditEntity(kind, name, recordId) X-Ref |
Returns whether the current user can edit the given entity. param: {string} kind Entity kind. param: {string} name Entity name. param: {string} recordId Record's id. |
useUploadMediaFromBlobURL(args = {}) X-Ref |
Handles uploading a media file from a blob URL on mount. param: {Object} args Upload media arguments. param: {string} args.url Blob URL. param: {?Array} args.allowedTypes Array of allowed media types. param: {Function} args.onChange Function called when the media is uploaded. param: {Function} args.onError Function called when an error happens. |
useToolsPanelDropdownMenuProps() X-Ref |
No description |
Caption({attributeKey = 'caption',attributes,setAttributes,isSelected,insertBlocksAfter,placeholder = (0,external_wp_i18n_namespaceObject.__) X-Ref |
No description |
AudioEdit({attributes,className,setAttributes,onReplace,isSelected: isSingleSelected,insertBlocksAfter}) X-Ref |
No description |
toggleAttribute(attribute) X-Ref |
No description |
onSelectURL(newSrc) X-Ref |
No description |
onUploadError(message) X-Ref |
No description |
getAutoplayHelp(checked) X-Ref |
No description |
onSelectAudio(media) X-Ref |
No description |
save({attributes}) X-Ref |
No description |
migrate_font_family(attributes) X-Ref |
Migrates the current style.typography.fontFamily attribute, whose value was "var:preset|font-family|helvetica-arial", to the style.fontFamily attribute, whose value will be "helvetica-arial". return: {Object} The updated attributes. param: {Object} attributes The current attributes |
migrateAlign(attributes) X-Ref |
No description |
getUpdatedLinkAttributes({rel = '',url = '',opensInNewTab,nofollow}) X-Ref |
Updates the link attributes. param: {Object} attributes The current block attributes. param: {string} attributes.rel The current link rel attribute. param: {string} attributes.url The current link url. param: {boolean} attributes.opensInNewTab Whether the link should open in a new window. param: {boolean} attributes.nofollow Whether the link should be marked as nofollow. |
removeAnchorTag(value) X-Ref |
Removes anchor tags from a string. return: {string} The value with anchor tags removed. param: {string} value The value to remove anchor tags from. |
useEnter(props) X-Ref |
No description |
onKeyDown(event) X-Ref |
No description |
WidthPanel({selectedWidth,setAttributes}) X-Ref |
No description |
handleChange(newWidth) X-Ref |
No description |
ButtonEdit(props) X-Ref |
No description |
onKeyDown(event) X-Ref |
No description |
startEditing(event) X-Ref |
No description |
unlink() X-Ref |
No description |
save_save({attributes,className}) X-Ref |
WordPress dependencies |
getTransformedMetadata(metadata, newBlockName, bindingsCallback) X-Ref |
Transform the metadata attribute with only the values and bindings specified by each transform. Returns `undefined` if the input metadata is falsy. return: {Object|undefined} New metadata object only with the relevant properties. param: {Object} metadata Original metadata attribute from the block that is being transformed. param: {Object} newBlockName Name of the final block after the transformation. param: {Function} bindingsCallback Optional callback to transform the `bindings` property object. |
ButtonsEdit({attributes,className}) X-Ref |
No description |
buttons_save_save({attributes,className}) X-Ref |
WordPress dependencies |
CalendarEdit({attributes}) X-Ref |
No description |
CategoriesEdit({attributes: {displayAsDropdown,showHierarchy,showPostCounts,showOnlyTopLevel,showEmpty,label,showLabel,taxonomy: taxonomySlug},setAttributes,className}) X-Ref |
No description |
ModalAuxiliaryActions({onClick,isModalFullScreen}) X-Ref |
No description |
ClassicEdit(props) X-Ref |
No description |
ModalEdit(props) X-Ref |
No description |
isTmceEmpty(editor) X-Ref |
No description |
FreeformEdit(props) X-Ref |
No description |
edit_ClassicEdit({clientId,attributes: {content},setAttributes,onReplace}) X-Ref |
No description |
onSetup(editor) X-Ref |
No description |
initialize() X-Ref |
No description |
onReadyStateChange() X-Ref |
No description |
focus() X-Ref |
No description |
onToolbarKeyDown(event) X-Ref |
No description |
freeform_save_save({attributes}) X-Ref |
WordPress dependencies |
CodeEdit({attributes,setAttributes,onRemove,insertBlocksAfter,mergeBlocks}) X-Ref |
No description |
utils_escape(content) X-Ref |
Escapes ampersands, shortcodes, and links. return: {string} The given content with some characters escaped. param: {string} content The content of a code block. |
escapeOpeningSquareBrackets(content) X-Ref |
Returns the given content with all opening shortcode characters converted into their HTML entity counterpart (i.e. [ => [). For instance, a shortcode like [embed] becomes [embed] This function replicates the escaping of HTML tags, where a tag like <strong> becomes <strong>. return: {string} The given content with its opening shortcode characters param: {string} content The content of a code block. |
escapeProtocolInIsolatedUrls(content) X-Ref |
Converts the first two forward slashes of any isolated URL into their HTML counterparts (i.e. // => //). For instance, https://youtube.com/watch?x becomes https://youtube.com/watch?x. An isolated URL is a URL that sits in its own line, surrounded only by spacing characters. See https://github.com/WordPress/wordpress-develop/blob/5.1.1/src/wp-includes/class-wp-embed.php#L403 return: {string} The given content with its ampersands converted into param: {string} content The content of a code block. |
code_save_save({attributes}) X-Ref |
Internal dependencies |
ColumnInspectorControls({width,setAttributes}) X-Ref |
No description |
ColumnEdit({attributes: {verticalAlignment,width,templateLock,allowedBlocks},setAttributes,clientId}) X-Ref |
No description |
column_save_save({attributes}) X-Ref |
WordPress dependencies |
getDeprecatedLayoutColumn(originalContent) X-Ref |
Given an HTML string for a deprecated columns inner block, returns the column index to which the migrated inner block should be assigned. Returns undefined if the inner block was not assigned to a column. return: {number | undefined} Column to which inner block is to be assigned. param: {string} originalContent Deprecated Columns inner block HTML. |
getEffectiveColumnWidth(block, totalBlockCount) X-Ref |
Returns an effective width for a given block. An effective width is equal to its attribute value if set, or a computed value assuming equal distribution. return: {number} Effective column width. param: {WPBlock} block Block object. param: {number} totalBlockCount Total number of blocks in Columns. |
getTotalColumnsWidth(blocks, totalBlockCount = blocks.length) X-Ref |
Returns the total width occupied by the given set of column blocks. return: {number} Total width occupied by blocks. param: {WPBlock[]} blocks Block objects. param: {?number} totalBlockCount Total number of blocks in Columns. |
getColumnWidths(blocks, totalBlockCount = blocks.length) X-Ref |
Returns an object of `clientId` → `width` of effective column widths. return: {Object<string,number>} Column widths. param: {WPBlock[]} blocks Block objects. param: {?number} totalBlockCount Total number of blocks in Columns. |
getRedistributedColumnWidths(blocks, availableWidth, totalBlockCount = blocks.length) X-Ref |
Returns an object of `clientId` → `width` of column widths as redistributed proportional to their current widths, constrained or expanded to fit within the given available width. return: {Object<string,number>} Redistributed column widths. param: {WPBlock[]} blocks Block objects. param: {number} availableWidth Maximum width to fit within. param: {?number} totalBlockCount Total number of blocks in Columns. |
hasExplicitPercentColumnWidths(blocks) X-Ref |
Returns true if column blocks within the provided set are assigned with explicit widths, or false otherwise. return: {boolean} Whether columns have explicit widths. param: {WPBlock[]} blocks Block objects. |
getMappedColumnWidths(blocks, widths) X-Ref |
Returns a copy of the given set of blocks with new widths assigned from the provided object of redistributed column widths. return: {WPBlock[]} blocks Mapped block objects. param: {WPBlock[]} blocks Block objects. param: {Object<string,number>} widths Redistributed column widths. |
getWidths(blocks, withParsing = true) X-Ref |
Returns an array with columns widths values, parsed or no depends on `withParsing` flag. return: {Array<number,string>} Column widths. param: {WPBlock[]} blocks Block objects. param: {?boolean} withParsing Whether value has to be parsed. |
getWidthWithUnit(width, unit) X-Ref |
Returns a column width with unit. return: {string} Column width with unit. param: {string} width Column width. param: {string} unit Column width unit. |
isPercentageUnit(unit) X-Ref |
Returns a boolean whether passed unit is percentage return: {boolean} Whether unit is '%'. param: {string} unit Column width unit. |
edit_ColumnInspectorControls({clientId,setAttributes,isStackedOnMobile}) X-Ref |
No description |
updateColumns(previousColumns, newColumns) X-Ref |
Updates the column count, including necessary revisions to child Column blocks to grant required or redistribute available space. param: {number} previousColumns Previous column count. param: {number} newColumns New column count. |
ColumnsEditContainer({attributes,setAttributes,clientId}) X-Ref |
No description |
updateAlignment(newVerticalAlignment) X-Ref |
Update all child Column blocks with a new vertical alignment setting based on whatever alignment is passed in. This allows change to parent to overide anything set on a individual column basis. param: {string} newVerticalAlignment The vertical alignment setting. |
Placeholder({clientId,name,setAttributes}) X-Ref |
No description |
columns_save_save({attributes}) X-Ref |
WordPress dependencies |
CommentsInspectorControls({attributes: {tagName},setAttributes}) X-Ref |
No description |
PostCommentsPlaceholder({postType,postId}) X-Ref |
No description |
CommentsLegacy({attributes,setAttributes,context: {postType,postId}}) X-Ref |
No description |
CommentsEdit(props) X-Ref |
No description |
comments_save_save({attributes: {tagName: Tag,legacy}}) X-Ref |
WordPress dependencies |
edit_Edit({attributes,context: {commentId},setAttributes,isSelected}) X-Ref |
No description |
comment_author_name_edit_Edit({attributes: {isLink,linkTarget,textAlign},context: {commentId},setAttributes}) X-Ref |
No description |
comment_content_edit_Edit({setAttributes,attributes: {textAlign},context: {commentId}}) X-Ref |
No description |
comment_date_edit_Edit({attributes: {format,isLink},context: {commentId},setAttributes}) X-Ref |
No description |
comment_edit_link_edit_Edit({attributes: {linkTarget,textAlign},setAttributes}) X-Ref |
No description |
comment_reply_link_edit_Edit({setAttributes,attributes: {textAlign}}) X-Ref |
No description |
CommentTemplateInnerBlocks({comment,activeCommentId,setActiveCommentId,firstCommentId,blocks}) X-Ref |
Component which renders the inner blocks of the Comment Template. return: {Element} Inner blocks of the Comment Template param: {Object} props Component props. param: {Array} [props.comment] - A comment object. param: {Array} [props.activeCommentId] - The ID of the comment that is currently active. param: {Array} [props.setActiveCommentId] - The setter for activeCommentId. param: {Array} [props.firstCommentId] - ID of the first comment in the array. param: {Array} [props.blocks] - Array of blocks returned from |
CommentTemplateEdit({clientId,context: {postId}}) X-Ref |
No description |
CommentTemplateSave() X-Ref |
WordPress dependencies |
CommentsPaginationPreviousEdit({attributes: {label},setAttributes,context: {'comments/paginationArrow': paginationArrow}}) X-Ref |
No description |
CommentsPaginationArrowControls({value,onChange}) X-Ref |
No description |
QueryPaginationEdit({attributes: {paginationArrow},setAttributes,clientId}) X-Ref |
No description |
comments_pagination_save_save() X-Ref |
WordPress dependencies |
CommentsPaginationNextEdit({attributes: {label},setAttributes,context: {'comments/paginationArrow': paginationArrow}}) X-Ref |
No description |
CommentsPaginationNumbersEdit() X-Ref |
No description |
comments_title_edit_Edit({attributes: {textAlign,showPostTitle,showCommentsCount,level,levelOptions},setAttributes,context: {postType,postId}}) X-Ref |
No description |
mediaPosition({x,y} = DEFAULT_FOCAL_POINT) X-Ref |
No description |
dimRatioToClass(ratio) X-Ref |
No description |
attributesFromMedia(media) X-Ref |
No description |
isContentPositionCenter(contentPosition) X-Ref |
Checks of the contentPosition is the center (default) position. return: {boolean} Whether the contentPosition is center. param: {string} contentPosition The current content position. |
getPositionClassName(contentPosition) X-Ref |
Retrieves the className for the current contentPosition. The default position (center) will not have a className. return: {string} The className assigned to the contentPosition. param: {string} contentPosition The current content position. |
backgroundImageStyles(url) X-Ref |
No description |
dimRatioToClassV1(ratio) X-Ref |
Original function to determine the background opacity classname Used in deprecations: v1-7. return: {string} background opacity class . param: {number} ratio ratio to use for opacity. |
migrateDimRatio(attributes) X-Ref |
No description |
migrateTag(attributes) X-Ref |
No description |
CoverHeightInput({onChange,onUnitChange,unit = 'px',value = ''}) X-Ref |
No description |
CoverInspectorControls({attributes,setAttributes,clientId,setOverlayColor,coverRef,currentSettings,updateDimRatio}) X-Ref |
No description |
CoverBlockControls({attributes,setAttributes,onSelectMedia,currentSettings,toggleUseFeaturedImage,onClearMedia}) X-Ref |
No description |
CoverPlaceholder({disableMediaButtons = false,children,onSelectMedia,onError,style,toggleUseFeaturedImage}) X-Ref |
Internal dependencies |
ResizableCoverPopover({className,height,minHeight,onResize,onResizeStart,onResizeStop,showHandle,size,width,...props}) X-Ref |
No description |
names(e,f) X-Ref |
No description |
toHex(num) X-Ref |
No description |
arrayToHex(arr) X-Ref |
No description |
isDark(color) X-Ref |
No description |
prepareIgnoredColor(color) X-Ref |
No description |
isRGBArray(value) X-Ref |
No description |
isIgnoredColor(data, index, ignoredColor) X-Ref |
No description |
isIgnoredColorAsNumbers(data, index, ignoredColor) X-Ref |
No description |
isIgnoredRGBColor(data, index, ignoredColor) X-Ref |
No description |
isIgnoredRGBAColor(data, index, ignoredColor) X-Ref |
No description |
inRange(colorComponent, ignoredColorComponent, value) X-Ref |
No description |
isIgnoredRGBAColorWithThreshold(data, index, ignoredColor) X-Ref |
No description |
dominantAlgorithm(arr, len, options) X-Ref |
No description |
simpleAlgorithm(arr, len, options) X-Ref |
No description |
sqrtAlgorithm(arr, len, options) X-Ref |
No description |
getDefaultColor(options) X-Ref |
No description |
getOption(options, name, defaultValue) X-Ref |
No description |
isSvg(filename) X-Ref |
No description |
getOriginalSize(resource) X-Ref |
No description |
getSrc(resource) X-Ref |
No description |
isInstanceOfHTMLImageElement(resource) X-Ref |
No description |
isInstanceOfOffscreenCanvas(resource) X-Ref |
No description |
isInstanceOfHTMLVideoElement(resource) X-Ref |
No description |
isInstanceOfHTMLCanvasElement(resource) X-Ref |
No description |
isInstanceOfImageBitmap(resource) X-Ref |
No description |
prepareSizeAndPosition(originalSize, options) X-Ref |
No description |
makeCanvas() X-Ref |
No description |
getError(message) X-Ref |
No description |
outputError(error, silent) X-Ref |
No description |
FastAverageColor() X-Ref |
No description |
compositeSourceOver(source, dest) X-Ref |
Performs a Porter Duff composite source over operation on two rgba colors. return: {RgbaColor} Composite color. param: {RgbaColor} source Source color. param: {RgbaColor} dest Destination color. |
retrieveFastAverageColor() X-Ref |
Retrieves the FastAverageColor singleton. return: {FastAverageColor} The FastAverageColor singleton. |
compositeIsDark(dimRatio, overlayColor, backgroundColor) X-Ref |
Computes if the color combination of the overlay and background color is dark. return: {boolean} true if the color combination composite result is dark. param: {number} dimRatio Opacity of the overlay between 0 and 100. param: {string} overlayColor CSS color string for the overlay. param: {string} backgroundColor CSS color string for the background. |
getInnerBlocksTemplate(attributes) X-Ref |
No description |
CoverEdit({attributes,clientId,isSelected,overlayColor,setAttributes,setOverlayColor,toggleSelection,context: {postId,postType}}) X-Ref |
Is the URL a temporary blob URL? A blob URL is one that is used temporarily while the media (image or video) is being uploaded and will not have an id allocated yet. return: {boolean} Is the URL a Blob URL. param: {number} id The id of the media. param: {string} url The url of the media. |
cover_save_save({attributes}) X-Ref |
No description |
DetailsEdit({attributes,setAttributes,clientId}) X-Ref |
No description |
details_save_save({attributes}) X-Ref |
No description |
getResponsiveHelp(checked) X-Ref |
No description |
WpEmbedPreview({html}) X-Ref |
No description |
resizeWPembeds({data: {secret,message,value} = {}}) X-Ref |
Checks for WordPress embed events signaling the height change when iframe content loads or iframe's window is resized. The event is sent from WordPress core via the window.postMessage API. References: window.postMessage: https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage WordPress core embed-template on load: https://github.com/WordPress/WordPress/blob/HEAD/wp-includes/js/wp-embed-template.js#L143 WordPress core embed-template on resize: https://github.com/WordPress/WordPress/blob/HEAD/wp-includes/js/wp-embed-template.js#L187 param: {MessageEvent} event Message event. |
EmbedPreview({preview,previewable,url,type,isSelected,className,icon,label,insertBlocksAfter,attributes,setAttributes}) X-Ref |
No description |
embed_save_save({attributes}) X-Ref |
No description |
getTitle(providerName) X-Ref |
No description |
FileBlockInspector({hrefs,openInNewWindow,showDownloadButton,changeLinkDestinationOption,changeOpenInNewWindow,changeShowDownloadButton,displayPreview,changeDisplayPreview,previewHeight,changePreviewHeight}) X-Ref |
No description |
ClipboardToolbarButton({text,disabled}) X-Ref |
No description |
FileEdit({attributes,isSelected,setAttributes,clientId}) X-Ref |
No description |
onSelectFile(newMedia) X-Ref |
No description |
onUploadError(message) X-Ref |
No description |
changeLinkDestinationOption(newHref) X-Ref |
No description |
changeOpenInNewWindow(newValue) X-Ref |
No description |
changeShowDownloadButton(newValue) X-Ref |
No description |
changeDisplayPreview(newValue) X-Ref |
No description |
handleOnResizeStop(event, direction, elt, delta) X-Ref |
No description |
changePreviewHeight(newValue) X-Ref |
No description |
file_save_save({attributes}) X-Ref |
No description |
form_save_save({attributes}) X-Ref |
WordPress dependencies |
InputFieldBlock({attributes,setAttributes,className}) X-Ref |
No description |
form_input_save_save({attributes}) X-Ref |
No description |
form_submit_button_save_save() X-Ref |
WordPress dependencies |
form_submission_notification_save_save({attributes}) X-Ref |
External dependencies |
defaultColumnsNumberV1(attributes) X-Ref |
Original function to determine default number of columns from a block's attributes. Used in deprecations: v1-6, for versions of the gallery block that didn't use inner blocks. return: {number} Default number of columns for the gallery. param: {Object} attributes Block attributes. |
getHrefAndDestination(image, destination) X-Ref |
Original function to determine new href and linkDestination values for an image block from the supplied Gallery link destination. Used in deprecations: v1-6. return: {Object} New attributes to assign to image block. param: {Object} image Gallery image. param: {string} destination Gallery's selected link destination. |
runV2Migration(attributes) X-Ref |
No description |
getImageBlock(image, sizeSlug, linkTo) X-Ref |
Gets an Image block from gallery image data Used to migrate Galleries to nested Image InnerBlocks. return: {Object} Image block. param: {Object} image Image properties. param: {string} sizeSlug Gallery sizeSlug attribute. param: {string} linkTo Gallery linkTo attribute. |
defaultColumnsNumber(imageCount) X-Ref |
No description |
utils_getHrefAndDestination(image, galleryDestination, imageDestination) X-Ref |
Determines new href and linkDestination values for an Image block from the supplied Gallery link destination, or falls back to the Image blocks link. return: {Object} New attributes to assign to image block. param: {Object} image Gallery image. param: {string} galleryDestination Gallery's selected link destination. param: {Object} imageDestination Image blocks attributes. |
evalAspectRatio(value) X-Ref |
Evaluates a CSS aspect-ratio property value as a number. Degenerate or invalid ratios behave as 'auto'. And 'auto' ratios return NaN. return: {number} Numerical aspect ratio or NaN if invalid. param: {string} value CSS aspect-ratio property value. |
removeNewTabRel(currentRel) X-Ref |
No description |
getUpdatedLinkTargetSettings(value, {rel}) X-Ref |
Helper to get the link target settings to be stored. return: {Object} Updated link target settings. param: {boolean} value The new link target value. param: {Object} attributes Block attributes. param: {Object} attributes.rel Image block's rel attribute. |
getImageSizeAttributes(image, size) X-Ref |
Determines new Image block attributes size selection. param: {Object} image Media file object for gallery image. param: {string} size Selected size slug to apply. |
isValidFileType(file) X-Ref |
Checks if the file has a valid file type. return: {boolean} - Returns true if the file has a valid file type, otherwise false. param: {File} file - The file to check. |
Gallery(props) X-Ref |
No description |
useImageSizes(images, isSelected, getSettings) X-Ref |
Calculates the image sizes that are available for the current gallery images in order to populate the 'Resolution' selector. return: {Array} An array of image size options. param: {Array} images Basic image block data taken from current gallery innerBlock. param: {boolean} isSelected Is the block currently selected in the editor. param: {Function} getSettings Block editor store selector. |
getImageSizing() X-Ref |
No description |
useGetNewImages(images, imageData) X-Ref |
Keeps track of images already in the gallery to allow new innerBlocks to be identified. This is required so default gallery attributes can be applied without overwriting any custom attributes applied to existing images. return: {Array} An array of any new images that have been added to the gallery. param: {Array} images Basic image block data taken from current gallery innerBlock param: {Array} imageData The related image data for each of the current gallery images. |
getNewImages() X-Ref |
No description |
useGetMedia(innerBlockImages) X-Ref |
Retrieves the extended media info for each gallery image from the store. This is used to determine which image size options are available for the current gallery. return: {Array} An array of media info options for each gallery image. param: {Array} innerBlockImages An array of the innerBlock images currently in the gallery. |
GapStyles({blockGap,clientId}) X-Ref |
WordPress dependencies |
GalleryEdit(props) X-Ref |
No description |
buildImageAttributes(imageAttributes) X-Ref |
Determines the image attributes that should be applied to an image block after the gallery updates. The gallery will receive the full collection of images when a new image is added. As a result we need to reapply the image's original settings if it already existed in the gallery. If the image is in fact new, we need to apply the gallery's current settings to the image. return: {Object} Attributes to set on the new image block. param: {Object} imageAttributes Media object for the actual image. |
isValidFileType(file) X-Ref |
No description |
updateImages(selectedImages) X-Ref |
No description |
onUploadError(message) X-Ref |
No description |
setLinkTo(value) X-Ref |
No description |
setColumnsNumber(value) X-Ref |
No description |
toggleImageCrop() X-Ref |
No description |
toggleRandomOrder() X-Ref |
No description |
toggleOpenInNewTab(openInNewTab) X-Ref |
No description |
updateImagesSize(newSizeSlug) X-Ref |
No description |
saveWithInnerBlocks({attributes}) X-Ref |
No description |
updateThirdPartyTransformToGallery(block) X-Ref |
Third party block plugins don't have an easy way to detect if the innerBlocks version of the Gallery is running when they run a 3rdPartyBlock -> GalleryBlock transform so this tranform filter will handle this. Once the innerBlocks version is the default in a core release, this could be deprecated and removed after plugin authors have been given time to update transforms. return: {Block} The transformed block. param: {Block} block The transformed block. |
updateThirdPartyTransformFromGallery(toBlock, fromBlocks) X-Ref |
Third party block plugins don't have an easy way to detect if the innerBlocks version of the Gallery is running when they run a GalleryBlock -> 3rdPartyBlock transform so this transform filter will handle this. Once the innerBlocks version is the default in a core release, this could be deprecated and removed after plugin authors have been given time to update transforms. return: {Block} The transformed block. param: {Block} toBlock The block to transform to. param: {Block[]} fromBlocks The blocks to transform from. |
useShouldShowPlaceHolder({attributes = {style: undefined,backgroundColor: undefined,textColor: undefined,fontSize: undefined},usedLayoutType = '',hasInnerBlocks = false}) X-Ref |
A custom hook to tell the Group block whether to show the variation placeholder. return: {[boolean, Function]} A state value and setter function. param: {Object} props Arguments to pass to hook. param: {Object} [props.attributes] The block's attributes. param: {string} [props.usedLayoutType] The block's current layout type. param: {boolean} [props.hasInnerBlocks] Whether the block has inner blocks. |
GroupPlaceHolder({name,onSelect}) X-Ref |
Display group variations if none is selected. return: {JSX.Element} The placeholder. param: {Object} props Component props. param: {string} props.name The block's name. param: {Function} props.onSelect Function to set block's attributes. |
GroupEditControls({tagName,onSelectTagName}) X-Ref |
No description |
GroupEdit({attributes,name,setAttributes,clientId}) X-Ref |
No description |
group_save_save({attributes: {tagName: Tag}}) X-Ref |
WordPress dependencies |
HeadingEdit({attributes,setAttributes,mergeBlocks,onReplace,style,clientId}) X-Ref |
No description |
heading_save_save({attributes}) X-Ref |
WordPress dependencies |
getLevelFromHeadingNodeName(nodeName) X-Ref |
Given a node name string for a heading node, returns its numeric level. return: {number} Heading level. param: {string} nodeName Heading node name. |
HomeEdit({attributes,setAttributes,context}) X-Ref |
No description |
home_link_save_save() X-Ref |
WordPress dependencies |
HTMLEditPreview({content,isSelected}) X-Ref |
No description |
HTMLEdit({attributes,setAttributes,isSelected}) X-Ref |
No description |
switchToPreview() X-Ref |
No description |
switchToHTML() X-Ref |
No description |
html_save_save({attributes}) X-Ref |
WordPress dependencies |
image_Image({temporaryURL,attributes,setAttributes,isSingleSelected,insertBlocksAfter,onReplace,onSelectImage,onSelectURL,onUploadError,context,clientId,blockEditingMode,parentLayoutType,maxContentWidth}) X-Ref |
No description |
onResizeStart() X-Ref |
No description |
onResizeStop() X-Ref |
No description |
onImageError() X-Ref |
No description |
onImageLoad(event) X-Ref |
No description |
onSetHref(props) X-Ref |
No description |
onSetLightbox(enable) X-Ref |
No description |
resetLightbox() X-Ref |
No description |
onSetTitle(value) X-Ref |
No description |
updateAlt(newAlt) X-Ref |
No description |
updateImage(newSizeSlug) X-Ref |
No description |
uploadExternal() X-Ref |
No description |
switchToCover() X-Ref |
No description |
useMaxWidthObserver() X-Ref |
No description |
hasSize(image, size) X-Ref |
Checks if WP generated the specified image size. Size generation is skipped when the image is smaller than the said size. return: {boolean} Whether or not it has default image size. param: {Object} image param: {string} size |
ImageEdit({attributes,setAttributes,isSelected: isSingleSelected,className,insertBlocksAfter,onReplace,context,clientId,__unstableParentLayout: parentLayout}) X-Ref |
No description |
onUploadError(message) X-Ref |
No description |
onSelectImagesList(images) X-Ref |
No description |
onSelectImage(media) X-Ref |
No description |
onSelectURL(newURL) X-Ref |
No description |
image_save_save({attributes}) X-Ref |
No description |
stripFirstImage(attributes, {shortcode}) X-Ref |
WordPress dependencies |
getFirstAnchorAttributeFormHTML(html, attributeName) X-Ref |
No description |
LatestComments({attributes,setAttributes}) X-Ref |
Maximum number of comments a user can show using this block. |
getFeaturedImageDetails(post, size) X-Ref |
No description |
LatestPostsEdit({attributes,setAttributes}) X-Ref |
No description |
createListBlockFromDOMElement(listElement) X-Ref |
No description |
migrateToListV2(attributes) X-Ref |
No description |
migrateTypeToInlineStyle(attributes) X-Ref |
No description |
TagName(props, ref) X-Ref |
WordPress dependencies |
useMigrateOnLoad(attributes, clientId) X-Ref |
At the moment, deprecations don't handle create blocks from attributes (like when using CPT templates). For this reason, this hook is necessary to avoid breaking templates using the old list block format. param: {Object} attributes Block attributes. param: {string} clientId Block client ID. |
useOutdentList(clientId) X-Ref |
No description |
IndentUI({clientId}) X-Ref |
No description |
list_edit_Edit({attributes,setAttributes,clientId,style}) X-Ref |
No description |
list_save_save({attributes}) X-Ref |
WordPress dependencies |
getListContentSchema({phrasingContentSchema}) X-Ref |
Internal dependencies |
getListContentFlat(blocks) X-Ref |
No description |
useIndentListItem(clientId) X-Ref |
No description |
useOutdentListItem() X-Ref |
No description |
getParentListItemId(id) X-Ref |
No description |
use_enter_useEnter(props) X-Ref |
Internal dependencies |
onKeyDown(event) X-Ref |
No description |
useSpace(clientId) X-Ref |
Internal dependencies |
onKeyDown(event) X-Ref |
No description |
useMerge(clientId, onMerge) X-Ref |
Internal dependencies |
getTrailingId(id) X-Ref |
No description |
getParentListItemId(id) X-Ref |
No description |
_getNextId(id) X-Ref |
Return the next list item with respect to the given list item. If none, return the next list item of the parent list item if it exists. return: {string?} The client ID of the next list item. param: {string} id A list item client ID. |
getNextId(id) X-Ref |
Given a client ID, return the client ID of the list item on the next line, regardless of indentation level. return: {string?} The client ID of the next list item. param: {string} id The client ID of the current list item. |
mergeWithNested(clientIdA, clientIdB) X-Ref |
No description |
edit_IndentUI({clientId}) X-Ref |
No description |
ListItemEdit({attributes,setAttributes,clientId,mergeBlocks}) X-Ref |
No description |
list_item_save_save({attributes}) X-Ref |
No description |
LoginOutEdit({attributes,setAttributes}) X-Ref |
No description |
imageFillStyles(url, focalPoint) X-Ref |
No description |
ToolbarEditButton({mediaId,mediaUrl,onSelectMedia,toggleUseFeaturedImage,useFeaturedImage}) X-Ref |
No description |
PlaceholderContainer({className,mediaUrl,onSelectMedia,toggleUseFeaturedImage}) X-Ref |
No description |
MediaContainer(props, ref) X-Ref |
No description |
getImageSourceUrlBySizeSlug(image, slug) X-Ref |
No description |
edit_attributesFromMedia({attributes: {linkDestination,href},setAttributes}) X-Ref |
No description |
MediaTextEdit({attributes,isSelected,setAttributes,context: {postId,postType}}) X-Ref |
No description |
media_text_save_save({attributes}) X-Ref |
No description |
MissingEdit({attributes,clientId}) X-Ref |
No description |
convertToHTML() X-Ref |
No description |
missing_save_save({attributes}) X-Ref |
WordPress dependencies |
MoreEdit({attributes: {customText,noTeaser},insertBlocksAfter,setAttributes}) X-Ref |
No description |
more_save_save({attributes: {customText,noTeaser}}) X-Ref |
WordPress dependencies |
Icon({icon,size = 24,...props}, ref) X-Ref |
Return an SVG icon. return: {JSX.Element} Icon component param: {IconProps} props icon is the SVG component to render param: {import('react').ForwardedRef<HTMLElement>} ref The forwarded ref to the SVG element. |
useNavigationMenu(ref) X-Ref |
Internal dependencies |
selectExistingMenu(select, ref) X-Ref |
No description |
useNavigationEntities(menuId) X-Ref |
Manages fetching and resolution state for all entities required for the Navigation block. return: { NavigationEntitiesData } the entity data. param: {number} menuId the menu for which to retrieve menuItem data. |
buildMenuLabel(title, id, status) X-Ref |
No description |
NavigationMenuSelector({currentMenuId,onSelectNavigationMenu,onSelectClassicMenu,onCreateNew,actionLabel,createNavigationMenuIsSuccess,createNavigationMenuIsError}) X-Ref |
No description |
NavigationPlaceholder({isSelected,currentMenuId,clientId,canUserCreateNavigationMenus = false,isResolvingCanUserCreateNavigationMenus,onSelectNavigationMenu,onSelectClassicMenu,onCreateEmpty}) X-Ref |
No description |
OverlayMenuIcon({icon}) X-Ref |
No description |
ResponsiveWrapper({children,id,isOpen,isResponsive,onToggle,isHiddenByDefault,overlayBackgroundColor,overlayTextColor,hasIcon,icon}) X-Ref |
No description |
NavigationInnerBlocks({clientId,hasCustomPlaceholder,orientation,templateLock}) X-Ref |
No description |
NavigationMenuNameControl() X-Ref |
No description |
areBlocksDirty(originalBlocks, blocks) X-Ref |
No description |
UnsavedInnerBlocks({blocks,createNavigationMenu,hasSelection}) X-Ref |
No description |
NavigationMenuDeleteControl({onDelete}) X-Ref |
No description |
useNavigationNotice({name,message = ''} = {}) X-Ref |
No description |
OverlayMenuPreview({setAttributes,hasIcon,icon}) X-Ref |
No description |
menuItemsToBlocks(menuItems) X-Ref |
Convert a flat menu item structure to a nested blocks structure. return: {WPBlock[]} An array of blocks. param: {Object[]} menuItems An array of menu items. |
mapMenuItemsToBlocks(menuItems, level = 0) X-Ref |
A recursive function that maps menu item nodes to blocks. return: {Object} Object containing innerBlocks and mapping. param: {WPNavMenuItem[]} menuItems An array of WPNavMenuItem items. param: {number} level An integer representing the nesting level. |
menuItemToBlockAttributes({title: menuItemTitleField,xfn,classes,attr_title,object,object_id,description,url,type: menuItemTypeField,target}, blockType, level) X-Ref |
Convert block attributes to menu item. return: {Object} the block attributes converted from the WPNavMenuItem item. param: {WPNavMenuItem} menuItem the menu item to be converted to block attributes. param: {string} blockType The block type. param: {number} level An integer representing the nesting level. |
createDataTree(dataset, id = 'id', relation = 'parent') X-Ref |
Creates a nested, hierarchical tree representation from unstructured data that has an inherent relationship defined between individual items. For example, by default, each element in the dataset should have an `id` and `parent` property where the `parent` property indicates a relationship between the current item and another item with a matching `id` properties. This is useful for building linked lists of data from flat data structures. return: {Array} a nested array of parent/child relationships param: {Array} dataset linked data to be rearranged into a hierarchical tree based on relational fields. param: {string} id the property which uniquely identifies each entry within the array. param: {*} relation the property which identifies how the current item is related to other items in the data (if at all). |
useConvertClassicToBlockMenu(createNavigationMenu, {throwOnError = false} = {}) X-Ref |
No description |
createTemplatePartId(theme, slug) X-Ref |
Generates a template part Id based on slug and theme inputs. return: {string|null} the template part's Id. param: {string} theme the template part's theme. param: {string} slug the template part's slug |
useTemplatePartAreaLabel(clientId) X-Ref |
No description |
useGenerateDefaultNavigationTitle(clientId) X-Ref |
No description |
useCreateNavigationMenu(clientId) X-Ref |
No description |
useInnerBlocks(clientId) X-Ref |
No description |
getComputedStyle(node) X-Ref |
External dependencies |
detectColors(colorsDetectionElement, setColor, setBackground) X-Ref |
No description |
getColors(context, isSubMenu) X-Ref |
Determine the colors for a menu. Order of priority is: 1: Overlay custom colors (if submenu) 2: Overlay theme colors (if submenu) 3: Custom colors 4: Theme colors 5: Global styles param: {Object} context param: {boolean} isSubMenu |
getNavigationChildBlockProps(innerBlocksColors) X-Ref |
No description |
DeletedNavigationWarning({onCreateNew,isNotice = false}) X-Ref |
No description |
AddSubmenuItem({block,onClose,expandedState,expand,setInsertedBlock}) X-Ref |
No description |
LeafMoreMenu(props) X-Ref |
No description |
getSuggestionsQuery(type, kind) X-Ref |
Given the Link block's type attribute, return the query params to give to /wp/v2/search. return: {{ type?: string, subtype?: string }} Search query params. param: {string} type Link block's type attribute. param: {string} kind Link block's entity of kind (post-type|taxonomy) |
LinkUIBlockInserter({clientId,onBack,onSelectBlock}) X-Ref |
No description |
UnforwardedLinkUI(props, ref) X-Ref |
No description |
AdditionalBlockContent({block,insertedBlock,setInsertedBlock}) X-Ref |
No description |
AccessibleDescription({id,children}) X-Ref |
WordPress dependencies |
AccessibleMenuDescription({id}) X-Ref |
Internal dependencies |
useResponsiveMenu(navRef) X-Ref |
No description |
ColorTools({textColor,setTextColor,backgroundColor,setBackgroundColor,overlayTextColor,setOverlayTextColor,overlayBackgroundColor,setOverlayBackgroundColor,clientId,navRef}) X-Ref |
No description |
Navigation({attributes,setAttributes,clientId,isSelected,className,backgroundColor,setBackgroundColor,textColor,setTextColor,overlayBackgroundColor,setOverlayBackgroundColor,overlayTextColor,setOverlayTextColor,hasSubmenuIndicatorSetting = true,customPlaceholder: CustomPlaceholder = null,__unstableLayoutClassNames: layoutClassNames}) X-Ref |
No description |
navigation_save_save({attributes}) X-Ref |
WordPress dependencies |
handleDragStart(event) X-Ref |
No description |
handleDragEnd() X-Ref |
No description |
handleDragEnter(event) X-Ref |
No description |
getMissingText(type) X-Ref |
No description |
Controls({attributes,setAttributes,setIsLabelFieldFocused}) X-Ref |
No description |
NavigationLinkEdit({attributes,isSelected,setAttributes,insertBlocksAfter,mergeBlocks,onReplace,context,clientId}) X-Ref |
No description |
selectLabelText() X-Ref |
Focus the Link label text and select it. |
removeLink() X-Ref |
Removes the current link if set. |
onKeyDown(event) X-Ref |
No description |
navigation_link_save_save() X-Ref |
WordPress dependencies |
getIcon(variationName) X-Ref |
WordPress dependencies |
enhanceNavigationLinkVariations(settings, name) X-Ref |
No description |
handleDragStart(event) X-Ref |
No description |
handleDragEnd() X-Ref |
No description |
handleDragEnter(event) X-Ref |
No description |
NavigationSubmenuEdit({attributes,isSelected,setAttributes,mergeBlocks,onReplace,context,clientId}) X-Ref |
Navigation Link Block Attributes |
selectLabelText() X-Ref |
Focus the Link label text and select it. |
onKeyDown(event) X-Ref |
No description |
transformToLink() X-Ref |
No description |
navigation_submenu_save_save() X-Ref |
WordPress dependencies |
NextPageEdit() X-Ref |
No description |
nextpage_save_save() X-Ref |
WordPress dependencies |
useParsePatternDependencies() X-Ref |
Hook used by PatternEdit to parse block patterns. It returns a function that takes a pattern and returns nothing but throws an error if the pattern is recursive. return: {Function} A function to parse block patterns. |
parsePatternDependencies(deps, {name,blocks}) X-Ref |
Parse a given pattern and traverse its contents to detect any subsequent patterns on which it may depend. Such occurrences will be added to an internal dependency graph. If a circular dependency is detected, an error will be thrown. EXPORTED FOR TESTING PURPOSES ONLY. param: {Map<string, Set<string>>} deps Map of pattern dependencies. param: {Object} pattern Pattern. param: {string} pattern.name Pattern name. param: {Array} pattern.blocks Pattern's block list. |
registerDependency(deps, a, b) X-Ref |
Declare that pattern `a` depends on pattern `b`. If a circular dependency is detected, an error will be thrown. EXPORTED FOR TESTING PURPOSES ONLY. param: {Map<string, Set<string>>} deps Map of pattern dependencies. param: {string} a Slug for pattern A. param: {string} b Slug for pattern B. |
hasCycle(deps, slug, visitedNodes = new Set() X-Ref |
Determine if a given pattern has circular dependencies on other patterns. This will be determined by running a depth-first search on the current state of the graph represented by `patternDependencies`. return: {boolean} Whether any cycle was found. param: {Map<string, Set<string>>} deps Map of pattern dependencies. param: {string} slug Pattern slug. param: {Set<string>} [visitedNodes] Set to track visited nodes in the graph. param: {Set<string>} [currentPath] Set to track and backtrack graph paths. |
injectThemeAttributeInBlockTemplateContent(block) X-Ref |
No description |
createNavigationLinks(pages = []) X-Ref |
Converts an array of pages into a nested array of navigation link blocks. return: {Array} A nested array of navigation link blocks. param: {Array} pages An array of pages. |
findNavigationLinkById(navigationLinks, id) X-Ref |
Finds a navigation link block by id, recursively. It might be possible to make this a more generic helper function. return: {Object|null} The navigation link block with the given id. param: {Array} navigationLinks An array of navigation link blocks. param: {number} id The id of the navigation link to find. |
convertToNavigationLinks(pages = [], parentPageID = null) X-Ref |
No description |
useConvertToNavigationLinks({clientId,pages,parentClientId,parentPageID}) X-Ref |
No description |
ConvertToLinksModal({onClick,onClose,disabled}) X-Ref |
No description |
BlockContent({blockProps,innerBlocksProps,hasResolvedPages,blockList,pages,parentPageID}) X-Ref |
No description |
PageListEdit({context,clientId,attributes,setAttributes}) X-Ref |
No description |
useFrontPageId() X-Ref |
No description |
PageListItemEdit({context,attributes}) X-Ref |
No description |
useOnEnter(props) X-Ref |
No description |
onKeyDown(event) X-Ref |
No description |
ParagraphRTLControl({direction,setDirection}) X-Ref |
No description |
hasDropCapDisabled(align) X-Ref |
No description |
DropCapControl({clientId,attributes,setAttributes}) X-Ref |
No description |
ParagraphBlock({attributes,mergeBlocks,onReplace,onRemove,setAttributes,clientId}) X-Ref |
No description |
paragraph_save_save({attributes}) X-Ref |
No description |
PostAuthorEdit({isSelected,context: {postType,postId,queryId},attributes,setAttributes}) X-Ref |
No description |
PostAuthorNameEdit({context: {postType,postId},attributes: {textAlign,isLink,linkTarget},setAttributes}) X-Ref |
No description |
PostAuthorBiographyEdit({context: {postType,postId},attributes: {textAlign},setAttributes}) X-Ref |
No description |
post_comment_edit_Edit({attributes: {commentId},setAttributes}) X-Ref |
No description |
post_comment_save_save() X-Ref |
WordPress dependencies |
PostCommentsCountEdit({attributes,context,setAttributes}) X-Ref |
No description |
PostCommentsFormEdit({attributes,context,setAttributes}) X-Ref |
No description |
PostCommentsLinkEdit({context,attributes,setAttributes}) X-Ref |
No description |
ReadOnlyContent({parentLayout,layoutClassNames,userCanEdit,postType,postId}) X-Ref |
No description |
EditableContent({context = {}}) X-Ref |
No description |
Content(props) X-Ref |
No description |
edit_Placeholder({layoutClassNames}) X-Ref |
No description |
RecursionError() X-Ref |
No description |
PostContentEdit({context,__unstableLayoutClassNames: layoutClassNames,__unstableParentLayout: parentLayout}) X-Ref |
No description |
PostDateEdit({attributes: {textAlign,format,isLink,displayType},context: {postId,postType: postTypeSlug,queryId},setAttributes}) X-Ref |
No description |
is12HourFormat(format) X-Ref |
No description |
PostExcerptEditor({attributes: {textAlign,moreText,showMoreOnNewLine,excerptLength},setAttributes,isSelected,context: {postId,postType,queryId}}) X-Ref |
No description |
utils_dimRatioToClass(ratio) X-Ref |
Generates the opacity/dim class based on given number. return: {string} Generated class. param: {number} ratio Dim/opacity number. |
getMediaSourceUrlBySizeSlug(media, slug) X-Ref |
No description |
PostFeaturedImageEdit({clientId,attributes,setAttributes,context: {postId,postType: postTypeSlug,queryId}}) X-Ref |
No description |
PostNavigationLinkEdit({context: {postType},attributes: {type,label,showTitle,textAlign,linkLabel,arrow,taxonomy},setAttributes}) X-Ref |
No description |
PostTemplateInnerBlocks({classList}) X-Ref |
No description |
PostTemplateBlockPreview({blocks,blockContextId,classList,isHidden,setActiveBlockContextId}) X-Ref |
No description |
PostTemplateEdit({setAttributes,clientId,context: {query: {perPage,offset = 0,postType,order,orderBy,author,search,exclude,sticky,inherit,taxQuery,parents,pages,format,...restQueryArgs} = {},templateSlug,previewPostType},attributes: {layout},__unstableLayoutClassNames}) X-Ref |
No description |
PostTemplateSave() X-Ref |
WordPress dependencies |
usePostTerms({postId,term}) X-Ref |
No description |
PostTermsEdit({attributes,clientId,context,isSelected,setAttributes,insertBlocksAfter}) X-Ref |
No description |
enhanceVariations(settings, name) X-Ref |
No description |
PostTimeToReadEdit({attributes,setAttributes,context}) X-Ref |
No description |
PostTitleEdit({attributes: {level,levelOptions,textAlign,isLink,rel,linkTarget},setAttributes,context: {postType,postId,queryId},insertBlocksAfter}) X-Ref |
No description |
PreformattedEdit({attributes,mergeBlocks,setAttributes,onRemove,insertBlocksAfter,style}) X-Ref |
No description |
preformatted_save_save({attributes}) X-Ref |
WordPress dependencies |
parseBorderColor(styleString) X-Ref |
No description |
multilineToInline(value) X-Ref |
No description |
PullQuoteEdit({attributes,setAttributes,isSelected,insertBlocksAfter}) X-Ref |
No description |
pullquote_save_save({attributes}) X-Ref |
No description |
useIsPostTypeHierarchical(postType) X-Ref |
Hook that returns whether a specific post type is hierarchical. return: {boolean} Whether a specific post type is hierarchical. param: {string} postType The post type to check. |
useAllowedControls(attributes) X-Ref |
Hook that returns the query properties' names defined by the active block variation, to determine which block's filters to show. return: {string[]} An array of the query attributes. param: {Object} attributes Block attributes. |
isControlAllowed(allowedControls, key) X-Ref |
No description |
useBlockNameForPatterns(clientId, attributes) X-Ref |
Helper hook that determines if there is an active variation of the block and if there are available specific patterns for this variation. If there are, these patterns are going to be the only ones suggested to the user in setup and replace flow, without including the default ones for Query Loop. If there are no such patterns, the default ones for Query Loop are going to be suggested. return: {string} The block name to be used in the patterns suggestions. param: {string} clientId The block's client ID. param: {Object} attributes The block's attributes. |
useScopedBlockVariations(attributes) X-Ref |
Helper hook that determines if there is an active variation of the block and if there are available specific scoped `block` variations connected with this variation. If there are, these variations are going to be the only ones suggested to the user in setup flow when clicking to `start blank`, without including the default ones for Query Loop. If there are no such scoped `block` variations, the default ones for Query Loop are going to be suggested. The way we determine such variations is with the convention that they have the `namespace` attribute defined as an array. This array should contain the names(`name` property) of any variations they want to be connected to. For example, if we have a `Query Loop` scoped `inserter` variation with the name `products`, we can connect a scoped `block` variation by setting its `namespace` attribute to `['products']`. If the user selects this variation, the `namespace` attribute will be overridden by the main `inserter` variation. return: {WPBlockVariation[]} The block variations to be suggested in setup flow, when clicking to `start blank`. param: {Object} attributes The block's attributes. |
EnhancedPaginationControl({enhancedPagination,setAttributes,clientId}) X-Ref |
No description |
QueryToolbar({openPatternSelectionModal,name,clientId}) X-Ref |
No description |
OrderControl({order,orderBy,onChange}) X-Ref |
No description |
AuthorControl({value,onChange}) X-Ref |
No description |
ParentControl({parents,postType,onChange}) X-Ref |
No description |
TaxonomyControls({onChange,query}) X-Ref |
No description |
TaxonomyItem({taxonomy,termIds,onChange}) X-Ref |
Renders a `FormTokenField` for a given taxonomy. return: {JSX.Element} The rendered component. param: {Object} props The props for the component. param: {Object} props.taxonomy The taxonomy object. param: {number[]} props.termIds An array with the block's term ids for the given taxonomy. param: {Function} props.onChange Callback `onChange` function. |
formatNamesToValues(names, formats) X-Ref |
No description |
FormatControls({onChange,query: {format}}) X-Ref |
No description |
StickyControl({value,onChange}) X-Ref |
No description |
QueryInspectorControls(props) X-Ref |
No description |
EnhancedPaginationModal({clientId,attributes: {enhancedPagination},setAttributes}) X-Ref |
No description |
QueryContent({attributes,setAttributes,openPatternSelectionModal,name,clientId,context}) X-Ref |
No description |
QueryPlaceholder({attributes,clientId,name,openPatternSelectionModal}) X-Ref |
No description |
QueryVariationPicker({clientId,attributes,icon,label}) X-Ref |
No description |
normalizeSearchInput(input = '') X-Ref |
Sanitizes the search input string. return: {string} The normalized search input. param: {string} input The search input to normalize. |
getPatternSearchRank(pattern, searchValue) X-Ref |
Get the search rank for a given pattern and a specific search term. return: {number} A pattern search rank param: {Object} pattern Pattern to rank param: {string} searchValue Search term |
searchPatterns(patterns = [], searchValue = '') X-Ref |
Filters an pattern list given a search term. return: {Array} Filtered pattern list. param: {Array} patterns Item list param: {string} searchValue Search input. |
PatternSelectionModal({clientId,attributes,setIsPatternSelectionModalOpen}) X-Ref |
No description |
query_save_save({attributes: {tagName: Tag = 'div'}}) X-Ref |
WordPress dependencies |
QueryNoResultsEdit() X-Ref |
No description |
query_no_results_save_save() X-Ref |
WordPress dependencies |
QueryPaginationArrowControls({value,onChange}) X-Ref |
No description |
QueryPaginationLabelControl({value,onChange}) X-Ref |
No description |
edit_QueryPaginationEdit({attributes: {paginationArrow,showLabel},setAttributes,clientId}) X-Ref |
No description |
query_pagination_save_save() X-Ref |
WordPress dependencies |
QueryPaginationNextEdit({attributes: {label},setAttributes,context: {paginationArrow,showLabel}}) X-Ref |
No description |
QueryPaginationNumbersEdit({attributes,setAttributes}) X-Ref |
No description |
QueryPaginationPreviousEdit({attributes: {label},setAttributes,context: {paginationArrow,showLabel}}) X-Ref |
No description |
useArchiveLabel() X-Ref |
WordPress dependencies |
QueryTitleEdit({attributes: {type,level,levelOptions,textAlign,showPrefix,showSearchTerm},setAttributes}) X-Ref |
No description |
QuoteEdit({attributes,setAttributes,insertBlocksAfter,clientId,className,style,isSelected}) X-Ref |
No description |
quote_save_save({attributes}) X-Ref |
No description |
setBlockEditMode(setEditMode, blocks, mode) X-Ref |
No description |
RecursionWarning() X-Ref |
No description |
ReusableBlockEditRecursionWrapper(props) X-Ref |
No description |
ReusableBlockControl({recordId,canOverrideBlocks,hasContent,handleEditOriginal,resetContent}) X-Ref |
No description |
ReusableBlockEdit({name,attributes: {ref,content},__unstableParentLayout: parentLayout,clientId: patternClientId,setAttributes}) X-Ref |
No description |
ReadMore({attributes: {content,linkTarget},setAttributes,insertBlocksAfter}) X-Ref |
No description |
RSSEdit({attributes,setAttributes}) X-Ref |
No description |
toggleAttribute(propName) X-Ref |
No description |
onSubmitURL(event) X-Ref |
No description |
utils_isPercentageUnit(unit) X-Ref |
Returns a boolean whether passed unit is percentage return: {boolean} Whether unit is '%'. param: {string} unit Block width unit. |
SearchEdit({className,attributes,setAttributes,toggleSelection,isSelected,clientId}) X-Ref |
No description |
useDeprecatedOpacity(opacity, currentColor, setAttributes) X-Ref |
WordPress dependencies |
SeparatorEdit({attributes,setAttributes}) X-Ref |
No description |
separatorSave({attributes}) X-Ref |
WordPress dependencies |
ShortcodeEdit({attributes,setAttributes}) X-Ref |
No description |
shortcode_save_save({attributes}) X-Ref |
WordPress dependencies |
onResizeStart() X-Ref |
No description |
onResizeStop() X-Ref |
No description |
SiteLogoReplaceFlow({mediaURL,onRemoveLogo,...mediaReplaceProps}) X-Ref |
No description |
LogoEdit({attributes,className,setAttributes,isSelected}) X-Ref |
No description |
SiteTaglineEdit({attributes,setAttributes,insertBlocksAfter}) X-Ref |
No description |
setTagline(newTagline) X-Ref |
No description |
SiteTitleEdit({attributes,setAttributes,insertBlocksAfter}) X-Ref |
No description |
setTitle(newTitle) X-Ref |
No description |
SocialLinksEdit(props) X-Ref |
No description |
social_links_save_save(props) X-Ref |
WordPress dependencies |
DimensionInput({label,onChange,isResizing,value = ''}) X-Ref |
No description |
SpacerControls({setAttributes,orientation,height,width,isResizing}) X-Ref |
No description |
spacer_save_save({attributes}) X-Ref |
WordPress dependencies |
createTable({rowCount,columnCount}) X-Ref |
Creates a table state. return: {Object} New table state. param: {Object} options param: {number} options.rowCount Row count for the table to create. param: {number} options.columnCount Column count for the table to create. |
getFirstRow(state) X-Ref |
Returns the first row in the table. return: {Object | undefined} The first table row. param: {Object} state Current table state. |
getCellAttribute(state, cellLocation, attributeName) X-Ref |
Gets an attribute for a cell. return: {*} The attribute value. param: {Object} state Current table state. param: {Object} cellLocation The location of the cell param: {string} attributeName The name of the attribute to get the value of. |
updateSelectedCell(state, selection, updateCell) X-Ref |
Returns updated cell attributes after applying the `updateCell` function to the selection. return: {Object} New table state including the updated cells. param: {Object} state The block attributes. param: {Object} selection The selection of cells to update. param: {Function} updateCell A function to update the selected cell attributes. |
isCellSelected(cellLocation, selection) X-Ref |
Returns whether the cell at `cellLocation` is included in the selection `selection`. return: {boolean} True if the cell is selected, false otherwise. param: {Object} cellLocation An object containing cell location properties. param: {Object} selection An object containing selection properties. |
insertRow(state, {sectionName,rowIndex,columnCount}) X-Ref |
Inserts a row in the table state. return: {Object} New table state. param: {Object} state Current table state. param: {Object} options param: {string} options.sectionName Section in which to insert the row. param: {number} options.rowIndex Row index at which to insert the row. param: {number} options.columnCount Column count for the table to create. |
deleteRow(state, {sectionName,rowIndex}) X-Ref |
Deletes a row from the table state. return: {Object} New table state. param: {Object} state Current table state. param: {Object} options param: {string} options.sectionName Section in which to delete the row. param: {number} options.rowIndex Row index to delete. |
insertColumn(state, {columnIndex}) X-Ref |
Inserts a column in the table state. return: {Object} New table state. param: {Object} state Current table state. param: {Object} options param: {number} options.columnIndex Column index at which to insert the column. |
deleteColumn(state, {columnIndex}) X-Ref |
Deletes a column from the table state. return: {Object} New table state. param: {Object} state Current table state. param: {Object} options param: {number} options.columnIndex Column index to delete. |
toggleSection(state, sectionName) X-Ref |
Toggles the existence of a section. return: {Object} New table state. param: {Object} state Current table state. param: {string} sectionName Name of the section to toggle. |
isEmptyTableSection(section) X-Ref |
Determines whether a table section is empty. return: {boolean} True if the table section is empty, false otherwise. param: {Object} section Table section state. |
isEmptyRow(row) X-Ref |
Determines whether a table row is empty. return: {boolean} True if the table section is empty, false otherwise. param: {Object} row Table row state. |
TSection({name,...props}) X-Ref |
No description |
TableEdit({attributes,setAttributes,insertBlocksAfter,isSelected: isSingleSelected}) X-Ref |
No description |
onChangeInitialColumnCount(count) X-Ref |
Updates the initial column count used for table creation. param: {number} count New initial column count. |
onChangeInitialRowCount(count) X-Ref |
Updates the initial row count used for table creation. param: {number} count New initial row count. |
onCreateTable(event) X-Ref |
Creates a table based on dimensions in local state. param: {Object} event Form submit event. |
onChangeFixedLayout() X-Ref |
Toggles whether the table has a fixed layout or not. |
onChange(content) X-Ref |
Changes the content of the currently selected cell. param: {Array} content A RichText content value. |
onChangeColumnAlignment(align) X-Ref |
Align text within the a column. param: {string} align The new alignment to apply to the column. |
getCellAlignment() X-Ref |
Get the alignment of the currently selected cell. return: {string | undefined} The new alignment to apply to the column. |
onToggleHeaderSection() X-Ref |
Add or remove a `head` table section. |
onToggleFooterSection() X-Ref |
Add or remove a `foot` table section. |
onInsertRow(delta) X-Ref |
Inserts a row at the currently selected row index, plus `delta`. param: {number} delta Offset for selected row index at which to insert. |
onInsertRowBefore() X-Ref |
Inserts a row before the currently selected row. |
onInsertRowAfter() X-Ref |
Inserts a row after the currently selected row. |
onDeleteRow() X-Ref |
Deletes the currently selected row. |
onInsertColumn(delta = 0) X-Ref |
Inserts a column at the currently selected column index, plus `delta`. param: {number} delta Offset for selected column index at which to insert. |
onInsertColumnBefore() X-Ref |
Inserts a column before the currently selected column. |
onInsertColumnAfter() X-Ref |
Inserts a column after the currently selected column. |
onDeleteColumn() X-Ref |
Deletes the currently selected column. |
table_save_save({attributes}) X-Ref |
No description |
normalizeRowColSpan(rowColSpan) X-Ref |
Normalize the rowspan/colspan value. Returns undefined if the parameter is not a positive number or the default value (1) for rowspan/colspan. return: {string|undefined} normalized rowspan/colspan value. param: {number|undefined} rowColSpan rowspan/colspan value. |
TableOfContentsList({nestedHeadingList,disableLinkActivation,onClick}) X-Ref |
Internal dependencies |
linearToNestedHeadingList(headingList) X-Ref |
Takes a flat list of heading parameters and nests them based on each header's immediate parent's level. return: The nested list of headings. param: headingList The flat list of headings to nest. |
getLatestHeadings(select, clientId) X-Ref |
No description |
observeCallback(select, dispatch, clientId) X-Ref |
No description |
useObserveHeadings(clientId) X-Ref |
No description |
TableOfContentsEdit({attributes: {headings = [],onlyIncludeCurrentPage},clientId,setAttributes}) X-Ref |
No description |
table_of_contents_save_save({attributes: {headings = []}}) X-Ref |
No description |
TagCloudEdit({attributes,setAttributes}) X-Ref |
No description |
__extends(d, b) X-Ref |
No description |
__() X-Ref |
No description |
__rest(s, e) X-Ref |
No description |
__decorate(decorators, target, key, desc) X-Ref |
No description |
__param(paramIndex, decorator) X-Ref |
No description |
__esDecorate(ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) X-Ref |
No description |
accept(f) X-Ref |
No description |
__runInitializers(thisArg, initializers, value) X-Ref |
No description |
__propKey(x) X-Ref |
No description |
__setFunctionName(f, name, prefix) X-Ref |
No description |
__metadata(metadataKey, metadataValue) X-Ref |
No description |
__awaiter(thisArg, _arguments, P, generator) X-Ref |
No description |
adopt(value) X-Ref |
No description |
fulfilled(value) X-Ref |
No description |
rejected(value) X-Ref |
No description |
step(result) X-Ref |
No description |
__generator(thisArg, body) X-Ref |
No description |
verb(n) X-Ref |
No description |
step(op) X-Ref |
No description |
__exportStar(m, o) X-Ref |
No description |
__values(o) X-Ref |
No description |
__read(o, n) X-Ref |
No description |
__spread() X-Ref |
No description |
__spreadArrays() X-Ref |
No description |
__spreadArray(to, from, pack) X-Ref |
No description |
__await(v) X-Ref |
No description |
__asyncGenerator(thisArg, _arguments, generator) X-Ref |
No description |
awaitReturn(f) X-Ref |
No description |
verb(n, f) X-Ref |
No description |
resume(n, v) X-Ref |
No description |
step(r) X-Ref |
No description |
fulfill(value) X-Ref |
No description |
reject(value) X-Ref |
No description |
settle(f, v) X-Ref |
No description |
__asyncDelegator(o) X-Ref |
No description |
verb(n, f) X-Ref |
No description |
__asyncValues(o) X-Ref |
No description |
verb(n) X-Ref |
No description |
settle(resolve, reject, d, v) X-Ref |
No description |
__makeTemplateObject(cooked, raw) X-Ref |
No description |
__importStar(mod) X-Ref |
No description |
__importDefault(mod) X-Ref |
No description |
__classPrivateFieldGet(receiver, state, kind, f) X-Ref |
No description |
__classPrivateFieldSet(receiver, state, value, kind, f) X-Ref |
No description |
__classPrivateFieldIn(state, receiver) X-Ref |
No description |
__addDisposableResource(env, value, async) X-Ref |
No description |
__disposeResources(env) X-Ref |
No description |
fail(e) X-Ref |
No description |
next() X-Ref |
No description |
localeLowerCase(str, locale) X-Ref |
Localized lower case. |
lowerCase(str) X-Ref |
Lower case as a function. |
noCase(input, options) X-Ref |
Normalize the string into something other libraries can manipulate easier. |
replace(input, re, value) X-Ref |
Replace `re` in the input string with the replacement value. |
upperCaseFirst(input) X-Ref |
Upper case the first character of an input string. |
capitalCaseTransform(input) X-Ref |
No description |
capitalCase(input, options) X-Ref |
No description |
dotCase(input, options) X-Ref |
No description |
paramCase(input, options) X-Ref |
No description |
useAlternativeTemplateParts(area, excludedId) X-Ref |
Retrieves the available template parts for the given area. return: {{ templateParts: Array, isResolving: boolean }} array of template parts. param: {string} area Template part area. param: {string} excludedId Template part ID to exclude. |
useAlternativeBlockPatterns(area, clientId) X-Ref |
Retrieves the available block patterns for the given area. return: {Array} array of block patterns. param: {string} area Template part area. param: {string} clientId Block Client ID. (The container of the block can impact allowed blocks). |
useCreateTemplatePartFromBlocks(area, setAttributes) X-Ref |
No description |
useTemplatePartArea(area) X-Ref |
Retrieves the template part area object. return: {{icon: Object, label: string, tagName: string}} Template Part area. param: {string} area Template part area identifier. |
TitleModal({areaLabel,onClose,onSubmit}) X-Ref |
No description |
TemplatePartPlaceholder({area,clientId,templatePartId,onOpenSelectionModal,setAttributes}) X-Ref |
No description |
mapTemplatePartToBlockPattern(templatePart) X-Ref |
This maps the properties of a template part to those of a block pattern. return: {Object} The template part in the shape of block pattern. param: {Object} templatePart |
TemplatePartSelectionModal({setAttributes,onClose,templatePartId = null,area,clientId}) X-Ref |
No description |
transformWidgetToBlock(widget) X-Ref |
Converts a widget entity record into a block. return: {Object} a block (converted from the entity record). param: {Object} widget The widget entity record. |
switchLegacyWidgetType(block) X-Ref |
Switch Legacy Widget to the first matching transformation block. return: {Object|undefined} a block param: {Object} block Legacy Widget block object |
transformInnerBlocks(innerBlocks = []) X-Ref |
No description |
TemplatePartImportControls({area,setAttributes}) X-Ref |
No description |
TemplatePartAdvancedControls({tagName,setAttributes,isEntityAvailable,templatePartId,defaultWrapper,hasInnerBlocks}) X-Ref |
No description |
useRenderAppender(hasInnerBlocks) X-Ref |
No description |
useLayout(layout) X-Ref |
No description |
NonEditableTemplatePartPreview({postId: id,layout,tagName: TagName,blockProps}) X-Ref |
No description |
EditableTemplatePartInnerBlocks({postId: id,hasInnerBlocks,layout,tagName: TagName,blockProps}) X-Ref |
No description |
TemplatePartInnerBlocks({postId: id,hasInnerBlocks,layout,tagName: TagName,blockProps}) X-Ref |
No description |
ReplaceButton({isEntityAvailable,area,templatePartId,isTemplatePartSelectionOpen,setIsTemplatePartSelectionOpen}) X-Ref |
No description |
TemplatesList({area,clientId,isEntityAvailable,onSelect}) X-Ref |
No description |
TemplatePartEdit({attributes,setAttributes,clientId}) X-Ref |
No description |
getTemplatePartIcon(iconName) X-Ref |
No description |
enhanceTemplatePartVariations(settings, name) X-Ref |
No description |
TermDescriptionEdit({attributes,setAttributes,mergedStyle}) X-Ref |
No description |
TextColumnsEdit({attributes,setAttributes}) X-Ref |
No description |
text_columns_save_save({attributes}) X-Ref |
WordPress dependencies |
VerseEdit({attributes,setAttributes,mergeBlocks,onRemove,insertBlocksAfter,style}) X-Ref |
No description |
verse_save_save({attributes}) X-Ref |
WordPress dependencies |
Tracks({tracks = []}) X-Ref |
No description |
TrackList({tracks,onEditPress}) X-Ref |
No description |
SingleTrackEditor({track,onChange,onClose,onRemove}) X-Ref |
No description |
TracksEditor({tracks = [],onChange}) X-Ref |
No description |
VideoEdit({isSelected: isSingleSelected,attributes,className,setAttributes,insertBlocksAfter,onReplace}) X-Ref |
No description |
onSelectVideo(media) X-Ref |
No description |
onSelectURL(newSrc) X-Ref |
No description |
onUploadError(message) X-Ref |
No description |
onSelectPoster(image) X-Ref |
No description |
onRemovePoster() X-Ref |
No description |
video_save_save({attributes}) X-Ref |
No description |
FootnotesEdit({context: {postType,postId}}) X-Ref |
No description |
rng() X-Ref |
No description |
unsafeStringify(arr, offset = 0) X-Ref |
No description |
stringify(arr, offset = 0) X-Ref |
No description |
v4_v4(options, buf, offset) X-Ref |
No description |
onClick() X-Ref |
No description |
BlockKeyboardShortcuts() X-Ref |
No description |
Generated : Sat Nov 23 08:20:01 2024 | Cross-referenced by PHPXref |