IntelliJ Plugin开发 (一) 创建一个编辑器上的右键菜单

最新推荐文章于 2024-09-26 22:29:26 发布

Fanx繁星

最新推荐文章于 2024-09-26 22:29:26 发布

阅读量1.6k

点赞数 1

分类专栏： IntelliJ Plugin 开发教程文章标签：编辑器 intellij-idea java kotlin IDEA插件

该文章为 Fanx繁星原创文章，如需转载请注明来源

本文链接：https://blog.csdn.net/qq_32447361/article/details/126824493

版权

IntelliJ Plugin 开发教程专栏收录该内容

2 篇文章 2 订阅

订阅专栏

官方文档 IDE Plugin SDK Doc

JDK版本： 17
IDEA版本： IU-2022.2.1
Gradle版本：7.5
编程语言：Java和kotlin

AnAction是Idea插件的操作类
通过AnAction，可以使我们的插件在Idea创建相应的操作，例如新建文件，打开文件以及打开一个窗口等，并将其添加到菜单栏，工具栏，右键菜单等地方

创建一个AnAction对象

package icu.weboys.sundriesplugin.core.translate

class TranslateAction : AnAction(){
    override fun actionPerformed(e: AnActionEvent) {
        //Todo...
    }
}

新建一个类后继承 AnAction，并实现 actionPerformed方法即可完成一个简单的操作对象，接下来就是让这个操作与Idea的菜单进行绑定

通过Plugin.xml进行注册

EditorPopupMenu 编辑器右键菜单的GroupId

创建单个菜单

<actions>
        <action id="icu.weboys.sundriesplugin.core.translate.TranslateAction"
                class="icu.weboys.sundriesplugin.core.translate.TranslateAction" text="Translate" description="翻译">
            <add-to-group group-id="EditorPopupMenu" anchor="first"/>
        </action>
    </actions>

在Anactions标签内加入一个 action

属性	说明
id	当前操作的id，可自定义填写，或写当前绑定的AnAction对象的包名.类名/类名
class	绑定的AnAction对象
text	当前这个菜单要显示什么内容
description	当前菜单的介绍
icon	菜单旁边要显示什么图标

创建菜单组

菜单组即为当前菜单下有N个子菜单

<group></group>

其Group中属性与Action属性相同

属性	说明
id	当前操作的id，可自定义填写，或写当前绑定的AnAction对象的包名.类名/类名
class	绑定的AnAction对象
text	当前这个菜单要显示什么内容
description	当前菜单的介绍
icon	菜单旁边要显示什么图标

例如

<actions>
        <group popup="true" class="icu.weboys.sundriesplugin.core.quicksearch.QuickSearchGroup" id="quickstart.QuickSearchGroup" text="在Web中搜索..." icon="AllIcons.Actions.Search" description="Quick search">
            <add-to-group group-id="EditorPopupMenu" anchor="first"/>
        </group>
</actions>

如何给其添加子菜单

在这里正好说一下上方的 add-to-group 这个标签

属性	说明
group-id	菜单组Id
anchor	添加的位置可选值 first,last ,before 啥效果自己摸索吧

从名字上就可以知道它的作用就是将当前这个Action添加到一个组

在上面我们创建了一个名字叫做 “在Web中搜索…”的Group 和一个翻译的菜单（从自己项目中拷贝的代码，不同功能的，主要是上面那个是动态添加的，没有现成的将就点看吧）

这个是添加到 [在Web中搜索]这个组的

<add-to-group group-id="quickstart.QuickSearchGroup" anchor="first"/>

我们将它添加到翻译的标签内

<actions>
        <action id="icu.weboys.sundriesplugin.core.translate.TranslateAction"
                class="icu.weboys.sundriesplugin.core.translate.TranslateAction" text="Translate" description="翻译">
            <add-to-group group-id="quickstart.QuickSearchGroup" anchor="first"/>
        </action>
    </actions>

这样我们在预览时，可以看到，当鼠标点击在web中搜索这个菜单上时，后面会显示出翻译的菜单，当点击这个菜单后，会执行我们的actionPerformed这个方法

通过代码创建菜单组

首先我们还是要在Plugin.xml中注册一个 group

<group popup="true" class="icu.weboys.sundriesplugin.core.quicksearch.QuickSearchGroup" id="quickstart.QuickSearchGroup" text="在Web中搜索..." icon="AllIcons.Actions.Search" description="Quick search">
     <add-to-group group-id="EditorPopupMenu" anchor="first"/>
</group>

然后我们创建一个类并继承 ActionGroup 对象

package icu.weboys.sundriesplugin.core.quicksearch

import com.intellij.openapi.actionSystem.ActionGroup
import com.intellij.openapi.actionSystem.AnAction
import com.intellij.openapi.actionSystem.AnActionEvent
import icu.weboys.sundriesplugin.config.QsConfigFactory

class QuickSearchGroup : ActionGroup() {
    override fun getChildren(e: AnActionEvent?): Array<AnAction> {
        // return Array<AnAction>;
        // 一个AnAction对象的数组
    }
}

我们在这个getChildren方法中返回的这个数组，就是它的子菜单
这样插件启用用，会把这些子菜单添加到在web中搜索的下面

设置子菜单的图标文字说明等内容

但是用到最开始创建的AnAction对象，而且我们没有在plugin.xml中搞它的文字和图标，所以我们需要在代码中设置

先看看 AnAction的构造方法

  public AnAction() {
    // avoid eagerly creating template presentation
  }

  /**
   * Creates a new action with {@code icon} provided. Its text, description set to {@code null}.
   *
   * @param icon Default icon to appear in toolbars and menus (Note some platform don't have icons in menu).
   */
  public AnAction(@Nullable Icon icon) {
    this(Presentation.NULL_STRING, Presentation.NULL_STRING, icon);
  }

  /**
   * Creates a new action with the specified text. Description and icon are
   * set to {@code null}.
   *
   * @param text Serves as a tooltip when the presentation is a button and the name of the
   *             menu item when the presentation is a menu item.
   */
  public AnAction(@Nullable @ActionText String text) {
    this(text, null, null);
  }

  /**
   * Creates a new action with the specified text. Description and icon are
   * set to {@code null}.
   *
   * @param dynamicText Serves as a tooltip when the presentation is a button and the name of the
   *                    menu item when the presentation is a menu item.
   *                    <p>
   *                    Use it if you need to localize action text.
   */
  public AnAction(@NotNull Supplier<@ActionText String> dynamicText) {
    this(dynamicText, Presentation.NULL_STRING, null);
  }

  /**
   * Constructs a new action with the specified text, description and icon.
   *
   * @param text        Serves as a tooltip when the presentation is a button and the name of the
   *                    menu item when the presentation is a menu item
   * @param description Describes current action, this description will appear on
   *                    the status bar when presentation has focus
   * @param icon        Action's icon
   */
  public AnAction(@Nullable @ActionText String text,
                  @Nullable @ActionDescription String description,
                  @Nullable Icon icon) {
    this(() -> text, () -> description, icon);

看完后应该就不用说咋设置了吧

例如

package icu.weboys.sundriesplugin.core.quicksearch

class QuickSearchAction(name:String,des:String,icon:ICON) : AnAction(name,des,icon){
    override fun actionPerformed(e: AnActionEvent) {
    }
}