UITextButton should be used for de-emphasized actions, or actions inline with text content.

Compatibility

Text buttons, as well as other button styles, can be used within other components, for example, appearing on UIHeaders, or in UIPlatformTables. Text buttons are the default action type on UIHeaders.

Action Areas

Often, multiple buttons are used together to create groups of related actions, commonly on headers, modals, alerts, or forms. Text buttons should never be used as the primary actions in a form or modal, and should rarely be placed immediately adjacent to a UIButton.

Alternatives

For actions that are more significant than the appearance of a text button would indicate, use a type of UIButton.

‍

Text buttons consist of a single-line text label. The clickable area is determined by the text itself.

A text button should always visually convey its current interactive states: enabled, disabled, hover, focused, pressed. Disabled actions should never disappear entirely from view.

To help indicate active processes triggered by a text button (e.g. “saving…”), a text button can be temporarily replaced with a disabled alternate label (see Buttons & Indicators).

‍