React-native之WebView(14)

一. 简介

在原生开发中加载网页时经常用到WebView ,RN也给我们提供了WebView控件,可以用于访问一个网页。

二. 属性
  • automaticallyAdjustContentInsets
    是否自动调整内部内容
  • allowsInlineMediaPlayback bool (ios)
    指定HTML5视频是在网页当前位置播放还是使用原生的全屏播放器播放。 默认值为false。
    注意 : 要让视频在网页中播放,不光要将这个属性设为true,HTML中的视频元素本身也需要包含webkit-playsinline属性。
  • bounces bool (ios)
  • contentInset {top: number, left: number, bottom: number, right: number}
    内部内容偏移值 该值为一个JavaScript对象
  • dataDetectorTypes enum('phoneNumber', 'link', 'address', 'calendarEvent', 'none', 'all'), [object Object]
    探测网页中某些特殊数据类型,自动生成可点击的链接,默认情况下仅允许探测电话号码。
    你可以指定探测下述类型中的一种,或者使用数组来指定多个类型。
    dataDetectorTypes的可选值:
    'phoneNumber'
    'link'
    'address'
    'calendarEvent'
    'none'
    'all'
  • domStorageEnabled bool (android)
    指定是否开启DOM本地存储。
  • injectedJavaScript string
    注入的js代码,其值为字符串,如果加上了该属性,就会在webview里面执行js代码(在网页加载之前注入)
  • mediaPlaybackRequiresUserAction bool
    设置页面中的HTML5音视频是否需要在用户点击后再开始播放。默认值为true.
  • source:{{uri:'网址'}}
    在WebView中载入一段静态的html代码或是一个url(还可以附带一些header选项){{html:'html代码块'}}
  • onError function
    加载失败时调用。
  • onLoad function
    加载成功时调用。
  • onLoadEnd function
    加载结束时(无论成功或失败)调用。
  • onLoadStart function
    加载开始时调用。
  • onMessage function
    在webview内部的网页中调用window.postMessage方法时可以触发此属性对应的函数,从而实现网页和RN之间的数据交换。 设置此属性的同时会在webview中注入一个postMessage的全局函数并覆盖可能已经存在的同名实现。
    网页端的window.postMessage只发送一个参数data,此参数封装在RN端的event对象中,即event.nativeEvent.data。data 只能是一个字符串。
  • javaScriptEnabled bool (android)
    iOS平台JavaScript是默认开启的。
  • onNavigationStateChange function
    监听导航状态变化的函数(当发现浏览器地址改变时,触发事件)
  • onShouldStartLoadWithRequest function (ios)
    允许为webview发起的请求运行一个自定义的处理函数。返回true或false表示是否要继续执行响应的请求。
  • renderError function
    设置一个函数,返回一个视图用于显示错误。
  • startInLoadingState
    是否开启页面加载的状态
  • renderLoading function
    webview组件正在渲染页面时触发的函数,需要同startInLoadingState一起使用,当startInLoadingState为true时该函数才起作用
  • scalesPageToFit bool
    设置是否要把网页缩放到适应视图的大小,以及是否允许用户改变缩放比例。
  • scrollEnabled bool (ios)
    表示webview里面页面是否能滚动,如果其值为true则可以滚动,否则禁止滚动
  • userAgent string (android)
    为WebView设置user-agent字符串标识。这一字符串也可以在原生端用WebViewConfig来设置,但js端的设置会覆盖原生端的设置。
三. 示例

const screenWidth =Dimensions.get('window').width; const screenHeight =Dimensions.get('window').height;

render(){ return (

); }

效果

React-native之WebView(14)_第1张图片
webview_01.png

你可能感兴趣的:(React-native之WebView(14))