Save File Dialog

Category: User Interface

Opens a save dialog and returns the selected output path as a string. Use `suggestedName` and `types` to guide what the dialog proposes to the user. When the chosen path will later be used by another block family such as the spreadsheet blocks, keep the suggested name and file types aligned with the formats that block family actually supports. At least one of `suggestedName` or `types` should be provided. Use `initialDomain` to control which location the dialog opens in first. With `cancelBehavior=STOP`, cancelling aborts the script immediately. With `cancelBehavior=EMPTY`, cancelling returns an empty string instead.

Inputs

Input	Required	Value Kind	Types	Enum Values
suggestedName	no	expression	string	—
types	no	expression	array	—
cancelBehavior	no	enum	enum-string	STOP, EMPTY
initialDomain	no	enum	enum-string	DEFAULT, USER_DESKTOP, USER_DOCUMENTS, USER_PICTURES, USER_VIDEOS, USER_MUSIC, USER_DOWNLOADS, USER_HOME, TEMP, APP_LOCAL_DATA, APP_LOCAL_LIBRARY, APP_LOCAL_CACHE, APP_LOCAL_SHARED, APP_LOCAL_TEMPORARY, APP_ROAMING_DATA, APP_ROAMING_LIBRARY

Notes

No additional notes are available yet.

See Also

• Building Prompt Dialogs: Explains how UI Prompt Field and UI Prompt Form work together to build custom dialogs.

Examples

Export Spreadsheet With Save Dialog

Uses `saveFileDialog` with supported spreadsheet suffixes, writes a header row, then appends data rows.

kind: Pattern · format: runtime-dsl · validation: Schema only

Topics: spreadsheet export, save dialogs

Source: patterns/ex-spreadsheet-export-with-save-dialog.json

Download JSON

Export Sequence Markers To SRT

Prompts for the subtitle text source first, then exports active-sequence markers to an `.srt` file while skipping empty resolved text and zero-duration markers.

kind: Recipe · format: persisted-document · validation: Schema only

Topics: markers, subtitles, SRT export, save dialogs, marker comments

Source: recipes/ex-markers-export-active-sequence-to-srt.json

Download JSON

Export Sequence Markers To YouTube Chapter Text

Prompts for the chapter title source and output mode, then exports active-sequence markers as YouTube chapter lines to the clipboard or a `.txt` file while skipping empty resolved text.

kind: Recipe · format: persisted-document · validation: Schema only

Topics: markers, YouTube chapters, text export, clipboard workflows, save dialogs, marker comments

Source: recipes/ex-markers-export-active-sequence-to-youtube-chapter-text.json

Download JSON