React Native WebView - a Modern, Cross-Platform WebView for React Native

![Lean Core Extracted][lean-core-issue]

React Native WebView is a modern, well-supported, and cross-platform WebView for React Native. It is intended to be a replacement for the built-in WebView (which will be removed from core).

Core Maintainers - Sponsoring companies

_This project is maintained for free by these people using both their free time and their company work time._

- Thibault Malbranche (Twitter @titozzz) from Brigad
- Jamon Holmgren (Twitter @jamonholmgren) from Infinite Red

Platforms Supported

- [x] iOS
- [x] Android
- [x] macOS
- [x] Windows

_Note: Expo support for React Native WebView started with Expo SDK v33.0.0._

Getting Started

Read our Getting Started Guide. If any step seems unclear, please create a detailed issue.

Versioning

This project follows semantic versioning. We do not hesitate to release breaking changes but they will be in a major version.

Breaking History:

Current Version: !version

- 11.0.0 - Android setSupportMultipleWindows.
- 10.0.0 - Android Gradle plugin is only required when opening the project stand-alone
- 9.0.0 - props updates to injectedJavaScript are no longer immutable.
- 8.0.0 - onNavigationStateChange now triggers with hash url changes
- 7.0.1 - Removed UIWebView
- 6.0.2 - Update to AndroidX. Make sure to enable it in your project's android/gradle.properties. See Getting Started Guide.
- 5.0.1 - Refactored the old postMessage implementation for communication from webview to native.
- 4.0.0 - Added cache (enabled by default).
- 3.0.0 - WKWebview: Add shared process pool so cookies and localStorage are shared across webviews in iOS (enabled by default).
- 2.0.0 - First release this is a replica of the core webview component

Upcoming:

- this.webView.postMessage() removal (never documented and less flexible than injectJavascript) -> how to migrate
- Kotlin rewrite
- Maybe Swift rewrite

Usage

Import the WebView component from react-native-webview and use it like so:

``jsx
import React, { Component } from 'react';
import { StyleSheet, Text, View } from 'react-native';
import { WebView } from 'react-native-webview';

// ...
class MyWebComponent extends Component {
render() {
return ;
}
}
`

For more, read the API Reference and Guide. If you're interested in contributing, check out the Contributing Guide.

Common issues

- If you're getting Invariant Violation: Native component for "RNCWebView does not exist" it likely means you forgot to run react-native link` or there was some error with the linking process

Contributing

See Contributing.md

Contributors

Thanks goes to these wonderful people (emoji key):

Thibault Malbranche 💻 🤔 👀 📖 🚧 ⚠️ 🚇 💬	Jamon Holmgren 💻 🤔 👀 📖 🚧 ⚠️ 💡 💬	Andrei Pfeiffer 💻 👀 🤔	Michael Diarmid 💻 👀 🤔 🔧	Scott Mathson 💻 📖	Margaret 💻 📖	Jordan Sexton 💻 📖
Malcolm Scruggs 💻 🔧 ⚠️	Momazo7u7 📖	Marco 📖	Julien Eluard 📖	Jian Wei 💻 📖	Sergei Butko 📖	TMomemt 💻
Eric Lewis 💻 📖	Daniel Vicory 💻 📖

This project follows the all-contributors specification. Contributions of any kind welcome!

License

MIT

Translations

This readme is available in:

- Brazilian portuguese

[lean-core-issue]: https://github.com/facebook/react-native/issues/23313