定制 broqit/editorjs-simple-html-parser 二次开发

按需修改功能、优化性能、对接业务系统,提供一站式技术支持

邮箱:yvsm@zunyunkeji.com | QQ:316430983 | 微信:yvsm316

broqit/editorjs-simple-html-parser

Composer 安装命令:

composer require broqit/editorjs-simple-html-parser

包简介

A simple Json to Html parser for EditorJS library

README 文档

README

codecov License: GPL v3

Simple PHP Parser for Editor.js

Parse data for Editor.js with 2 way:

  1. Parse JSON data to HTML
  2. Parse HTML to JSON data

Supported Tools

Package Key Main CSS Class
(with default prefix)
Additional / modificator CSS classes
(with default prefix)
@editorjs/header
editorjs-header-with-alignment
header .prs-header alignment:
.prs_left
.prs_right
.prs_center
.prs_justify
@editorjs/paragraph
editorjs-paragraph-with-alignment
paragraph .prs-paragraph alignment:
.prs_left
.prs_right
.prs_center
.prs_justify
@editorjs/inline-code
@editorjs/marker
@editorjs/underline
@editorjs/list list .prs-list additional:
.prs_ordered
@editorjs/raw raw
@editorjs/simple-image simpleImage .prs-image additional:
.prs_withborder
.prs_withbackground
.prs_stretched
@editorjs/embed embed .prs-embed additional:
.prs_youtube
.prs_codepen
.prs_vimeo
@editorjs/link linkTool .prs-linktool additional:
.prs_title
.prs_description
.prs_sitename
@editorjs/delimiter delimiter .prs-delimiter
editorjs-alert alert .prs-alert alignment:
.prs_left
.prs_right
.prs_center
additional:
.prs_primary
.prs_secondary
.prs_info
.prs_success
.prs_warning
.prs_danger
.prs_light
.prs_dark
@editorjs/warning warning .prs-warning
@editorjs/table table .prs-table additional:
.prs_withheadings
@editorjs/quote quote .prs-quote alignment:
.prs_left
.prs_center
@editorjs/code code .prs-code

Installation

composer require broqit/editorjs-simple-html-parser

1. JSON to HTML Parser

Usage

use Durlecode\EJSParser\Parser;

$html = Parser::parse($data)->toHtml();

Where $data is the clean JSON data coming from Editor.js See $data example below

{
    "time" : 1583848289745,
    "blocks" : [
        {
            "type" : "header",
            "data" : {
                "text" : "Hello World",
                "level" : 2
            }
        }
    ],
    "version" : "2.16.1"
}

By default this will generate html with css classes with prs prefix, so if you want to change it, follow example below

use Durlecode\EJSParser\Parser;

$parser = new Parser($data);

$parser->setPrefix("cat");

$parsed = $parser->toHtml();

Methods

toHtml()

Return generated HTML

setPrefix(string $prefix)

Set CSS classes Prefix

getPrefix()

Return current prefix

getVersion()

Return Editor.js content version

getTime()

Return Editor.js content timestamp

getBlocks()

Return Editor.js content blocks

Generated HTML

Header
<h2 class="prs-header prs_center">Lorem</h2>
Paragraph
<p class="prs-paragraph prs_center">
    <code class="inline-code">Pellentesque</code> 
    <i>malesuada fames</i> 
    <mark class="cdx-marker">tempus</mark>
</p>
Ordered List
<ol class="prs-list prs_ordered">
    <li></li>
</ol>
Unordered List
<ul class="prs-list">
    <li></li>
</ul>
Table
<table class="prs-table prs_withheadings">
    <thead>
        <tr>
            <th>1</th><th>2</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>a</td><td>b</td>
        </tr>
    </tbody>
</table>
Code
<pre class="prs-code">
    <code></code>
</pre>
Embed
(Actually working with Youtube, Codepen & Gfycat)
<figure class="prs-embed prs_youtube">
    <iframe width="580" height="320" src="https://www.youtube.com/embed/CwXOrWvPBPk" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen="1"></iframe>
    <figcaption>Shrek (2001) Trailer</figcaption>
</figure>
Delimiter
<hr class="prs-delimiter">
LinkTool
<figure class="prs-linkTool">
    <a href="https://github.com/" target="_blank">
       <img src="https://example.com/cat.png" alt="">
       <p class="prs_title">Title</p>
       <p class="prs_description">Description</p>
       <p class="prs_sitename">example.com</p>
    </a>
</figure>
Image
<figure class="prs-image prs_withborder prs_withbackground prs_stretched">
    <img src="" alt="">
    <figcaption></figcaption>
</figure>
Quote
<figure class="prs-quote prs_center">
    <blockquote></blockquote>
    <figcaption></figcaption>
</figure>
Warning
<div class="prs-warning">
    <i></i>
    <h4>Title</h4>
    <p>Message</p>
</div>
Alert
<p class="prs-alert prs_center prs_success">
    Alert!
</p>
Raw
<div class="prs-raw">
    Raw HTML ...
</div>

2. HTML to JSON Parser

Usage

use Durlecode\EJSParser\HtmlParser;

$parser = new HtmlParser($html);

$blocks = $parser->toBlocks();

header("Content-Type: application/json");
echo $blocks;

Where $html is the HTML specially tagged with CSS classes See examples of the generated HTML code above

By default this will parse html with css classes with prs prefix, so if you want to change it, follow example below

use Durlecode\EJSParser\HtmlParser;

$parser = new HtmlParser($html);

$parser->setPrefix("cat");

$blocks = $parser->toBlocks();

You may set time and version EditorJS generated blocks By default: time generate auto, EditorJS version pass from config.php:

use Durlecode\EJSParser\HtmlParser;

$parser = new HtmlParser($html);

$parser->setTime("1703787424242");
$parser->setVersion("2.28.8");

$blocks = $parser->toBlocks();

Methods

toBlocks()

Return generated EditorJS Blocks

setPrefix(string $prefix)

Set CSS classes Prefix

getPrefix()

Return current prefix

setVersion(string $version)

Set Editor.js content version

getVersion()

Return Editor.js content version

getTime()

Return Editor.js content timestamp

setTime(string $time)

Set Editor.js content timestamp

broqit/editorjs-simple-html-parser 适用场景与选型建议

broqit/editorjs-simple-html-parser 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 203 次下载、GitHub Stars 达 0, 最近一次更新时间为 2024 年 08 月 18 日, 在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 broqit/editorjs-simple-html-parser 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。

围绕 broqit/editorjs-simple-html-parser 我们能提供哪些服务?
定制开发 / 二次开发

基于 broqit/editorjs-simple-html-parser 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ:316430983 微信:yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

统计信息

  • 总下载量: 203
  • 月度下载量: 0
  • 日度下载量: 0
  • 收藏数: 0
  • 点击次数: 9
  • 依赖项目数: 0
  • 推荐数: 0

GitHub 信息

  • Stars: 0
  • Watchers: 0
  • Forks: 13
  • 开发语言: PHP

其他信息

  • 授权协议: MIT
  • 更新时间: 2024-08-18