Opens the editor's font picker for the selected component, letting a Wix user choose a font family without selecting a weight.
Call selectFont() when you also need the Wix user to choose a weight in the same picker.
| Name | Type | Description |
|---|---|---|
selectedFontFamily | object | Font family to show when the picker opens, as { family, weight }. |
target | HTMLElement | Element in your panel that the picker popup opens relative to. |
panelOptions | object | Positioning options for the picker popup, such as placement and YShift. |
onChange | function | Called with the selected font family when the Wix user confirms a selection. |
onPreview | function | Called with the font family while the Wix user is previewing options, before confirming. |
Promise<IFontFamily | undefined>
The selected font family, or undefined if the Wix user closes the picker without selecting anything. Use the onChange and onPreview callbacks to receive selections as the Wix user interacts with the picker, and apply them yourself with setStyles().
Last updated: 8 September 2026