react-native-masked-view

A <MaskedView> element for react-native

Usage no npm install needed!

<script type="module">
  import reactNativeMaskedView from 'https://cdn.skypack.dev/react-native-masked-view';
</script>

README

react-native-masked-view

Masked View Component for React. Just like a <View /> with a mask.

<MaskedView maskImage="mask.png">...</MaskedView>

screen shot

compatibility

The latest version is compatible with react-native@0.7.1

installation

  • npm install react-native-masked-view
  • var MaskedView = require('react-native-masked-view');

... then have a look at these instructions and adjust accordingly.

options

note: since react@0.6.0-rc the MaskedView element cannot have it's own backgroundColor, but it's children can.

demo

Just clone this repo, cd into react-native-masked-view and npm install. Then open MaskedViewDemo.xcodeproj and click run.

todo

  • add more sizing options
  • add various mask sources: shape, svg, other layers
  • replace maskImage prop with maskSource prop that works just like <Image />'s source prop. (the internal react-native image-related code really should be refactored so it's more easily re-usable outside of <Image />)