Swift Optional badge(_:)用法及代碼示例

用法一

實例方法

badge(_:)

從本地化的字符串鍵生成視圖的標記。

聲明

func badge(_ key: LocalizedStringKey?) -> some View

參數

key: 顯示為徽章的可選字符串鍵。將值設置為 nil 以隱藏徽章。

詳述

使用徽章來傳達有關視圖的可選補充信息。使徽章的內容盡可能簡短。徽章僅出現在列表行和選項卡欄中。

此修飾符代表您創建 Text 視圖，並將本地化鍵視為類似於 Text/init(_:tableName:bundle:comment:) 。有關本地化字符串的更多信息，請參閱Text。以下示例顯示了一個列表，其中一個行帶有 “Default” 標記。


NavigationView {
    List(servers) { server in
        Text(server.name)
            .badge(server.isDefault ? "Default" : nil)
    }
    .navigationTitle("Servers")
}

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+

用法二

實例方法

badge(_:)

從文本視圖生成視圖的標記。

聲明

func badge(_ label: Text?) -> some View

參數

label: 一個可選的 Text 視圖，顯示為徽章。將值設置為 nil 以隱藏徽章。

詳述

使用徽章來傳達有關視圖的可選補充信息。使徽章的內容盡可能簡短。徽章僅出現在列表行和選項卡欄中。

當您想要設置 Text 視圖的樣式以用作徽章時，請使用此初始化程序。以下示例使用 Text/monospacedDigit() 、 Text/foregroundColor(_:) 和 Text/bold() 修飾符自定義徽章。


var body: some View {
    let badgeView = Text("\(recentItems.count)")
        .monospacedDigit()
        .foregroundColor(.red)
        .bold()


    List {
        Text("Recents")
            .badge(badgeView)
        Text("Favorites")
    }
}

當徽章出現在 TabView 中時，設置文本視圖的樣式無效。

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+

用法三

實例方法

badge(_:)

從整數值生成視圖的標記。

聲明

func badge(_ count: Int) -> some View

參數

count: 要在徽章中顯示的整數值。將該值設置為零以隱藏徽章。

詳述

使用徽章來傳達有關視圖的可選補充信息。使徽章的內容盡可能簡短。徽章僅出現在列表行和選項卡欄中。

以下示例顯示了一個 List，其值為 recentItems.count，由其中一行上的標記表示：


List {
    Text("Recents")
        .badge(recentItems.count)
    Text("Favorites")
}

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+

用法四

實例方法

badge(_:)

從字符串生成視圖的徽章。

聲明

func badge<S>(_ label: S?) -> some View where S : StringProtocol

參數

label: 要顯示為徽章的可選字符串。將值設置為 nil 以隱藏徽章。

詳述

使用徽章來傳達有關視圖的可選補充信息。使徽章的內容盡可能簡短。徽章僅出現在列表行和選項卡欄中。

此修飾符代表您創建 Text 視圖，並將本地化鍵視為類似於 Text/init(_:)-9d1g4 。以下示例顯示了一個列表，其中一個行帶有 “Default” 標記。


NavigationView {
    List(servers) { server in
        Text(server.name)
            .badge(server.defaultString())
    }
    .navigationTitle("Servers")
}

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+

相關用法

注：本文由純淨天空篩選整理自apple.com大神的英文原創作品 Optional badge(_:)。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。