touchBarItemPresence(_:)

Return Value 戻り値

A trait that describes the behavior for this Touch Bar view. このTouch Barビューの挙動を記述するある特徴。

Discussion 議論

Use touchBarItemPresence(_:) to define the visibility requirements of a particular Touch Bar view during customization by the user. touchBarItemPresence(_:)を使って、ユーザによるカスタマイズの間における、特定のTouch Barビューの可視的要件を定義してください。

Touch Bar views may be: Touch Barビューは、以下であるかもしれません：

• .required: not allowed to be removed by the user. .required: ユーザによって取り除かれることを許可しない。

• .default: shown by default prior to user customization, but removable. .default: 初期状態ではユーザのカスタマイズの前に示される、しかし取り除くことができる。

• .optional: not visible by default, but can be added through the customization palette. .optional: 初期状態では可視ではない、しかしカスタマイゼーションパレットを通して追加できる。

Each TouchBarItemPresence must be initialized with a string that is a globally unique identifier for this item. 各TouchBarItemPresenceは、ある文字列で初期化されなければなりません、それはこの項目に対するグローバルに特有な識別子です。

In the example below, all of the Touch Bar items are visible in the Touch Bar by default, except for the “Clubs” item. It’s set to .optional but is configurable by the user: 以下の例において、Touch Bar項目の全ては、Touch Barにおいて初期状態で可視です、“Clubs” 項目を除いては。それは.optionalに設定されます、しかしユーザによって構成設定可能です：

TextField("TouchBar Demo", text: $placeholder)
    .frame(maxWidth: .infinity, maxHeight: .infinity)
    .focusable()
    .touchBar {
        Button("♥️", action: selectHearts)
            .touchBarItemPresence(.required("heartsKey"))
        Button("♣️", action: selectClubs)
            .touchBarItemPresence(.optional("clubsKey"))
        Button("♠️", action: selectSpades)
            .touchBarItemPresence(.required("spadesKey"))
        Button("♦️", action: selectDiamonds)
            .touchBarItemPresence(.required("diamondsKey"))
}