• Stars
    star
    3,754
  • Rank 11,741 (Top 0.3 %)
  • Language
    TypeScript
  • License
    MIT License
  • Created over 9 years ago
  • Updated 3 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

React Native Blur component

@react-native-community/blur

npm version

A component for UIVisualEffectView's blur and vibrancy effect on iOS, and BlurView on Android.

Current Maintainers:

Content

Installation

yarn add @react-native-community/blur

Install native dependencies (iOS only):

cd ios && pod install

Usage

BlurView

Property Possible Values Default Platform
blurType See blurType below - All
blurAmount 0 - 100 (The maximum blurAmount on Android is 32, so higher values will be clamped to 32) 10 All
reducedTransparencyFallbackColor Any color - iOS only
blurRadius 0 - 25 Matches iOS blurAmount Android only
downsampleFactor 0 - 25 Matches iOS blurAmount Android only
overlayColor Any color Default color based on iOS blurType Android only

blurType

Name Description
xlight extra light blur type
light light blur type
dark dark blur type
extraDark extra dark blur type (tvOS only)
regular regular blur type (iOS 10+ and tvOS only)
prominent prominent blur type (iOS 10+ and tvOS only)

blurType (iOS 13 only)

Name Description
chromeMaterial An adaptable blur effect that creates the appearance of the system chrome.
material An adaptable blur effect that creates the appearance of a material with normal thickness.
thickMaterial An adaptable blur effect that creates the appearance of a material that is thicker than normal.
chromeMaterial An adaptable blur effect that creates the appearance of the system chrome.
thinMaterial An adaptable blur effect that creates the appearance of an ultra-thin material.
ultraThinMaterial An adaptable blur effect that creates the appearance of an ultra-thin material.
chromeMaterialDark A blur effect that creates the appearance of an ultra-thin material and is always dark.
materialDark A blur effect that creates the appearance of a thin material and is always dark.
thickMaterialDark A blur effect that creates the appearance of a material with normal thickness and is always dark.
thinMaterialDark A blur effect that creates the appearance of a material that is thicker than normal and is always dark.
ultraThinMaterialDark A blur effect that creates the appearance of the system chrome and is always dark.
chromeMaterialLight An adaptable blur effect that creates the appearance of the system chrome.
materialLight An adaptable blur effect that creates the appearance of a material with normal thickness.
thickMaterialLight An adaptable blur effect that creates the appearance of a material that is thicker than normal.
thinMaterialLight An adaptable blur effect that creates the appearance of a thin material.
ultraThinMaterialLight An adaptable blur effect that creates the appearance of an ultra-thin material.

Complete usage example that works on iOS and Android:

import React, { Component } from "react";
import { View, Image, Text, StyleSheet } from "react-native";
import { BlurView } from "@react-native-community/blur";

export default function Menu() {
  return (
    <View style={styles.container}>
      <Image
        key={'blurryImage'}
        source={{ uri }}
        style={styles.absolute}
      />
      <Text style={styles.absolute}>Hi, I am some blurred text</Text>
      {/* in terms of positioning and zIndex-ing everything before the BlurView will be blurred */}
      <BlurView
        style={styles.absolute}
        blurType="light"
        blurAmount={10}
        reducedTransparencyFallbackColor="white"
      />
      <Text>I'm the non blurred text because I got rendered on top of the BlurView</Text>
    </View>
  )
}

const styles = StyleSheet.create({
  container: {
    justifyContent: "center",
    alignItems: "center"
  },
  absolute: {
    position: "absolute",
    top: 0,
    left: 0,
    bottom: 0,
    right: 0
  }
});

In this example, the Image component will be blurred, because the BlurView in positioned on top. But the Text will stay unblurred.

If the accessibility setting Reduce Transparency is enabled the BlurView will use reducedTransparencyFallbackColor as it's background color rather than blurring. If no reducedTransparencyFallbackColor is provided, theBlurViewwill use the default fallback color (white, black, or grey depending on blurType)

VibrancyView

Uses the same properties as BlurView (blurType, blurAmount, and reducedTransparencyFallbackColor).

The vibrancy effect lets the content underneath a blurred view show through more vibrantly

VibrancyView is only supported on iOS. Also note that the VibrancyView must contain nested views

import { VibrancyView } from "@react-native-community/blur";

export default function Menu() {
  return (
    <Image source={{ uri }} style={styles.absolute}>
      <VibrancyView blurType="light" style={styles.flex}>
      <Text>Hi, I am some vibrant text.</Text>
      </VibrancyView>
    </Image>
  )
}

Example React Native App

This project includes an example React Native app, which was used to make the GIF in this README. You can run the apps by following these steps:

Clone the repository

git clone https://github.com/react-native-community/react-native-blur.git

Install dependencies

yarn

Run the app

yarn example android/ios

Questions?

Feel free to create an issue

More Repositories

1

react-native-side-menu

Side menu component for React Native
JavaScript
2,213
star
2

react-native-navbar

Navbar component for React Native
JavaScript
1,894
star
3

browserify-react-live

React Live Patch for browserify
JavaScript
83
star
4

react-native-network-proxy

Network debugger (logger) for React Native apps
JavaScript
74
star
5

Reactive2015

Reactive 2015 Conference contest app
JavaScript
62
star
6

ReactNativeWithSwiftUITutorial

Supportive material for the tutorial about React Native and SwiftUI
Objective-C
61
star
7

react-native-list

FlatList, VirtualizedList, SectionList for React-Native < 0.43
JavaScript
44
star
8

react-native-uber-rides

🚗 React Native port for Uber Rides SDK
Swift
33
star
9

fflux

Flux-based architecture library with immutable data support
JavaScript
31
star
10

ExampleBridge

Objective-C
27
star
11

react-navigation-parser

Parser tool for react-navigation
JavaScript
24
star
12

navigator-redux

Navigator for React-Native, driven by redux
JavaScript
18
star
13

browserify-patch-server

Patch server for browserify
JavaScript
15
star
14

jest-styled-components-matcher

Jest matcher for styled components (React Native)
JavaScript
14
star
15

metro-bundler-ui

5
star
16

fflux-isomorphic-example

Example of usage fflux for creating isomorphic apps
JavaScript
3
star
17

schemify

TypeScript compiler for React Native CodeGen project
TypeScript
3
star
18

kureev.com

JavaScript
2
star
19

veloria

Veloria is a SQLite-based ORM that aims to bring prisma-like experience for React Native
TypeScript
2
star
20

go-rfcomm-server

Draft implementation of the server that accepts Bluetooth connections using RFCOMM protocol
Go
1
star
21

hello-github-actions

Dockerfile
1
star
22

github-actions-for-ci

JavaScript
1
star