1 # Copyright 2015 Jason Woofenden
2 # This file implements an WYSIWYG editor in the browser (no contenteditable)
4 # This program is free software: you can redistribute it and/or modify it under
5 # the terms of the GNU Affero General Public License as published by the Free
6 # Software Foundation, either version 3 of the License, or (at your option) any
9 # This program is distributed in the hope that it will be useful, but WITHOUT
10 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
11 # FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
14 # You should have received a copy of the GNU Affero General Public License
15 # along with this program. If not, see <http://www.gnu.org/licenses/>.
20 TYPE_TAG = peach_parser.TYPE_TAG
21 TYPE_TEXT = peach_parser.TYPE_TEXT
22 TYPE_COMMENT = peach_parser.TYPE_COMMENT
23 TYPE_DOCTYPE = peach_parser.TYPE_DOCTYPE
25 debug_dot_at = (doc, x, y) ->
27 el = doc.createElement 'div'
28 el.setAttribute 'style', "position: absolute; left: #{x}px; top: #{y}px; width: 1px; height: 3px; background-color: red"
29 doc.body.appendChild el
30 #console.log(new Error().stack)
32 # text nodes don't have getBoundingClientRect(), so use selection api to find
34 get_el_bounds = (el) ->
35 if el.getBoundingClientRect?
36 rect = el.getBoundingClientRect()
38 # text nodes don't have getBoundingClientRect(), so use range api
39 range = el.ownerDocument.createRange()
40 range.selectNodeContents el
41 rect = range.getBoundingClientRect()
42 doc = el.ownerDocument.documentElement
43 win = el.ownerDocument.defaultView
44 y_fix = win.pageYOffset - doc.clientTop
45 x_fix = win.pageXOffset - doc.clientLeft
49 w: rect.width ? (rect.right - rect.left)
50 h: rect.height ? (rect.top - rect.bottom)
53 is_display_block = (el) ->
55 return el.currentStyle.display is 'block'
57 return window.getComputedStyle(el, null).getPropertyValue('display') is 'block'
59 # Warning: currently assumes you're asking about a single character
60 # Note: chromium returns multiple bounding rects for a space at a line-break
61 # Note: chromium's getBoundingClientRect() is broken (when zero-area client rects)
62 # Note: sometimes returns null (eg for whitespace that is not visible)
63 text_range_bounds = (el, start, end) ->
64 range = document.createRange()
65 range.setStart el, start
67 rects = range.getClientRects()
72 doc = el.ownerDocument.documentElement
73 win = el.ownerDocument.defaultView
74 y_fix = win.pageYOffset - doc.clientTop
75 x_fix = win.pageXOffset - doc.clientLeft
79 w: rect.width ? (rect.right - rect.left)
80 h: rect.height ? (rect.top - rect.bottom)
82 bounding: range.getBoundingClientRect()
85 # figure out the x/y coordinates of where the cursor should be if it's at
86 # position ``i`` within text node ``n``
87 # sometimes returns null (eg for whitespace that is not visible)
88 window.cursor_to_xyh = cursor_to_xyh = (n, i) ->
89 range = document.createRange()
91 ret = text_range_bounds n.el, 0, 0
93 ret = text_range_bounds n.el, i - 1, i
97 ret = text_range_bounds n.el, i, i + 1
99 debug_dot_at n.el.ownerDocument, ret.x, ret.y
102 # encode text so it can be safely placed inside an html attribute
103 enc_attr_regex = new RegExp '(&)|(")|(\u00A0)', 'g'
105 return txt.replace enc_attr_regex, (match, amp, quote) ->
106 return '&' if (amp)
107 return '"' if (quote)
109 enc_text_regex = new RegExp '(&)|(<)|(\u00A0)', 'g'
111 return txt.replace enc_text_regex, (match, amp, lt) ->
112 return '&' if (amp)
113 return '<' if (lt)
133 dom_to_html = (dom) ->
145 if el.attrs[k].length > 0
146 ret += "=\"#{enc_attr el.attrs[k]}\""
148 unless void_elements[el.name]
149 if el.children.length
150 ret += dom_to_html el.children
151 ret += "</#{el.name}>"
153 ret += enc_text el.text
155 ret += "<!--#{el.text}-->"
157 ret += "<!DOCTYPE #{el.name}"
158 if el.public_identifier? and el.public_identifier.length > 0
159 ret += " \"#{el.public_identifier}\""
160 if el.system_identifier? and el.system_identifier.length > 0
161 ret += " \"#{el.system_identifier}\""
165 domify = (doc, hash) ->
166 for tag, attrs of hash
168 return document.createTextNode attrs
169 el = document.createElement tag
184 css += 'border: 1px solid black;'
185 css += "padding: #{overlay_padding}px;"
188 css += 'border: 1px solid black;'
189 css += "padding: #{overlay_padding}px;"
192 css += 'position: relative;'
195 css += 'box-sizing: border-box;'
197 css += 'border: none;'
199 css += "width: #{300 - 4 - 4 * overlay_padding}px;"
200 css += "height: #{300 - 4 - 4 * overlay_padding}px;"
203 css += 'position: absolute;'
204 css += "left: -#{overlay_padding}px;"
205 css += "top: -#{overlay_padding}px;"
206 css += "right: -#{overlay_padding}px;"
207 css += "bottom: -#{overlay_padding}px;"
208 css += 'overflow: hidden;'
211 css += 'position: absolute;'
212 css += 'background: rgba(100,100,100,0.2);'
215 css += 'position: absolute;'
216 css += 'height: 1em;'
218 css += 'margin-left: -1px;'
219 css += 'margin-right: -1px;'
220 css += 'background: #444;'
221 css += '-webkit-animation: blink 1s steps(2, start) infinite;'
222 css += 'animation: blink 1s steps(2, start) infinite;'
224 css += '@-webkit-keyframes blink {'
225 css += 'to { visibility: hidden; }'
227 css += '@keyframes blink {'
228 css += 'to { visibility: hidden; }'
236 KEY_BACKSPACE = 8 # <--
237 KEY_DELETE = 46 # -->
249 '20': true # capslock
251 '144': true # numlock
253 '91': true # windows "start" key
254 control_key_codes = # we react to these, but they aren't typing
270 instantiate_tree = (tree, parent) ->
274 c.el = parent.ownerDocument.createTextNode c.text
275 parent.appendChild c.el
277 # TODO create in correct namespace
278 c.el = parent.ownerDocument.createElement c.name
280 # FIXME if attr_whitelist[k]?
281 c.el.setAttribute k, v
282 parent.appendChild c.el
284 instantiate_tree c.children, c.el
286 traverse_tree = (tree, state, cb) ->
291 traverse_tree c.children, state, cb
294 # find the next element in tree (and decendants) that is after n and can contain text
295 # TODO make it so cursor can go places that don't have text but could
296 find_next_cursor_position = (tree, n, i) ->
297 if n? and n.type is TYPE_TEXT and n.text.length > i
298 orig_xyh = cursor_to_xyh n, i
300 console.log "ERROR: couldn't find xy for current cursor location"
302 for next_i in [i+1 .. n.text.length] # inclusive is valid (after last char)
303 next_xyh = cursor_to_xyh n, next_i
305 if next_xyh.x > orig_xyh.x or next_xyh.y > orig_xyh.y
307 found = traverse_tree tree, before: n?, (node, state) ->
308 if node.type is TYPE_TEXT and state.before is false
314 return [found.node, 0]
317 # TODO make it so cursor can go places that don't have text but could
318 find_prev_cursor_position = (tree, n, i) ->
319 if n? and n.type is TYPE_TEXT and i > 0
320 orig_xyh = cursor_to_xyh n, i
322 console.log "ERROR: couldn't find xy for current cursor location"
324 for prev_i in [i-1 .. 0]
325 prev_xyh = cursor_to_xyh n, prev_i
327 if prev_xyh.x < orig_xyh.x or prev_xyh.y < orig_xyh.y
330 found = traverse_tree tree, before: n?, (node, state) ->
331 if node.type is TYPE_TEXT
337 state.node = state.prev
342 return [found.node, found.node.text.length]
345 find_loc_cursor_position = (tree, loc) ->
347 if c.type is TYPE_TAG or c.type is TYPE_TEXT
348 bounds = get_el_bounds c.el
349 continue if loc.x < bounds.x
350 continue if loc.x > bounds.x + bounds.w
351 continue if loc.y < bounds.y
352 continue if loc.y > bounds.y + bounds.h
354 ret = find_loc_cursor_position c.children, loc
356 if c.type is TYPE_TEXT
357 # click is within bounding box that contains all text.
358 return [c, 0] if c.text.length is 0
360 before = cursor_to_xyh c, before_i
362 console.log "error: failed to find cursor pixel location for start of", c
364 after_i = c.text.length
365 after = cursor_to_xyh c, after_i
367 console.log "error: failed to find cursor pixel location for end of", c
369 if loc.y < before.y + before.h and loc.x < before.x
370 # console.log 'before first char on first line'
372 if loc.y > after.y and loc.x > after.x
373 # console.log 'after last char on last line'
376 console.log "Warning: click in bounding box but above first line"
377 continue # above first line (runaround?)
378 if loc.y > after.y + after.h
379 console.log "Warning: click in bounding box but below last line", loc.y, after.y, after.h
380 continue # below last line (shouldn't happen?)
381 while after_i - before_i > 1
382 cur_i = Math.round((before_i + after_i) / 2)
383 cur = cursor_to_xyh c, cur_i
385 console.log "error: failed to find cursor pixel location for", c, cur_i
387 if loc.y < cur.y or (loc.y <= cur.y + cur.h and loc.x < cur.x)
393 # which one is closest?
394 if Math.abs(before.x - loc.x) < Math.abs(after.x - loc.x)
400 # browsers collapse these (html5 spec calls these "space characters")
401 is_space_code = (char_code) ->
403 when 9, 10, 12, 13, 32
407 return is_space_code chr.charCodeAt 0
409 # pass a array of nodes (from parser library, ie it should have .el and .text)
410 tree_dedup_space = (tree) ->
411 prev = cur = next = null
412 prev_i = cur_i = next_i = 0
413 prev_pos = pos = next_pos = null
414 prev_px = cur_px = next_px = null
418 iterate = (tree, cb) ->
420 if n.type is TYPE_TEXT
422 while i < n.text.length # don't foreach, cb might remove chars
426 if n.type is TYPE_TAG
427 block = is_display_block n.el
430 if n.children.length > 0
431 iterate n.children, cb
436 removed_char = cur.text.charAt(cur_i)
437 cur.el.textContent = cur.text = (cur.text.substr 0, cur_i) + (cur.text.substr cur_i + 1)
438 if next is cur # in same text node
440 throw "how is this possible?"
445 cur.el.textContent = cur.text = (cur.text.substr 0, cur_i) + removed_char + (cur.text.substr cur_i)
446 if next is cur # in same text node
449 # return true if cur was removed from the dom (ie re-use same prev)
451 # cur definitately set
452 # prev and/or next might be null, indicating the start/end of a display:block
453 return false unless is_space_code cur.text.charCodeAt cur_i
454 bounds = text_range_bounds cur.el, cur_i, cur_i + 1
456 # 1. zero rects returned by getClientRects() means collapsed space
459 # 2. width greater than zero means visible space
462 # now the weird edge cases...
464 # firefox and chromium both report zero width for characters at the end
465 # of a line where the text wraps (automatically, due to word-wrap) to
466 # the next line. These do not appear to be distinguishable from
467 # collapsed spaces via the range/bounds api, so...
469 # remove it from the dom, and if prev or next moves, put it back.
470 if prev? and not prev_px?
471 prev_px = cursor_to_xyh prev, prev_i
472 if next? and not next_px?
473 next_px = cursor_to_xyh next, next_i
474 #if prev is null and next is null
475 # parent_px = cur.parent.el.getBoundingClientRect()
479 new_prev_px = cursor_to_xyh prev, prev_i
480 if new_prev_px.x isnt prev_px.x or new_prev_px.y isnt prev_px.y
483 console.log "this shouldn't happen, we remove spaces that don't locate"
486 new_next_px = cursor_to_xyh next, next_i
487 if new_next_px.x isnt next_px.x or new_next_px.y isnt next_px.y
490 # console.log "removing space becase space after it is collapsed"
491 # if there's no prev or next (single space inside a block-level element?) check
492 # TODO scrapt this, or fix it so it works when there's no parent
493 # if prev is null and next is null
494 # new_parent_px = cur.parent.el.getBoundingClientRect()
495 # if new_parent_px.left isnt parent_px.left or new_parent_px.top isnt parent_px.top or new_parent_px.right isnt parent_px.right or new_parent_px.bottom isnt parent_px.bottom
496 # console.log "WEIRD: parent moved"
497 # return put_it_back()
498 # we didn't put it back
500 # pass null at start/end of display:block
508 # don't advance (to the next character next time) if we removed a
509 # character from the same text node as ``next``, because doing so
510 # renumbers the indexes in that string
511 if removed and cur is next
527 class PeachHTML5Editor
528 # Options: (all optional)
529 # editor_id: "id" attribute for outer-most element created by/for editor
530 constructor: (in_el, options) ->
531 @options = options ? {}
534 @initialized = false # when iframes have loaded
535 @outer_iframe # iframe to hold editor
536 @outer_idoc # "document" object for @outer_iframe
537 @iframe = null # iframe to hold editable content
538 @idoc = null # "document" object for @iframe
541 @cursor_visible = false
542 opt_fragment = @options.fragment ? true
545 @parser_opts.fragment = 'body'
547 @outer_iframe = domify document, iframe: class: 'peach_html5_editor'
548 if @options.editor_id?
549 @outer_iframe.setAttribute 'id', @options.editor_id
550 @outer_iframe.onload = =>
551 @outer_idoc = @outer_iframe.contentDocument
552 icss = domify @outer_idoc, style: children: [
553 domify @outer_idoc, text: css
555 @outer_idoc.head.appendChild icss
558 @iframe = domify @outer_idoc, iframe: {}
561 @outer_idoc.body.appendChild(
562 domify @outer_idoc, div: id: 'wrap1', children: [
563 domify @outer_idoc, div: id: 'wrap2', children: [
564 domify @outer_idoc, div: id: 'wrap3', children: [
566 @overlay = domify @outer_idoc, div: id: 'overlay'
571 @in_el.parentNode.appendChild @outer_iframe
572 init: -> # called by @iframe's onload
573 @idoc = @iframe.contentDocument
574 @overlay.onclick = (e) =>
576 @outer_idoc.body.onkeyup = (e) =>
578 @outer_idoc.body.onkeydown = (e) =>
580 @outer_idoc.body.onkeypress = (e) =>
582 if @options.stylesheet
584 @idoc.head.appendChild domify @idoc, style: src: @options.stylesheet
585 @load_html @in_el.value
587 if @options.initialized_cb?
588 @options.initialized_cb()
590 x = (e.offsetX ? e.layerX) - overlay_padding
591 y = (e.offsetY ? e.layerY) - overlay_padding
592 new_cursor = find_loc_cursor_position @tree, x: x, y: y
594 @move_cursor new_cursor
597 return false if ignore_key_codes[e.keyCode]?
598 #return false if control_key_codes[e.keyCode]?
601 return false if ignore_key_codes[e.keyCode]?
602 #return false if control_key_codes[e.keyCode]?
606 new_cursor = find_prev_cursor_position @tree, @cursor...
608 @move_cursor new_cursor
611 new_cursor = find_next_cursor_position @tree, c, -1
613 @move_cursor new_cursor
620 new_cursor = find_next_cursor_position @tree, @cursor...
622 @move_cursor new_cursor
625 new_cursor = find_prev_cursor_position @tree, c, -1
627 @move_cursor new_cursor
635 return false unless @cursor?
636 return false unless @cursor[1] > 0
637 @cursor[0].text = @cursor[0].text.substr(0, @cursor[1] - 1) + @cursor[0].text.substr(@cursor[1])
638 @cursor[0].el.nodeValue = @cursor[0].text
639 @move_cursor [@cursor[0], @cursor[1] - 1]
642 return false unless @cursor?
643 return false unless @cursor[1] < @cursor[0].text.length
644 @cursor[0].text = @cursor[0].text.substr(0, @cursor[1]) + @cursor[0].text.substr(@cursor[1] + 1)
645 @cursor[0].el.nodeValue = @cursor[0].text
646 @move_cursor [@cursor[0], @cursor[1]]
664 return false if ignore_key_codes[e.keyCode]?
665 return false if control_key_codes[e.keyCode]? # handled in keydown
666 char = e.charCode ? e.keyCode
668 char = String.fromCharCode char
670 @cursor[0].text = char + @cursor[0].text
671 else if @cursor[1] is @cursor[0].text.length - 1
672 @cursor[0].text += char
675 @cursor[0].text.substr(0, @cursor[1]) +
677 @cursor[0].text.substr(@cursor[1])
678 @cursor[0].el.nodeValue = @cursor[0].text
679 @move_cursor [@cursor[0], @cursor[1] + 1]
682 clear_dom: -> # remove all the editable content (and cursor, overlays, etc)
683 while @idoc.body.childNodes.length
684 @idoc.body.removeChild @idoc.body.childNodes[0]
688 @tree = peach_parser.parse html, @parser_opts
690 instantiate_tree @tree, @idoc.body
691 tree_dedup_space @tree
694 # FIXME don't export cursor placeholder (when cursor is between space characters)
695 @in_el.onchange = null
696 @in_el.value = dom_to_html @tree
698 @load_html @in_el.value
699 kill_cursor: -> # remove it, forget where it was
701 @cursor_el.parentNode.removeChild @cursor_el
702 @cursor_visible = false
704 move_cursor: (cursor) ->
705 loc = cursor_to_xyh cursor[0], cursor[1]
707 console.log "error: tried to move cursor to position that has no pixel location", cursor[0], cursor[1]
710 # replace cursor, to reset blink animation
712 @cursor_el.parentNode.removeChild @cursor_el
713 @cursor_el = domify @outer_idoc, div: id: 'cursor'
714 @overlay.appendChild @cursor_el
715 @cursor_visible = true
716 # TODO figure out x,y coords for cursor
717 @cursor_el.style.left = "#{loc.x + overlay_padding}px"
718 @cursor_el.style.top = "#{loc.y + overlay_padding}px"
720 window.peach_html5_editor = (args...) ->
721 return new PeachHTML5Editor args...
723 # test in browser: peach_html5_editor(document.getElementsByTagName('textarea')[0])