Qt官方示例-Markdown編輯器

基於QWebEngineView與QWebChannel實現的Markdown編輯器。

main_page

0x00 原理

  Markdown編輯器演示瞭如何使用QWebChannelJavaScript庫爲自定義標記語言提供富文本預覽工具。css

  Markdown是一種輕量級的標記語言,具備純文本格式語法。能夠在瀏覽器中查看時將內容呈現爲富文本格式html

  Markdown編輯器主窗口分爲編輯區域預覽區域web

  • 編輯區域(左欄):

該編輯器區域使用QPlainTextEdit實現。瀏覽器

  • 預覽區域(右欄):

預覽區域使用QWebEngineView實現的。爲了呈現文本,藉助Web引擎內部的JavaScript庫,將Markdown文本轉換爲HTML格式。預覽是經過QWebChannel發送編輯區域的文本內容到QWebEngineView渲染(支持邊編輯邊渲染更新)。markdown

0x01 實現

  • 爲編輯區域加載markdown格式文件。
QFile defaultTextFile(":/default.md");
defaultTextFile.open(QIODevice::ReadOnly);
ui->editor->setPlainText(defaultTextFile.readAll());
  • 使用QWebChannel綁定page(QWebEngineView)對文本進行更新。
connect(ui->editor, &QPlainTextEdit::textChanged,
        [this]() { m_content.setText(ui->editor->toPlainText()); });

QWebChannel *channel = new QWebChannel(this);
channel->registerObject(QStringLiteral("content"), &m_content);
page->setWebChannel(channel);
  • 加載網頁文件用於接收ui->editor(QPlainTextEdit)的內容。
ui->preview->setUrl(QUrl("qrc:/index.html"));
  • index.html中,咱們加載一個自定義樣式表和兩個JavaScript庫。markdown.css是由Kevin Burke建立的markdown友好樣式表。marked.js是Markdown解析器和編譯器,由Christopher Jeffrey編寫,旨在提升速度,而qwebchannel.js是QWebChannel模塊的一部分(用於數據交互)。
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<head>
  <link rel="stylesheet" type="text/css" href="3rdparty/markdown.css">
  <script src="3rdparty/marked.js"></script>
  <script src="qrc:/qtwebchannel/qwebchannel.js"></script>
</head>
<body>
  <div id="placeholder"></div>
  <script>
  'use strict';

  var placeholder = document.getElementById('placeholder');

  var updateText = function(text) {
      placeholder.innerHTML = marked(text); 
  }

  new QWebChannel(qt.webChannelTransport,
    function(channel) {
      var content = channel.objects.content;
      updateText(content.text);
      content.textChanged.connect(updateText);
    }
  );
  </script>
</body>
</html>
  • uml簡圖

uml

0x02 關於更多

  • QtCreator軟件能夠找到:

what_find

  • 或在如下Qt安裝目錄找到
C:\Qt\{你的Qt版本}\Examples\{你的Qt版本}\webenginewidgets\markdowneditor
  • 相關連接
https://doc.qt.io/qt-5/qtwebengine-webenginewidgets-markdowneditor-example.html
  • Qt君公衆號回覆『Qt示例』獲取更多內容。
相關文章
相關標籤/搜索