Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cross-testing the Multi-select Plugin with other Blockly Plugins #50

Closed
1 of 9 tasks
HollowMan6 opened this issue May 2, 2024 · 31 comments
Closed
1 of 9 tasks
Assignees
Labels
enhancement New feature or request GSoC

Comments

@HollowMan6
Copy link
Collaborator

Check for duplicates

  • I have searched for similar issues before opening a new one.

Problem

Test the integration with other Blockly plugins, apply fixes whenever applicable (something to start with is https://groups.google.com/g/blockly/c/MuL2Ln8SwDU)

Request

To start with:

Workspace-related

  • Keyboard-navigation
  • Shadow-block-converter
  • Workspace-content-higlight
  • Disable-top-blocks
  • Plugin-strict-connection-checker

Blocks-related

  • Block-dynamic-connection
  • Block-shareable-procedures
  • Block-test

We might want to check with other plugins as well later if time allows

Alternatives considered

No response

Additional context

No response

@HollowMan6 HollowMan6 added enhancement New feature or request GSoC labels May 2, 2024
@HollowMan6
Copy link
Collaborator Author

The new changes in Blockly 11 may cause the compatibility issue with the backpack plugin again, so we should re-evaluate again after #39 is done
google/blockly-samples#2311

@changminbark
Copy link
Contributor

Hi everyone,

My name is Chang Min Bark and I will be the GSoC contributor in charge of upgrading the multiselect plugin. I am also in charge of cross-testing the mutliselect plugin with other Blockly plugins. I am looking forward to contributing to this community!

Thanks,
Chang Min

@changminbark
Copy link
Contributor

Quick update: The newly updated multiselect plugin works with the scroll-options plugin as well as multiple workspaces.

@changminbark
Copy link
Contributor

changminbark commented Jul 18, 2024

Checklist:

Original

  • Scroll-options plugin
  • Backpack (Need to update UI in Backpack plugin side)

Workspace-related

  • Keyboard-navigation
  • Shadow-block-converter
  • Workspace-content-highlight
  • Disable-top-blocks
  • Plugin-strict-connection-checker

Blocks-related

  • Block-dynamic-connection
  • Block-shareable-procedures
  • Block-test

@changminbark
Copy link
Contributor

changminbark commented Jul 23, 2024

Keyboard Navigation Plugin:

https://developers.google.com/blockly/guides/configure/web/keyboard-nav

Tested with the backpack plugin and multiselect plugin

  • Enabling keyboard navigation
  • Using default cursor across all levels
  • Connecting blocks on workspace
  • Moving a block on the workspace
  • Detaching blocks
  • Inserting a block from the toolbox
  • Delete shortcut (look at note and comments below)
  • Copy/paste shortcut (look at note and comments below)

Note: When editing a field (e.g. true/false block), I cannot use "w" or "s" to navigate through the field options. However, I can use the arrow keys to navigate through the field options. I don't know if this is intended behavior for the keyboard navigation plugin. I tested this with and without the multiselect plugin.

Note: I am not sure if there is a bug with the keyboard navigation's copy/paste function. The following gif was tested without the multiselect plugin. I cannot seem to reproduce it, so I am also not sure about this bug.
keyboard_nav_copy_paste_bug

However, with the multiselect plugin, it seems to be holding two different copyData storages (so two different copy-pastes are running simultaneously with the shortcut).

What should be the intended behavior here? Should we incorporate the copy functionality of the keyboard navigation plugin into the multiselect plugin? I don't think this would be a good idea as not everyone will use both plugins at the same time. Do you have any other suggestions?

Note: When installing the multiselect plugin first, there is no error regarding the delete shortcut. However, when installing the keyboard navigation plugin first, we encounter this error:
image

I am not sure why we don't see this issue when we install the multiselect plugin first.

Multiselect Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

Note: The multiselect mode is activated when holding shift for moving around the keyboard navigation cursor, but this does not cause any unwanted behavior as the multiselect mode affects cursor/mouse behavior.

Backpack Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

@HollowMan6
Copy link
Collaborator Author

Note: When editing a field (e.g. true/false block), I cannot use "w" or "s" to navigate through the field options. However, I can use the arrow keys to navigate through the field options. I don't know if this is intended behavior for the keyboard navigation plugin. I tested this with and without the multiselect plugin.

The Keyboard Navigation Plugin is highly experimental, so I would expect this to happen. You can report it to the Blockly team.

Note: I am not sure if there is a bug with the keyboard navigation's copy/paste function. The following gif was tested without the multiselect plugin. I cannot seem to reproduce it, so I am also not sure about this bug.

However, with the multiselect plugin, it seems to be holding two different copyData storages (so two different copy-pastes are running simultaneously with the shortcut).

What should be the intended behavior here? Should we incorporate the copy functionality of the keyboard navigation plugin into the multiselect plugin? I don't think this would be a good idea as not everyone will use both plugins at the same time. Do you have any other suggestions?

That's one thing to think about. I guess the Blockly team doesn't have a good solution for this either (e.g. cross tab copy-paste and the keyboard navigation also have two set of copyData storages). Of course, we shouldn't incorporate the copy functionality of the keyboard navigation plugin into the multiselect plugin this time, but it would be good to work out some design so that people can connect the multi-select copyData storages with possibly other plugins /for other uses (extensibility).

Note: When installing the multiselect plugin first, there is no error regarding the delete shortcut. However, when installing the keyboard navigation plugin first, we encounter this error:

I am not sure why we don't see this issue when we install the multiselect plugin first.

This is exactly #41 Let me know if you have any insights on this one.

@changminbark
Copy link
Contributor

The Keyboard Navigation Plugin is highly experimental, so I would expect this to happen. You can report it to the Blockly team.

This may be related to this issue: google/blockly-samples#2380

That's one thing to think about. I guess the Blockly team doesn't have a good solution for this either (e.g. cross tab copy-paste and the keyboard navigation also have two set of copyData storages). Of course, we shouldn't incorporate the copy functionality of the keyboard navigation plugin into the multiselect plugin this time, but it would be good to work out some design so that people can connect the multi-select copyData storages with possibly other plugins /for other uses (extensibility).

I think that a possible solution to this would be to implement what the multiselect plugin is doing in Blockly core. Instead of having the base copy/cut/paste function directly using the copyData of that one block/element, it should define a set (can be called copyData) that contains a set of each element's copy data (whether it be just one element or multiple). This can be used across different plugins that have their own copy/cut/paste shortcut functions defined.

image

This is exactly #41 Let me know if you have any insights on this one.

I found out the reason why this occurs. Currently, the keyboard navigation plugin allows for collisions when they register the key mappings for the shortcut registry while the multiselect plugin does not. This should be a simple fix by also allowing the shortcuts in the multiselect plugin to allow for collisions. However, I am not sure if this would be a good idea as other plugins may have copy/cut/paste shortcuts that behave differently. Having multiple copy/cut/paste functions would lead to unexpected behaviors. It would also be impossible to make an all-in-one copy/cut/paste functions for all the plugins. So I am not sure how to approach this issue.

image

If there is nothing else that I can investigate in, I will mark this cross-checking as done and move onto the next plugin.

@HollowMan6
Copy link
Collaborator Author

HollowMan6 commented Jul 24, 2024

I think that a possible solution to this would be to implement what the multiselect plugin is doing in Blockly core.

You can discuss that with the Blockly team to see if this is feasible.

I found out the reason why this occurs. Currently, the keyboard navigation plugin allows for collisions when they register the key mappings for the shortcut registry while the multiselect plugin does not.

Yeah, I mean that and that's why I mentioned this here: https://groups.google.com/g/blockly/c/MuL2Ln8SwDU/m/9WihibDsAgAJ

This should be a simple fix by also allowing the shortcuts in the multiselect plugin to allow for collisions. However, I am not sure if this would be a good idea as other plugins may have copy/cut/paste shortcuts that behave differently. Having multiple copy/cut/paste functions would lead to unexpected behaviors. It would also be impossible to make an all-in-one copy/cut/paste functions for all the plugins. So I am not sure how to approach this issue.

You can try and see if it works when you allow for collisions. One of the solutions I proposed (guess, not verified) is to temporarily unregister the multi-select plugin key mappings when keyboard navigation is activated, and register that back when deactivated. You can also verify if this works/is possible or not. if you have any better ideas/comments, feel free to continue commenting under that thread.

@changminbark
Copy link
Contributor

You can discuss that with the Blockly team to see if this is feasible.

I will send an email to them soon.

Yeah, I mean that and that's why I mentioned this here: https://groups.google.com/g/blockly/c/MuL2Ln8SwDU/m/9WihibDsAgAJ

I don't have access to comment on the thread.

You can try and see if it works when you allow for collisions. One of the solutions I proposed (guess, not verified) is to temporarily unregister the multi-select plugin key mappings when keyboard navigation is activated, and register that back when deactivated. You can also verify if this works/is possible or not. if you have any better ideas/comments, feel free to continue commenting under that thread.

I was able to do the temporary unregister and it seems to be working. Since it works, should I implement it into the multi-select plugin and push the change into the blockly-v11 branch?

@HollowMan6
Copy link
Collaborator Author

Yeah, I mean that and that's why I mentioned this here: https://groups.google.com/g/blockly/c/MuL2Ln8SwDU/m/9WihibDsAgAJ

I don't have access to comment on the thread.

Really? It's a public Google group.

You can try and see if it works when you allow for collisions. One of the solutions I proposed (guess, not verified) is to temporarily unregister the multi-select plugin key mappings when keyboard navigation is activated, and register that back when deactivated. You can also verify if this works/is possible or not. if you have any better ideas/comments, feel free to continue commenting under that thread.

I was able to do the temporary unregister and it seems to be working. Since it works, should I implement it into the multi-select plugin and push the change into the blockly-v11 branch?

You mean implement the "allow for collisions"? Sure, you can test that and once you think it's fine, it's always preferred to have that allowed.

@changminbark
Copy link
Contributor

changminbark commented Jul 25, 2024

Yeah, I mean that and that's why I mentioned this here: https://groups.google.com/g/blockly/c/MuL2Ln8SwDU/m/9WihibDsAgAJ

I don't have access to comment on the thread.

Really? It's a public Google group.

image

You mean implement the "allow for collisions"? Sure, you can test that and once you think it's fine, it's always preferred to have that allowed.

The only problem I have encountered is that when we unregister the multiselect shortcuts when we are in the keyboard navigation mode, we cannot use the cursor to select/copy/cut/paste. We can only copy/cut/paste the blocks selected in the keyboard navigation mode. I have tried registering the original Blockly core shortcuts, but they do not allow for collisions and will run into an error with the keyboard navigation plugin. If you think this behavior is still okay, I will push it into the blockly-v11 branch of the multiselect plugin.

@changminbark
Copy link
Contributor

This is a gif of the plugins working together:
multiselect_keyboardnav

@HollowMan6
Copy link
Collaborator Author

image

Have you actually joined the group?

You mean implement the "allow for collisions"? Sure, you can test that and once you think it's fine, it's always preferred to have that allowed.

The only problem I have encountered is that when we unregister the multiselect shortcuts when we are in the keyboard navigation mode, we cannot use the cursor to select/copy/cut/paste. We can only copy/cut/paste the blocks selected in the keyboard navigation mode. I have tried registering the original Blockly core shortcuts, but they do not allow for collisions and will run into an error with the keyboard navigation plugin. If you think this behavior is still okay, I will push it into the blockly-v11 branch of the multiselect plugin.

I don’t quite understand, are you combining the things I mentioned with allowing collisions, or simply the methods I mentioned? If later, what are you going to commit in our code base? We can discuss this more during our meeting. BTW, since we are touching something new, there is no regression involved, do you think this is Okay or not? It’s always good to develop a “design taste” for everyone, not just for me. For me, my principle is that, if it introduces another higher priority bug that doesn’t have a possible workaround, it’s better not to introduce it.

@HollowMan6
Copy link
Collaborator Author

This is a gif of the plugins working together: multiselect_keyboardnav multiselect_keyboardnav

Can you by any chance multi select the blocks purely via keyboard, without the use of the mouse?

@changminbark
Copy link
Contributor

Have you actually joined the group?

Oh, I guess that was the issue.

I don’t quite understand, are you combining the things I mentioned with allowing collisions, or simply the methods I mentioned? If later, what are you going to commit in our code base? We can discuss this more during our meeting. BTW, since we are touching something new, there is no regression involved, do you think this is Okay or not? It’s always good to develop a “design taste” for everyone, not just for me. For me, my principle is that, if it introduces another higher priority bug that doesn’t have a possible workaround, it’s better not to introduce it.

So what I did was I allowed collisions from the multiselect plugin side and then made it so that the multiselect plugin's shortcuts are unregistered when we turn on the keyboard navigation mode and re-register it when we turn off the keyboard navigation mode. I can just commit the portion of the code that allows for collisions from the multiselect plugin side, or I can commit the whole code that also unregisters/re-registers the shortcuts (this is based on the conditional shown below).

image

Can you by any chance multi select the blocks purely via keyboard, without the use of the mouse?

No, this is not possible. That is why I am a little unsure about whether we should commit just the collision allowance or also the shortcut unregistration/re-registration.

In my opinion, it does not make sense for the keyboard navigation to rely on the multiselect plugin to select multiple blocks. That should be feature on its own in the keyboard navigation plugin. As for the behavior shown in the gif, I think it should be fine as long as the user knows that you are not able to copy/paste using the cursor at all (as we unregister all cursor related copy/paste functions including the original Blockly core one) while in the keyboard navigation mode.

@HollowMan6
Copy link
Collaborator Author

Have you actually joined the group?

Oh, I guess that was the issue.

I don’t quite understand, are you combining the things I mentioned with allowing collisions, or simply the methods I mentioned? If later, what are you going to commit in our code base? We can discuss this more during our meeting. BTW, since we are touching something new, there is no regression involved, do you think this is Okay or not? It’s always good to develop a “design taste” for everyone, not just for me. For me, my principle is that, if it introduces another higher priority bug that doesn’t have a possible workaround, it’s better not to introduce it.

So what I did was I allowed collisions from the multiselect plugin side and then made it so that the multiselect plugin's shortcuts are unregistered when we turn on the keyboard navigation mode and re-register it when we turn off the keyboard navigation mode. I can just commit the portion of the code that allows for collisions from the multiselect plugin side, or I can commit the whole code that also unregisters/re-registers the shortcuts (this is based on the conditional shown below).

Sure, you can commit that. BTW, are you going to expose "unbindMultiselectCopyPaste_" to the developer, or is this going to happen automatically? If the former, there's a naming issue here in the method (public ones should not have an underscore as the suffix).

In my opinion, it does not make sense for the keyboard navigation to rely on the multiselect plugin to select multiple blocks. That should be feature on its own in the keyboard navigation plugin. As for the behavior shown in the gif, I think it should be fine as long as the user knows that you are not able to copy/paste using the cursor at all (as we unregister all cursor related copy/paste functions including the original Blockly core one) while in the keyboard navigation mode.

In my opinion, it does not make sense for the keyboard navigation to rely on the multiselect plugin to select multiple blocks.

It looks like the Blockly team wants to integrate the keyboard navigation into core in the future, so in the end, we should still be able to do that google/blockly-samples#2380 (comment)

I think it should be fine as long as the user knows that you are not able to copy/paste using the cursor at all (as we unregister all cursor related copy/paste functions including the original Blockly core one)

How will the user know? It sounds like only the developer knows that.

@changminbark
Copy link
Contributor

Sure, you can commit that. BTW, are you going to expose "unbindMultiselectCopyPaste_" to the developer, or is this going to happen automatically? If the former, there's a naming issue here in the method (public ones should not have an underscore as the suffix).

This will happen automatically, as it is a 'keydown' event listener. It only fires if it detects that the workspace is in keyboard accessibility mode.

It looks like the Blockly team wants to integrate the keyboard navigation into core in the future, so in the end, we should still be able to do that google/blockly-samples#2380 (comment)

Then the Blockly team would have to make the original core shortcuts to allow for collisions. Because right now, we cannot use both (core and keyboard nav) shortcuts as the core does not allow for collisions (if we are to re-register the core shortcuts). This would be the solution to allowing users to use the core shortcuts while in keyboard navigation mode (with the multiselect plugin). So, currently, after I push the latest commit, we will be able to use both plugins, but we will not be able to copy/paste regularly using a cursor when the keyboard navigation mode is on unless we make a change to the core shortcuts OR change the keyboard navigation plugin to unregister/re-register their shortcuts.

How will the user know? It sounds like only the developer knows that.

I guess there is no way the user knows unless there is some kind of written documentation/tutorial for them. I just thought it did not make sense for a user to turn on the keyboard navigation mode and then proceed to use the cursor to copy/paste. Isn't the purpose of the keyboard navigation mode to completely remove the need for a mouse/cursor?

@HollowMan6
Copy link
Collaborator Author

HollowMan6 commented Jul 25, 2024

I just thought it did not make sense for a user to turn on the keyboard navigation mode and then proceed to use the cursor to copy/paste. Isn't the purpose of the keyboard navigation mode to completely remove the need for a mouse/cursor?
So, currently, after I push the latest commit, we will be able to use both plugins, but we will not be able to copy/paste regularly using a cursor when the keyboard navigation mode is on unless we make a change to the core shortcuts OR change the keyboard navigation plugin to unregister/re-register their shortcuts.

Sounds good if we document this on our side.

Then the Blockly team would have to make the original core shortcuts to allow for collisions.

Maybe you also want to make the Blockly team aware of this (by opening an issue there or something)

@changminbark
Copy link
Contributor

Okay, I have pushed the commit in the PR and created an issue: google/blockly-samples#2424

I will now start cross-checking with the next plugin (Shadow-block-converter).

@changminbark
Copy link
Contributor

changminbark commented Jul 30, 2024

Shadowblock Converter Plugin:

https://github.com/google/blockly-samples/tree/master/plugins/shadow-block-converter

Tested with the backpack plugin, keyboard navigation plugin, and multiselect plugin

  • Editing a shadow block converts it into a real block regardless of multiselect mode (and whether selected is multiselected or not)

Note: I think that I've come across a bug where editing a shadow block will select the parent block (at least visually). However, when trying to select something else (like a block or the workspace), the former shadow block's parent block does not get unselected (visually). This was tested without any of the other plugins (except for backpack). I will report this on the Blockly plugins github page (google/blockly-samples#2426).

shadowblock_converter

Note: When a shadow block gets converted into a regular block, it is not in the multiselect draggable's subdraggables, but this is not an issue for modifying/moving the multiselection as the parent block is still in the selection.

Multiselect Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

Note: The multiselect mode is activated when holding shift for moving around the keyboard navigation cursor, but this does not cause any unwanted behavior as the multiselect mode affects cursor/mouse behavior.

Backpack Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

Keyboard Navigation Plugin:
Everything works as intended (use cases). Editing a shadow block converts it to a regular block and the keyboard navigation's cursor/indicator is moved back to the workspace level.

@changminbark
Copy link
Contributor

If there are no concerns or questions, I will move on to the next plugin (Workspace-content-highlight) soon.

@changminbark
Copy link
Contributor

(Workspace) Content Highlight Plugin:

https://github.com/google/blockly-samples/tree/master/plugins/content-highlight

Tested with the backpack plugin, keyboard navigation plugin, shadow block converter plugin and multiselect plugin

  • Dragging a block/block selection (using multiselect plugin) expands the content highlight box.

Multiselect Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

Backpack Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

Keyboard Navigation Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

Shadow Block Converter Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

@changminbark
Copy link
Contributor

Disable Top Blocks Plugin:

https://github.com/google/blockly-samples/tree/master/plugins/disable-top-blocks

Tested with the backpack plugin and multiselect plugin.

  • Disable blocks is not available for orphan blocks, even with multiselection.

disable_top_blocks

Note: We have to install the multiselect plugin first if we want the disable top blocks plugin to work properly as the multiselect plugin installs/overrides the disable top blocks plugin's context menu. Should we write this down somewhere or is it enough to indicate it in this comment?

Multiselect Plugin:
Everything works as intended (use cases). We must just make sure that the disable top blocks plugin is installed after the multiselect plugin:
image

Backpack Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

@HollowMan6
Copy link
Collaborator Author

Note: We have to install the multiselect plugin first if we want the disable top blocks plugin to work properly as the multiselect plugin installs/overrides the disable top blocks plugin's context menu. Should we write this down somewhere or is it enough to indicate it in this comment?

Multiselect Plugin: Everything works as intended (use cases). We must just make sure that the disable top blocks plugin is installed after the multiselect plugin: image

This sounds very similar to the keyboard navigation plugin, does this cause any conflict/missing feature? If not, then documenting this to let people know in README is a good idea.

@changminbark
Copy link
Contributor

This sounds very similar to the keyboard navigation plugin, does this cause any conflict/missing feature? If not, then documenting this to let people know in README is a good idea.

This does not cause any bugs/conflicts/unintended use cases. I will document this in the README and push it to the blockly-v11 branch.

@changminbark
Copy link
Contributor

Strict Connection Checker Plugin:

https://github.com/google/blockly-samples/tree/master/plugins/strict-connection-checker

Tested with the backpack plugin and multiselect plugin.

  • Strict connection checking for connection types works, even with multiselection. Refer to gifs below.

Without strict connection check:
multiselect without strict connection

With strict connection check:
multiselect with strict connection

Multiselect Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

Backpack Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

@changminbark
Copy link
Contributor

changminbark commented Aug 5, 2024

Block Dynamic Connection Plugin:

https://github.com/google/blockly-samples/tree/master/plugins/block-dynamic-connection

Tested with the backpack plugin and multiselect plugin.

  • Multiple block dynamic connection works. Refer to gif below

multiselect with dynamic block

Note: If you watch the gif, when I undo the connection of the dynamic connection, some of the blocks are moved to a random location first. This only occurs with the multiselection. I am not sure what is causing the location to be moved randomly. However, it does not seem to be causing any major issues (unintended behavior). I will continue looking into what is causing it.

dynamic block weird behavior

Note: Another thing I noticed is that the dynamic create text block does not shrink back to its original number when I undo the action of dynamically connecting the block. This is also present without the multiselect plugin. I opened an issue at google/blockly-samples#2434

dynamic block bug

Test environment:

/**
 * @license
 * Copyright 2022 MIT
 * SPDX-License-Identifier: Apache-2.0
 */

/**
 * @fileoverview Plugin test.
 */

import * as Blockly from 'blockly';
import {toolboxCategories, createPlayground} from '@blockly/dev-tools';
import {Multiselect} from '../src/index';
import {Backpack} from '@blockly/workspace-backpack';
import {NavigationController} from '@blockly/keyboard-navigation';
import {shadowBlockConversionChangeListener} from '@blockly/shadow-block-converter';
import {ContentHighlight} from "@blockly/workspace-content-highlight";
import {DisableTopBlocks} from "@blockly/disable-top-blocks";
import {pluginInfo as StrictConnectionsPluginInfo} from '@blockly/plugin-strict-connection-checker';
import * as BlockDynamicConnection from "@blockly/block-dynamic-connection";

/**
 * Create a workspace.
 * @param {HTMLElement} blocklyDiv The blockly container div.
 * @param {!Blockly.BlocklyOptions} options The Blockly options.
 * @returns {!Blockly.WorkspaceSvg} The created workspace.
 */
function createWorkspace(blocklyDiv, options) {
  const workspace = Blockly.inject(blocklyDiv, options);

  // Initialize backpack plugin.
  const backpack = new Backpack(workspace);
  backpack.init();

  // // KEYBOARD NAVIGATION PLUGIN (DONE) ============================================================
  // // Initialize plugin.
  //   const navigationController = new NavigationController();
  //   navigationController.init();
  //   navigationController.addWorkspace(workspace);
  // // Turns on keyboard navigation.
  //   navigationController.enable(workspace);

  // // SHADOW BLOCK CONVERTER PLUGIN (DONE) =========================================================
  // workspace.addChangeListener(shadowBlockConversionChangeListener);

  // // CONTENT HIGHLIGHT PLUGIN (DONE) ==============================================================
  // // Initialize plugin.
  // const contentHighlight = new ContentHighlight(workspace);
  // contentHighlight.init();

  // // DISABLE TOP BLOCKS PLUGIN (DONE) ==============================================================
  // // The plugin must be initialized before it has any effect.
  // const disableTopBlocksPlugin = new DisableTopBlocks();
  // disableTopBlocksPlugin.init();

  // // STRICT CONNECTION CHECKER PLUGIN (DONE) =======================================================

  // BLOCK DYNAMIC CONNECTION PLUGIN
  // Add the change listener so connections will be finalized on deletion.
  workspace.addChangeListener(BlockDynamicConnection.finalizeConnections);

  const multiselectPlugin = new Multiselect(workspace);
  multiselectPlugin.init(options);


  return workspace;
}

document.addEventListener('DOMContentLoaded', function() {
  BlockDynamicConnection.overrideOldBlockDefinitions();

  const toolbox = {
    kind: 'flyoutToolbox',
    contents: [
      {
        kind: 'block',
        type: 'text_join',
      },
      {
        kind: 'block',
        type: 'lists_create_with',
      },
      {
        kind: 'block',
        type: 'controls_if',
      },
      {
        kind: 'block',
        type: 'logic_boolean',
        fields: {
          BOOL: 'TRUE',
        },
      },
      {
        kind: 'block',
        type: 'text',
        fields: {
          TEXT: 'abc',
        },
      },
      {
        kind: 'block',
        type: 'math_number',
        fields: {
          NUM: '123',
        },
      },
      {
        kind: 'block',
        type: 'text_print',
        inputs: {
          TEXT: {
            shadow: {
              type: 'text',
              fields: {
                TEXT: 'abc',
              },
            },
            block: undefined,
          },
        },
      },
    ],
  };
  const defaultOptions = {
    toolbox: toolbox,
    plugins: {
      // ...StrictConnectionsPluginInfo,
      connectionPreviewer:
          BlockDynamicConnection.decoratePreviewer(
              // Replace with a custom connection previewer, or remove to decorate
              // the default one.
              Blockly.InsertionMarkerPreviewer,
          ),
    },
    useDoubleClick: true,
    bumpNeighbours: false,
    multiFieldUpdate: true,
    multiselectIcon: {
      hideIcon: false,
      weight: 3,
      enabledIcon: 'media/select.svg',
      disabledIcon: 'media/unselect.svg',
    },
    multiSelectKeys: ['Shift'],
    multiselectCopyPaste: {
      crossTab: true,
      menu: true,
    },
    grid: {
      spacing: 25,
      length: 3,
      colour: '#ccc',
      snap: true,
    },
    move: {
      wheel: true,
    },
    zoom: {
      wheel: true,
    },
  };

  createPlayground(document.getElementById('root'), createWorkspace,
      defaultOptions);
});

Multiselect Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

Backpack Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

@changminbark
Copy link
Contributor

changminbark commented Aug 5, 2024

After looking into the weird undo behavior, I found that each block undergoes a drag and then two move actions. This seems to be the same for the block that does not move to a random location prior to connecting (the block with the normal behavior also has 1 drag and then 2 move actions being called). I am not too sure what is causing this. If you have any suggestions, that would be helpful. However, this might also be related to the weird undo compatibility with the multiselect plugin.

image
image

@changminbark
Copy link
Contributor

Block Shareable Procedures:

https://github.com/google/blockly-samples/tree/master/plugins/block-shareable-procedures

Tested with the multiselect plugin.

  • The new blocks can be multiselected and the shareable procedures functionality still works.

block shareable procedures

Test environment
index.js:

/**
 * @license
 * Copyright 2022 Google LLC
 * SPDX-License-Identifier: Apache-2.0
 */
/**
 * @fileoverview Block test.
 */

import * as Blockly from 'blockly';
import {toolboxCategories} from '@blockly/dev-tools';
import {
  blocks,
  unregisterProcedureBlocks,
  registerProcedureSerializer,
} from '@blockly/block-shareable-procedures';
import {ProcedureBase} from '@blockly/block-shareable-procedures';
import {Multiselect} from "../src";

/* eslint no-unused-vars: "off" */

unregisterProcedureBlocks();
Blockly.common.defineBlocks(blocks);

registerProcedureSerializer();

let workspace1;
let workspace2;

document.addEventListener('DOMContentLoaded', function () {
  injectTwoWorkspaces();
});

/**
 * Injects two workspaces that share procedure models. Undo and redo are off.
 */
function injectTwoWorkspaces() {
  const options = {
    toolbox: toolboxCategories,
    useDoubleClick: true,
    bumpNeighbours: false,
    multiFieldUpdate: true,
    multiselectIcon: {
      hideIcon: false,
      weight: 3,
      enabledIcon: 'media/select.svg',
      disabledIcon: 'media/unselect.svg',
    },
    multiSelectKeys: ['Shift'],
    multiselectCopyPaste: {
      crossTab: true,
      menu: true,
    },
    grid: {
      spacing: 25,
      length: 3,
      colour: '#ccc',
      snap: true,
    },
    move: {
      wheel: true,
    },
    zoom: {
      wheel: true,
    },
  };
  workspace1 = Blockly.inject('blockly1', options);
  workspace2 = Blockly.inject('blockly2', options);
  // If we allow undoing operations, it can create event loops when sharing
  // events between workspaces.
  workspace1.MAX_UNDO = 0;
  workspace2.MAX_UNDO = 0;
  workspace1.addChangeListener(createEventSharer(workspace2));
  workspace2.addChangeListener(createEventSharer(workspace1));

  workspace1.addChangeListener(
    createSerializationListener(workspace1, 'save1'),
  );
  workspace2.addChangeListener(
    createSerializationListener(workspace2, 'save2'),
  );

  const multiselectPlugin1 = new Multiselect(workspace1);
  multiselectPlugin1.init(options);

  const multiselectPlugin2 = new Multiselect(workspace2);
  multiselectPlugin2.init(options);

  document
    .getElementById('load')
    .addEventListener('click', () => reloadWorkspaces());
}

/** Injects one workspace with undo and redo enabled. */
function injectOneWorkspace() {
  const elem = document.getElementById('blockly2');
  elem.parentElement.removeChild(elem);

  const options = {
    toolbox: toolboxCategories,
  };
  workspace1 = Blockly.inject('blockly1', options);

  workspace1.addChangeListener(
    createSerializationListener(workspace1, 'save1'),
  );

  document
    .getElementById('load')
    .addEventListener('click', () => loadWorkspace());
}

/**
 * Returns an event listener that shares procedure and var events from the
 * connected workspace to the other workspace.
 * @param {!Blockly.Workspace} otherWorkspace The workspace to share events to.
 * @returns {function(Blockly.Events.Abstract)} The listener.
 */
function createEventSharer(otherWorkspace) {
  return (e) => {
    if (
      !(e instanceof ProcedureBase) &&
      !(e instanceof Blockly.Events.VarBase)
    ) {
      return;
    }
    let event;
    try {
      event = Blockly.Events.fromJson(e.toJson(), otherWorkspace);
    } catch (e) {
      // Could not deserialize event. This is expected to happen. E.g.
      // when round-tripping parameter deletes, the delete in the
      // secondary workspace cannot be deserialized into the original
      // workspace.
      return;
    }
    event.run(true);
  };
}

/**
 * Returns an event listener that serializes the given workspace to JSON and
 * outputs it to the text area with the given ID.
 * @param {!Blockly.Workspace} workspace The workspace to serialize.
 * @param {string} textAreaId The ID of the text area to output to.
 * @returns {function(Blockly.Events.Abstract)} The listener.
 */
function createSerializationListener(workspace, textAreaId) {
  const textArea = document.getElementById(textAreaId);
  return (e) => {
    if (workspace.isDragging()) return;
    textArea.value = JSON.stringify(
      Blockly.serialization.workspaces.save(workspace),
      undefined,
      2,
    );
  };
}

/**
 * Reloads both workspaces to showcase serialization working.
 */
async function reloadWorkspaces() {
  const save1 = Blockly.serialization.workspaces.save(workspace1);
  const save2 = Blockly.serialization.workspaces.save(workspace2);
  workspace1.clear();
  workspace2.clear();
  // Show people the cleared workspace so they know the reload did something.
  await new Promise((resolve) => setTimeout(resolve, 500));
  Blockly.serialization.workspaces.load(save1, workspace1);
  Blockly.serialization.workspaces.load(save2, workspace2);
}

/** Loads the workspace in single workspace mode. */
function loadWorkspace() {
  const save1 = JSON.parse(document.getElementById('save1').value);
  workspace1.clear();
  Blockly.serialization.workspaces.load(save1, workspace1);
}

index.html:

<!doctype html>
<html>
  <head>
    <meta charset="utf-8" />
    <title>Blockly Shareable Procedures</title>
    <style>
      html,
      body {
        margin: 0;
      }

      h2,
      h3 {
        padding: 1em;
        margin: 0;
        background-color: black;
        color: white;
        font-family: monospace;
      }

      #root {
        display: flex;
      }

      #saveArea {
        display: flex;
        flex-direction: column;
        flex-grow: 1;
        height: 100vh;
      }

      .save {
        flex-grow: 1;
        background-color: black;
        color: white;
        resize: none;
      }

      .blockly {
        flex-grow: 4;
        height: 100vh;
      }
    </style>
  </head>

  <body>
    <div id="root">
      <div class="blockly" id="blockly1"></div>
      <div class="blockly" id="blockly2"></div>
      <div id="saveArea">
        <h2>Saved State</h2>
        <input id="load" type="button" value="Reload" />
        <h3>Workspace 1</h3>
        <textarea class="save" id="save1"></textarea>
        <h3>Workspace 2</h3>
        <textarea class="save" id="save2"></textarea>
      </div>
    </div>
    <script src="../build/test_bundle.js"></script>
  </body>
</html>

Multiselect Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

@changminbark
Copy link
Contributor

Test Blocks Plugin:

https://github.com/google/blockly-samples/tree/master/plugins/block-test

Tested with the multiselect plugin.

test blocks plugin

  • Multiselection works with every type of test block.

Note: The drag to dupe block is never added to the multiselection as it breaks the functionality (addressed previously in PR).

Multiselect Plugin:
Everything works as intended (use cases). There are no clashes as there are no overlapping use cases.

@HollowMan6
Copy link
Collaborator Author

Closing as the goal has been reached, thank you @changminbark

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request GSoC
Projects
None yet
Development

No branches or pull requests

2 participants