Go to file
allcontributors[bot] e346a85dd2 docs: update .all-contributorsrc 2019-06-19 13:31:42 +00:00
.circleci feat(typescript): Source code rewrite using typescript (#425) 2019-03-20 12:35:13 +00:00
.github chore(docs): Add CODEOWNERS file (#606) 2019-06-02 20:42:56 +02:00
.vscode feat(typescript): Source code rewrite using typescript (#425) 2019-03-20 12:35:13 +00:00
android fix(performance): Improved `onScroll` to work efficiently on Android (#609) 2019-06-02 20:19:39 +02:00
bin Added starter setup script 2018-08-15 21:09:05 -07:00
docs feat(iOS WKWebView): Add mainDocumentURL to onShouldStartLoadWithRequest(#493) 2019-06-13 08:59:52 +02:00
ios feat(iOS WKWebView): Add mainDocumentURL to onShouldStartLoadWithRequest(#493) 2019-06-13 08:59:52 +02:00
src feat(iOS WKWebView): Add mainDocumentURL to onShouldStartLoadWithRequest(#493) 2019-06-13 08:59:52 +02:00
.all-contributorsrc docs: update .all-contributorsrc 2019-06-19 13:31:42 +00:00
.eslintignore feat(android): fix overflow issues and match iOS default renders (#472) 2019-04-02 16:05:56 +02:00
.eslintrc.js feat(typescript): Source code rewrite using typescript (#425) 2019-03-20 12:35:13 +00:00
.flowconfig Add WebView Flow types 2018-09-10 18:46:07 -06:00
.flowconfig.android Add WebView Flow types 2018-09-10 18:46:07 -06:00
.gitignore feat(typescript): Source code rewrite using typescript (#425) 2019-03-20 12:35:13 +00:00
.prettierrc.js feat(typescript): Source code rewrite using typescript (#425) 2019-03-20 12:35:13 +00:00
.releaserc fix(semantic-release): Use git plugin to auto commit 2018-10-18 11:37:43 +02:00
LICENSE WIP: iOS WKWebView 2018-09-08 10:42:02 -07:00
README.md docs: update README.md 2019-06-19 13:31:41 +00:00
babel.config.js feat(android): fix overflow issues and match iOS default renders (#472) 2019-04-02 16:05:56 +02:00
index.d.ts fix(types): export WebViewProps for external use (#457) 2019-03-27 09:25:59 +01:00
index.js feat(typescript): Source code rewrite using typescript (#425) 2019-03-20 12:35:13 +00:00
jest.config.js feat(android): fix overflow issues and match iOS default renders (#472) 2019-04-02 16:05:56 +02:00
package.json chore(release): 6.3.0 [skip ci] 2019-06-13 07:01:25 +00:00
react-native-webview.podspec fix(package.json): Add license to podspec and update package.json version dynamically. (#98) 2018-10-18 11:08:49 +02:00
tsconfig.json feat(typescript): Source code rewrite using typescript (#425) 2019-03-20 12:35:13 +00:00
yarn.lock feat(android): fix overflow issues and match iOS default renders (#472) 2019-04-02 16:05:56 +02:00

README.md

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

star this repo PRs Welcome All Contributors Known Vulnerabilitiesversion

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.

Platforms Supported

  • iOS (both UIWebView and WKWebView)
  • Android

Note: React Native WebView is not currently supported by Expo unless you "eject".

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

yarn add react-native-webview@androidx

yarn add react-native-webview

  • 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:

  • UIWebView removal
  • this.webView.postMessage() removal (never documented and less flexible than injectJavascript)
  • Kotlin rewrite
  • Maybe Swift rewrite

Usage

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

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

// ...
class MyWebComponent extends Component {
  render() {
    return (
      <WebView source={{ uri: 'https://facebook.github.io/react-native/' }} />
    );
  }
}

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 "RNCWKWebView 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
Thibault Malbranche

💻 🤔 👀 📖 🚧 ⚠️ 🚇 💬
Jamon Holmgren
Jamon Holmgren

💻 🤔 👀 📖 🚧 ⚠️ 💡 💬
Andrei Pfeiffer
Andrei Pfeiffer

💻 👀 🤔
Michael Diarmid
Michael Diarmid

💻 👀 🤔 🔧
Scott Mathson
Scott Mathson

💻 📖
Margaret
Margaret

💻 📖
Jordan Sexton
Jordan Sexton

💻 📖
Malcolm Scruggs
Malcolm Scruggs

💻 🔧 ⚠️
Momazo7u7
Momazo7u7

📖
Marco
Marco

📖
Julien Eluard
Julien Eluard

📖
Jian Wei
Jian Wei

💻 📖
Sergei Butko
Sergei Butko

📖
TMomemt
TMomemt

💻
Eric Lewis
Eric Lewis

💻 📖
Daniel Vicory
Daniel Vicory

💻 📖
Femi Veys
Femi Veys

💻

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

License

MIT