Handbook · Reference · Blockly
Blockly toolbox
Where in the UI. Scripts tab. Categories in the Blockly toolbox flyout.
How-to lives on Scripts. This index is the map. Stock Logic/Math/Text/Lists/Variables/Functions are Blockly’s. Everything else calls a host method (see host methods) and needs a capability.
User-visible strings in scripts should use ContaindText (containd_text), not stock text, so translations can fill keys.
| Category | Purpose | Blocks |
|---|---|---|
| Logic | Stock Blockly: if, compare, and/or, booleans, ternary. | 7 |
| Loops | Repeat, while, for, for-each, plus item-ref list length helpers. | 7 |
| Math | Stock math plus Containd rounding, hex color ints, and random lists. | 15 |
| Text | Stock string ops plus ContaindText and rich-text link formatters. | 16 |
| Lists | Stock lists plus Containd concat/append (interpreter-safe). | 14 |
| Dialogs | Alerts, toasts, confirms, pickers, SVG dialogs. | 7 |
| Containd text helpers | Split/join/sanitize and encoded selects. | 8 |
| Navigation | Navigate, open link/website/deep link/search. | 5 |
| Tree | Walk the item tree: roots, parent, children, placeholders, ids. | 18 |
| Layouts | Resolve layouts/elements, enable layouts, enum option helpers. | 30 |
| Data | Read/write item fields, categories, variables, local state, style patches. | 49 |
| Table | CTBL / file-table rows, CSV, columns. | 26 |
| Class | Class variables, membership, list/run class scripts and API. | 21 |
| Relatives | Read/write parent, child, sibling fields and properties. | 10 |
| Date and time | Clock, duration, format, weekday helpers, datetime writes. | 14 |
| Units | Convert quantities and list unit catalogs. | 3 |
| Statistics | Plots, series, summaries, regression, FFT helpers. | 59 |
| Device | Clipboard and barcode scanner. | 3 |
| Canvas | Query, move, align, animate items; schedules; canvas level. | 15 |
| Graph | Item graph edges, wire style, peer ids. | 21 |
| Media | Import images, QR, thumbnails, screenshots. | 6 |
| Files | CSV, filenames, share, PDF document blocks, inventory report. | 17 |
| Items | Create, retype, trash, apply mutations. | 16 |
| AI | Credits and launch AI chat (capability-gated). | 2 |
| System | Reminders, timers, display refresh, script log, evaluate expression. | 24 |
| Actions | Dispatch template actions / custom actions. | 3 |
| Shared functions | Call shared functions and return values. | 4 |
| Advanced | Generic host call and graph mutation patches. | 3 |
| Variables (stock) | Blockly variable getters/setters for script-local names (not item variables). | 0 |
| Functions (stock) | Blockly procedures. Prefer Containd shared functions for reusable host-facing APIs. | 0 |
Source: app/lib/scripts/blocklyToolbox.ts.