DevTools: [Documentation] Add property token autodetection

Now documentation context menu item appears without token selection.

BUG=391593

Review URL: https://codereview.chromium.org/471583003

git-svn-id: svn://svn.chromium.org/blink/trunk@180362 bbb929c8-8fbe-4397-9dbb-9b2b20218538

third_party/WebKit/Source/devtools/front_end/documentation/DocumentationURLProvider.js

@@ -38,10 +38,15 @@ WebInspector.DocumentationURLProvider._sources = [
  */
 WebInspector.DocumentationURLProvider._urlFormat = "http://docs.webplatform.org/w/api.php?action=query&titles=%s%s&prop=revisions&rvprop=timestamp|content&format=json"
 
+/**
+ * @typedef {{url: string, name: string, searchItem: string}}
+ */
+WebInspector.DocumentationURLProvider.ItemDescriptor;
+
 WebInspector.DocumentationURLProvider.prototype = {
     /**
      * @param {string} searchTerm
-     * @return {!Array.<{url: string, name: string}>}
+     * @return {!Array.<!WebInspector.DocumentationURLProvider.ItemDescriptor>}
      */
     itemDescriptors: function(searchTerm)
     {
@@ -56,13 +61,14 @@ WebInspector.DocumentationURLProvider.prototype = {
 
         /**
          * @param {string} searchTerm
-         * @return {{url: string, name: string}}
+         * @return {!WebInspector.DocumentationURLProvider.ItemDescriptor}
          */
         function createDescriptor(searchTerm)
         {
             return {
                 url: String.sprintf(WebInspector.DocumentationURLProvider._urlFormat, sourceRef.url, searchTerm),
-                name: sourceRef.name
+                name: sourceRef.name,
+                searchItem: searchTerm
             };
         }
     }

third_party/WebKit/Source/devtools/front_end/documentation/DocumentationView.js

@@ -45,21 +45,52 @@ WebInspector.DocumentationView.ContextMenuProvider.prototype = {
         if (!(target instanceof WebInspector.CodeMirrorTextEditor))
             return;
         var textEditor = /** @type {!WebInspector.CodeMirrorTextEditor} */ (target);
-        var selection = textEditor.selection();
-        if (!selection || selection.isEmpty() || selection.startLine !== selection.endLine)
-            return;
-        var selectedText = textEditor.copyRange(selection);
-        var urlProvider = new WebInspector.DocumentationURLProvider();
-        var descriptors = urlProvider.itemDescriptors(selectedText);
+        var descriptors = this._determineDescriptors(textEditor);
+
         if (!descriptors.length)
             return;
         if (descriptors.length === 1) {
             var formatString = WebInspector.useLowerCaseMenuTitles() ? "Show documentation for %s.%s" : "Show Documentation for %s.%s";
-            contextMenu.appendItem(WebInspector.UIString(formatString, descriptors[0].name, selectedText), WebInspector.DocumentationView.showDocumentationURL.bind(null, descriptors[0].url));
+            contextMenu.appendItem(WebInspector.UIString(formatString, descriptors[0].name, descriptors[0].searchItem), WebInspector.DocumentationView.showDocumentationURL.bind(null, descriptors[0].url));
             return;
         }
         var subMenuItem = contextMenu.appendSubMenuItem(WebInspector.UIString(WebInspector.useLowerCaseMenuTitles() ? "Show documentation for..." : "Show Documentation for..."));
         for (var i = 0; i < descriptors.length; ++i)
-            subMenuItem.appendItem(String.sprintf("%s.%s", descriptors[i].name, selectedText), WebInspector.DocumentationView.showDocumentationURL.bind(null, descriptors[i].url));
+            subMenuItem.appendItem(String.sprintf("%s.%s", descriptors[i].name, descriptors[i].searchItem), WebInspector.DocumentationView.showDocumentationURL.bind(null, descriptors[i].url));
+    },
+
+    /**
+     * @param {!WebInspector.CodeMirrorTextEditor} textEditor
+     * @return {!Array.<!WebInspector.DocumentationURLProvider.ItemDescriptor>}
+     */
+    _determineDescriptors: function(textEditor)
+    {
+        var urlProvider = new WebInspector.DocumentationURLProvider();
+        var textSelection = textEditor.selection().normalize();
+
+        if (!textSelection.isEmpty()) {
+            if (textSelection.startLine !== textSelection.endLine)
+                return [];
+            return urlProvider.itemDescriptors(textEditor.copyRange(textSelection));
+        }
+
+        var descriptors = computeDescriptors(textSelection.startColumn);
+        if (descriptors.length)
+            return descriptors;
+
+        return computeDescriptors(textSelection.startColumn - 1);
+
+        /**
+         * @param {number} column
+         * @return {!Array.<!WebInspector.DocumentationURLProvider.ItemDescriptor>}
+         */
+        function computeDescriptors(column)
+        {
+            var token = textEditor.tokenAtTextPosition(textSelection.startLine, column);
+            if (!token)
+                return [];
+            var tokenText = textEditor.line(textSelection.startLine).substring(token.startColumn, token.endColumn);
+            return urlProvider.itemDescriptors(tokenText);
+        }
     }
 }