SwiftUIVisualEffects

1.0.3

View modifiers that wrap UIVisualEffectView, with environment integration.
lucasbrown/swiftui-visual-effects

What's New

SwiftUI Visual Effects 1.0.3

2020-06-30T22:17:28Z
  • Licensed the project.
  • Added support for state changes.
  • Moved the following structures to a Wrappers folder in Sources/SwiftUIVisualEffects:
    • _BlurVisualEffectViewRepresentable
    • _VibrancyVisualEffectViewRepresentable
  • Moved BlurEffect to a new file, BlurEffect.swift, in Sources/SwiftUIVisualEffects.

SwiftUI Visual Effects


System materials in SwiftUI

View modifiers that wrap UIVisualEffectView and all of its associated objects, with environment integration for storing effect styles. Vibrancy effects will always use the current blur effect style for proper vibrancy-effect layering.

Adding and Styling a Blur Effect

YourView()
  // Add a blur effect.
  .blurEffect()
  // Style the blur effect.
  .blurEffectStyle(.systemChromeMaterial)

Adding and Styling a Vibrancy Effect

YourView()
  // Add a vibrancy effect.
  .vibrancyEffect()
  // Style the vibrancy effect.
  .vibrancyEffectStyle(.fill)

Adding and Styling Blur and Vibrancy Effects

ZStack {
  YourBackgroundContent()
    // Add a blur effect.
    .blurEffect()

  YourForegroundContent()
    // Add a vibrancy effect.
    .vibrancyEffect()
}
// Set the style for blur effects within this view.
.blurEffectStyle(.systemChromeMaterial)
// Set the style for vibrancy effects within this view.
.vibrancyEffectStyle(.fill)

Adding Blur and Vibrancy Effects Directly to a View

Adding both a blur and vibrancy effect directly to a view only displays the blur effect.

If you’d like to blur the view’s background content, while adding vibrancy to the view’s foreground content, use the .background() modifier, and pass BlurEffect() as its argument. Although BlurEffect may not be very Apple-like, it’s better than the .blurEffect() modifier implementation below.

YourView()
  .vibrancyEffect()
  .background(BlurEffect())

// as opposed to:

YourView()
  .vibrancyEffect()
  .background(
    Color.clear
      .blurEffect()
  )

Description

  • Swift Tools 5.2.0
View More Packages from this Author

Dependencies

  • None
Last updated: Sun Dec 15 2024 00:23:42 GMT-1000 (Hawaii-Aleutian Standard Time)