Bundleware, Toolbar Script Reference

Last site update 30th October 2026

Toolbar.Search

PartAPI 2
SignatureToolbar.Search: FunctionComponent<SearchProps> & { /** Bundleware 0.4 and later. */ readonly Suggestion: FunctionComponent<SuggestionProps>; }
Take it fromconst { Toolbar } = Bundleware;

Props

PropTypeDescription
placeholderstringThe field's hint, which is also its accessible name.
buttonTitlestringOptional. Defaults to "Search".
iconIconRefOptional. Drawn inside the field, before the text.
width'narrow' | 'med' | 'wide'Optional.
notestringOptional. Fine print under the suggestions, such as 'Suggestions are simulated on this device.'
childrenChildrenOptional. The suggestions: <Toolbar.Search.Suggestion> rows, <Toolbar.Menu.Item> commands, and <Toolbar.Menu.Section>s of them under a caption; at most 12 rows. Bundleware 0.4 and later.
urlstringOptional. Opened in a new tab, with exactly one {q} for the search text.
onSearch(text: string) => void | Promise<void>Optional. Runs instead of opening a URL, with the trimmed search text. Bundleware 0.4 and later.

Availability

Applicable versionsAPI 2 and higher
Bundleware0.3.0, build 2026.10.30