fab-manager/vendor/assets/components/angular-summernote/README.md

angular-summernote - AngularJS directive to Summernote

---

angular-summernote is just a directive to bind summmernote's all features. You can use summernote with angular way.

Table of Contents

• Demo
• Installation
• How To Use
  • summernote directive
  • Options
  • ngModel
  • Event Listeners
  • i18n Support
• FAQ
• Change Logs

Demo

See at JSFiddle or run example in projects(need to run bower install before run)

Installation

angular-summernote requires all include files of Summernote. see Summernote's installation.

Project files are also available through your favourite package manager:

• Bower: bower install angular-summernote

How To Use

When you are done downloading all the dependencies and project files the only remaining part is to add dependencies on the ui.bootstrap AngularJS module:

When you've inclued all js and css files you need to inject a into your angular application:

angular.module('myApp', ['summernote']);

summernote Directive

You can use summernote directive where you want to use summernote editor. And when the scope is destroyed the directive will be destroyed.

As element:

<summernote></summernote>

As attribute:

<div summernote></div>

It will be initialized automatically.

Options

summernote's options can be specified as attributes.

height

<summernote height="300"></summernote>

focus

<summernote focus></summernote>

airmode

<summernote airMode></summernote>

options object

You can specify all options using ngModel in config attribute.

<summernote config="options"></summernote>

function DemoController($scope) {
  $scope.options = {
    height: 300,
    focus: true,
    airMode: true,
    toolbar: [
            ['edit',['undo','redo']],
            ['headline', ['style']],
            ['style', ['bold', 'italic', 'underline', 'superscript', 'subscript', 'strikethrough', 'clear']],
            ['fontface', ['fontname']],
            ['textsize', ['fontsize']],
            ['fontclr', ['color']],
            ['alignment', ['ul', 'ol', 'paragraph', 'lineheight']],
            ['height', ['height']],
            ['table', ['table']],
            ['insert', ['link','picture','video','hr']],
            ['view', ['fullscreen', 'codeview']],
            ['help', ['help']]
        ]
  };
}

NOTE: height and focus attributes have high priority than options object.

NOTE: custom toolbar can be set by options object.

ngModel

summernote's code, that is HTML string in summernote. If you specify ngModel it will be 2-ways binding to HTML string in summernote. Otherwise angular-summernote simply ignore it.

<summernote ng-model="text"></summernote>

function DemoController($scope) {
  $scope.text = "Hello World";
}

Event Listeners

event listeners can be registered as attribute as you want.

function DemoController($scope) {
  $scope.init = function() { console.log('Summernote is launched'); }
  $scope.enter = function() { console.log('Enter/Return key pressed'); }
  $scope.focus = function(e) { console.log('Editable area is focused'); }
  $scope.blur = function(e) { console.log('Editable area loses focus'); }
  $scope.paste = function(e) { console.log('Called event paste'); }
  $scope.change = function(contents) {
    console.log('contents are changed:', contents, $scope.editable);
  };
  $scope.keyup = function(e) { console.log('Key is released:', e.keyCode); }
  $scope.keydown = function(e) { console.log('Key is pressed:', e.keyCode); }
  $scope.imageUpload = function(files, editor) {
    console.log('image upload:', files, editor);
    console.log('image upload\'s editable:', $scope.editable);
  }
}

<summernote on-init="init()" on-enter="enter()" on-focus="focus(evt)"
            on-blur="blur(evt)" on-paste="paste()" on-keyup="keyup(evt)"
            on-keydown="keydown(evt)" on-change="change(contents)"
            on-image-upload="imageUpload(files, editor)" editable="editable">
</summernote>

If you use $editable object in onImageUpload or onChange (see summernote's callback), you should defined editable attribute and use it in $scope. (Because AngularJS 1.3.x restricts access to DOM nodes from within expressions)

i18n Support

If you use i18n, you have to include language files. See summernote's document for more details. And then you can specify language like:

<summernote lang="ko-KR"></summernote>

FAQ

• How to solve compatibility problem with AngularUI Bootstrap?

AngularUI Bootstrap module is written to replace the JavaScript file for bootstrap with its own implementation (ui-bootstrap-tpls.min.js).

Summernote was intended to work with Bootstrap, so the coder implemented features that rely on the bootstrap.js file being present.

• If you do not include bootstrap.js, summernote throws exceptions.
• If you do not include ui-bootstrap-tpls.min.js, your angular directives for bootstrap will not work.
• If you include both, then both JavaScript files try to listen on various events, and otherwise may have incompatibility issues.

If you have a drop down in the navbar, and use data-dropdown directive as bootstrap says to, then two clicks are required to open the drop down (menu) instead of the expected one click.

The solution is to not use data-dropdown directive. However, the real solution is for summernote to be agnostic about which of bootstrap.js or ui-bootstrap-tpls.min.js are loaded and make the right calls. (see #21)

Change Logs

See here.