Updates

google · Aug 29, 2024 · 6e60592 · 6e60592
1 parent 006cc65
commit 6e60592
Show file tree

Hide file tree

Showing 75 changed files with 93 additions and 100 deletions.
diff --git a/examples/custom-tooltips-demo/index.html b/examples/custom-tooltips-demo/index.html
@@ -14,7 +14,6 @@
     <script src="./node_modules/blockly/blockly_compressed.js"></script>
     <script src="./node_modules/blockly/blocks_compressed.js"></script>
     <script src="./node_modules/blockly/msg/en.js"></script>
-    <script src="./node_modules/@blockly/dev-tools/dist/index.js"></script>
     <script src="./index.js"></script>
     <style>
       html,
@@ -36,7 +35,7 @@
 
     <div class="title-grow">
       <div class="title">Custom Tooltips</div>
-      <div class="subtitle">Example of using a custom tooltip renderer. Make sure you select the 'default' toolbox.</div>
+      <div class="subtitle">Example of using a custom tooltip renderer.</div>
     </div>
 
     <a href="https://github.com/google/blockly-samples/blob/master/examples/custom-tooltips-demo" class="button" target="_blank">View code</a>
@@ -46,7 +45,7 @@
         <div class="drop-shadow"></div>
 
 
-    <div id="root"></div>
+    <div id="root" style="height: 600px; width: 600px"></div>
   </main>
 
   <!-- FOOTER  -->

diff --git a/examples/custom-tooltips-demo/index.js b/examples/custom-tooltips-demo/index.js
@@ -43,20 +43,6 @@ function initTooltips() {
   Blockly.Tooltip.setCustomTooltip(customTooltip);
 }
 
-/**
- * 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);
-
-  initTooltips();
-
-  return workspace;
-}
-
 document.addEventListener('DOMContentLoaded', function () {
   Blockly.Blocks['custom_tooltip_1'] = {
     init: function () {
@@ -76,7 +62,7 @@ document.addEventListener('DOMContentLoaded', function () {
       this.setHelpUrl('');
     },
   };
-  const defaultOptions = {
+  const options = {
     toolbox: {
       kind: 'flyoutToolbox',
       contents: [
@@ -86,11 +72,6 @@ document.addEventListener('DOMContentLoaded', function () {
     },
   };
 
-  // createPlayground is from @blockly/dev-tools.
-  // eslint-disable-next-line no-undef
-  createPlayground(
-    document.getElementById('root'),
-    createWorkspace,
-    defaultOptions,
-  );
+  Blockly.inject(document.getElementById('root'), options);
+  initTooltips();
 });
diff --git a/examples/custom-tooltips-demo/node_modules/@blockly/dev-tools/dist/index.js b/examples/custom-tooltips-demo/node_modules/@blockly/dev-tools/dist/index.js
diff --git a/plugins/block-dynamic-connection/README.html b/plugins/block-dynamic-connection/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/block-dynamic-connection Demo</div>
       <div class="subtitle">A group of blocks that add connections dynamically.</div>
     </div>
-    0.7.8
+    0.7.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/block-dynamic-connection" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/block-dynamic-connection" class="button" target="_blank">View on npm</a>

diff --git a/plugins/block-dynamic-connection/test/index.html b/plugins/block-dynamic-connection/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/block-dynamic-connection Demo</div>
       <div class="subtitle">A group of blocks that add connections dynamically.</div>
     </div>
-    0.7.8
+    0.7.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/block-dynamic-connection" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/block-dynamic-connection" class="button" target="_blank">View on npm</a>

diff --git a/plugins/block-plus-minus/README.html b/plugins/block-plus-minus/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/block-plus-minus Demo</div>
       <div class="subtitle">A group of blocks that replace the built-in mutator UI with a +/- based UI.</div>
     </div>
-    8.0.8
+    8.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/block-plus-minus" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/block-plus-minus" class="button" target="_blank">View on npm</a>

diff --git a/plugins/block-plus-minus/test/index.html b/plugins/block-plus-minus/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/block-plus-minus Demo</div>
       <div class="subtitle">A group of blocks that replace the built-in mutator UI with a +/- based UI.</div>
     </div>
-    8.0.8
+    8.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/block-plus-minus" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/block-plus-minus" class="button" target="_blank">View on npm</a>

diff --git a/plugins/block-shareable-procedures/README.html b/plugins/block-shareable-procedures/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/block-shareable-procedures Demo</div>
       <div class="subtitle">A plugin that adds procedure blocks which are backed by explicit data models.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/block-shareable-procedures" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/block-shareable-procedures" class="button" target="_blank">View on npm</a>

diff --git a/plugins/block-shareable-procedures/test/index.html b/plugins/block-shareable-procedures/test/index.html
@@ -65,7 +65,7 @@
       <div class="title">@blockly/block-shareable-procedures Demo</div>
       <div class="subtitle">A plugin that adds procedure blocks which are backed by explicit data models.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/block-shareable-procedures" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/block-shareable-procedures" class="button" target="_blank">View on npm</a>

diff --git a/plugins/block-test/README.html b/plugins/block-test/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/block-test Demo</div>
       <div class="subtitle">A group of Blockly test blocks.</div>
     </div>
-    6.0.7
+    6.0.8
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/block-test" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/block-test" class="button" target="_blank">View on npm</a>

diff --git a/plugins/block-test/test/index.html b/plugins/block-test/test/index.html
@@ -41,7 +41,7 @@
       <div class="title">@blockly/block-test Demo</div>
       <div class="subtitle">A group of Blockly test blocks.</div>
     </div>
-    6.0.7
+    6.0.8
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/block-test" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/block-test" class="button" target="_blank">View on npm</a>

diff --git a/plugins/content-highlight/README.html b/plugins/content-highlight/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/workspace-content-highlight Demo</div>
       <div class="subtitle">A Blockly workspace plugin that adds a highlight around the content area.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/content-highlight" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/workspace-content-highlight" class="button" target="_blank">View on npm</a>

diff --git a/plugins/content-highlight/test/index.html b/plugins/content-highlight/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/workspace-content-highlight Demo</div>
       <div class="subtitle">A Blockly workspace plugin that adds a highlight around the content area.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/content-highlight" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/workspace-content-highlight" class="button" target="_blank">View on npm</a>

diff --git a/plugins/continuous-toolbox/README.html b/plugins/continuous-toolbox/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/continuous-toolbox Demo</div>
       <div class="subtitle">A Blockly plugin that adds a continous-scrolling style toolbox and flyout</div>
     </div>
-    6.0.8
+    6.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/continuous-toolbox" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/continuous-toolbox" class="button" target="_blank">View on npm</a>

diff --git a/plugins/continuous-toolbox/test/index.html b/plugins/continuous-toolbox/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/continuous-toolbox Demo</div>
       <div class="subtitle">A Blockly plugin that adds a continous-scrolling style toolbox and flyout</div>
     </div>
-    6.0.8
+    6.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/continuous-toolbox" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/continuous-toolbox" class="button" target="_blank">View on npm</a>

diff --git a/plugins/cross-tab-copy-paste/README.html b/plugins/cross-tab-copy-paste/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/plugin-cross-tab-copy-paste Demo</div>
       <div class="subtitle">Allows you to copy blocks with cross-tab.</div>
     </div>
-    6.0.8
+    6.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/cross-tab-copy-paste" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/plugin-cross-tab-copy-paste" class="button" target="_blank">View on npm</a>

diff --git a/plugins/cross-tab-copy-paste/test/index.html b/plugins/cross-tab-copy-paste/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/plugin-cross-tab-copy-paste Demo</div>
       <div class="subtitle">Allows you to copy blocks with cross-tab.</div>
     </div>
-    6.0.8
+    6.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/cross-tab-copy-paste" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/plugin-cross-tab-copy-paste" class="button" target="_blank">View on npm</a>

diff --git a/plugins/dev-tools/README.html b/plugins/dev-tools/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/dev-tools Demo</div>
       <div class="subtitle">A library of common utilities for Blockly extension development.</div>
     </div>
-    8.0.8
+    8.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/dev-tools" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/dev-tools" class="button" target="_blank">View on npm</a>

diff --git a/plugins/dev-tools/test/index.html b/plugins/dev-tools/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/dev-tools Demo</div>
       <div class="subtitle">A library of common utilities for Blockly extension development.</div>
     </div>
-    8.0.8
+    8.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/dev-tools" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/dev-tools" class="button" target="_blank">View on npm</a>

diff --git a/plugins/disable-top-blocks/README.html b/plugins/disable-top-blocks/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/disable-top-blocks Demo</div>
       <div class="subtitle">A Blockly plugin that shows the 'disable' context menu option only on non-orphan blocks.</div>
     </div>
-    0.5.8
+    0.5.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/disable-top-blocks" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/disable-top-blocks" class="button" target="_blank">View on npm</a>

diff --git a/plugins/disable-top-blocks/test/index.html b/plugins/disable-top-blocks/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/disable-top-blocks Demo</div>
       <div class="subtitle">A Blockly plugin that shows the 'disable' context menu option only on non-orphan blocks.</div>
     </div>
-    0.5.8
+    0.5.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/disable-top-blocks" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/disable-top-blocks" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-angle/README.html b/plugins/field-angle/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/field-angle Demo</div>
       <div class="subtitle">A Blockly angle field.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-angle" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-angle" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-angle/test/index.html b/plugins/field-angle/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/field-angle Demo</div>
       <div class="subtitle">A Blockly angle field.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-angle" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-angle" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-bitmap/README.html b/plugins/field-bitmap/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/field-bitmap Demo</div>
       <div class="subtitle">A field that lets users input a pixel grid with their mouse.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-bitmap" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-bitmap" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-bitmap/test/index.html b/plugins/field-bitmap/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/field-bitmap Demo</div>
       <div class="subtitle">A field that lets users input a pixel grid with their mouse.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-bitmap" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-bitmap" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-colour-hsv-sliders/README.html b/plugins/field-colour-hsv-sliders/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/field-colour-hsv-sliders Demo</div>
       <div class="subtitle">A Blockly colour field using HSV sliders.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-colour-hsv-sliders" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-colour-hsv-sliders" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-colour-hsv-sliders/test/index.html b/plugins/field-colour-hsv-sliders/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/field-colour-hsv-sliders Demo</div>
       <div class="subtitle">A Blockly colour field using HSV sliders.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-colour-hsv-sliders" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-colour-hsv-sliders" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-colour/README.html b/plugins/field-colour/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/field-colour Demo</div>
       <div class="subtitle">A Blockly colour field.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-colour" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-colour" class="button" target="_blank">View on npm</a>
@@ -263,6 +263,22 @@ <h3 id="blocks">Blocks</h3>
 colourBlend.installBlock({
   javascript: javascriptGenerator,
 });</code></pre>
+<h4 id="message-files-and-locales">Message files and locales</h4>
+<p>The blocks in this package contain text that can be
+<a href="https://developers.google.com/blockly/guides/create-custom-blocks/localize-blocks">localized</a>
+into multiple languages. As of August 2024, the relevant messages are
+included in the core Blockly language files.</p>
+<p>If your blocks show <code>%{BKY_COLOUR_BLEND_TITLE}</code> or similar text instead
+of the expected text, make sure that you either:</p>
+<ul>
+<li>Import the <a href="https://developers.google.com/blockly/guides/configure/web/translations#import_blockly_default_modules">default Blockly modules</a>,
+which includes the English langfiles, or</li>
+<li>Explicitly <a href="https://developers.google.com/blockly/guides/configure/web/translations#import_blockly_languages">import a language</a>
+and call <code>setLocale</code> before using these blocks.</li>
+</ul>
+<p>For more information on Blockly's approach to localization, see the
+<a href="https://developers.google.com/blockly/guides/create-custom-blocks/localize-blocks">Localize Blocks</a>
+developer guide.</p>
 <h3 id="api-reference">API Reference</h3>
 <ul>
 <li><code>setColours</code>: Sets the colour options, and optionally the titles for the

diff --git a/plugins/field-colour/test/index.html b/plugins/field-colour/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/field-colour Demo</div>
       <div class="subtitle">A Blockly colour field.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-colour" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-colour" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-date/README.html b/plugins/field-date/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/field-date Demo</div>
       <div class="subtitle">A Blockly date picker field that uses the browser's date picker.</div>
     </div>
-    9.0.8
+    9.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-date" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-date" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-date/test/index.html b/plugins/field-date/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/field-date Demo</div>
       <div class="subtitle">A Blockly date picker field that uses the browser's date picker.</div>
     </div>
-    9.0.8
+    9.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-date" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-date" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-dependent-dropdown/README.html b/plugins/field-dependent-dropdown/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/field-dependent-dropdown Demo</div>
       <div class="subtitle">A Blockly dropdown field that automatically updates its available options depending on the value of another field.</div>
     </div>
-    4.0.8
+    4.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-dependent-dropdown" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-dependent-dropdown" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-dependent-dropdown/test/index.html b/plugins/field-dependent-dropdown/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/field-dependent-dropdown Demo</div>
       <div class="subtitle">A Blockly dropdown field that automatically updates its available options depending on the value of another field.</div>
     </div>
-    4.0.8
+    4.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-dependent-dropdown" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-dependent-dropdown" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-grid-dropdown/README.html b/plugins/field-grid-dropdown/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/field-grid-dropdown Demo</div>
       <div class="subtitle">A Blockly dropdown field with grid layout.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-grid-dropdown" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-grid-dropdown" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-grid-dropdown/test/index.html b/plugins/field-grid-dropdown/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/field-grid-dropdown Demo</div>
       <div class="subtitle">A Blockly dropdown field with grid layout.</div>
     </div>
-    5.0.8
+    5.0.9
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-grid-dropdown" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-grid-dropdown" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-multilineinput/README.html b/plugins/field-multilineinput/README.html
@@ -24,7 +24,7 @@
       <div class="title">@blockly/field-multilineinput Demo</div>
       <div class="subtitle">A Blockly multilineinput field.</div>
     </div>
-    5.0.9
+    5.0.10
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-multilineinput" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-multilineinput" class="button" target="_blank">View on npm</a>

diff --git a/plugins/field-multilineinput/test/index.html b/plugins/field-multilineinput/test/index.html
@@ -33,7 +33,7 @@
       <div class="title">@blockly/field-multilineinput Demo</div>
       <div class="subtitle">A Blockly multilineinput field.</div>
     </div>
-    5.0.9
+    5.0.10
 
     <a href="https://github.com/google/blockly-samples/blob/master/plugins/field-multilineinput" class="button" target="_blank">View code</a>
     <a href="https://www.npmjs.com/package/@blockly/field-multilineinput" class="button" target="_blank">View on npm</a>