[InputEvent] Add 'beforeinput' logic in |will*()| and guarded by a flag (3/11)

third_party/WebKit/Source/core/editing/commands/CompositeEditCommand.h

 /*
  * Copyright (C) 2005, 2006, 2008 Apple Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
@@ skipping 62 matching lines @@
     return m_endingRootEditableElement.get();
   }
 
   DECLARE_VIRTUAL_TRACE();
 
  private:
   EditCommandComposition(Document*,
                          const VisibleSelection& startingSelection,
                          const VisibleSelection& endingSelection);
 
-  // TODO(chongz): Implement "beforeinput" as described below:
-  // Fires "beforeinput" and will returns |false| to cancel unapply / reapply if
+  // Fires "beforeinput" if |BeforeInputTiming == kShouldFireInCommand|.
+  // Will return |false| to cancel unapply / reapply if
   //   * "beforeinput" was canceled, or
   //   * |frame| was destroyed by event handlers.
   // Note: Undo stack will always get popped.
   bool willUnapply(EditCommandSource, BeforeInputTiming);
   bool willReapply(EditCommandSource, BeforeInputTiming);
 
   Member<Document> m_document;
   VisibleSelection m_startingSelection;
   VisibleSelection m_endingSelection;
   HeapVector<Member<SimpleEditCommand>> m_commands;
@@ skipping 31 matching lines @@
   // |TypingCommand| will return the text of the last |m_commands|.
   virtual String textDataForInputEvent() const;
   virtual DataTransfer* dataTransferForInputEvent() const;
   virtual RangeVector* targetRangesForInputEvent() const;
 
   DECLARE_VIRTUAL_TRACE();
 
  protected:
   explicit CompositeEditCommand(Document&);
 
-  // TODO(chongz): Implement "beforeinput" as described below:
-  // Fires "beforeinput" and will return |false| to cancel applying editing if
+  // Fires "beforeinput" if |BeforeInputTiming == kShouldFireInCommand|.
+  // Will return |false| to cancel applying editing if
   //   * "beforeinput" was canceled, or
   //   * |frame| was destroyed by event handlers.
   // |willApplyEditing()| should be called from
   //   * |CompositeEditCommand::apply()|, and
   //   * |TypingCommand::willAddTypingToOpenCommand()|.
   bool willApplyEditing(EditCommandSource, BeforeInputTiming);
 
   //
   // sugary-sweet convenience functions to help create and apply edit commands
   // in composite commands
@@ skipping 148 matching lines @@
 
 DEFINE_TYPE_CASTS(CompositeEditCommand,
                   EditCommand,
                   command,
                   command->isCompositeEditCommand(),
                   command.isCompositeEditCommand());
 
 }  // namespace blink
 
 #endif  // CompositeEditCommand_h