• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2006, 2007, 2008, 2011 Apple Inc. All rights reserved.
3  * Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies)
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  */
26 
27 #include "config.h"
28 #include "core/editing/InputMethodController.h"
29 
30 #include "core/events/CompositionEvent.h"
31 #include "core/dom/Document.h"
32 #include "core/dom/Element.h"
33 #include "core/dom/Range.h"
34 #include "core/dom/Text.h"
35 #include "core/editing/Editor.h"
36 #include "core/editing/TypingCommand.h"
37 #include "core/frame/LocalFrame.h"
38 #include "core/html/HTMLTextAreaElement.h"
39 #include "core/page/Chrome.h"
40 #include "core/page/ChromeClient.h"
41 #include "core/page/EventHandler.h"
42 #include "core/rendering/RenderObject.h"
43 
44 namespace WebCore {
45 
SelectionOffsetsScope(InputMethodController * inputMethodController)46 InputMethodController::SelectionOffsetsScope::SelectionOffsetsScope(InputMethodController* inputMethodController)
47     : m_inputMethodController(inputMethodController)
48     , m_offsets(inputMethodController->getSelectionOffsets())
49 {
50 }
51 
~SelectionOffsetsScope()52 InputMethodController::SelectionOffsetsScope::~SelectionOffsetsScope()
53 {
54     m_inputMethodController->setSelectionOffsets(m_offsets);
55 }
56 
57 // ----------------------------
58 
create(LocalFrame & frame)59 PassOwnPtr<InputMethodController> InputMethodController::create(LocalFrame& frame)
60 {
61     return adoptPtr(new InputMethodController(frame));
62 }
63 
InputMethodController(LocalFrame & frame)64 InputMethodController::InputMethodController(LocalFrame& frame)
65     : m_frame(frame)
66     , m_compositionStart(0)
67     , m_compositionEnd(0)
68 {
69 }
70 
~InputMethodController()71 InputMethodController::~InputMethodController()
72 {
73 }
74 
hasComposition() const75 bool InputMethodController::hasComposition() const
76 {
77     return m_compositionNode && m_compositionNode->isContentEditable();
78 }
79 
editor() const80 inline Editor& InputMethodController::editor() const
81 {
82     return m_frame.editor();
83 }
84 
clear()85 void InputMethodController::clear()
86 {
87     m_compositionNode = nullptr;
88     m_customCompositionUnderlines.clear();
89 }
90 
insertTextForConfirmedComposition(const String & text)91 bool InputMethodController::insertTextForConfirmedComposition(const String& text)
92 {
93     return m_frame.eventHandler().handleTextInputEvent(text, 0, TextEventInputComposition);
94 }
95 
selectComposition() const96 void InputMethodController::selectComposition() const
97 {
98     RefPtrWillBeRawPtr<Range> range = compositionRange();
99     if (!range)
100         return;
101 
102     // The composition can start inside a composed character sequence, so we have to override checks.
103     // See <http://bugs.webkit.org/show_bug.cgi?id=15781>
104     VisibleSelection selection;
105     selection.setWithoutValidation(range->startPosition(), range->endPosition());
106     m_frame.selection().setSelection(selection, 0);
107 }
108 
confirmComposition()109 bool InputMethodController::confirmComposition()
110 {
111     if (!hasComposition())
112         return false;
113     return finishComposition(m_compositionNode->data().substring(m_compositionStart, m_compositionEnd - m_compositionStart), ConfirmComposition);
114 }
115 
confirmComposition(const String & text)116 bool InputMethodController::confirmComposition(const String& text)
117 {
118     return finishComposition(text, ConfirmComposition);
119 }
120 
confirmCompositionOrInsertText(const String & text,ConfirmCompositionBehavior confirmBehavior)121 bool InputMethodController::confirmCompositionOrInsertText(const String& text, ConfirmCompositionBehavior confirmBehavior)
122 {
123     if (!hasComposition()) {
124         if (!text.length())
125             return false;
126         editor().insertText(text, 0);
127         return true;
128     }
129 
130     if (text.length()) {
131         confirmComposition(text);
132         return true;
133     }
134 
135     if (confirmBehavior != KeepSelection)
136         return confirmComposition();
137 
138     SelectionOffsetsScope selectionOffsetsScope(this);
139     return confirmComposition();
140 }
141 
confirmCompositionAndResetState()142 void InputMethodController::confirmCompositionAndResetState()
143 {
144     if (!hasComposition())
145         return;
146 
147     // ChromeClient::willSetInputMethodState() resets input method and the composition string is committed.
148     m_frame.chromeClient().willSetInputMethodState();
149 }
150 
cancelComposition()151 void InputMethodController::cancelComposition()
152 {
153     finishComposition(emptyString(), CancelComposition);
154 }
155 
cancelCompositionIfSelectionIsInvalid()156 void InputMethodController::cancelCompositionIfSelectionIsInvalid()
157 {
158     if (!hasComposition() || editor().preventRevealSelection())
159         return;
160 
161     // Check if selection start and selection end are valid.
162     Position start = m_frame.selection().start();
163     Position end = m_frame.selection().end();
164     if (start.containerNode() == m_compositionNode
165         && end.containerNode() == m_compositionNode
166         && static_cast<unsigned>(start.computeOffsetInContainerNode()) >= m_compositionStart
167         && static_cast<unsigned>(end.computeOffsetInContainerNode()) <= m_compositionEnd)
168         return;
169 
170     cancelComposition();
171     m_frame.chromeClient().didCancelCompositionOnSelectionChange();
172 }
173 
finishComposition(const String & text,FinishCompositionMode mode)174 bool InputMethodController::finishComposition(const String& text, FinishCompositionMode mode)
175 {
176     if (!hasComposition())
177         return false;
178 
179     ASSERT(mode == ConfirmComposition || mode == CancelComposition);
180 
181     Editor::RevealSelectionScope revealSelectionScope(&editor());
182 
183     if (mode == CancelComposition)
184         ASSERT(text == emptyString());
185     else
186         selectComposition();
187 
188     if (m_frame.selection().isNone())
189         return false;
190 
191     // Dispatch a compositionend event to the focused node.
192     // We should send this event before sending a TextEvent as written in Section 6.2.2 and 6.2.3 of
193     // the DOM Event specification.
194     if (Element* target = m_frame.document()->focusedElement()) {
195         unsigned baseOffset = m_frame.selection().base().downstream().deprecatedEditingOffset();
196         Vector<CompositionUnderline> underlines;
197         for (size_t i = 0; i < m_customCompositionUnderlines.size(); ++i) {
198             CompositionUnderline underline = m_customCompositionUnderlines[i];
199             underline.startOffset -= baseOffset;
200             underline.endOffset -= baseOffset;
201             underlines.append(underline);
202         }
203         RefPtrWillBeRawPtr<CompositionEvent> event = CompositionEvent::create(EventTypeNames::compositionend, m_frame.domWindow(), text, underlines);
204         target->dispatchEvent(event, IGNORE_EXCEPTION);
205     }
206 
207     // If text is empty, then delete the old composition here. If text is non-empty, InsertTextCommand::input
208     // will delete the old composition with an optimized replace operation.
209     if (text.isEmpty() && mode != CancelComposition) {
210         ASSERT(m_frame.document());
211         TypingCommand::deleteSelection(*m_frame.document(), 0);
212     }
213 
214     m_compositionNode = nullptr;
215     m_customCompositionUnderlines.clear();
216 
217     insertTextForConfirmedComposition(text);
218 
219     if (mode == CancelComposition) {
220         // An open typing command that disagrees about current selection would cause issues with typing later on.
221         TypingCommand::closeTyping(&m_frame);
222     }
223 
224     return true;
225 }
226 
setComposition(const String & text,const Vector<CompositionUnderline> & underlines,unsigned selectionStart,unsigned selectionEnd)227 void InputMethodController::setComposition(const String& text, const Vector<CompositionUnderline>& underlines, unsigned selectionStart, unsigned selectionEnd)
228 {
229     Editor::RevealSelectionScope revealSelectionScope(&editor());
230 
231     // Updates styles before setting selection for composition to prevent
232     // inserting the previous composition text into text nodes oddly.
233     // See https://bugs.webkit.org/show_bug.cgi?id=46868
234     m_frame.document()->updateRenderTreeIfNeeded();
235 
236     selectComposition();
237 
238     if (m_frame.selection().isNone())
239         return;
240 
241     if (Element* target = m_frame.document()->focusedElement()) {
242         // Dispatch an appropriate composition event to the focused node.
243         // We check the composition status and choose an appropriate composition event since this
244         // function is used for three purposes:
245         // 1. Starting a new composition.
246         //    Send a compositionstart and a compositionupdate event when this function creates
247         //    a new composition node, i.e.
248         //    m_compositionNode == 0 && !text.isEmpty().
249         //    Sending a compositionupdate event at this time ensures that at least one
250         //    compositionupdate event is dispatched.
251         // 2. Updating the existing composition node.
252         //    Send a compositionupdate event when this function updates the existing composition
253         //    node, i.e. m_compositionNode != 0 && !text.isEmpty().
254         // 3. Canceling the ongoing composition.
255         //    Send a compositionend event when function deletes the existing composition node, i.e.
256         //    m_compositionNode != 0 && test.isEmpty().
257         RefPtrWillBeRawPtr<CompositionEvent> event = nullptr;
258         if (!hasComposition()) {
259             // We should send a compositionstart event only when the given text is not empty because this
260             // function doesn't create a composition node when the text is empty.
261             if (!text.isEmpty()) {
262                 target->dispatchEvent(CompositionEvent::create(EventTypeNames::compositionstart, m_frame.domWindow(), m_frame.selectedText(), underlines));
263                 event = CompositionEvent::create(EventTypeNames::compositionupdate, m_frame.domWindow(), text, underlines);
264             }
265         } else {
266             if (!text.isEmpty())
267                 event = CompositionEvent::create(EventTypeNames::compositionupdate, m_frame.domWindow(), text, underlines);
268             else
269                 event = CompositionEvent::create(EventTypeNames::compositionend, m_frame.domWindow(), text, underlines);
270         }
271         if (event.get())
272             target->dispatchEvent(event, IGNORE_EXCEPTION);
273     }
274 
275     // If text is empty, then delete the old composition here. If text is non-empty, InsertTextCommand::input
276     // will delete the old composition with an optimized replace operation.
277     if (text.isEmpty()) {
278         ASSERT(m_frame.document());
279         TypingCommand::deleteSelection(*m_frame.document(), TypingCommand::PreventSpellChecking);
280     }
281 
282     m_compositionNode = nullptr;
283     m_customCompositionUnderlines.clear();
284 
285     if (!text.isEmpty()) {
286         ASSERT(m_frame.document());
287         TypingCommand::insertText(*m_frame.document(), text, TypingCommand::SelectInsertedText | TypingCommand::PreventSpellChecking, TypingCommand::TextCompositionUpdate);
288 
289         // Find out what node has the composition now.
290         Position base = m_frame.selection().base().downstream();
291         Position extent = m_frame.selection().extent();
292         Node* baseNode = base.deprecatedNode();
293         unsigned baseOffset = base.deprecatedEditingOffset();
294         Node* extentNode = extent.deprecatedNode();
295         unsigned extentOffset = extent.deprecatedEditingOffset();
296 
297         if (baseNode && baseNode == extentNode && baseNode->isTextNode() && baseOffset + text.length() == extentOffset) {
298             m_compositionNode = toText(baseNode);
299             m_compositionStart = baseOffset;
300             m_compositionEnd = extentOffset;
301             m_customCompositionUnderlines = underlines;
302             size_t numUnderlines = m_customCompositionUnderlines.size();
303             for (size_t i = 0; i < numUnderlines; ++i) {
304                 m_customCompositionUnderlines[i].startOffset += baseOffset;
305                 m_customCompositionUnderlines[i].endOffset += baseOffset;
306             }
307             if (baseNode->renderer())
308                 baseNode->renderer()->paintInvalidationForWholeRenderer();
309 
310             unsigned start = std::min(baseOffset + selectionStart, extentOffset);
311             unsigned end = std::min(std::max(start, baseOffset + selectionEnd), extentOffset);
312             RefPtrWillBeRawPtr<Range> selectedRange = Range::create(baseNode->document(), baseNode, start, baseNode, end);
313             m_frame.selection().setSelectedRange(selectedRange.get(), DOWNSTREAM, FrameSelection::NonDirectional, NotUserTriggered);
314         }
315     }
316 }
317 
setCompositionFromExistingText(const Vector<CompositionUnderline> & underlines,unsigned compositionStart,unsigned compositionEnd)318 void InputMethodController::setCompositionFromExistingText(const Vector<CompositionUnderline>& underlines, unsigned compositionStart, unsigned compositionEnd)
319 {
320     Element* editable = m_frame.selection().rootEditableElement();
321     Position base = m_frame.selection().base().downstream();
322     Node* baseNode = base.anchorNode();
323     if (editable->firstChild() == baseNode && editable->lastChild() == baseNode && baseNode->isTextNode()) {
324         m_compositionNode = nullptr;
325         m_customCompositionUnderlines.clear();
326 
327         if (base.anchorType() != Position::PositionIsOffsetInAnchor)
328             return;
329         if (!baseNode || baseNode != m_frame.selection().extent().anchorNode())
330             return;
331 
332         m_compositionNode = toText(baseNode);
333         RefPtrWillBeRawPtr<Range> range = PlainTextRange(compositionStart, compositionEnd).createRange(*editable);
334         m_compositionStart = range->startOffset();
335         m_compositionEnd = range->endOffset();
336         m_customCompositionUnderlines = underlines;
337         size_t numUnderlines = m_customCompositionUnderlines.size();
338         for (size_t i = 0; i < numUnderlines; ++i) {
339             m_customCompositionUnderlines[i].startOffset += m_compositionStart;
340             m_customCompositionUnderlines[i].endOffset += m_compositionStart;
341         }
342         if (baseNode->renderer())
343             baseNode->renderer()->paintInvalidationForWholeRenderer();
344         return;
345     }
346 
347     Editor::RevealSelectionScope revealSelectionScope(&editor());
348     SelectionOffsetsScope selectionOffsetsScope(this);
349     setSelectionOffsets(PlainTextRange(compositionStart, compositionEnd));
350     setComposition(m_frame.selectedText(), underlines, 0, 0);
351 }
352 
compositionRange() const353 PassRefPtrWillBeRawPtr<Range> InputMethodController::compositionRange() const
354 {
355     if (!hasComposition())
356         return nullptr;
357     unsigned length = m_compositionNode->length();
358     unsigned start = std::min(m_compositionStart, length);
359     unsigned end = std::min(std::max(start, m_compositionEnd), length);
360     if (start >= end)
361         return nullptr;
362     return Range::create(m_compositionNode->document(), m_compositionNode.get(), start, m_compositionNode.get(), end);
363 }
364 
getSelectionOffsets() const365 PlainTextRange InputMethodController::getSelectionOffsets() const
366 {
367     RefPtrWillBeRawPtr<Range> range = m_frame.selection().selection().firstRange();
368     if (!range)
369         return PlainTextRange();
370     Node* editable = m_frame.selection().rootEditableElementOrTreeScopeRootNode();
371     ASSERT(editable);
372     return PlainTextRange::create(*editable, *range.get());
373 }
374 
setSelectionOffsets(const PlainTextRange & selectionOffsets)375 bool InputMethodController::setSelectionOffsets(const PlainTextRange& selectionOffsets)
376 {
377     if (selectionOffsets.isNull())
378         return false;
379     Element* rootEditableElement = m_frame.selection().rootEditableElement();
380     if (!rootEditableElement)
381         return false;
382 
383     RefPtrWillBeRawPtr<Range> range = selectionOffsets.createRange(*rootEditableElement);
384     if (!range)
385         return false;
386 
387     return m_frame.selection().setSelectedRange(range.get(), VP_DEFAULT_AFFINITY, FrameSelection::NonDirectional, FrameSelection::CloseTyping);
388 }
389 
setEditableSelectionOffsets(const PlainTextRange & selectionOffsets)390 bool InputMethodController::setEditableSelectionOffsets(const PlainTextRange& selectionOffsets)
391 {
392     if (!editor().canEdit())
393         return false;
394     return setSelectionOffsets(selectionOffsets);
395 }
396 
extendSelectionAndDelete(int before,int after)397 void InputMethodController::extendSelectionAndDelete(int before, int after)
398 {
399     if (!editor().canEdit())
400         return;
401     PlainTextRange selectionOffsets(getSelectionOffsets());
402     if (selectionOffsets.isNull())
403         return;
404 
405     // A common call of before=1 and after=0 will fail if the last character
406     // is multi-code-word UTF-16, including both multi-16bit code-points and
407     // Unicode combining character sequences of multiple single-16bit code-
408     // points (officially called "compositions"). Try more until success.
409     // http://crbug.com/355995
410     //
411     // FIXME: Note that this is not an ideal solution when this function is
412     // called to implement "backspace". In that case, there should be some call
413     // that will not delete a full multi-code-point composition but rather
414     // only the last code-point so that it's possible for a user to correct
415     // a composition without starting it from the beginning.
416     // http://crbug.com/37993
417     do {
418         if (!setSelectionOffsets(PlainTextRange(std::max(static_cast<int>(selectionOffsets.start()) - before, 0), selectionOffsets.end() + after)))
419             return;
420         if (before == 0)
421             break;
422         ++before;
423     } while (m_frame.selection().start() == m_frame.selection().end() && before <= static_cast<int>(selectionOffsets.start()));
424     TypingCommand::deleteSelection(*m_frame.document());
425 }
426 
427 } // namespace WebCore
428