ReactNative进阶(十):WebView 应用详解

谁践踏了优雅 2023-01-17 02:24 610阅读 0赞

文章目录

    • 一、WebView 组件介绍
    • 二、WebView 使用样例
      • 2.1 通过 url 地址加载网页
      • 2.2 加载 html 代码
      • 2.3 RN -> HTML5 通信
      • 2.4 HTML5(Vue) -> RN 通信
      • 2.5 JavaScript 脚本注入
    • 三、拓展阅读

一、WebView 组件介绍

使用 WebView 组件可通过 url 来加载显示一个网页,也可以传入一段 html 代码来显示。下面对其主要属性和方法进行介绍。

1. 主要属性

  • source:在 WebView 中载入一段静态的 html 代码或是一个 url(还可以附带一些 header 选项);
  • automaticallyAdjustContentInsets:设置是否自动调整内容。格式:bool
  • contentInset:设置内容所占的尺寸大小。格式:{top:number,left:number,bottom:number,right:number};
  • injectJavaScript:当网页加载之前注入一段 js 代码。其值是字符串形式。
  • startInLoadingState:是否开启页面加载的状态,其值为 true 或者 false。
  • bounces(仅iOS):回弹特性。默认为 true。如果设置为 false,则内容拉到底部或者头部都不回弹。
  • scalesPageToFit(仅iOS):用于设置网页是否缩放自适应到整个屏幕视图,以及用户是否可以改变缩放页面。
  • scrollEnabled(仅iOS):用于设置是否开启页面滚动。
  • domStorageEnabled(仅Android):用于控制是否开启 DOM Storage(存储)。
  • javaScriptEnabled(仅Android):是否开启 JavaScript,在 iOS 中的 WebView 是默认开启的。

2. 主要方法

  • onNavigationStateChange:当导航状态发生变化的时候调用。
  • onLoadStart:当网页开始加载的时候调用。
  • onError:当网页加载失败的时候调用。
  • onLoad:当网页加载结束的时候调用。
  • onLoadEnd:当网页加载结束调用,不管是成功还是失败。
  • renderLoadingWebView组件正在渲染页面时触发的函数,只有 startInLoadingState 为 - true 时该函数才起作用。
  • renderError:监听渲染页面出错的函数。
  • onShouldStartLoadWithRequest(仅iOS):该方法允许拦截 WebView 加载的 URL 地址,进行自定义处理。该方法通过返回 true 或者 false 来决定是否继续加载该拦截到请求。
  • onMessage:在webView内部网页中,调用window.postMessage可以触发此属性对应的函数,通过event.nativeEvent.data获取接收到的数据,实现网页和RN之间的数据传递。
  • injectJavaScript:函数接受一个字符串,该字符串将传递给WebView,并立即执行为JavaScript

二、WebView 使用样例

2.1 通过 url 地址加载网页

  1. import React, { Component} from 'react';
  2. import {
  3. AppRegistry,
  4. StyleSheet,
  5. Dimensions,
  6. Text,
  7. View,
  8. WebView
  9. } from 'react-native';
  10. //获取设备的宽度和高度
  11. var {
  12. height: deviceHeight,
  13. width: deviceWidth
  14. } = Dimensions.get('window');
  15. //默认应用的容器组件
  16. class App extends Component {
  17. //渲染
  18. render() {
  19. return (
  20. <View style={ styles.container}>
  21. <WebView bounces={ false}
  22. scalesPageToFit={ true}
  23. source={ { uri:"https://shq5785.blog.csdn.net/",method: 'GET'}}
  24. style={ { width:deviceWidth, height:deviceHeight}}>
  25. </WebView>
  26. </View>
  27. );
  28. }
  29. }
  30. //样式定义
  31. const styles = StyleSheet.create({
  32. container: {
  33. flex: 1,
  34. paddingTop:20
  35. }
  36. });
  37. AppRegistry.registerComponent('HelloWorld', () => App);

2.2 加载 html 代码

  1. import React, { Component} from 'react';
  2. import {
  3. AppRegistry,
  4. StyleSheet,
  5. Dimensions,
  6. Text,
  7. View,
  8. WebView
  9. } from 'react-native';
  10. //获取设备的宽度和高度
  11. var {
  12. height: deviceHeight,
  13. width: deviceWidth
  14. } = Dimensions.get('window');
  15. //默认应用的容器组件
  16. class App extends Component {
  17. //渲染
  18. render() {
  19. return (
  20. <View style={ styles.container}>
  21. <WebView bounces={ false}
  22. scalesPageToFit={ true}
  23. source={ { html:"<h1 style='color:#ff0000'>欢迎访问 https://shq5785.blog.csdn.net/</h1>"}}
  24. style={ { width:deviceWidth, height:deviceHeight}}>
  25. </WebView>
  26. </View>
  27. );
  28. }
  29. }
  30. //样式定义
  31. const styles = StyleSheet.create({
  32. container: {
  33. flex: 1,
  34. paddingTop:20
  35. }
  36. });
  37. AppRegistry.registerComponent('HelloWorld', () => App);

2.3 RN -> HTML5 通信

WebView加载html时,可实现htmlrn之间的通信。rnhtml发送数据可以通过postMessage函数实现。如下:

RN

  1. <WebView
  2. ref={ (view) => (this.webView = view)}
  3. useWebKit={ false}
  4. useWebKit={ false}
  5. onLoad={ () => {
  6. let data = {
  7. name: userInfo.usrName
  8. };
  9. this.webView.postMessage(JSON.stringify(data));
  10. }}
  11. onError={ (event) => {
  12. console.log(`==webViewError:${ JSON.stringify(event.nativeEvent)}`);
  13. }}
  14. onMessage={ (event) => {
  15. this._onH5Message(event);
  16. }}
  17. automaticallyAdjustContentInsets={ false}
  18. contentInset={ { top: 0, left: 0, bottom: -1, right: 0 }}
  19. onScroll={ (event) => this._onScroll(event)}
  20. style={ styles.webview}
  21. source={ this.html ? { html: this.html } : { uri: this.url }}
  22. bounces={ false}
  23. showsHorizontalScrollIndicator={ false}
  24. showsVerticalScrollIndicator={ false}
  25. />

html

  1. // 在html中注册事件接收rn发过来的数据并显示在html中
  2. document.addEventListener('message', function listener(RnData) {
  3. messagesReceivedFromReactNative += 1;
  4. document.getElementsByTagName('p')[0].innerHTML =
  5. '从React Native接收的消息: ' + messagesReceivedFromReactNative;
  6. document.getElementsByTagName('p')[1].innerHTML = RnData.data;
  7. // 获取接收后的数据后,及时清除监听器
  8. document.removeEventListener('message', listener)
  9. });

html中定义一个按钮,并添加事件向rn发送数据:

  1. //window.postMessage向rn发送数据
  2. document.getElementsByTagName('button')[0].addEventListener('click', function() {
  3. window.postMessage('这是html发送到RN的消息');
  4. });

html中调用了window.postMessage函数后,WebViewonMessage函数将会被回调,用来处理htmlrn发送的数据,可以通过e.nativeEvent.data获取发送过来的数据。

  1. // 接收HTML发出的数据
  2. _onH5Message = (e) => {
  3. this.setState({
  4. messagesReceivedFromWebView: this.state.messagesReceivedFromWebView + 1,
  5. message: e.nativeEvent.data,
  6. })
  7. Alert.alert(e.nativeEvent.data)
  8. }

2.4 HTML5(Vue) -> RN 通信

HTML5

  1. const message = {
  2. flag: 'previewIamge'
  3. filePath: filePath
  4. }
  5. window.ReactNativeWebView.postMessage(Json.stringify(message))

RN
还是通过WebView提供的onMessage 属性完成回调。

  1. <WebView
  2. ref={ (view) => (this.webView = view)}
  3. useWebKit={ false}
  4. useWebKit={ false}
  5. onLoad={ () => {
  6. let data = {
  7. name: userInfo.usrName
  8. };
  9. this.webView.postMessage(JSON.stringify(data));
  10. }}
  11. onError={ (event) => {
  12. console.log(`==webViewError:${ JSON.stringify(event.nativeEvent)}`);
  13. }}
  14. onMessage={ (event) => {
  15. this._onH5Message(event);
  16. }}
  17. automaticallyAdjustContentInsets={ false}
  18. contentInset={ { top: 0, left: 0, bottom: -1, right: 0 }}
  19. onScroll={ (event) => this._onScroll(event)}
  20. style={ styles.webview}
  21. source={ this.html ? { html: this.html } : { uri: this.url }}
  22. bounces={ false}
  23. showsHorizontalScrollIndicator={ false}
  24. showsVerticalScrollIndicator={ false}
  25. />

回调函数_onH5Message()实现逻辑如下:

  1. // 接收HTML发出的数据
  2. _onH5Message = (e) => {
  3. this.setState({
  4. messagesReceivedFromWebView: this.state.messagesReceivedFromWebView + 1,
  5. message: e.nativeEvent.data,
  6. })
  7. Alert.alert(e.nativeEvent.data)
  8. }

2.5 JavaScript 脚本注入

注:这种方式适用于 react-native-webviewRN本身没有试过)。

android开发中,需要使用 javaScriptEnabled属性来支持JavaScriptios默认是支持的,没有此属性。在WebView中提供了函数injectJavaScript(String),它有一个字符串参数,可以向webview中注入脚本,如下:

  1. //脚本注入
  2. injectJS = () => {
  3. const script = 'document.write("Injected JS ")'; // eslint-disable-line quotes
  4. if (this.webview) {
  5. this.webview.injectJavaScript(script);
  6. }
  7. }

实现思路:通过injectJavaScript 注入JS ,在H5页面加载之后立即执行。相当于webview端主动调用H5的方法。

注意事项:injectJavaScript注入的必须是js。注入内容可以是方法实现,也可以是方法名字。

注意:

  • 注入函数名的时候,实际上注入的仍然是函数实现。
  • 当注入js方法名需要传递参数的时候,可提前将函数名作为字符串,函数参数作为变量,生成一个字符串,然后将此字符串注入。

RN端

首先Webview绑定 ref='webView'

H5调用一个名为 receiveMessage 的函数,并传入一个字符串, 参数true不可少

  1. <WebView
  2. ref={ (view) => (this.webView = view)}
  3. useWebKit={ false}
  4. useWebKit={ false}
  5. onLoadEnd={ () => {
  6. this.endLoad();
  7. }}
  8. ..
  9. />
  10. //加载结束调用,不管是成功还是失败。
  11. endLoad(){
  12. // 在H5调用一个名为 `receiveMessage` 的函数,并传入一个字符串, 参数true不可少
  13. this.refs.webView.injectJavaScript(`receiveMessage("RN向H5发送消息");true;`)
  14. }

H5端(Vue实现)

mounted中往 window 上添加一个方法(注意:不是监听,只是挂载);名为 receiveMessage (必须和RN端保持一致)。

  1. mounted(){
  2. //在window上挂载一个receiveMessage方法,RN会调用
  3. window.receiveMessage = (msg) => {
  4. alert( msg)
  5. }
  6. },

三、拓展阅读

  • WebView 官方文档

发表评论

表情:
评论列表 (有 0 条评论,610人围观)

还没有评论,来说两句吧...

相关阅读