富文本之BootStrap-wysiwyg

BootStrap-wysiwyg

BootStrap-wysiwyg插件具有良好的编辑功能和展示效果。
一、使用方法在网上有很多，在此记录自己使用过程中的一些问题和解决方式。

相关依赖：

bootstrap-wysiwyg.js    （核心）
jquery.hotkeys.js       （快捷键）
prettify.js             

prettify.css
edit.css                （页面展示效果，可自定义）

bootstrap.min.css
font-awesome.css        （字体图片样式）

bootstrap.min.js
jquery2.1.4.min.js

相关文件地址：【相关文件下载地址】

页面代码：

//工具栏的定义
<div class="btn-toolbar" data-role="editor-toolbar" data-target="#editor">
      <div class="btn-group">
        <a class="btn dropdown-toggle" data-toggle="dropdown" title="Font"><i class="icon-font"></i><b class="caret"></b></a>
          <ul class="dropdown-menu">
          </ul>
        </div>
      <div class="btn-group">
        <a class="btn dropdown-toggle" data-toggle="dropdown" title="Font Size"><i class="icon-text-height"></i>&nbsp;<b class="caret"></b></a>
          <ul class="dropdown-menu">
          <li><a data-edit="fontSize 5"><font size="5">Huge</font></a></li>
          <li><a data-edit="fontSize 3"><font size="3">Normal</font></a></li>
          <li><a data-edit="fontSize 1"><font size="1">Small</font></a></li>
          </ul>
      </div>
      <div class="btn-group">
        <a class="btn" data-edit="bold" title="Bold (Ctrl/Cmd+B)"><i class="icon-bold"></i></a>
        <a class="btn" data-edit="italic" title="Italic (Ctrl/Cmd+I)"><i class="icon-italic"></i></a>
        <a class="btn" data-edit="strikethrough" title="Strikethrough"><i class="icon-strikethrough"></i></a>
        <a class="btn" data-edit="underline" title="Underline (Ctrl/Cmd+U)"><i class="icon-underline"></i></a>
      </div>
      <div class="btn-group">
        <a class="btn" data-edit="insertunorderedlist" title="Bullet list"><i class="icon-list-ul"></i></a>
        <a class="btn" data-edit="insertorderedlist" title="Number list"><i class="icon-list-ol"></i></a>
        <a class="btn" data-edit="outdent" title="Reduce indent (Shift+Tab)"><i class="icon-indent-left"></i></a>
        <a class="btn" data-edit="indent" title="Indent (Tab)"><i class="icon-indent-right"></i></a>
      </div>
      <div class="btn-group">
        <a class="btn" data-edit="justifyleft" title="Align Left (Ctrl/Cmd+L)"><i class="icon-align-left"></i></a>
        <a class="btn" data-edit="justifycenter" title="Center (Ctrl/Cmd+E)"><i class="icon-align-center"></i></a>
        <a class="btn" data-edit="justifyright" title="Align Right (Ctrl/Cmd+R)"><i class="icon-align-right"></i></a>
        <a class="btn" data-edit="justifyfull" title="Justify (Ctrl/Cmd+J)"><i class="icon-align-justify"></i></a>
      </div>
      <div class="btn-group">
          <a class="btn dropdown-toggle" data-toggle="dropdown" title="Hyperlink"><i class="icon-link"></i></a>
            <div class="dropdown-menu input-append">
                <input class="span2" placeholder="URL" type="text" data-edit="createLink"/>
                <button class="btn" type="button">Add</button>
        </div>
        <a class="btn" data-edit="unlink" title="Remove Hyperlink"><i class="icon-cut"></i></a>
      </div>

      <div class="btn-group">
        <a class="btn" title="Insert picture (or just drag & drop)" id="pictureBtn"><i class="icon-picture"></i></a>
        <input type="file" data-role="magic-overlay" data-target="#pictureBtn" data-edit="insertImage" />
      </div>
      <div class="btn-group">
        <a class="btn" data-edit="undo" title="Undo (Ctrl/Cmd+Z)"><i class="icon-undo"></i></a>
        <a class="btn" data-edit="redo" title="Redo (Ctrl/Cmd+Y)"><i class="icon-repeat"></i></a>
      </div>
      <input type="text" data-edit="inserttext" id="voiceBtn" x-webkit-speech="">
    </div>
    //文本输入区域
    <div id="editor">
      输入内容&hellip;
    </div>

JS代码：

//初始化工具栏
function initToolbarBootstrapBindings() {
      var fonts = ['Serif', 'Sans', 'Arial', 'Arial Black', 'Courier', 
            'Courier New', 'Comic Sans MS', 'Helvetica', 'Impact', 'Lucida Grande', 'Lucida Sans', 'Tahoma', 'Times',
            'Times New Roman', 'Verdana'],
            fontTarget = $('[title=Font]').siblings('.dropdown-menu');
      $.each(fonts, function (idx, fontName) {
          fontTarget.append($('<li><a data-edit="fontName ' + fontName +'" style="font-family:\''+ fontName +'\'">'+fontName + '</a></li>'));
      });
      $('a[title]').tooltip({container:'body'});
        $('.dropdown-menu input').click(function() {return false;})
            .change(function () {$(this).parent('.dropdown-menu').siblings('.dropdown-toggle').dropdown('toggle');})
        .keydown('esc', function () {this.value='';$(this).change();});

      $('[data-role=magic-overlay]').each(function () { 
        var overlay = $(this), target = $(overlay.data('target')); 
        overlay.css('opacity', 0).css('position', 'absolute').offset(target.offset()).width(target.outerWidth()).height(target.outerHeight());
      });
      if ("onwebkitspeechchange"  in document.createElement("input")) {
        var editorOffset = $('#editor').offset();
        $('#voiceBtn').css('position','absolute').offset({top: editorOffset.top, left: editorOffset.left+$('#editor').innerWidth()-35});
      } else {
        $('#voiceBtn').hide();
      }
    };
    //错误提示
    function showErrorAlert (reason, detail) {
        var msg='';
        if (reason==='unsupported-file-type') { msg = "Unsupported format " +detail; }
        else {
            console.log("error uploading file", reason, detail);
        }
        $('<div class="alert"> <button type="button" class="close" data-dismiss="alert">&times;</button>'+ 
         '<strong>File upload error</strong> '+msg+' </div>').prependTo('#alerts');
    };
    initToolbarBootstrapBindings(); 
    $('#editor').wysiwyg({ fileUploadError: showErrorAlert} );

二、自定义上传图片到服务器
主要修改bootstrap-wysiwyg.js中的一个方法

var readFileIntoDataUrl = function (fileInfo) {
        //原有的方法
//      var loader = $.Deferred(),
//          fReader = new FileReader();
//      fReader.onload = function (e) {
//          loader.resolve(e.target.result);
//      };
//      fReader.onerror = loader.reject;
//      fReader.onprogress = loader.notify;
//      fReader.readAsDataURL(fileInfo);
//      return loader.promise();

        //自定义方法
        var form = new FormData();
        form.append("file", fileInfo);
        var xhr = new XMLHttpRequest();
        xhr.open("post", "/imgupload", false);//后台接收的方法，返回图片路径（全路径，不然页面不显示图片）
        xhr.send(form);
        return xhr.responseText;
    };

后台接收的方法示例：

    /**
     * 新闻图片上传，返回全路径
     * @param file  图片文件
     * @return  图片服务器全路径
     */
    @RequestMapping(value = "imgupload", method = RequestMethod.POST)
    @ResponseBody
    @LogOperation("上传图片文件")
    public String imgUpload(
            @RequestPart(required = false, value = "file") MultipartFile file
    ) {
        String picUrl = null;
        try {
            FileResult fileResult = fileFacade.postObject(Category.Image, SubCategory.Program
                    , file.getOriginalFilename(), file.getBytes());
            if (fileResult != null && fileResult.isSuccess()) {
                String fileName = fileResult.getFileName();
                //获得全路径
                FileResult result = fileFacade.getObject(Category.Image, SubCategory.Program, fileName);
                picUrl = result.getFileName();
            }
        }catch (IOException ex){
            throw new RuntimeException("上传图片失败");
        }
        return picUrl;
    }

三、传递参数

//在回台接收输入区域的内容使用jQuery
$("#editor").html();

结束：
这只是简单的使用示例。
还有很多更方便的使用技巧，希望有经验的朋友留言，共同学习。