LiquidGlassKit

حزمة SwiftUI للتطبيقات التي تريد استخدام Liquid Glass مع الاستمرار في دعم الأنظمة التي لا تملكه. في iOS وmacOS وtvOS وwatchOS 26 تُرسَم باستخدام glassEffect الأصلي في SwiftUI؛ وفي الإصدارات الأقدم وفي visionOS تُرسَم بتمويه (blur) من نوع Material مع صبغة (tint) وإبراز للحواف (edge highlight) وظل. يُبنى كل مكوّن على معدِّل واحد، glassSurface، بحيث تُعالَج السمة (theme) ومسار العرض (rendering path) وReduce Transparency في مكان واحد. لا اعتماديات من جهات خارجية.

الميزات

معدِّل واحد، مساران: يختار glassSurface الزجاج الأصلي أو بديل Material في وقت التشغيل (run time)، ويفرض glassRenderingMode(.fallback) مظهرًا واحدًا في كل مكان

عناصر تحكم جاهزة: أزرار، ونمط switch، وslider، وبطاقات، وحقول نصية، وشريط بحث، وشريط tabs عائم بزر إجراء (action button) وبادجات (badges)، وشريط تنقّل (navigation bar)، وbottom sheet

زجاج مصبوغ بتدرج (gradient) وإبرازات متحركة shimmer وpulse وbreathe على كلا مساري العرض

GlassTheme لتسلسل هرمي كامل من العروض (view hierarchy)، و14 قالبًا جاهزًا في GlassPreset، وGlassCodeExporter لتحويل مظهر مضبوط إلى كود Swift

إمكانية الوصول: يرسم المسار البديل خلفية معتمة (opaque) عند تفعيل Reduce Transparency وحافة أقوى عند تفعيل Increase Contrast، ودون أي إبرازات عند تفعيل Reduce Motion، مع سلوك VoiceOver الخاص بـ SwiftUI نفسها للـ switch وslider

لا تعارض في الأسماء مع glassEffect أو GlassEffectContainer أو GlassButtonStyle الخاصة بـ SwiftUI، بحيث يمكن استيراد (import) الوحدتين في ملف واحد

حزم اختبارات Swift Testing بفحوصات بكسل خارج الشاشة (offscreen)، تعمل في CI على macOS ومحاكي iOS 26 ومحاكي iOS 18.6

البدء السريع

swift

1import LiquidGlassKit
2import SwiftUI
3 
4struct ContentView: View {
5    var body: some View {
6        ZStack {
7            LinearGradient(colors: [.indigo, .pink], startPoint: .top, endPoint: .bottom)
8                .ignoresSafeArea()
9            VStack(spacing: 16) {
10                GlassCard {
11                    Label("Hello, glass", systemImage: "sparkles")
12                }
13                GlassButton("Tap me", systemImage: "hand.tap") {}
14            }
15        }
16    }
17}

التثبيت

Swift Package Manager (Xcode)

text

1https://github.com/muhittincamdali/LiquidGlassKit.git

Swift Package Manager (Package.swift)

swift

1dependencies: [
2    .package(url: "https://github.com/muhittincamdali/LiquidGlassKit.git", from: "2.1.0")
3],
4targets: [
5    .target(name: "YourApp", dependencies: [
6        .product(name: "LiquidGlassKit", package: "LiquidGlassKit")
7    ])
8]