Added empty trashcan function.

[BeksOmega]

The basics

• I branched from develop
• My pull request is against develop
• My code follows the style guide

The details

Resolves

Closes #3666

Proposed Changes

First commit adds constants to the trashcan's animation. I've been wanting to do this for a while so I just tacked it onto this PR. If you guys don't like it I'm totally cool with removing it.

Second commit adds an emptyContents function and a contentsIsOpen function.

• emptyContents: Clears the trashcan's contents. Sets the lid's minOpenness to 0. And hides the flyout.
• contentsIsOpen: returns if the trashcan flyout is currently open.

I figured people might want to check if the flyout is open before emptying it.

Reason for Changes

1. I like constants.
2. Might be useful when you're creating an application that uses levels? And it adds a harmless bit of flexibility for developers.

Test Coverage

1. Imported the following xml to the playground:

<xml xmlns="https://developers.google.com/blockly/xml">
  <block type="controls_if"></block>
  <block type="controls_if">
    <statement name="DO0">
      <block type="controls_if"></block>
    </statement>
  </block>
  <block type="controls_if">
    <statement name="DO0">
      <block type="controls_if">
        <statement name="DO0">
          <block type="controls_if"></block>
        </statement>
      </block>
    </statement>
  </block>
</xml>

2. Deleted all of the blocks.
3. Opened the trashcan.
4. Ran the following code in the console:

Blockly.mainWorkspace.trashcan.emptyContents()

5. Observed how the flyout and lid closed.
6. Attempted to open the trashcan, and observed how it was not possible.
7. Imported the following xml:

<xml xmlns="https://developers.google.com/blockly/xml">
  <block type="controls_repeat_ext">
    <value name="TIMES">
      <shadow type="math_number">
        <field name="NUM">0</field>
      </shadow>
    </value>
  </block>
</xml>

8. Deleted the block.
9. Opened the trashcan.
10. Observed how the trashcan did not contain any of the blocks from before it was emptied.

And the lid animation is exactly the same.
Develop:

This branch:

Tested on:

• Desktop Chrome

Documentation

Noupers

Additional Information

N/A

[rachel-fenichel]

Sorry for the delay!

This looks good and I like the constants. However, I'd like them to be private, and then reassess if we're getting requests to be able to change them.