# SETTINGS
overlay_padding = 10
+breathing_room = 30 # minimum pixels above/below cursor
timeout = (ms, cb) -> return setTimeout cb, ms
next_frame = (cb) ->
throw "how is this possible?"
next_i -= 1
return 1
- whitespace_to_space = (undo) ->
+ replace_with_space = (undo) ->
if undo
cur.text = (cur.text.substr 0, cur_i) + removed_char + (cur.text.substr cur_i + 1)
cur.el.textContent = cur.text
else
removed_char = cur.text.charAt(cur_i)
- cur.text = (cur.text.substr 0, cur_i) + ' ' + (cur.text.substr cur_i + 1)
- cur.el.textContent = cur.text
+ if removed_char isnt ' '
+ cur.text = (cur.text.substr 0, cur_i) + ' ' + (cur.text.substr cur_i + 1)
+ cur.el.textContent = cur.text
return 0
# return true if cur was removed from the dom (ie re-use same prev)
operate = ->
# cur definitately set
# prev and/or next might be null, indicating the start/end of a display:block
return false unless is_space_code cur.text.charCodeAt cur_i
- fixers = [remove, whitespace_to_space]
+ fixers = [remove, replace_with_space]
+ # check for common case: single whitespace surrounded by non-whitespace chars
+ if prev? and next?
+ unless (is_space_code prev.text.charCodeAt prev_i) or (is_space_code next.text.charCodeAt next_i)
+ dbg = cur.text.charCodeAt cur_i
+ if cur.text.charAt(cur_i) is ' ' # perens required
+ # single space can't collapse, doesn't need fixin'
+ return false
+ else
+ # tab, newline, etc, can't collapse, but maybe should be replaced
+ fixers = [replace_with_space]
bounds = text_range_bounds cur.el, cur_i, cur_i + 1
# consistent cases:
# 1. zero rects returned by getClientRects() means collapsed space
return remove()
# 2. width greater than zero means visible space
if bounds.w > 0
- fixers.shift() # don't try removing
+ # has bounds, don't try removing
+ fixers = [replace_with_space]
# now the weird edge cases...
#
# firefox and chromium both report zero width for characters at the end
# collapsed spaces via the range/bounds api, so...
#
# remove it from the dom, and if prev or next moves, put it back.
+ #
+ # this block (try changing it, put it back if something moves) is also
+ # used on collapsable whitespace characters besides space. In this case
+ # the character is replaced with a normal space character instead of
+ # removed
if prev? and not prev_px?
prev_px = new_cursor_position n: prev, i: prev_i
if next? and not next_px?
constructor: (in_el, options) ->
@options = options ? {}
@in_el = in_el
- @tree = null
+ @tree = null # array of Nodes, all editable content
+ @tree_parent = null # @tree is this.children. .el might === @idoc.body
@matting = []
@init_1_called = false # when iframes have loaded
@outer_iframe # iframe to hold editor
@move_cursor new_cursor
return false
when KEY_BACKSPACE
- return false unless @cursor?
- return false unless @cursor.i > 0
- @remove_character @cursor.n, @cursor.i - 1
- @adjust_whitespace_style @cursor.n
- @changed()
- new_cursor = new_cursor_position n: @cursor.n, i: @cursor.i - 1
- if new_cursor?
- @move_cursor new_cursor
- else
- @kill_cursor()
+ @on_key_backspace e
return false
when KEY_DELETE
return false unless @cursor?
when KEY_INSERT
return false
when KEY_PAGE_UP
+ @on_page_up_key e
return false
when KEY_PAGE_DOWN
+ @on_page_down_key e
return false
when KEY_TAB
return false
return unless cur_block.parent?
cur_block = cur_block.parent
# find array to insert new element into
- if cur_block.parent?.el?
- parent_el = cur_block.parent.el
- pc = cur_block.parent.children
- else
+ if cur_block.parent is @tree_parent # top-level
parent_el = @idoc.body
pc = @tree
+ else
+ parent_el = cur_block.parent.el
+ pc = cur_block.parent.children
# find index of current block in its parent
for n, i in pc
break if n is cur_block
new_node.el = domify @idoc, p: style: 'white-space: pre-wrap', children: [new_text.el]
pc.splice i, 0, new_node
parent_el.insertBefore new_node.el, before
+ @changed()
new_cursor = new_cursor_position n: new_text, i: 0
throw 'bork bork' unless new_cursor?
@move_cursor new_cursor
# TODO move content past cursor into this new block
+ find_block_parent: (n) ->
+ loop
+ n = n.parent
+ return null unless n?
+ return n if is_display_block n.el
+ return n if n is @tree_parent
+ return null
+ on_key_backspace: (e) ->
+ return false unless @cursor?
+ if @is_lone_space @cursor.n # false if it's not in a tag
+ if @cursor.i is 1
+ # don't delete the space, because then it would collapse
+ # instead leave a space after the cursor
+ new_cursor = new_cursor_position n: @cursor.n, i: 0
+ if new_cursor?
+ @move_cursor new_cursor
+ else
+ @kill_cursor()
+ else
+ # cursor at the begining of an element that contains only a space
+ parent = @cursor.n.parent
+ new_cursor = find_prev_cursor_position @tree, @cursor
+ if new_cursor?
+ if new_cursor.n is @cursor.n or new_cursor.n is parent
+ new_cursor = null
+ tag = @cursor.n.parent
+ if tag is @tree_parent
+ console.log "top-level text not supported" # FIXME
+ return false
+ for n, i in tag.parent.children
+ if n is tag
+ tag.parent.el.removeChild tag.el
+ tag.parent.children.splice i, 1
+ break
+ @changed()
+ if new_cursor?
+ # re-check, in case it moved or is invalid now
+ new_cursor = new_cursor_position n: new_cursor.n, i: new_cursor.i
+ if new_cursor?
+ @move_cursor new_cursor
+ return
+ new_cursor = first_cursor_position @tree
+ if new_cursor?
+ @move_cursor new_cursor
+ else
+ @kill_cursor
+ return
+ else if @cursor.i is 0 # start of text chunk
+ # FIXME clean this up: use new code for text runs
+ # FIXME handle backspacing a <br> even if it's near a inline tag boundary
+ # determine if cursor is at start of text run (text formatted inline)
+ block = @find_block_parent @cursor.n
+ return unless block
+ at_block_start = true
+ prev_pos = find_prev_cursor_position @tree, @cursor
+ unless prev_pos?
+ # if the cursor can't go back, then there's probably nowhere we can merge into
+ # TODO consider case of nested blocks. should backspace remove one?
+ return
+ prev_pos_block = @find_block_parent prev_pos.n
+ if prev_pos_block is block
+ # context: there is text before the cursor within the same block.
+ # FIXME clean up this hack for looking for <br>
+ cursor_text_pi = @cursor.n.parent.children.indexOf @cursor.n
+ if cursor_text_pi > 0
+ prev_node = @cursor.n.parent.children[cursor_text_pi - 1]
+ if prev_node.type is 'tag' and prev_node.name is 'br'
+ @remove_node prev_node
+ @text_cleanup @cursor.n.parent
+ @changed()
+ new_cursor = new_cursor_position n: prev_pos.n, i: prev_pos.i
+ if new_cursor?
+ @move_cursor new_cursor
+ else
+ @kill_cursor
+ return
+ # note: find_prev_cursor_position just crossed a boundary, not a character
+ # prev_pos is within the same block, try deleting there
+ @move_cursor prev_pos
+ # FIXME cleanup: don't call @move_cursor twice if the next line succeeds
+ return @on_key_backspace()
+ # context: backspace pressed at start of a display:block
+ return if block is @tree_parent # top level text
+ parent = block.parent
+ parent_i = parent.children.indexOf block
+ if parent_i is -1
+ throw "BUG #98270918347"
+ return
+ if parent_i is 0
+ # no previous sibling to merge into, so instead move contents into parent
+ dest = parent
+ before = block
+ else
+ # FIXME prev_sib should be the previous in-flow element
+ # ie it should skip comments, hidden things, floating things, etc.
+ prev_sib = parent.children[parent_i - 1]
+ if is_display_block prev_sib.el
+ dest = prev_sib
+ before = null # null means append
+ else
+ dest = parent
+ before = block
+ if dest is @tree_parent
+ # don't remove outer-most blocks
+ return
+ while block.children.length > 0
+ n = block.children[block.children.length - 1]
+ @move_node n, dest, before
+ block.children.pop()
+ before = n
+ @remove_node block
+ @text_cleanup dest
+ @changed()
+ new_cursor = new_cursor_position n: prev_pos.n, i: prev_pos.i
+ if new_cursor?
+ @move_cursor new_cursor
+ else
+ @kill_cursor
+ return
+ else
+ # TODO handle case of removing last char
+ # CONTINUE
+ if @is_only_char_in_tag @cursor.n
+ if is_display_block @cursor.n.parent.el
+ @cursor.n.el.textContent = @cursor.n.text = ' '
+ else
+ console.log "unimplemented: delete last char in inline" # FIXME
+ return
+ else
+ @remove_character @cursor.n, @cursor.i - 1
+ @adjust_whitespace_style @cursor.n
+ @changed()
+ new_cursor = new_cursor_position n: @cursor.n, i: @cursor.i - 1
+ if new_cursor?
+ @move_cursor new_cursor
+ else
+ @kill_cursor()
+ return
+ on_page_up_key: (e) ->
+ if @wrap2.scrollTop is 0
+ return unless @cursor?
+ new_cursor = first_cursor_position @tree
+ if new_cursor?
+ if new_cursor.n isnt @cursor.n or new_cursor.i isnt @cursor.i
+ @move_cursor new_cursor
+ return
+ if @cursor?
+ screen_y = @cursor.y - @wrap2.scrollTop
+ scroll_amount = @wrap2_height - breathing_room
+ @wrap2.scrollTop = Math.max 0, @wrap2.scrollTop - scroll_amount
+ if @cursor?
+ @move_cursor_into_view screen_y + @wrap2.scrollTop
+ on_page_down_key: (e) ->
+ lowest_scrollpos = @wrap2.scrollHeight - @wrap2_height
+ if @wrap2.scrollTop is lowest_scrollpos
+ return unless @cursor?
+ new_cursor = last_cursor_position @tree
+ if new_cursor?
+ if new_cursor.n isnt @cursor.n or new_cursor.i isnt @cursor.i
+ @move_cursor new_cursor
+ return
+ if @cursor?
+ screen_y = @cursor.y - @wrap2.scrollTop
+ scroll_amount = @wrap2_height - breathing_room
+ @wrap2.scrollTop = Math.min lowest_scrollpos, @wrap2.scrollTop + scroll_amount
+ if @cursor?
+ @move_cursor_into_view screen_y + @wrap2.scrollTop
+ return
+ move_cursor_into_view: (y_target) ->
+ return if y_target is @cursor.y
+ was = @cursor
+ y_min = @wrap2.scrollTop
+ unless @wrap2.scrollTop is 0
+ y_min += breathing_room
+ y_max = @wrap2.scrollTop + @wrap2_height
+ unless @wrap2.scrollTop is @wrap2.scrollHeight - @wrap2_height # downmost
+ y_max -= breathing_room
+ y_target = Math.min y_target, y_max
+ y_target = Math.max y_target, y_min
+ if y_target < @cursor.y
+ finder = find_up_cursor_position
+ far_enough = (cur, target_y) ->
+ return cur.y + cur.h <= target_y
+ else
+ finder = find_down_cursor_position
+ far_enough = (cur, y_target) ->
+ return cur.y >= y_target
+ loop
+ cur = finder @tree, was, @cursor_ideal_x
+ break unless cur?
+ break if far_enough cur, y_target
+ was = cur
+ if was is @cursor
+ was = null
+ if was?
+ if was.y + was.h > y_max
+ was = null
+ else if was.y < y_min
+ was = null
+ if cur?
+ if cur.y + cur.h > y_max
+ cur = null
+ else if cur.y < y_min
+ cur = null
+ if cur? and was?
+ # both valid, pick best
+ if cur.y < y_min
+ new_cursor = was
+ else if was.y + was.h > y_max
+ new_cursor = cur
+ else if cur.y - y_target < y_target - was.y
+ new_cursor = cur
+ else
+ new_cursor = was
+ else
+ new_cursor = was ? cur
+ if new_cursor?
+ saved_ideal_x = @cursor_ideal_x
+ @move_cursor new_cursor
+ @cursor_ideal_x = saved_ideal_x
+ return
clear_dom: -> # remove all the editable content (and cursor, overlays, etc)
while @idoc.body.childNodes.length
@idoc.body.removeChild @idoc.body.childNodes[0]
return
load_html: (html) ->
@tree = peach_parser.parse html, @parser_opts
+ if !@tree[0]?.parent
+ @tree = peach_parser.parse '<p style="white-space: pre-wrap"> </p>', @parser_opts
+ @tree_parent = @tree[0]?.parent
+ @tree_parent.el = @idoc.body
@clear_dom()
- instantiate_tree @tree, @idoc.body
+ instantiate_tree @tree, @tree_parent.el
tree_dedup_space @tree
@changed()
changed: ->
if needle is n.attrs.style.substr n.attrs.style.length - needle
n.attrs.style = n.attrs.style.substr 0, n.attrs.style.length - needle
n.el.setAttribute n.attrs.style
+ # true if n is text node with only one caracter, and the only child of a tag
+ is_only_char_in_tag: (n, i) ->
+ return false unless n.type is 'text'
+ return false unless n.text.length is 1
+ return false if n.parent is @tree_parent
+ return false unless n.parent.children.length is 1
+ return true
+ # true if n is text node with just a space in it, and the only child of a tag
+ is_lone_space: (n, i) ->
+ return false unless n.type is 'text'
+ return false unless n.text is ' '
+ return false if n.parent is @tree_parent
+ return false unless n.parent.children.length is 1
+ return true
+ # detect special case: typing before a space that's the only thing in a block/doc
+ # reason: enter key creates blocks with just a space in them
+ insert_should_replace: (n, i) ->
+ return false unless i is 0
+ return false unless n.text is ' '
+ return true if n.parent is @tree_parent
+ if n.parent.children.length is 1
+ if n.parent.children[0] is n
+ # n is only child
+ return true
+ return false
# after calling this, you MUST call changed() and adjust_whitespace_style()
insert_character: (n, i, char) ->
+ return if @cursor.n.parent is @tree_parent # FIXME implement text nodes at top level
parent = @cursor.n.parent
- return unless parent
- return unless parent.el?
# insert the character
- if i is 0
- # special case: typing before a space that's the only thing in a block/doc
- # reason: enter key creates blocks with just a space in them
- special_case = false
- if n.text is ' '
- if n.parent?.el?
- if n.parent.children.length is 1
- if n.parent.children[0] is n
- special_case = true
- else
- special_case = true
- if special_case
- n.text = char
- else
- n.text = char + n.text
+ if @insert_should_replace n, i
+ n.text = char
+ else if i is 0
+ n.text = char + n.text
else if i is n.text.length
# replace the space
n.text += char
char +
n.text.substr(i)
n.el.nodeValue = n.text
- # after calling this, you MUST call changed() and adjust_whitespace_style()
+ # WARNING: after calling this, you MUST call changed() and adjust_whitespace_style()
remove_character: (n, i) ->
n.text = n.text.substr(0, i) + n.text.substr(i + 1)
n.el.nodeValue = n.text
+ # call this after you insert or remove inline nodes. It will:
+ # merge consecutive text nodes
+ # remove empty text nodes
+ # adjust white-space property
+ text_cleanup: (n) ->
+ return
+ # FIXME implement this
+ # WARNING: after calling this one or more times, you MUST:
+ # if it's inline: call @text_cleanup
+ # call @changed()
+ remove_node: (n) ->
+ i = n.parent.children.indexOf n
+ if i is -1
+ throw "BUG #9187112313"
+ n.el.parentNode.removeChild n.el
+ n.parent.children.splice i, 1
+ return
+ # remove a node from the tree/dom, insert into new_parent before insert_before?end
+ # WARNING: after calling this one or more times, you MUST:
+ # if it's inline: call @text_cleanup
+ # call @changed()
+ move_node: (n, new_parent, insert_before = null) ->
+ i = n.parent.children.indexOf n
+ if i is -1
+ throw "Error: tried to remove node, but it's not in it's parents list of children"
+ return
+ if insert_before?
+ before_i = new_parent.children.indexOf insert_before
+ if i is -1
+ throw "Error: tried to move a node to be before a non-existent node"
+ @remove_node n
+ if insert_before?
+ new_parent.insertBefore n.el, insert_before
+ new_parent.children.splice before_i, 0, n
+ else
+ new_parent.el.appendChild n.el, insert_before
+ new_parent.children.push n
+ n.parent = new_parent
+ return
kill_cursor: -> # remove it, forget where it was
if @cursor_visible
@cursor_el.parentNode.removeChild @cursor_el
@cursor_visible = false
@cursor = null
@annotate null
+ return
move_cursor: (cursor) ->
@cursor_ideal_x = cursor.x
@cursor = cursor
@cursor_el.style.height = "#{Math.round height * 0.82}px"
@annotate cursor.n
@scroll_into_view cursor.y, height
+ return
scroll_into_view: (y, h = 0) ->
- closest = 30 # setting: smallest pixels from top/bottom of screet that's OK
y += overlay_padding # convert units from @idoc to @wrap2
# very top of document
- if y <= closest
+ if y <= breathing_room
@wrap2.scrollTop = 0
return
# very bottom of document
- if y + h >= @wrap2.scrollHeight - closest
+ if y + h >= @wrap2.scrollHeight - breathing_room
@wrap2.scrollTop = @wrap2.scrollHeight - @wrap2_height
return
# The most scrolled up (lowest value for scrollTop) that would be OK
- upmost = y + h + closest - @wrap2_height
+ upmost = y + h + breathing_room - @wrap2_height
upmost = Math.max(upmost, 0)
# the most scrolled down (highest value for scrollTop) that would be OK
- downmost = y - closest
+ downmost = y - breathing_room
downmost = Math.min(downmost, @wrap2.scrollHeight - @wrap2_height)
if upmost > downmost # means h is too big to fit
# scroll so top is visible
return unless n?
prev_bounds = x: 0, y: 0, w: 0, h: 0
alpha = 0.1
- while n?.el?
+ while n?.el? and n isnt @tree_parent
if n.type is 'text'
n = n.parent
continue
Got questions, comments, patches, etc.? Contact Jason Woofenden