Controls and Indicators

Display values and get user selections.

Overview 概要

SwiftUI provides controls that enable user interaction adapted to each platform and context. For example, users can initiate events with buttons, menus, and links, or choose among a set of discrete values with different kinds of pickers. You can also display information to the user with indicators like progress views and gauges.

An illustration showing a variety of different kinds of built-in controls that SwiftUI provides, like buttons, sliders, steppers, toggles, and pickers.

Use these built-in controls and indicators when composing custom views, and style them to match the needs of your app’s user interface. For design guidance, see Human Interface Guidelines.

Topics 話題

Buttons ボタン

struct Button

A control that initiates an action.

struct EditButton

A button that toggles the edit mode environment value.

struct PasteButton

A system button that reads data from the pasteboard and delivers it to a closure.

struct Link

A control for navigating to a URL. あるURLへと案内するためのコントロール。

struct Menu

A control for presenting a menu of actions. アクションいくつかからなるあるメニューを提示するためのコントロール。

Value Inputs

struct Slider

A control for selecting a value from a bounded linear range of values. 値いくつかからなる有界線形範囲からある値を選択するためのコントロール。

struct Stepper

A control that performs increment and decrement actions. 漸増および漸減アクションを実行するコントロール。

struct Toggle

A control that toggles between on and off states. オンおよびオフ状態の間でトグルする（同じ操作で２状態を切り替える）コントロール。

Pickers

struct Picker

A control for selecting from a set of mutually exclusive values. 一揃いの相互に排他的な値から選択するためのコントロール。

struct DatePicker

A control for selecting an absolute date. 絶対日付を選択するためのコントロール。

struct ColorPicker

A control used to select a color from the system color picker UI. ある色をシステムカラーピッカ−UIから選択するために使われるあるコントロール。

Indicators

struct ProgressView

A view that shows the progress towards completion of a task. あるビュー、それはあるタスクの完了に向けての進捗を示します。

struct Gauge

A view that shows a value within a range. あるビュー、それはある値をある範囲内で示します。

Configuration

enum ControlActiveState

enum ControlSize

The size classes, like regular or small, that you can apply to controls within a view. サイズクラス、レギュラーまたはスモールのような、それはあなたがビュー内のコントロールに適用できるものです。

enum Prominence

A type indicating the prominence of a view hierarchy.

enum Visibility

The visibility of a UI element, chosen automatically based on the platform, current context, and other factors.