基于Java和Bytemd用120行代码实现一个桌面版Markdown编辑器
Posted Java知音_
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了基于Java和Bytemd用120行代码实现一个桌面版Markdown编辑器相关的知识,希望对你有一定的参考价值。
前提
某一天点开掘金的写作界面的时候,发现了内置Markdown
编辑器有一个Github
的图标,点进去就是一个开源的Markdown
编辑器项目bytemd
(https://github.com/bytedance/bytemd
):
这是一个NodeJs
项目,由字节跳动提供。联想到之前业余的时候做过一些Swing
或者JavaFx
的Demo
,记得JavaFx
中有一个组件WebView
已经支持html5
、CSS3
和ES5
,这个组件作为一个嵌入式浏览器,可以轻松地渲染一个URL
里面的文本内容或者直接渲染一个原始的Html
字符串。另外,由于原生的JavaFx
的视觉效果比较丑,可以考虑引入Swing
配合IntelliJ IDEA
的主题提供更好的视觉效果。本文的代码基于JDK11
开发。
引入依赖
很多人吐槽过Swing
组件的视觉效果比较差,原因有几个:
技术小众,现在有更好的组件进行混合开发和跨平台开发
基于上一点原因,导致很少人会去开发
Swing
组件的UI
,其实Swing
的每个组件都可以重新实现UI
的表现效果compose-jb
(JetBrains
)组件很晚才发布出来,刚好碰上Swing
官方停止维护,后面应该更加少人会使用Swing
做GUI
开发
使用Swing
并且成功了的方案最知名的就是JetBrains
全家桶。目前来看,为了解决这个"丑"的问题,现在有比较简单的处理方案:
方案一:使用
compose-jb
(名字有点不好听,官方仓库为https://github.com/JetBrains/compose-jb
)开发,这个是JetBrains
系列的通用组件,基于Swing
做二次封装,「不过必须使用语言Kotlin
,有点强买强卖的嫌疑」,这列贴两个官方的图参考一下:
方案二:
FormDev
(之前推出过Swing
布局器的开发商,官网https://www.formdev.com/flatlaf
)提供的FlatLaf
(Flat Look and Feel
),提供了Light Dark IntelliJ and Darcula themes
,而且依赖少,使用起来十分简单,个人认为当前这个是Swing UI
组件视觉效果首选
引入FlatLaf
和OpenFx
的依赖:
<dependency>
<groupId>com.formdev</groupId>
<artifactId>flatlaf</artifactId>
<version>1.5</version>
</dependency>
<dependency>
<groupId>com.formdev</groupId>
<artifactId>flatlaf-intellij-themes</artifactId>
<version>1.5</version>
</dependency>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-media</artifactId>
<version>11.0.2</version>
</dependency>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-swing</artifactId>
<version>11.0.2</version>
</dependency>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-web</artifactId>
<version>11.0.2</version>
</dependency>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-base</artifactId>
<version>11.0.2</version>
</dependency>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-graphics</artifactId>
<version>11.0.2</version>
</dependency>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-controls</artifactId>
<version>11.0.2</version>
</dependency>
布局和实现
布局的实现比较简单:
最终的H5
文本渲染在WebView
组件中(JFXPanel
是JavaFx => Swing
的适配器,WebView
是JavaFx
的组件,但是这里使用的外层容器都是Swing
组件),具体的编码实现如下:
public class MarkdownEditor {
private static final int W = 1200;
private static final int H = 1000;
private static final String TITLE = "markdown editor";
public static String CONTENT = "<!DOCTYPE html>\\n" +
"<html lang=\\"en\\">\\n" +
"<head>\\n" +
" <meta charset=\\"UTF-8\\"/>\\n" +
" <meta name=\\"viewport\\" content=\\"width=device-width, initial-scale=1.0\\"/>\\n" +
" <title>ByteMD example</title>\\n" +
" <link rel=\\"stylesheet\\" href=\\"https://unpkg.com/bytemd/dist/index.min.css\\"/>\\n" +
" <link rel=\\"stylesheet\\" href=\\"https://unpkg.com/github-markdown-css\\"/>\\n" +
" <script src=\\"https://unpkg.com/bytemd\\"></script>\\n" +
" <script src=\\"https://unpkg.com/@bytemd/plugin-gfm\\"></script>\\n" +
" <script src=\\"https://unpkg.com/@bytemd/plugin-highlight\\"></script>\\n" +
" <style>\\n" +
" .bytemd {\\n" +
" height: calc(100vh - 50px);\\n" +
" }\\n" +
"\\n" +
" .footer {\\n" +
" width: 100%;\\n" +
" height: 30px;\\n" +
" left: 0;\\n" +
" position: absolute;\\n" +
" bottom: 0;\\n" +
" text-align: center;\\n" +
" }\\n" +
" </style>\\n" +
"</head>\\n" +
"<body>\\n" +
"<div class=\\"footer\\">\\n" +
" <a href=\\"https://github.com/bytedance/bytemd\\">bytemd</a>\\n" +
"</div>\\n" +
"<script>\\n" +
" const plugins = [bytemdPluginGfm(), bytemdPluginHighlight()];\\n" +
" const editor = new bytemd.Editor({\\n" +
" target: document.body,\\n" +
" props: {\\n" +
" value: '# heading\\\\n\\\\nparagraph\\\\n\\\\n> blockquote',\\n" +
" plugins,\\n" +
" },\\n" +
" });\\n" +
" editor.$on('change', (e) => {\\n" +
" editor.$set({value: e.detail.value});\\n" +
" });\\n" +
"</script>\\n" +
"</body>\\n" +
"</html>";
static {
// 初始化主题
try {
UIManager.setLookAndFeel(FlatIntelliJLaf.class.getName());
} catch (Exception e) {
throw new IllegalStateException("theme init error", e);
}
}
private static JFrame buildFrame(int w, int h, LayoutManager layoutManager) {
JFrame frame = new JFrame();
frame.setLayout(layoutManager);
frame.setTitle(TITLE);
frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
frame.setSize(w, h);
Toolkit toolkit = Toolkit.getDefaultToolkit();
int x = (int) (toolkit.getScreenSize().getWidth() - frame.getWidth()) / 2;
int y = (int) (toolkit.getScreenSize().getHeight() - frame.getHeight()) / 2;
frame.setLocation(x, y);
return frame;
}
private static void initAndDisplay() {
// 构建窗体
JFrame frame = buildFrame(W, H, new BorderLayout());
JFXPanel panel = new JFXPanel();
Platform.runLater(() -> {
panel.setSize(W, H);
initWebView(panel, CONTENT);
frame.getContentPane().add(panel);
});
frame.setVisible(true);
}
public static void main(String[] args) {
SwingUtilities.invokeLater(MarkdownEditor::initAndDisplay);
}
private static void initWebView(JFXPanel fxPanel, String content) {
StackPane root = new StackPane();
Scene scene = new Scene(root);
WebView webView = new WebView();
WebEngine webEngine = webView.getEngine();
webEngine.setjavascriptEnabled(true);
webEngine.loadContent(content);
root.getChildren().add(webView);
fxPanel.setScene(scene);
}
}
H5
文本来源于bytemd
的原生JS
实现例子:
所有代码加上注释大概120
多行。使用JDK11
运行,结果如下:
目前有2
个没有解决的问题(也有可能是):
JS
的动作触发有轻微延迟WebView
组件初始化比较慢
小结
Oracle JDK
官方已经宣布不再维护Swing
项目,按照一般的尿性后面有可能从JDK
中移除,也许是因为它体现不了自身的价值(低情商:不赚钱)。Swing
的开发中布局是比较反人类的,一般可能一个Swing
项目布局会耗费90%
以上的时间,原生组件的UI
设计看上去比较"丑",没有丰富的扩展组件和活跃的社区,加上现在有其他更好的跨平台开发方案如Qt
、React Native
和Flutter
等等,Swing
被遗忘是一个既定的结局。往后除了一枝独秀的JetBrains
,Swing
的结局就是成为少数人业务的爱好,成为JDK GUI
编程爱好者的收藏品。
Demo
源码:
local-markdown-editor(
https://gitee.com/throwableDoge/local-markdown-editor
)
(本文完 e-a-20210815 c-1-d)
推荐:
PS:因为公众号平台更改了推送规则,如果不想错过内容,记得读完点一下“在看”,加个“星标”,这样每次新文章推送才会第一时间出现在你的订阅列表里。点“在看”支持我们吧!
以上是关于基于Java和Bytemd用120行代码实现一个桌面版Markdown编辑器的主要内容,如果未能解决你的问题,请参考以下文章