e8fbfb14c1
Add coexistence checks to all enqueue methods to prevent loading both React and Grid.js assets simultaneously. Changes: - ReactAdmin.php: Only enqueue React assets when ?react=1 - Init.php: Skip Grid.js when React active on admin pages - Form.php, Coupon.php, Access.php: Restore classic assets when ?react=0 - Customer.php, Product.php, License.php: Add coexistence checks Now the toggle between Classic and React versions works correctly. Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
392 lines
8.4 KiB
Markdown
392 lines
8.4 KiB
Markdown
# DOM
|
|
|
|
DOM utilities module for WordPress.
|
|
|
|
## Installation
|
|
|
|
Install the module
|
|
|
|
```bash
|
|
npm install @wordpress/dom --save
|
|
```
|
|
|
|
## API
|
|
|
|
<!-- START TOKEN(Autogenerated API docs) -->
|
|
|
|
### computeCaretRect
|
|
|
|
Get the rectangle for the selection in a container.
|
|
|
|
_Parameters_
|
|
|
|
- _win_ `Window`: The window of the selection.
|
|
|
|
_Returns_
|
|
|
|
- `DOMRect | null`: The rectangle.
|
|
|
|
### documentHasSelection
|
|
|
|
Check whether the current document has a selection. This includes focus in input fields, textareas, and general rich-text selection.
|
|
|
|
_Parameters_
|
|
|
|
- _doc_ `Document`: The document to check.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: True if there is selection, false if not.
|
|
|
|
### documentHasTextSelection
|
|
|
|
Check whether the current document has selected text. This applies to ranges of text in the document, and not selection inside `<input>` and `<textarea>` elements.
|
|
|
|
See: <https://developer.mozilla.org/en-US/docs/Web/API/Window/getSelection#Related_objects>.
|
|
|
|
_Parameters_
|
|
|
|
- _doc_ `Document`: The document to check.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: True if there is selection, false if not.
|
|
|
|
### documentHasUncollapsedSelection
|
|
|
|
Check whether the current document has any sort of (uncollapsed) selection. This includes ranges of text across elements and any selection inside textual `<input>` and `<textarea>` elements.
|
|
|
|
_Parameters_
|
|
|
|
- _doc_ `Document`: The document to check.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: Whether there is any recognizable text selection in the document.
|
|
|
|
### focus
|
|
|
|
Object grouping `focusable` and `tabbable` utils under the keys with the same name.
|
|
|
|
### getFilesFromDataTransfer
|
|
|
|
Gets all files from a DataTransfer object.
|
|
|
|
_Parameters_
|
|
|
|
- _dataTransfer_ `DataTransfer`: DataTransfer object to inspect.
|
|
|
|
_Returns_
|
|
|
|
- `File[]`: An array containing all files.
|
|
|
|
### getOffsetParent
|
|
|
|
Returns the closest positioned element, or null under any of the conditions of the offsetParent specification. Unlike offsetParent, this function is not limited to HTMLElement and accepts any Node (e.g. Node.TEXT_NODE).
|
|
|
|
_Related_
|
|
|
|
- <https://drafts.csswg.org/cssom-view/#dom-htmlelement-offsetparent>
|
|
|
|
_Parameters_
|
|
|
|
- _node_ `Node`: Node from which to find offset parent.
|
|
|
|
_Returns_
|
|
|
|
- `Node | null`: Offset parent.
|
|
|
|
### getPhrasingContentSchema
|
|
|
|
Get schema of possible paths for phrasing content.
|
|
|
|
_Related_
|
|
|
|
- <https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content>
|
|
|
|
_Parameters_
|
|
|
|
- _context_ `[string]`: Set to "paste" to exclude invisible elements and sensitive data.
|
|
|
|
_Returns_
|
|
|
|
- `Partial<ContentSchema>`: Schema.
|
|
|
|
### getRectangleFromRange
|
|
|
|
Get the rectangle of a given Range. Returns `null` if no suitable rectangle can be found.
|
|
|
|
_Parameters_
|
|
|
|
- _range_ `Range`: The range.
|
|
|
|
_Returns_
|
|
|
|
- `DOMRect?`: The rectangle.
|
|
|
|
### getScrollContainer
|
|
|
|
Given a DOM node, finds the closest scrollable container node or the node itself, if scrollable.
|
|
|
|
_Parameters_
|
|
|
|
- _node_ `Element | null`: Node from which to start.
|
|
- _direction_ `?string`: Direction of scrollable container to search for ('vertical', 'horizontal', 'all'). Defaults to 'vertical'.
|
|
|
|
_Returns_
|
|
|
|
- `Element | undefined`: Scrollable container node, if found.
|
|
|
|
### insertAfter
|
|
|
|
Given two DOM nodes, inserts the former in the DOM as the next sibling of the latter.
|
|
|
|
_Parameters_
|
|
|
|
- _newNode_ `Node`: Node to be inserted.
|
|
- _referenceNode_ `Node`: Node after which to perform the insertion.
|
|
|
|
_Returns_
|
|
|
|
- `void`:
|
|
|
|
### isEmpty
|
|
|
|
Recursively checks if an element is empty. An element is not empty if it contains text or contains elements with attributes such as images.
|
|
|
|
_Parameters_
|
|
|
|
- _element_ `Element`: The element to check.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: Whether or not the element is empty.
|
|
|
|
### isEntirelySelected
|
|
|
|
Check whether the contents of the element have been entirely selected. Returns true if there is no possibility of selection.
|
|
|
|
_Parameters_
|
|
|
|
- _element_ `HTMLElement`: The element to check.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: True if entirely selected, false if not.
|
|
|
|
### isFormElement
|
|
|
|
Detects if element is a form element.
|
|
|
|
_Parameters_
|
|
|
|
- _element_ `Element`: The element to check.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: True if form element and false otherwise.
|
|
|
|
### isHorizontalEdge
|
|
|
|
Check whether the selection is horizontally at the edge of the container.
|
|
|
|
_Parameters_
|
|
|
|
- _container_ `HTMLElement`: Focusable element.
|
|
- _isReverse_ `boolean`: Set to true to check left, false for right.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: True if at the horizontal edge, false if not.
|
|
|
|
### isNumberInput
|
|
|
|
Check whether the given element is an input field of type number.
|
|
|
|
_Parameters_
|
|
|
|
- _node_ `Node`: The HTML node.
|
|
|
|
_Returns_
|
|
|
|
- `node is HTMLInputElement`: True if the node is number input.
|
|
|
|
### isPhrasingContent
|
|
|
|
Find out whether or not the given node is phrasing content.
|
|
|
|
_Related_
|
|
|
|
- <https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content>
|
|
|
|
_Parameters_
|
|
|
|
- _node_ `Node`: The node to test.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: True if phrasing content, false if not.
|
|
|
|
### isRTL
|
|
|
|
Whether the element's text direction is right-to-left.
|
|
|
|
_Parameters_
|
|
|
|
- _element_ `Element`: The element to check.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: True if rtl, false if ltr.
|
|
|
|
### isTextContent
|
|
|
|
_Parameters_
|
|
|
|
- _node_ `Node`:
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: Node is text content
|
|
|
|
### isTextField
|
|
|
|
Check whether the given element is a text field, where text field is defined by the ability to select within the input, or that it is contenteditable.
|
|
|
|
See: <https://html.spec.whatwg.org/#textFieldSelection>
|
|
|
|
_Parameters_
|
|
|
|
- _node_ `Node`: The HTML element.
|
|
|
|
_Returns_
|
|
|
|
- `node is HTMLElement`: True if the element is an text field, false if not.
|
|
|
|
### isVerticalEdge
|
|
|
|
Check whether the selection is vertically at the edge of the container.
|
|
|
|
_Parameters_
|
|
|
|
- _container_ `HTMLElement`: Focusable element.
|
|
- _isReverse_ `boolean`: Set to true to check top, false for bottom.
|
|
|
|
_Returns_
|
|
|
|
- `boolean`: True if at the vertical edge, false if not.
|
|
|
|
### placeCaretAtHorizontalEdge
|
|
|
|
Places the caret at start or end of a given element.
|
|
|
|
_Parameters_
|
|
|
|
- _container_ `HTMLElement`: Focusable element.
|
|
- _isReverse_ `boolean`: True for end, false for start.
|
|
|
|
### placeCaretAtVerticalEdge
|
|
|
|
Places the caret at the top or bottom of a given element.
|
|
|
|
_Parameters_
|
|
|
|
- _container_ `HTMLElement`: Focusable element.
|
|
- _isReverse_ `boolean`: True for bottom, false for top.
|
|
- _rect_ `[DOMRect]`: The rectangle to position the caret with.
|
|
|
|
### remove
|
|
|
|
Given a DOM node, removes it from the DOM.
|
|
|
|
_Parameters_
|
|
|
|
- _node_ `Node`: Node to be removed.
|
|
|
|
_Returns_
|
|
|
|
- `void`:
|
|
|
|
### removeInvalidHTML
|
|
|
|
Given a schema, unwraps or removes nodes, attributes and classes on HTML.
|
|
|
|
_Parameters_
|
|
|
|
- _HTML_ `string`: The HTML to clean up.
|
|
- _schema_ `import('./clean-node-list').Schema`: Schema for the HTML.
|
|
- _inline_ `boolean`: Whether to clean for inline mode.
|
|
|
|
_Returns_
|
|
|
|
- `string`: The cleaned up HTML.
|
|
|
|
### replace
|
|
|
|
Given two DOM nodes, replaces the former with the latter in the DOM.
|
|
|
|
_Parameters_
|
|
|
|
- _processedNode_ `Element`: Node to be removed.
|
|
- _newNode_ `Element`: Node to be inserted in its place.
|
|
|
|
_Returns_
|
|
|
|
- `void`:
|
|
|
|
### replaceTag
|
|
|
|
Replaces the given node with a new node with the given tag name.
|
|
|
|
_Parameters_
|
|
|
|
- _node_ `Element`: The node to replace
|
|
- _tagName_ `string`: The new tag name.
|
|
|
|
_Returns_
|
|
|
|
- `Element`: The new node.
|
|
|
|
### safeHTML
|
|
|
|
Strips scripts and on\* attributes from HTML.
|
|
|
|
_Parameters_
|
|
|
|
- _html_ `string`: HTML to sanitize.
|
|
|
|
_Returns_
|
|
|
|
- `string`: The sanitized HTML.
|
|
|
|
### unwrap
|
|
|
|
Unwrap the given node. This means any child nodes are moved to the parent.
|
|
|
|
_Parameters_
|
|
|
|
- _node_ `Node`: The node to unwrap.
|
|
|
|
_Returns_
|
|
|
|
- `void`:
|
|
|
|
### wrap
|
|
|
|
Wraps the given node with a new node with the given tag name.
|
|
|
|
_Parameters_
|
|
|
|
- _newNode_ `Element`: The node to insert.
|
|
- _referenceNode_ `Element`: The node to wrap.
|
|
|
|
<!-- END TOKEN(Autogenerated API docs) -->
|
|
|
|
## Contributing to this package
|
|
|
|
This is an individual package that's part of the Gutenberg project. The project is organized as a monorepo. It's made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to [npm](https://www.npmjs.com/) and used by [WordPress](https://make.wordpress.org/core/) as well as other software projects.
|
|
|
|
To find out more about contributing to this package or Gutenberg as a whole, please read the project's main [contributor guide](https://github.com/WordPress/gutenberg/tree/HEAD/CONTRIBUTING.md).
|
|
|
|
<br /><br /><p align="center"><img src="https://s.w.org/style/images/codeispoetry.png?1" alt="Code is Poetry." /></p>
|