nadar / prosemirror-json-parser
A library that easily converts ProseMirror/TipTap JSON into customizable HTML elements.
Installs: 2 287
Dependents: 1
Suggesters: 0
Security: 0
Stars: 3
Watchers: 3
Forks: 0
Open Issues: 0
Requires
- php: ^8.1
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.2
- phpstan/phpstan: ^1.7
- phpunit/phpunit: ^10
- rector/rector: ^0.14.2
README
The ProseMirror JSON Parser (prosemirror-json-parser) is a versatile PHP library crafted for effortless conversion of ProseMirror/TipTap JSON Model content into HTML. With dependency-free operation and exceptional parsing speed, this library ensures high-performance HTML generation. Seamlessly integrating with TipTap and ProseMirror, it offers customization through easy addition or modification of nodes. Effortlessly install via Composer, utilize the toHtml
function and explore extensive customization options for tailored JSON to HTML conversion.
It functions seamlessly with both TipTap and ProseMirror because TipTap is built upon ProseMirror.
Key Features:
- Dependency-free: No additional libraries required for this parser.
- Exceptional speed: Offers high-performance parsing capabilities.
- Highly extendible: Enables the addition of custom nodes as per your requirements.
- 100% Code Coverage and Testing: Ensures comprehensive test coverage, guaranteeing reliability and stability.
- Robust out-of-the-box HTML generation: Generates high-quality HTML seamlessly without requiring modifications, ensuring ease of use and reliability.
Installation & Usage
To install the library using Composer, execute the following command:
composer require nadar/prosemirror-json-parser
After installing the library, integrate the parser into your project. Utilize the toHtml
function to convert your JSON value into renderable HTML code. Note that the toHtml
function solely accepts an array. Therefore, if your content is in JSON format, employ json_decode($json, true)
to initially convert the JSON string into an array and pass it toHtml(json_decode($json, true))
.
$html = (new Nadar\ProseMirror\Parser()) ->toHtml($json);
Extending & Customizing
Each node corresponds to a callable function within the parser, using the node's name as the key. This setup allows for easy addition or modification of nodes.
For example, to adjust the rendering of the image node, you can include your own function into the parser using the replaceNode()
method:
$html = (new \Nadar\ProseMirror\Parser()) ->replaceNode(\Nadar\ProseMirror\Types::image, fn(\Nadar\ProseMirror\Node $node) => '<img src="' . $node->getAttr('src') . '" class="this-is-my-class" />') ->toHtml($json);
To see all default nodes declared, refer to the
Types
class.
If you have a custom node with a specific name, you can add it to the parser using the addNode()
method:
$html = (new \Nadar\ProseMirror\Parser()) ->addNode('myCustomNode', fn(\Nadar\ProseMirror\Node $node) => '<div class="my-custom-node">...</div>') ->toHtml($json);
The
addNode()
andreplaceNode()
methods are almost identical internally, except thatreplaceNode
should only be used when altering the output of default nodes. You can view all by-default declared nodes in theTypes
class.
The text and image were enhanced by an AI, as English is not my first language and I am quite lazy. Even this sentence was generated by AI.