Skip to main content

DQLEditor

The DQLEditor is specifically designed for editing DQL queries.

It further offers syntax highlighting and autocomplete functionality specific to the Dynatrace Query Language (DQL). Once the editor is focused via the keyboard, the user must press Enter to start editing and Escape to quit editing and return to the keyboard navigation flow.

OverviewPropertiesUsageChangelog3.14.0

Changes to DQLEditor. The full components changelog also lists package-wide and cross-cutting entries.

3.14.0​

Updates​

  • Introduced the new showOffScreenDiagnosticIndicators prop that renders floating pill buttons at the top and bottom edges of the editor indicating off-screen error-severity validation problems, each showing the count of off-screen errors. Clicking a pill scrolls the nearest such error into view. (APPDEV-17075)

3.11.3​

Updates​

  • Added showLintGutter prop to show per-line severity markers in a gutter column. (APPDEV-17073)
  • Fixed the autocomplete section header incorrectly appearing at the second position instead of the top when navigating to a paginated suggestions page. (APPDEV-19531)
  • Improved the autocomplete suggestion tooltip layout and content. (APPDEV-17385)
  • Fixed function names with trailing digits being incorrectly highlighted as number literals in the autocomplete info popup synopsis. (APPDEV-19541)
  • Fixed the autocomplete popup leaving extra space below informational text when no suggestions are available. (APPDEV-19536)

3.11.0​

Updates​

  • Autocomplete suggestion labels are now truncated with a middle ellipsis that adapts to the available space — longer type labels reduce the suggestion threshold so labels no longer wrap or overflow the panel. (APPDEV-17383)
  • Added token type display next to each suggestion in the autocomplete panel. (APPDEV-17383)
  • The autocomplete suggestion description no longer shows internal placeholder text for value suggestions. (APPDEV-19072)

3.10.0​

Updates​

  • Fixed the freeze that occurred when syntax highlighting a DQL query containing a triple-quoted string with many escaped quotes. (APPDEV-18665)
  • Fixed a redundant tooltip appearing in the autocomplete when there are no suggestions and only info is shown. (APPDEV-18761)

3.9.0​

Updates​

  • The "Format query" action menu item now displays its keyboard shortcut (Cmd+Shift+F on macOS, Ctrl+Shift+F on Windows/Linux). (APPDEV-18298)
  • Improved the line highlight animation that plays when the editor value changes externally. The highlight now appears instantly and fades out smoothly, using a subtler color that no longer inverts the text color. (APPDEV-18552)
  • Now shows the correct autocomplete suggestions after a duration unit. (APPDEV-18323)
  • Code folding is now supported for block comments and subqueries. (APPDEV-18343)
  • Now shows the correct autocomplete suggestion when typing a duration unit alias after a number. (APPDEV-18323)
  • Fixed the issue where autosuggestions could carry over between separate DQL editors. (APPDEV-18160)
  • Autocomplete now runs a fresh query when you type a dot, ensuring all fields are included in the suggestions. (APPDEV-18160)

3.8.0​

Deprecations​

  • isControlled is deprecated from the start and will be removed when fully controlled behavior becomes the default. (APPDEV-5775)

Updates​

  • Tooltips on autocomplete suggestions are now also shown on mouse hover. (APPDEV-17382)
  • Fixed an editor crash that occurred sometimes when clicking on an editor while it was hidden, detached, or mid-layout (e.g. inside a re-rendering or collapsing container). (APPDEV-17855)
  • Fixed incorrect spacing around the actions menu trigger button when the visual refresh introduced in Strato 3.5.0 is enabled. The trigger is now correctly aligned to the top-right corner of the editor. (APPDEV-18162)
  • Updated the list of DQL commands used for syntax highlighting with the following: removed experimentalFieldsSummary and experimentalLoad, added metrics, and prepared syntax highlighting support for new, upcoming commands. (APPDEV-18180)
  • DQL formatting is now available via a built-in menu button or keyboard shortcut (Ctrl-Shift-f, Mac: Cmd-Shift-f). (PRODUCT-12538)
  • Improved DQL autocomplete when replacing existing command tokens, including nested subqueries. (APPDEV-17943)
  • You can now opt in to fully controlled editor behavior. Set isControlled={true} to have the editor always reflect value and forward user input via onChange. When false (default), existing value behavior stays unchanged. As this prop will be removed when fully controlled behavior becomes the standard, it is already deprecated. (APPDEV-5775)

3.7.0​

Updates​

  • Added a defaultValue prop for uncontrolled usage. It sets the initial editor content. Existing value behavior is unchanged. (APPDEV-17373)
  • DQLEditor.ActionsMenu now accepts optional children. Custom menu items passed as children are rendered between the built-in Copy query and Open documentation actions. (APPDEV-17376)
  • Fixed an editor crash that could occur when hovering over an editor while it was hidden, detached, or mid-layout (e.g. inside a re-rendering or collapsing container). (APPDEV-17905)
  • The autocomplete popup now includes an info section below the suggestions and shows relevant keyboard shortcuts along with a link to the DQL syntax documentation. (APPDEV-17384)

3.6.0​

Updates​

  • Typing a backtick or other dead-key character on keyboard layouts that require IME composition no longer corrupts the editor content. (APPDEV-17841)
  • Autosuggestions now open only on typing, Ctrl+Space, or focus into an empty editor — not on cursor navigation or focus into a non-empty editor. Additionally, autosuggestions now reopen after ESC when continuing to type a command prefix following an inline block comment. (APPDEV-17881)
  • Null literals are now syntax-highlighted. (APPDEV-17731)
  • A query between at least two triple-quoted strings in one line is no longer highlighted as a string. (APPDEV-17719)
  • A single-line comment containing consecutive double-quote characters is now correctly highlighted as a comment to the end of the line. (APPDEV-17719)
  • Added DQLEditor.ActionsMenu slot that enables a built-in actions menu with "Copy query" and "Open documentation" actions. (APPDEV-17375)

3.5.2​

Updates​

  • Autosuggestions now open only on typing, Ctrl+Space, or focus into an empty editor — not on cursor navigation or focus into a non-empty editor. Additionally, autosuggestions now reopen after ESC when continuing to type a command prefix following an inline block comment. (APPDEV-17881)

3.5.0​

Updates​

  • Syntax highlighting no longer highlights commands when they appear at the beginning of another token. (APPDEV-11154)
  • Number literals followed by a duration or calendar duration unit suffix are now highlighted. (APPDEV-17380)
  • Boolean literals are now syntax-highlighted. (APPDEV-17379)

3.4.1​

Updates​

  • Autosuggestions now open only on typing, Ctrl+Space, or focus into an empty editor — not on cursor navigation or focus into a non-empty editor. Additionally, autosuggestions now reopen after ESC when continuing to type a command prefix following an inline block comment. (APPDEV-17881)

3.4.0​

Updates​

  • Autocomplete now reopens when typing resumes after dismissing suggestions with Esc, as well as when the cursor is positioned before or after a comment. (APPDEV-16879)
  • Autocomplete suggestions now open automatically when the cursor is placed on a new line after existing query content. (APPDEV-17256)

3.2.0​

Updates​

  • Added data-dt-name attribute to autocomplete suggestion items and the "Learn more" link. (APPDEV-16670)
Still have questions?
Find answers in the Dynatrace Community