/docs/_docs/features/quick-open.md

https://github.com/facebook/nuclide · Markdown · 90 lines · 57 code · 33 blank · 0 comment · 0 complexity · 8206e9314a2b570ddef996cd60b6cbc6 MD5 · raw file 

    

  1. ---
    2. 

  2. pageid: feature-quick-open
    3. 

  3. title: Quick Open
    4. 

  4. layout: docs
    5. 

  5. permalink: /docs/features/quick-open/
    6. 

  6. ---
    7. 

  7. 

  8. Nuclide goes beyond just normal file opening capabilities. Quick Open provides multiple
    9. 

  9. mechanisms to find a file, from recently opened files to a global OmniSearch that lets you search
    10. 

  10. for anything a file might contain.
    11. 

  11. 

  12. * TOC
    13. 

  13. {:toc}
    14. 

  14. 

  15. ## Toggling
    16. 

  16. 

  17. There are three ways to toggle the **Quick Open** window.
    18. 

  18. 

  19. - The `Cmd-T` (macOS) or `Ctrl-T` (Linux) keyboard shortcuts
    20. 

  20. - [Command palette](/docs/editor/basics/#command-palette) searching for
    21. 

  21. `Nuclide Quick Open: Find Anything Via Omni Search`
    22. 

  22. - [Quick Launch Menu](/docs/quick-start/getting-started/#quick-launch-menu)
    23. 

  23. 

  24. ![](/static/images/docs/feature-quick-open-toggle-window.png)
    25. 

  25. 

  26. > The `Hack Symbols` pane will only show if you have [Hack](/docs/languages/hack) files in your
    27. 

  27. > project.
    28. 

  28. 

  29. ## OmniSearch
    30. 

  30. 

  31. *Keyboard Shortcuts*: `Cmd-T` or `Cmd-P` (`Ctrl-T` or `Ctrl-P` on Linux)
    32. 

  32. 

  33. When launching the **Quick Open** window, you will be taken to the **OmniSearch** tab. All of the
    34. 

  34. features of the other tabs are coalesced and condensed into your search results in this tab.
    35. 

  35. 

  36. ![](/static/images/docs/feature-quick-open-omnisearch.png)
    37. 

  37. 

  38. ## Filenames
    39. 

  39. 

  40. *Keyboard Shortcut*: `Option-Cmd-T` (`Alt-Ctrl-T` Linux)
    41. 

  41. 

  42. If you just want to search by filename (including within the path to the file) only, you can click
    43. 

  43. on the **Filenames** tab in the **Quick Open** window.
    44. 

  44. 

  45. ![](/static/images/docs/feature-quick-open-filenames.png)
    46. 

  46. 

  47. ## Open Files
    48. 

  48. 

  49. *Keyboard Shortcut*: `Option-Cmd-O` (`Alt-Ctrl-O` Linux)
    50. 

  50. 

  51. If you have a lot of files open in your [editor](/docs/editor/basics), you can use the **Open Files** tab of Quick Open to quickly scan a list of your currently open files.
    52. 

  52. 

  53. ![](/static/images/docs/feature-quick-open-open-files.png)
    54. 

  54. 

  55. ## Recent Files
    56. 

  56. 

  57. *Keyboard Shortcut*: `Option-Cmd-R` (`Alt-Ctrl-R` Linux)
    58. 

  58. 

  59. If you have recently closed a file and would like to quickly open it back up, you can use the
    60. 

  60. **Recent Files** tab of Quick Open. This tab also displays when you last opened the file(s).
    61. 

  61. 

  62. ![](/static/images/docs/feature-quick-open-toggle-recent-files.png)
    63. 

  63. 

  64. ## Hack Symbols
    65. 

  65. 

  66. *Keyboard Shortcut*: `Option-Cmd-Y` (`Alt-Ctrl-Y` Linux)
    67. 

  67. 

  68. If your project contains [Hack](/docs/languages/hack) code, you will get Hack language-specific
    69. 

  69. search options. Here you can search based on function (`@function-name`), class (`#class-name`), or
    70. 

  70. constant (`%constant-name`) symbols in your project.
    71. 

  71. 

  72. To access this feature, click on the **Hack Symbols** tab in the **Quick Open** window.
    73. 

  73. 

  74. ![](/static/images/docs/feature-quick-open-toggle-hack-symbols.png)
    75. 

  75. 

  76. ## Code Search
    77. 

  77. 

  78. *Keyboard Shortcut*: `Option-Cmd-K` (`Alt-Ctrl-K` Linux)
    79. 

  79. 

  80. The Code Search tab will help you find a piece of code within all the source files in your projects.
    81. 

  81. Internally it uses either [ripgrep](https://github.com/BurntSushi/ripgrep) (rg),
    82. 

  82. [silversearcher](https://github.com/ggreer/the_silver_searcher) (ag) or
    83. 

  83. [ack](https://beyondgrep.com/).
    84. 

  84. 

  85. By default, Nuclide will use any available tool in your PATH.
    86. 

  86. However, you can specify a default one in the *nuclide-code-search* tab in the Nuclide package
    87. 

  87. settings. We recommend ripgrep and ag because they are blazing fast. Sadly, only ripgrep works
    88. 

  88. properly on Windows.
    89. 

  89. 

  90. ![](/static/images/blog/2017-08-31/quick-open.png)
    91.