ReactNative进阶（十）：网页组件（WebView）的使用详解

文章目录

• • 一、WebView 组件介绍
  • 二、WebView 组件使用样例
  • • 2.1 通过url地址加载网页
    • 2.2 加载html代码
    • 2.3 RN和Html通信
    • 2.4 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：当网页加载结束调用，不管是成功还是失败。
• renderLoading：WebView组件正在渲染页面时触发的函数，只有 startInLoadingState 为 - true 时该函数才起作用。
• renderError：监听渲染页面出错的函数。
• onShouldStartLoadWithRequest（仅iOS）：该方法允许拦截 WebView 加载的 URL 地址，进行自定义处理。该方法通过返回 true 或者 false 来决定是否继续加载该拦截到请求。
• onMessage：在webView内部网页中，调用window.postMessage可以触发此属性对应的函数，通过event.nativeEvent.data获取接收到的数据，实现网页和RN之间的数据传递。
• injectJavaScript：函数接受一个字符串，该字符串将传递给WebView，并立即执行为JavaScript。

二、WebView 组件使用样例

2.1 通过url地址加载网页

import React, {Component} from 'react';
import {
    AppRegistry,
    StyleSheet,
    Dimensions,
    Text,
    View,
    WebView
} from 'react-native';
 
//获取设备的宽度和高度
var {
    height: deviceHeight,
    width: deviceWidth
} = Dimensions.get('window');
 
//默认应用的容器组件
class App extends Component {
    //渲染
    render() {
        return (
            <View style={styles.container}>
              <WebView bounces={false}
                scalesPageToFit={true}
                source={{uri:"https://shq5785.blog.csdn.net/",method: 'GET'}}
                style={{width:deviceWidth, height:deviceHeight}}>
              </WebView>
            </View>
        );
    }
}
 
//样式定义
const styles = StyleSheet.create({
    container: {
        flex: 1,
        paddingTop:20
    }
});
 
AppRegistry.registerComponent('HelloWorld', () => App);

2.2 加载html代码

import React, {Component} from 'react';
import {
    AppRegistry,
    StyleSheet,
    Dimensions,
    Text,
    View,
    WebView
} from 'react-native';
 
//获取设备的宽度和高度
var {
    height: deviceHeight,
    width: deviceWidth
} = Dimensions.get('window');
 
//默认应用的容器组件
class App extends Component {
    //渲染
    render() {
        return (
            <View style={styles.container}>
              <WebView bounces={false}
                scalesPageToFit={true}
                source={{html:"<h1 style='color:#ff0000'>欢迎访问 https://shq5785.blog.csdn.net/</h1>"}}
                style={{width:deviceWidth, height:deviceHeight}}>
              </WebView>
            </View>
        );
    }
}
 
//样式定义
const styles = StyleSheet.create({
    container: {
        flex: 1,
        paddingTop:20
    }
});
 
AppRegistry.registerComponent('HelloWorld', () => App);

2.3 RN和Html通信

当WebView加载html时，可实现html和rn之间的通信。rn向html发送数据可以通过postMessage函数实现。如下：

RN中：

 <WebView
    useWebKit={false}
    onLoad={() => {
      let data = {
        name: userInfo.usrName
      };
      this.webView.postMessage(JSON.stringify(data));
    }}
    onError={(event) => {
      console.log(`==webViewError:${JSON.stringify(event.nativeEvent)}`);
    }}
    onMessage={(event) => {
      this._onH5Message(event);
    }}
    automaticallyAdjustContentInsets={false}
    contentInset={{ top: 0, left: 0, bottom: -1, right: 0 }}
    onScroll={(event) => this._onScroll(event)}
    style={styles.webview}
    source={this.html ? { html: this.html } : { uri: this.url }}
    bounces={false}
    showsHorizontalScrollIndicator={false}
    showsVerticalScrollIndicator={false}
  />

html中：

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

在html中定义一个按钮，并添加事件向rn发送数据：

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

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

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

2.4 JavaScript 脚本注入

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

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

• WebView 官方文档