# @react-native-masked-view/masked-view

> React Native MaskedView component

Latest version **0.3.2** (published 2024-11-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install @react-native-masked-view/masked-view
pnpm add @react-native-masked-view/masked-view
yarn add @react-native-masked-view/masked-view
bun add @react-native-masked-view/masked-view
```

## Health

**Score 40/100 (D)** — status: stable.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support; pre 1.0.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 0.3.2 |
| Published | 2024-11-04 |
| First published | 2020-11-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 57.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1167 |
| Author | Mike Nedosekin |
| Maintainers | naturalclar, mike.nedosekin |
| Keywords | react-native, react native, masked-view, masked view |

## Links

- npm: https://www.npmjs.com/package/@react-native-masked-view/masked-view
- Repository: https://github.com/react-native-masked-view/masked-view
- Homepage: https://github.com/react-native-masked-view/masked-view#readme
- Issues: https://github.com/react-native-masked-view/masked-view/issues
- npm.io page: https://npm.io/package/@react-native-masked-view/masked-view

## Recent versions

- 0.3.2 (latest) — 2024-11-04
- 0.3.1 — 2023-12-11
- 0.3.0 — 2023-10-06
- 0.2.9 — 2023-03-31
- 0.2.8 — 2022-09-30
- 0.2.7 — 2022-07-14
- 0.2.6 — 2021-07-14
- 0.2.5 — 2021-06-29
- 0.2.4 — 2021-04-23
- 0.2.3 — 2021-03-17
- 0.2.2 — 2021-02-20
- 0.2.1 — 2021-02-05
- 0.2.0 — 2020-11-12

## README

# React Native `MaskedView`

[![Build Status][build-badge]][build]
[![Version][version-badge]][package]
[![MIT License][license-badge]][license]
[![Lean Core Badge][lean-core-badge]][lean-core-issue]

Provides a React component that renders a masked view.

## Platforms Supported

- [x] iOS
- [x] Android
- [ ] Web

## Getting Started

```sh
yarn add @react-native-masked-view/masked-view
```

or

```sh
npm install --save @react-native-masked-view/masked-view
```

### Using React Native >= 0.60

Linking the package manually is not required anymore with [Autolinking](https://github.com/react-native-masked-view/cli/blob/master/docs/autolinking.md).

Remember to install the pod with:

```sh
npx pod-install
```

### Using React Native < 0.60

You then need to link the native parts of the library for the platforms you are using. The easiest way to link the library is using the CLI tool by running this command from the root of your project:

```sh
react-native link @react-native-masked-view/masked-view
```

## Usage

Import the `MaskedView` component from `@react-native-masked-view/masked-view` and use it like so:

```jsx
import React from 'react';
import { Text, View } from 'react-native';
import MaskedView from '@react-native-masked-view/masked-view';

const App = () => {
  return (
    <MaskedView
      style={{ flex: 1, flexDirection: 'row', height: '100%' }}
      maskElement={
        <View
          style={{
            // Transparent background because mask is based off alpha channel.
            backgroundColor: 'transparent',
            flex: 1,
            justifyContent: 'center',
            alignItems: 'center',
          }}
        >
          <Text
            style={{
              fontSize: 60,
              color: 'black',
              fontWeight: 'bold',
            }}
          >
            Basic Mask
          </Text>
        </View>
      }
    >
      {/* Shows behind the mask, you can put anything here, such as an image */}
      <View style={{ flex: 1, height: '100%', backgroundColor: '#324376' }} />
      <View style={{ flex: 1, height: '100%', backgroundColor: '#F5DD90' }} />
      <View style={{ flex: 1, height: '100%', backgroundColor: '#F76C5E' }} />
      <View style={{ flex: 1, height: '100%', backgroundColor: '#e1e1e1' }} />
    </MaskedView>
  );
}

export default App
```

The following image demonstrates that you can put almost anything behind the mask. The three examples shown are masked `<View>`, `<Text>`, and `<Image>`.

<div align="center"><img src="img/example.png" width="200"></img></div>

### Props

- [View props...](https://github.com/facebook/react-native-website/blob/master/docs/view.md#props)

- [`maskElement`](#maskelement)

- [`androidRenderingMode`](#androidrenderingmode)

### Reference

### `maskElement`

| Type    | Required |
| ------- | -------- |
| element | Yes      |

### `androidRenderingMode`

By default `hardware` rendering mode will be used for best performance, however if you need to animate your `maskElement` then you’ll need to switch to `software` to get your mask to update. This prop only affects Android.

| Type                   | Required | Default    |
| ---------------------- | -------- | ---------- |
| `software`, `hardware` | No       | `hardware` |

<!-- badges -->

[build-badge]: https://github.com/react-native-masked-view/masked-view/workflows/Build/badge.svg
[build]: https://github.com/react-native-masked-view/masked-view/actions
[version-badge]: https://img.shields.io/npm/v/@react-native-masked-view/masked-view.svg?style=flat-square
[package]: https://www.npmjs.com/package/@react-native-masked-view/masked-view
[license-badge]: https://img.shields.io/npm/l/@react-native-masked-view/masked-view.svg?style=flat-square
[license]: https://opensource.org/licenses/MIT
[lean-core-badge]: https://img.shields.io/badge/Lean%20Core-Extracted-brightgreen.svg?style=flat-square
[lean-core-issue]: https://github.com/facebook/react-native/issues/23313

---
_Source: https://npm.io/package/@react-native-masked-view/masked-view · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._