Add experimental Support for DOM3 KeyboardEvent key value

public/platform/Platform.h

Index: public/platform/Platform.h
diff --git a/public/platform/Platform.h b/public/platform/Platform.h
index 8bfed7888c95c1943322a3bddf4762cd7429e32e..81ccf13ae72df1d0408797fac3c7100480b69551 100644
--- a/public/platform/Platform.h
+++ b/public/platform/Platform.h
@@ -638,6 +638,18 @@ public:
     // Returns 0, if DOM code enum is not found.
     virtual int domEnumFromCodeString(const WebString& codeString) { return 0; }
 
+    // This method converts from the supplied DOM |key| enum to the

[Wez, 2015/05/06 01:32:13]

Suggest: "... from the embedder-supplied |domKey| enum value to ..."

+    // corresponding DOM |key| string value for the key pressed. |domKey| values are

[Wez, 2015/05/06 01:32:13]

nit: Remove "for the key pressed" - the call accepts just a string containing a
DOM UI Events |key| meaning; it doesn't contain anything specific to a key
press, release, etc.

Also suggest wrapping consistently to 80 chars, since that's what you've done
for the rest of the comment. :)

+    // based on the value defined in ui/events/keycodes/dom3/dom_key_data.h.

[Wez, 2015/05/06 01:32:13]

Reword: "The DOM |key| enum <-> string mappings for Chromium are defined in ..."

or, better still, just remove the reference to the Chromium path, since that's a
Chromium- (and in general an embedder-) specific detail.

+    // Returns empty string, if DOM key value is not found.

[Wez, 2015/05/06 01:32:13]

nit: No need for comma between "string" and "if". Add "the" between "if" and
"DOM", and between "Returns" and "empty".

+    virtual WebString domKeyStringFromEnum(int domKey) { return WebString(); }
+
+    // This method converts from the suppled DOM |key| value to the
+    // embedder's DOM |key| enum for the key pressed. |keyString| is defined in

[Wez, 2015/05/06 01:32:13]

Suggest: "... to the embedder's corresponding enum value."

+    // ui/events/keycodes/dom3/dom_key_data.h.
+    // Returns 0 if DOM key enum is not found.

[Wez, 2015/05/06 01:32:13]

nit: Suggest "Returns 0 if |keyString| is not recognized."

+    virtual int domKeyEnumFromString(const WebString& keyString) { return 0; }
+
     // Quota -----------------------------------------------------------
 
     // Queries the storage partition's storage usage and quota information.