Note: the test will fail, because the PR depend from #40150.

I guess it is better to rebase this pr to the 5.0-dev branch, as it will get more attention for new features. Thanks for understanding.

The ESM version with use of importmap 5.0-dev...Fedik:joomla-cms:editor-js-api2

Main difference between ESM and current approcah, is reducing of globals.
Example instead of global Joomla.Editor.getActive() the script should import JoomlaEditor module and then use:

import { JoomlaEditor } from 'editor-api';

// And somewhere in code:
JoomlaEditor.setActive(...);
...
JoomlaEditor.getActive();

Note: Need to update PR to use ES modules

thanks, merging this for beta1 to get real world feedback

After this change my editor-xtd plugin stopped working. it was working on J3 / J4.
Note, that this is a plugin that will show a modal that I construct myself as there is no possibility to construct the modal via an iframe (like all other Joomla buttons are doing (as these have components generating the content of the iframe).

So the button is displaying, the modal window is constructed correctly (hidden), but clicking the button doesn't show / open the modal.

I have worked around this by setting the button->modal to true (which would then display an empty modal and not the one I created and setting the $button->options = ['confirmCallback' => true];

Now the modal I created works again.

So as far i can see this is just a workaround for having a button in the editor displaying your own modal when you do not have the option to.

Not even sure as to what the confirmCallback option will do, or if it is even possible to have a editor button open a custom BS modal without triggering the 'legacyModal' modus (which I presume is called legacy because it will be removed some day.

How is your button looks like?

The following "legacy code" should produce iframe:

$button  = new CMSObject();
$button->modal  = true;
$button->link = $link;

Would be good to have some more details, maybe we can improve something.

Note, that this is a plugin that will show a modal that I construct myself as there is no possibility to construct the modal via an iframe

How you doing it?

if it is even possible to have a editor button open a custom BS modal without triggering

With new API, you not limited to joomla modal, you can register your own "button action", and do whatever you want to do when button clicked. (joomla/Manual#97)

But legacy code still should work, maybe something missed.

Hi @Fedik thanks for following up.
there is no $button->link as this is plugin does not have a way to produce the contents of an iFrame. Instead it produces the modal itself.

        $button          = new CMSObject();
        $button->modal   = true;
        $button->editor  = $name;
        $button->text    = Text::_('PLG_EDITORS-XTD_OCHELEMENTS_BUTTON_OCHELEMENTS');
        $button->name    = $this->_type . '_' . $this->_name;
        $button->icon    = 'code';
        $button->iconSVG = '<svg viewBox="0 0 24 24" style="fill:none;" width="24" height="24" fill="none" stroke="currentColor" focusable="false"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4"></path></svg>';
        $button->options = ['confirmCallback' => true];

        // Create the Bootstrap Modal, the Joomla Helper class for this is to limited
        $modalId         = $button->editor . '_' . $button->name . '_modal';
        $modalLayout     = new FileLayout('modal', JPATH_PLUGINS . '/editors-xtd/ochelements/layouts/');
        $modalBodyLayout = new FileLayout('buttons', JPATH_PLUGINS . '/editors-xtd/ochelements/layouts/');
        $modalBody       = $modalBodyLayout->render(['editor' => $button->editor, 'content' => $pluginResults]);
        echo $modalLayout->render(['modalId' => $modalId, 'modalBody' => $modalBody]);

        return $button;

So the above code works because I added the confirmCallback option, without it the button shows, but will not open the modal.

I took a quick look at the new api and this is not an option for me: 70% of my customers is still on J3, and I do not want to maintain 3 versions of my extensions: Already noticed other B/C that required refactoring going to 5.0 for some of my extensions. So I need to be able to do it the way it was in J4 (which worked in J3) without B/C or with a workaround that will not break things.

This is what the modal looks like: the editor-xtd plugin triggers an event to which my other plugins / extensions respond: so the other plugins provide the content for the modal. ochElement (the editor plugin) then shows the collected results (buttons) in the form. Clicking the buttons in the modal will then insert the appropriate tag for the clicked button / functionality

@Ruud68 Please test #41633 that should keep old behavior untill Joomla 6.

Just to understand what is happening here:
previously we had (bootstrap) modals, you are replacing these with (custom Joomla) dialogs. Correct?

If so, would it then not make more sense to have the $button->action have the values:

• modal > which will then use / display the templates (bootstrap) modal
• dialog > the (custom joomla) dialogs

That makes more sense (at least to me) then trying to figure out what the difference is between $button->modal = true and $button->action = modal

Another benefit is that there is no need to deprecate things, as both template (bootstrap) modals are supported (also beyond v6) and the new (custom Joomla) dialogues can perfectly coexist and then the developer can decide what to use without being forced into dialogues.

Just my 2cts.

$button->modal = true

This is old way to make modal.

The problem with existing BS modals, in the way they are rendered they does not work properly when the field is used in repeatable mode, example in a subform field.
That why I would not do $button->action = 'modal' and $button->action = 'dialog'

$button->action = 'foobar'

This is a new API to asign specific action to your button.
In core Joomla provide modal action, that will display a Dialog.
Hovewer you can do your custom action, and it will run when user click the button

Look the link https://manual.joomla.org/docs/next/building-extensions/plugins/editors-xtd-plugin
There you can find how to do $button->action = 'insert-cat';

Thanks for the explanation and i understand what you are trying to solve, but when an extension developer doesn't migrate to dialogue and sticks to (bootstrap) modal then the issue in the subform field is not solved, correct?

Is the issue in the subform field related / caused by the id of the modal not being unique anymore (so multiple buttons share an id?), if so then IMO that is where things should be fixed, not by introducing new technology.

Again, just my 2cts

for consistent we only should support one look and feel, if 3rd party would like to use another popup tool then they can do it. It's not nice but possible. For us we fixed the subform issue with the new dialog, so "bug fixed" for us. If you or someone else provide a b/c fix for the bootstrap issue we will of course consider it. But it's hard to support multiple ways to do the same thing with our resources.

anyway thanks for bringing this up and I hope the solution provided by Fedir works at least the same as before without b/c break.