SwiftUI自定义泛型组件无法访问枚举专属属性问题

问题根源 #

你的CardSelectionList<T>泛型结构体仅约束了T: RawRepresentable, T.RawValue == String——这个约束只要求类型T能转换为String类型的rawValue，但没有要求T必须具备definition属性。因此在组件内部，编译器无法确认items[i]（类型为T）存在definition属性，直接访问会触发编译错误，你写的items[i].definition ?? nil本质上是编译器不允许的操作。

解决方案 #

以下两种方案可解决该问题，按需选择：

方案一：通过协议约束统一属性 #

1. 定义包含definition属性的协议：

protocol HasDefinition {
    var definition: String { get }
}

2. 让PlantStage枚举遵守该协议：

enum PlantStage: String, CaseIterable, HasDefinition {
    // 原有case和definition实现保持不变
}

3. 更新泛型组件的约束，新增HasDefinition协议要求：

struct CardSelectionList<T>: View where T: RawRepresentable, T.RawValue == String, T: HasDefinition {
    let items: [T]
    let newlySelectedPillText: String
    let currentlyActivePillText: String
    @Binding var selectedItem: T
    @Binding var selectedIndex: Int
    
    var body: some View {
        ScrollView {
            VStack(alignment: .leading, spacing: 10) {
                ForEach(0..<items.count, id: \.self) { i in
                    CardSelectable(
                        title: items[i].rawValue,
                        // 协议保证存在该属性，直接传递非可选值
                        description: items[i].definition,
                        currentlyActivePillText: currentlyActivePillText,
                        isNewlySelected: i == selectedIndex,
                        newlySelectedPillText: newlySelectedPillText
                    )
                    .onTapGesture {
                        selectedIndex = i
                        selectedItem = items[i]
                    }
                }
            }
        }
    }
}

4. 优化CardSelectable的description参数为非可选类型（因为协议已保证有值）：

struct CardSelectable: View {
    let title: String
    // 从String?改为String
    let description: String
    
    let currentlyActivePillText: String
    let isNewlySelected: Bool
    let newlySelectedPillText: String
    
    var body: some View {
        VStack(alignment: .leading, spacing: 5) {
            HStack(spacing: 8) {
                Text(title)
                    .font(.handjet(.bold, size: 24))
                
                if isNewlySelected {
                    TextPill(label: newlySelectedPillText, backgroundColor: Color.theme.accentYellow)
                }
            }
            
            // 无需if let，直接使用description
            Text(description)
                .font(.handjet(.medium, size: 20))
        }
        .padding()
        .frame(maxWidth: .infinity, alignment: .leading)
        .background(Color.theme.backgroundAccent)
        .overlay(isNewlySelected ? selectedBorder : nil)
        .clipShape(RoundedRectangle(cornerRadius: 8))
        .padding(.horizontal)
    }
}

方案二：通过闭包动态提取描述 #

如果不想定义协议，可通过闭包参数实现灵活的描述提取逻辑：

1. 为泛型组件新增闭包参数：

struct CardSelectionList<T>: View where T: RawRepresentable, T.RawValue == String {
    let items: [T]
    let newlySelectedPillText: String
    let currentlyActivePillText: String
    @Binding var selectedItem: T
    @Binding var selectedIndex: Int
    // 新增闭包，用于从T类型提取描述文本
    let getDescription: (T) -> String?
    
    var body: some View {
        ScrollView {
            VStack(alignment: .leading, spacing: 10) {
                ForEach(0..<items.count, id: \.self) { i in
                    CardSelectable(
                        title: items[i].rawValue,
                        description: getDescription(items[i]),
                        currentlyActivePillText: currentlyActivePillText,
                        isNewlySelected: i == selectedIndex,
                        newlySelectedPillText: newlySelectedPillText
                    )
                    .onTapGesture {
                        selectedIndex = i
                        selectedItem = items[i]
                    }
                }
            }
        }
    }
}

2. 使用组件时传入闭包：

#Preview {
    CardSelectionList(
        items: PlantStage.allCases,
        newlySelectedPillText: "New Stage",
        currentlyActivePillText: "Current Stage",
        selectedItem: .constant(.seed),
        selectedIndex: .constant(0),
        getDescription: { $0.definition }
    )
}

补充说明 #

你之前将description设为可选类型的尝试，并没有解决核心问题——编译器仍然不知道T类型拥有definition属性。只有通过协议约束明确属性要求，或者通过闭包动态传递属性值，才能让编译器正确识别并访问该属性。

内容的提问来源于stack exchange，提问作者lolrie