一、在 Mac 與 Windows 上會自動為常用操作綁定標準快捷鍵。
二、可用拖曳插入圖片,支援上傳,也能取用行動裝置的相片。
三、語音輸入(僅 Chrome)。
四、工具列可自訂,不產生多餘標籤,能直接沿用 Bootstrap、Font Awesome 等既有樣式。
五、不強制任何樣式,外觀完全由你決定。
六、只依賴瀏覽器標準特性,沒有非標準 hack;工具列與鍵盤行為都可替換成任何瀏覽器支援的命令。
七、不另開 iframe、不建隱藏 textarea,盡量保持單純,整編輯器就跑在一個 div 裡。
八、(可選)清除結尾空白、清掉空的 div 與 span。
九、需運行於現代瀏覽器,官方在 Chrome 26、Firefox 19、Safari 6 上測試過,使用者回報 IE10 亦可運作。
十、支援行動瀏覽器,於 iOS 6 的 iPad/iPhone 與 Android 4.1.1 Chrome 上驗證。
wysiwyg 與 wysihtml5 是兩個不同專案,前者可視為後者的強化版本,用法相近,依需求挑選即可。
wysiwyg 官網:https://mindmup.github.io/bootstrap-wysiwyg/
中文說明頁:https://www.bootcss.com/p/bootstrap-wysiwyg/
wysihtml5 官網:https://jhollingworth.github.io/bootstrap-wysihtml5/
第一步,引入必要檔案。官方文件講的是大致用法,但以下這組是實際跑起來的最小集合,細節不能省:
<link href="https://netdna.bootstrapcdn.com/twitter-bootstrap/2.3.1/css/bootstrap-combined.no-icons.min.css" rel="stylesheet"> <link href="https://netdna.bootstrapcdn.com/font-awesome/3.0.2/css/font-awesome.css" rel="stylesheet"> <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script> <script src="https://mindmup.s3.amazonaws.com/lib/jquery.hotkeys.js"></script> <script src="https://netdna.bootstrapcdn.com/twitter-bootstrap/2.3.1/js/bootstrap.min.js"></script> <script src="https://twitter.github.com/bootstrap/assets/js/google-code-prettify/prettify.js"></script> <link href="index.css" rel="stylesheet"> <script src="bootstrap-wysiwyg.js"></script>
第二步,加入初始化腳本。篇幅關係此處不展開,可直接對照官方 demo.html 的內容。
第三步,寫 HTML。值得注意的是,這個編輯器並未封裝成插件,而是把結構直接寫在頁面上。整個編輯器分兩塊:頂部工具列與下方的編輯區。
工具列:一個 div.btn-toolbar,內含多個 div.btn-group,每個按鈕就是一個 btn-group。提示文字可自為中文。
<div class="btn-toolbar" data-role="editor-toolbar" data-target="#editor">
<div class="btn-group">
<!-- 按鈕 -->
</div>
......
<div class="btn-group">
<!-- 按鈕 -->
</div>
</div>
其中還包含一個 HTML5 語音輸入框:
<input type="text" data-edit="inserttext" id="voiceBtn" x-webkit-speech="">
編輯區:一個 id 為 editor 的 div 就是全部。
<div id="editor">內容</div>

把結構寫死在 HTML 而非用 JS 生成,是這個編輯器最鮮明的取捨。好處是工具列完全由你掌控,要加自訂按鈕只需補一段 btn-group 並給對 data-edit;代價是頁面 HTML 會變長,且換一套按鈕得整套改寫。
另一點要留意的是範例中的 CDN 網址多為 Bootstrap 2.3.1 時代的資源,部分可能已失效。實際使用時建議把 jQuery、bootstrap、font-awesome 與 bootstrap-wysiwyg.js 都下載到專案內自行託管,避免第三方 CDN 掛掉導致編輯器直接不顯示。
整體來說,它適合「只需要基本富文本、且版面要完全配合既有設計」的場景;若需要表格、字型精細控制或成熟的檔案管理,還是得考慮更完整的方案。