intellij-sdk-code-samples/topics/user_interface_components/editor_components.md

Editor Components

Creating, customizing and using editor components in different contexts.

EditorTextField

Compared to Swing JTextArea, the IntelliJ Platform's editor component has a ton of advantages: syntax highlighting support, code completion, code folding and much more. Editors are normally displayed in editor tabs, but they can be embedded in dialogs or tool windows, too. This is enabled by the EditorTextField component.

The following attributes can be specified:

• The file type according to which the text in the text field is parsed;
• Whether the text field is read-only or editable;
• Whether the text field is single-line or multiline.

Further customizations are possible by subclassing and overriding createEditor() and applying EditorCustomization. Several commonly needed customization implementations exist, including:

• SpellCheckingEditorCustomization disables spellchecking
• HorizontalScrollBarEditorCustomization to turn on/off horizontal scrollbar
• ErrorStripeEditorCustomization to turn on/off error stripes on right

EditorTextField has a number of subclasses that can be used as needed for additional features.

If you want to use an editor as an input field in a dialog box, then consider using LanguageTextField, it provides a more accessible API.

If you want to add autocompletion to the editor, then use TextFieldWithCompletion. The constructor takes as an argument a class that implements TextCompletionProvider to provide autocompletion variants. Use TextFieldCompletionProvider to create your own provider. For this, override addCompletionVariants() and add completion variants using CompletionResultSet.addElement().

See also TextFieldCompletionProviderDumbAware for completion even at the indexing stage.

Refer to the to learn more about completion.

Java

If your plugin depends on Java functionality and targets 2019.2 or later, please make sure to follow the steps from this blog post.

{style="note"}

A common use case for EditorTextField is entering the name of a Java class or package. This can be accomplished with the following steps:

• Use JavaCodeFragmentFactory.createReferenceCodeFragment() to create a code fragment representing the class or package name;
• Call PsiDocumentManager.getDocument() to get the document corresponding to the code fragment;
• Pass the returned document to the EditorTextField constructor or its setDocument() method.

PsiFile psiFile = PsiDocumentManager.getInstance(project)
        .getPsiFile(editor.getDocument());
PsiElement element = psiFile.findElementAt(editor.getCaretModel().getOffset());

PsiExpressionCodeFragment code =
        JavaCodeFragmentFactory.getInstance(project)
        .createExpressionCodeFragment("", element, null, true);

Document document =
        PsiDocumentManager.getInstance(project).getDocument(code);

EditorTextField myInput =
        new EditorTextField(document, project, JavaFileType.INSTANCE);

TIPS:

• When creating more than one field, two separate documents are needed. This is accomplished by using separate instances of PsiExpressionCodeFragment.
• setText() no longer works for the input field. However, createExpressionCodeFragment() accepts the text for the field as an argument. The empty string can be replaced and create a new document in lieu of setText().
• Instances of JTextField in the GUI builder can be replaced with a custom replacement component using the right click in your IDE. Make sure to use "Custom Create" so the initialization code works properly.