Handbook · Reference · Blockly · System

Blockly: System

Where in the UI. Scripts tab toolbox.

Reminders, timers, display refresh, script log, evaluate expression.

Block idRead asPurpose
containd_evaluate_expressionevaluate expressionrequires scripts.invoke
containd_schedule_reminderschedule reminderCreates a reminder and returns reminderId (string). Store it to update or delete later.
containd_list_item_reminderslist item remindersList of reminderId strings for the current item.
containd_list_item_reminders_on_itemlist item reminders on itemList of reminderId strings for that item. Returns [] when none. Requires notifications.read.
containd_get_reminderget reminderLoads ReminderView for an id. Plug into “reminder … property” to read title, wasFired, etc.
containd_reminder_propertyreminder propertyRead one field from a ReminderView (from “get reminder”).
containd_update_reminderupdate reminderChange an existing reminder. “unchanged” leaves that field alone (no value plug).
containd_cancel_remindercancel reminderCancels the OS notification and deletes the reminder by reminderId.
containd_start_countdown_timerstart countdown timerStarts a countdown on an item.
containd_start_stopwatchstart stopwatchStarts a stopwatch on an item (counts up).
containd_get_timerget timerLoads one timer’s live state (TimerView object).
containd_list_item_timerslist item timersAll timers on the item running this script.
containd_list_item_timers_on_itemlist item timers on itemAll timers on another item.
containd_item_has_timeritem has timerQuick check for timers on the item running this script.
containd_item_has_timer_on_itemitem has timer on itemSame as “this item has timer”, for another item.
containd_timer_propertytimer propertyRead one field from a TimerView (from get timer or list/for-each).
containd_get_reminder_id_for_timerget reminder id for timerLooks up the OS reminder linked when the countdown was started with create reminder = true.
containd_get_timer_id_for_reminderget timer id for reminderReverse link: which timer created this reminder (if any).
containd_pause_timerpause timerPauses a running countdown or stopwatch (chip/modal stay; time freezes).
containd_resume_timerresume timerContinues a paused countdown or stopwatch.
containd_stop_timerstop timerStops and deletes the timer (UI closes). Also cancels a linked reminder if create reminder was used.
containd_lap_stopwatchlap stopwatchRecords a lap on a running stopwatch (no-op / error on countdowns).
containd_request_display_refreshrequest display refreshcallHost(requestDisplayRefresh)
containd_log_scriptlog scriptcallHost(logScript)