ueberdosis/tiptap-php là dự án PHP với 275 sao trong nhóm Backend. A PHP package to work with Tiptap content
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
A PHP package to work with Tiptap content. You can transform Tiptap-compatible JSON to HTML, and the other way around, sanitize your content, or just modify it.
Installation
You can install the package via composer:
composer require ueberdosis/tiptap-php
Usage
The PHP package mimics large parts of the JavaScript package. If you know your way around Tiptap, the PHP syntax will feel familiar to you.
Convert Tiptap HTML to JSON
Let’s start by converting a HTML snippet to a PHP array with a Tiptap-compatible structure:
This doesn’t fully adhere to the ProseMirror schema. Some things are supported too, for example aren’t marks allowed in a CodeBlock.
If you need better schema support, create an issue with the feature you’re missing.
Syntax highlighting for code blocks with highlight.php
The default CodeBlock extension doesn’t add syntax highlighting to your code blocks. However, if you want to add syntax highlighting to your code blocks, there’s a special CodeBlockHighlight extension.
Swapping our the default one works like that:
(new \Tiptap\Editor([
'extensions' => [
new \Tiptap\Extensions\StarterKit([
'codeBlock' => false,
]),
new \Tiptap\Nodes\CodeBlockHighlight(),
],
]))
->setContent('<pre><code><?php phpinfo()</code></pre>')
->getHTML();
// Returns:
// <pre><code class="hljs php"><span class="hljs-meta"><?php</span> phpinfo()</code></pre>
This is still unstyled. You need to load a CSS file to add colors to the output, for example like that:
Boom, syntax highlighting! By the way, this is powered by the amazing scrivo/highlight.php.
Syntax highlighting for code blocks with Shiki (Requires Node.js)
There is an alternate syntax highlighter that utilizes Shiki. Shiki is a beautiful syntax highlighter powered by the same language engine that many code editors use. The major differences from the CodeBlockHighlight extensions are:
you must install the shiki npm package.
Shiki code highlighting works by injecting inline styles so pulling in a external css file is not required.
you can use most VS Code themes to highlight your code.
To use the Shiki extension, first install the npm package
npm install shiki
Then follow the example below:
(new \Tiptap\Editor([
'extensions' => [
new \Tiptap\Extensions\StarterKit([
'codeBlock' => false,
]),
new \Tiptap\Nodes\CodeBlockShiki(),
],
]))
->setContent('<pre><code><?php phpinfo()</code></pre>')
->getHTML();
To configure the theme or default language for code blocks pass additonal configuration into the constructor as show below:
(new \Tiptap\Editor([
'extensions' => [
new \Tiptap\Extensions\StarterKit([
'codeBlock' => false,
]),
new \Tiptap\Nodes\CodeBlockShiki([
'theme' => 'github-dark', // default: nord, see https://github.com/shikijs/shiki/blob/main/docs/themes.md
'defaultLanguage' => 'php', // default: html, see https://github.com/shikijs/shiki/blob/main/docs/languages.md
'guessLanguage' => true, // default: true, if the language isn’t passed, it tries to guess the language with highlight.php
]),
],
]))
->setContent('<pre><code><?php phpinfo()</code></pre>')
->getHTML();
Under the hood the Shiki extension utilizes Shiki PHP by Spatie, so please see the documentation for additional details and considerations.
Convert content to plain text
Content can also be transformed to plain text, for example to put it into a search index.
A great use case for the PHP package is to clean (or “sanitize”) the content. You can do that with the sanitize() method. Works with JSON strings, PHP arrays and HTML.
It’ll return the same format you’re using as the input format.
(new \Tiptap\Editor)
->sanitize('<p>Example Text<script>alert("HACKED!")</script></p>');
// Returns:
// '<p>Example Text</p>'
Modifying the content
With the descendants() method you can loop through all nodes recursively as you are used to from the JavaScript package. But in PHP, you can even modify the node to update attributes and all that.
Warning: You need to add & to the parameter. Thats keeping a reference to the original item and allows to modify the original one, instead of just a copy.
Pass the configuration to the constructor of the editor. There’s not much to configure, but at least you can pass the initial content and load specific extensions.
new \Tiptap\Editor([
'content' => '<p>Example Text</p>',
'extensions' => [
new \Tiptap\Extensions\StarterKit,
],
])
The StarterKit is loaded by default. If you just want to use that, there’s no need to set it.
Extensions
By default, the StarterKit is loaded, but you can pass a custom array of extensions aswell.
new \Tiptap\Editor([
'extensions' => [
new \Tiptap\Extensions\StarterKit,
new \Tiptap\Marks\Link,
],
])
Configure extensions
Some extensions can be configured. Just pass an array to the constructor, that’s it. We’re aiming to support the same configuration as the JavaScript package.
new \Tiptap\Editor([
'extensions' => [
// …
new \Tiptap\Nodes\Heading([
'levels' => [1, 2, 3],
]),
],
])
You can pass custom HTML attributes through the configuration, too.
new \Tiptap\Editor([
'extensions' => [
// …
new \Tiptap\Nodes\Heading([
'HTMLAttributes' => [
'class' => 'my-custom-class',
],
]),
],
])
For the StarterKit, it’s slightly different, but works as you are used to from the JavaScript package.
If you need to change minor details of the supported extensions, you can just extend an extension.
<?php
class CustomBold extends \Tiptap\Marks\Bold
{
public function renderHTML($mark)
{
// Renders <b> instead of <strong>
return ['b', 0]
}
}
new \Tiptap\Editor([
'extensions' => [
new Paragraph,
new Text,
new CustomBold,
],
])
Custom extensions
You can even build custom extensions. If you are used to the JavaScript API, you will be surprised how much of that works in PHP, too. 🤯 Find a simple example below.
Make sure to dig through the extensions in this repository to learn more about the PHP extension API.
<?php
use Tiptap\Core\Node;
class CustomNode extends Node
{
public static $name = 'customNode';
public static $priority = 100;
public function addOptions()
{
return [
'HTMLAttributes' => [],
];
}
public function parseHTML()
{
return [
[
'tag' => 'my-custom-tag[data-id]',
],
[
'tag' => 'my-custom-tag',
'getAttrs' => function ($DOMNode) {
return ! \Tiptap\Utils\InlineStyle::hasAttribute($DOMNode, [
'background-color' => '#000000',
]) ? null : false;
},
],
[
'style' => 'background-color',
'getAttrs' => function ($value) {
return (bool) preg_match('/^(black)$/', $value) ? null : false;
},
],
];
}
public function renderHTML($node)
{
return ['my-custom-tag', ['class' => 'foobar'], 0]
}
}
Extension priority
Extensions are evaluated in the order of descending priority. By default, all Nodes, Marks, and Extensions, have a priority value of 100.
Priority should be defined when creating a Node extension to match markup that could be matched be other Nodes - an example of this is the TaskItem Node which has evaluation priority over the ListItem Node.
Testing
composer test
You can install nodemon (npm install -g nodemon) to keep the test suite running and watch for file changes:
composer test-watch
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
Hans Pagel
All Contributors
License
The MIT License (MIT). Please see License File for more information.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/ueberdosis/tiptap-php là nguồn chính thức.
ueberdosis/tiptap-php có bao nhiêu sao?
ueberdosis/tiptap-php có 275 sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/ueberdosis/tiptap-php. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
ueberdosis/tiptap-php có những chủ đề gì?
GitHub topics của ueberdosis/tiptap-php: "php", "prosemirror", "tiptap". TopGit xếp repo vào nhóm Backend.
ueberdosis/tiptap-php có trang demo không?
Dự án có trang chủ ở https://tiptap.dev. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
ueberdosis/tiptap-php còn đang phát triển không?
Commit gần nhất trên ueberdosis/tiptap-php là 6 ngày trước (theo timestamp GitHub). Repo có 45 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
ueberdosis/tiptap-php dùng license gì?
ueberdosis/tiptap-php phát hành theo license MIT. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
ueberdosis/tiptap-php viết bằng ngôn ngữ gì?
ueberdosis/tiptap-php chủ yếu viết bằng PHP. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Đọc đầy đủ README ở tab phía trên.
Vẫn đang phân vân về tiptap-php?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về tiptap-php.