react-native-webview.git
Andrei Pfeiffer ff32e34eb5 chore(docs): Add multiple file upload selection in the docs (#382) 5 年之前
.circleci chore(ci and npm): Setup CircleCI and semantic-release 6 年之前
android fix(Android <input />): Support file extensions in file input accept attributes (#357) 5 年之前
bin Added starter setup script 6 年之前
docs chore(docs): Add multiple file upload selection in the docs (#382) 5 年之前
ios fix(WKWebView Scrolling): fixed broken scroll (#372) 5 年之前
js feat(toggle scroll bar): added new props showsVerticalScrollIndicator / showsHorizontalScrollIndicator (#250) 5 年之前
typings fix(types): Add new cacheEnabled prop to typescript prop type declarations (#335) 5 年之前
.all-contributorsrc chore(docs): add jeluard as a contributor (#348) 5 年之前
.flowconfig Add WebView Flow types 6 年之前
.flowconfig.android Add WebView Flow types 6 年之前
.gitignore refactor(Android): New project setup + kotlin events (#121) 6 年之前
.releaserc fix(semantic-release): Use git plugin to auto commit 6 年之前
LICENSE WIP: iOS WKWebView 6 年之前
README.md chore(readme): Add getting started doc link (#370) 5 年之前
babel.config.js fix(webviewShared.js): Support all valid URI schemes and add testing (#293) 5 年之前
index.js Added RNCWebViewManager to xcode proj 6 年之前
jest.config.js fix(webviewShared.js): Support all valid URI schemes and add testing (#293) 5 年之前
package.json fix(vulnerability): merge issue (#399) 5 年之前
react-native-webview.podspec fix(package.json): Add license to podspec and update package.json version dynamically. (#98) 6 年之前
yarn.lock fix(vulnerability): merge issue (#399) 5 年之前

README.md

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

star this repo PRs Welcome All Contributors Known Vulnerabilities

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:

  • 2.0.0 - First release this is a replica of the core webview component
  • 3.0.0 - WKWebview: Add shared process pool so cookies and localStorage are shared across webviews in iOS (enabled by default).
  • 4.0.0 - Added cache (enabled by default).
  • 5.0.1 - Refactored the old postMessage implementation for communication from webview to native.

Upcoming:

  • UIWebView removal
  • this.webView.postMessage() removal (never documented and less flexible than injectJavascript)
  • Typescript rewrite
  • 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
  • There’s a problem on some Android devices where the webview could overlap previous siblings from same parent. To fix this, wrap the WebView in a View with style overflow: hidden.

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

📖

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

License

MIT