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.
See at JSFiddle
or run example in projects(need to run bower install
before run)
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
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']);
You can use summernote
directive where you want to use summernote editor.
And when the scope is destroyed the directive will be destroyed.
<summernote></summernote>
<div summernote></div>
It will be initialized automatically.
If you put markups in the directive, the markups used as initial text.
<summernote><span style="font-weight: bold;">This is initial text.</span></summernote>
summernote's options can be specified as attributes.
<summernote height="300"></summernote>
<summernote focus></summernote>
<summernote airMode></summernote>
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.
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";
}
And you can use ngModelOptions with Angular v1.3+. So, you can update ngModel when blur event emitted or with a debouncing delay if you want.
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) {
console.log('image upload:', files);
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-toolbar-click="toolbarClick(evt)"
on-image-upload="imageUpload(files)" editable="editable" editor="editor">
</summernote>
If you use $editable
object in onImageUpload
or onChange
(see summernote's callback),
you should define editable
attribute and use it in $scope
.
(Because AngularJS 1.3.x restricts access to DOM nodes from within expressions)
Since summernote v0.6.4, APIs have been changed. So, If you use the verions,
onImageUpload
is not return editor
object anymore. If you want to user
editor
object, you should define editor
attribute and use it in $scope
.
Futhermore, you can use summernote's APIs via the editor
object.
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>
- 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)
See here.