/* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ //! Common handling of keyboard input and state management for text input controls use dom::bindings::codegen::Bindings::KeyboardEventBinding::KeyboardEventMethods; use dom::bindings::js::JSRef; use dom::keyboardevent::KeyboardEvent; use servo_util::str::DOMString; use std::cmp::{min, max}; use std::default::Default; use std::num::SignedInt; #[deriving(Copy, PartialEq)] enum Selection { Selected, NotSelected } #[jstraceable] #[deriving(Copy)] struct TextPoint { /// 0-based line number line: uint, /// 0-based column number index: uint, } /// Encapsulated state for handling keyboard input in a single or multiline text input control. #[jstraceable] pub struct TextInput { /// Current text input content, split across lines without trailing '\n' lines: Vec, /// Current cursor input point edit_point: TextPoint, /// Beginning of selection range with edit_point as end that can span multiple lines. selection_begin: Option, /// Is this a multiline input? multiline: bool, } /// Resulting action to be taken by the owner of a text input that is handling an event. pub enum KeyReaction { TriggerDefaultAction, DispatchInput, Nothing, } impl Default for TextPoint { fn default() -> TextPoint { TextPoint { line: 0, index: 0, } } } /// Control whether this control should allow multiple lines. #[deriving(PartialEq)] pub enum Lines { Single, Multiple, } /// The direction in which to delete a character. #[deriving(PartialEq)] enum DeleteDir { Forward, Backward } /// Was the keyboard event accompanied by the standard control modifier, /// i.e. cmd on Mac OS or ctrl on other platforms. #[cfg(target_os="macos")] fn is_control_key(event: JSRef) -> bool { event.MetaKey() && !event.CtrlKey() && !event.AltKey() } #[cfg(not(target_os="macos"))] fn is_control_key(event: JSRef) -> bool { event.CtrlKey() && !event.MetaKey() && !event.AltKey() } impl TextInput { /// Instantiate a new text input control pub fn new(lines: Lines, initial: DOMString) -> TextInput { let mut i = TextInput { lines: vec!(), edit_point: Default::default(), selection_begin: None, multiline: lines == Lines::Multiple, }; i.set_content(initial); i } /// Remove a character at the current editing point fn delete_char(&mut self, dir: DeleteDir) { if self.selection_begin.is_none() { self.adjust_horizontal(if dir == DeleteDir::Forward { 1 } else { -1 }, Selection::Selected); } self.replace_selection("".into_string()); } /// Insert a character at the current editing point fn insert_char(&mut self, ch: char) { if self.selection_begin.is_none() { self.selection_begin = Some(self.edit_point); } self.replace_selection(ch.to_string()); } fn get_sorted_selection(&self) -> (TextPoint, TextPoint) { let begin = self.selection_begin.unwrap(); let end = self.edit_point; if begin.line < end.line || (begin.line == end.line && begin.index < end.index) { (begin, end) } else { (end, begin) } } fn replace_selection(&mut self, insert: String) { let (begin, end) = self.get_sorted_selection(); self.clear_selection(); let new_lines = { let prefix = self.lines[begin.line].slice_chars(0, begin.index); let suffix = self.lines[end.line].slice_chars(end.index, self.lines[end.line].char_len()); let lines_prefix = self.lines.slice(0, begin.line); let lines_suffix = self.lines.slice(end.line + 1, self.lines.len()); let mut insert_lines = if self.multiline { insert.as_slice().split('\n').map(|s| s.into_string()).collect() } else { vec!(insert) }; let mut new_line = prefix.into_string(); new_line.push_str(insert_lines[0].as_slice()); insert_lines[0] = new_line; let last_insert_lines_index = insert_lines.len() - 1; self.edit_point.index = insert_lines[last_insert_lines_index].char_len(); self.edit_point.line = begin.line + last_insert_lines_index; insert_lines[last_insert_lines_index].push_str(suffix); let mut new_lines = vec!(); new_lines.push_all(lines_prefix); new_lines.push_all(insert_lines.as_slice()); new_lines.push_all(lines_suffix); new_lines }; self.lines = new_lines; } /// Return the length of the current line under the editing point. fn current_line_length(&self) -> uint { self.lines[self.edit_point.line].char_len() } /// Adjust the editing point position by a given of lines. The resulting column is /// as close to the original column position as possible. fn adjust_vertical(&mut self, adjust: int, select: Selection) { if !self.multiline { return; } if select == Selection::Selected { if self.selection_begin.is_none() { self.selection_begin = Some(self.edit_point); } } else { self.clear_selection(); } assert!(self.edit_point.line < self.lines.len()); let target_line: int = self.edit_point.line as int + adjust; if target_line < 0 { self.edit_point.index = 0; self.edit_point.line = 0; return; } else if target_line as uint >= self.lines.len() { self.edit_point.line = self.lines.len() - 1; self.edit_point.index = self.current_line_length(); return; } self.edit_point.line = target_line as uint; self.edit_point.index = min(self.current_line_length(), self.edit_point.index); } /// Adjust the editing point position by a given number of columns. If the adjustment /// requested is larger than is available in the current line, the editing point is /// adjusted vertically and the process repeats with the remaining adjustment requested. fn adjust_horizontal(&mut self, adjust: int, select: Selection) { if select == Selection::Selected { if self.selection_begin.is_none() { self.selection_begin = Some(self.edit_point); } } else { if self.selection_begin.is_some() { let (begin, end) = self.get_sorted_selection(); self.edit_point = if adjust < 0 {begin} else {end}; self.clear_selection(); return } } if adjust < 0 { let remaining = self.edit_point.index; if adjust.abs() as uint > remaining && self.edit_point.line > 0 { self.adjust_vertical(-1, select); self.edit_point.index = self.current_line_length(); self.adjust_horizontal(adjust + remaining as int + 1, select); } else { self.edit_point.index = max(0, self.edit_point.index as int + adjust) as uint; } } else { let remaining = self.current_line_length() - self.edit_point.index; if adjust as uint > remaining && self.lines.len() > self.edit_point.line + 1 { self.adjust_vertical(1, select); self.edit_point.index = 0; // one shift is consumed by the change of line, hence the -1 self.adjust_horizontal(adjust - remaining as int - 1, select); } else { self.edit_point.index = min(self.current_line_length(), self.edit_point.index + adjust as uint); } } } /// Deal with a newline input. fn handle_return(&mut self) -> KeyReaction { if !self.multiline { return KeyReaction::TriggerDefaultAction; } self.insert_char('\n'); return KeyReaction::DispatchInput; } /// Select all text in the input control. fn select_all(&mut self) { self.selection_begin = Some(TextPoint { line: 0, index: 0, }); let last_line = self.lines.len() - 1; self.edit_point.line = last_line; self.edit_point.index = self.lines[last_line].char_len(); } /// Remove the current selection. fn clear_selection(&mut self) { self.selection_begin = None; } /// Process a given `KeyboardEvent` and return an action for the caller to execute. pub fn handle_keydown(&mut self, event: JSRef) -> KeyReaction { //A simple way to convert an event to a selection fn maybe_select(event: JSRef) -> Selection { if event.ShiftKey() { return Selection::Selected } return Selection::NotSelected } match event.Key().as_slice() { "a" if is_control_key(event) => { self.select_all(); KeyReaction::Nothing }, // printable characters have single-character key values c if c.len() == 1 => { self.insert_char(c.char_at(0)); return KeyReaction::DispatchInput; } "Space" => { self.insert_char(' '); KeyReaction::DispatchInput } "Delete" => { self.delete_char(DeleteDir::Forward); KeyReaction::DispatchInput } "Backspace" => { self.delete_char(DeleteDir::Backward); KeyReaction::DispatchInput } "ArrowLeft" => { self.adjust_horizontal(-1, maybe_select(event)); KeyReaction::Nothing } "ArrowRight" => { self.adjust_horizontal(1, maybe_select(event)); KeyReaction::Nothing } "ArrowUp" => { self.adjust_vertical(-1, maybe_select(event)); KeyReaction::Nothing } "ArrowDown" => { self.adjust_vertical(1, maybe_select(event)); KeyReaction::Nothing } "Enter" => self.handle_return(), "Home" => { self.edit_point.index = 0; KeyReaction::Nothing } "End" => { self.edit_point.index = self.current_line_length(); KeyReaction::Nothing } "PageUp" => { self.adjust_vertical(-28, maybe_select(event)); KeyReaction::Nothing } "PageDown" => { self.adjust_vertical(28, maybe_select(event)); KeyReaction::Nothing } "Tab" => KeyReaction::TriggerDefaultAction, _ => KeyReaction::Nothing, } } /// Get the current contents of the text input. Multiple lines are joined by \n. pub fn get_content(&self) -> DOMString { let mut content = "".into_string(); for (i, line) in self.lines.iter().enumerate() { content.push_str(line.as_slice()); if i < self.lines.len() - 1 { content.push('\n'); } } content } /// Set the current contents of the text input. If this is control supports multiple lines, /// any \n encountered will be stripped and force a new logical line. pub fn set_content(&mut self, content: DOMString) { self.lines = if self.multiline { content.as_slice().split('\n').map(|s| s.into_string()).collect() } else { vec!(content) }; self.edit_point.line = min(self.edit_point.line, self.lines.len() - 1); self.edit_point.index = min(self.edit_point.index, self.current_line_length()); } } #[test] fn test_textinput_delete_char() { let mut textinput = TextInput::new(Lines::Single, "abcdefg".into_string()); textinput.adjust_horizontal(2, Selection::NotSelected); textinput.delete_char(DeleteDir::Backward); assert_eq!(textinput.get_content().as_slice(), "acdefg"); textinput.delete_char(DeleteDir::Forward); assert_eq!(textinput.get_content().as_slice(), "adefg"); textinput.adjust_horizontal(2, Selection::Selected); textinput.delete_char(DeleteDir::Forward); assert_eq!(textinput.get_content().as_slice(), "afg"); } #[test] fn test_textinput_insert_char() { let mut textinput = TextInput::new(Lines::Single, "abcdefg".into_string()); textinput.adjust_horizontal(2, Selection::NotSelected); textinput.insert_char('a'); assert_eq!(textinput.get_content().as_slice(), "abacdefg"); textinput.adjust_horizontal(2, Selection::Selected); textinput.insert_char('b'); assert_eq!(textinput.get_content().as_slice(), "ababefg"); } #[test] fn test_textinput_get_sorted_selection() { let mut textinput = TextInput::new(Lines::Single, "abcdefg".into_string()); textinput.adjust_horizontal(2, Selection::NotSelected); textinput.adjust_horizontal(2, Selection::Selected); let (begin, end) = textinput.get_sorted_selection(); assert_eq!(begin.index, 2); assert_eq!(end.index, 4); textinput.clear_selection(); textinput.adjust_horizontal(-2, Selection::Selected); let (begin, end) = textinput.get_sorted_selection(); assert_eq!(begin.index, 2); assert_eq!(end.index, 4); } #[test] fn test_textinput_replace_selection() { let mut textinput = TextInput::new(Lines::Single, "abcdefg".into_string()); textinput.adjust_horizontal(2, Selection::NotSelected); textinput.adjust_horizontal(2, Selection::Selected); textinput.replace_selection("xyz".into_string()); assert_eq!(textinput.get_content().as_slice(), "abxyzefg"); } #[test] fn test_textinput_current_line_length() { let mut textinput = TextInput::new(Lines::Multiple, "abc\nde\nf".into_string()); assert_eq!(textinput.current_line_length(), 3); textinput.adjust_vertical(1, Selection::NotSelected); assert_eq!(textinput.current_line_length(), 2); textinput.adjust_vertical(1, Selection::NotSelected); assert_eq!(textinput.current_line_length(), 1); } #[test] fn test_textinput_adjust_vertical() { let mut textinput = TextInput::new(Lines::Multiple, "abc\nde\nf".into_string()); textinput.adjust_horizontal(3, Selection::NotSelected); textinput.adjust_vertical(1, Selection::NotSelected); assert_eq!(textinput.edit_point.line, 1); assert_eq!(textinput.edit_point.index, 2); textinput.adjust_vertical(-1, Selection::NotSelected); assert_eq!(textinput.edit_point.line, 0); assert_eq!(textinput.edit_point.index, 2); textinput.adjust_vertical(2, Selection::NotSelected); assert_eq!(textinput.edit_point.line, 2); assert_eq!(textinput.edit_point.index, 1); } #[test] fn test_textinput_adjust_horizontal() { let mut textinput = TextInput::new(Lines::Multiple, "abc\nde\nf".into_string()); textinput.adjust_horizontal(4, Selection::NotSelected); assert_eq!(textinput.edit_point.line, 1); assert_eq!(textinput.edit_point.index, 0); textinput.adjust_horizontal(1, Selection::NotSelected); assert_eq!(textinput.edit_point.line, 1); assert_eq!(textinput.edit_point.index, 1); textinput.adjust_horizontal(2, Selection::NotSelected); assert_eq!(textinput.edit_point.line, 2); assert_eq!(textinput.edit_point.index, 0); textinput.adjust_horizontal(-1, Selection::NotSelected); assert_eq!(textinput.edit_point.line, 1); assert_eq!(textinput.edit_point.index, 2); } #[test] fn test_textinput_handle_return() { let mut single_line_textinput = TextInput::new(Lines::Single, "abcdef".into_string()); single_line_textinput.adjust_horizontal(3, Selection::NotSelected); single_line_textinput.handle_return(); assert_eq!(single_line_textinput.get_content().as_slice(), "abcdef"); let mut multi_line_textinput = TextInput::new(Lines::Multiple, "abcdef".into_string()); multi_line_textinput.adjust_horizontal(3, Selection::NotSelected); multi_line_textinput.handle_return(); assert_eq!(multi_line_textinput.get_content().as_slice(), "abc\ndef"); } #[test] fn test_textinput_select_all() { let mut textinput = TextInput::new(Lines::Multiple, "abc\nde\nf".into_string()); assert_eq!(textinput.edit_point.line, 0); assert_eq!(textinput.edit_point.index, 0); textinput.select_all(); assert_eq!(textinput.edit_point.line, 2); assert_eq!(textinput.edit_point.index, 1); } #[test] fn test_textinput_get_content() { let single_line_textinput = TextInput::new(Lines::Single, "abcdefg".into_string()); assert_eq!(single_line_textinput.get_content().as_slice(), "abcdefg"); let multi_line_textinput = TextInput::new(Lines::Multiple, "abc\nde\nf".into_string()); assert_eq!(multi_line_textinput.get_content().as_slice(), "abc\nde\nf"); } #[test] fn test_textinput_set_content() { let mut textinput = TextInput::new(Lines::Multiple, "abc\nde\nf".into_string()); assert_eq!(textinput.get_content().as_slice(), "abc\nde\nf"); textinput.set_content("abc\nf".into_string()); assert_eq!(textinput.get_content().as_slice(), "abc\nf"); assert_eq!(textinput.edit_point.line, 0); assert_eq!(textinput.edit_point.index, 0); textinput.adjust_horizontal(3, Selection::Selected); assert_eq!(textinput.edit_point.line, 0); assert_eq!(textinput.edit_point.index, 3); textinput.set_content("de".into_string()); assert_eq!(textinput.get_content().as_slice(), "de"); assert_eq!(textinput.edit_point.line, 0); assert_eq!(textinput.edit_point.index, 2); }