Xamarin之webview控件_xamarin webview-程序员宅基地

在Xamarin中有一些Forms原生不太好实现的内容可以考虑使用HTML、Javascript、CSS那一套前端技术来实现,使用WebView来承载显示本地或网络上的HTML文件。不像OpenUri方法,不是将用户带到设备中的本地浏览器里去,而是用WebView直接在App内部显示HTML内容。

该文档由下面几节内容组成:

Content

WebView支持下列几种内容:

  • HTML和CSS网站——WebView全方位支持HTML和CSS布局的网站,也包括对JavaScript的支持。
  • 文档(Documents)——因为WebView使用的是平台本地组件,所以WebView可以显示平台所支持的那些文档类型。这意味着,PDF文件可以直接在iOS和Android平台上显示,但是Windows Phone平台不能。
  • HTML字符串——WebView可以显示内存中的HTML字符串。
  • 本地文件——WebView可以显示嵌入在App中的任何内容。

注意: Windows和Windows Phone平台上的WebView并不支持Silverlight,Flash和任何的ActiveX控件,即使该平台上的Internet Explorer浏览器都支持。

网站(Websites)

要显示因特网上的一个网站,可以给WebViewSource属性设置一个URL字符串:

var browser = new WebView {
    Source = "http://xamarin.com"
};

注意: URLs地址必须是指定协议的完整格式(如:前面必须有" http:// "或" http:// ")

iOS和ATS

自iOS 9以后,默认情况下仅允许应用程序和实现了最佳安全实践的服务通信,如果想和不安全的服务进行通信必须要修改Info.plist的设置。

注意: 如果你的应用程序需要链接一个不安全的服务,你应该使用NSExceptionDomains设置一些域名做为例外,而不是使用NSAllowsArbitraryLoads完全关闭ATSNSAllowsArbitraryLoads只应该用在某些极端紧急情况下。

下面这个例子展示了如何设置一些特殊域名(此处用xamarim.com举例)绕开ATS的检验:

<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSExceptionDomains</key>
        <dict>
            <key>xamarin.com</key>
            <dict>
                <key>NSIncludesSubdomains</key>
                <true/>
                <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
                <true/>
                <key>NSTemporaryExceptionMinimumTLSVersion</key>
                <string>TLSv1.1</string>
            </dict>
        </dict>
    </dict>

良好的实践是只让一部分域名绕开ATS的检验,允许你访问受信任的网站同时也能更安全的访问不受信任的域名。下面的例子展示了App当中最不安全的一种做法,完全禁用ATS

<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads </key>
        <true/>
    </dict>

查看App Transport Security获取关于iOS 9这个新功能的更多信息。

HTML字符串

如果你想展示一串被代码动态定义的HTML字符串,你需要创建一个HtmlWebViewSource的实例:

var browser = new WebView();
var htmlSource = new HtmlWebViewSource();
htmlSource.Html = @"<html><body>
  <h1>Xamarin.Forms</h1>
  <p>Welcome to WebView.</p>
  </body></html>";
browser.Source = htmlSource;

上面的代码中,@符号用于标记HTML作为一串字面量的字符串,所有通用转义符都会被忽略。

本地HTML文件

WebView可以直接展示嵌入在App中的HTML,CSS和Javascript,例如:

<html>
  <head>
    <title>Xamarin Forms</title>
  </head>
  <body>
    <h1>Xamrin.Forms</h1>
    <p>This is an iOS web page.</p>
    <img src="XamarinLogo.png" />
  </body>
</html>

CSS:

html,body {
      
  margin:0;
  padding:10;
}
body,p,h1 {
      
  font-family: Chalkduster;
}

注意上面的CSS中指定的特殊字体需要根据不同的平台自定义,不是所有的平台都具有相同的字体。

注意: Xamarin.Forms中当前存在一个bug,在Windows中本地HTML内容不能被显示,但是它不会影响Windows Phone。查看Bugzilla获取关于这个bug最新状态的更多信息。

使用WebView显示本地内容,你需要像打开其他文件一样打开一个HTML文件,然后读取内容文本到HtmlWebViewSourceHtml属性上。关于打开文件的更多信息,可以查看Working with Files

虽然我们读取了第一个页面,但是WebView并不知道HTML来自于哪里。这样在处理页面引用本地资源时就会有问题。例如,一个本地文件很可能有一个指向另一个文件的链接,也有可能使用一个分离的JavaScript文件,或者一个CSS样式文件。

为了解决这个问题,你需要告诉WebView到文件系统的哪里去寻找文件。此时需要设置WebView所引用的HtmlWebViewSource对象的BaseUrl属性。

因为文件系统在每个操作系统上是不一样的,所以你需要针对每个平台确定它的URL。Xamarin.Forms可以通过DependencyService解决运行时的平台依赖。

要使用DependencyService,需要先定义一个可被各平台所实现的接口:

public interface IBaseUrl { string Get(); }

注意,该接口需要被各个平台实现,否则App会无法运行。在公共项目中,要确保你记得使用DependencyService设置BaseUrl的值:

var source = new HtmlWebViewSource();
source.BaseUrl = DependencyService.Get<IBaseUrl>().Get();

至此,你只需要在各个平台中实现这个接口就可以了:

iOS
[assembly: Dependency(typeof(BaseUrl_iOS))]
namespace WorkingWithWebview.iOS
{
    public class BaseUrl_iOS : IBaseUrl
    {
        public string Get()
        {
            return NSBundle.MainBundle.BundlePath;
        }
    }
}

此时网站的位置会被定位到项目的根目录或者Resources目录,并且文件的生成操作应该修改为BundleResource,如下图:

Android

在Android平台下,HTML,CSS和图片文件应该位于Assets文件夹下,并且生成操作应该修改为AndroidAsset,如下图:

Android平台下,BaseUrl的值应该设置为"file:///android_asset/"

[assembly: Dependency(typeof(BaseUrl_Android))]
namespace WorkingWithWebview.Android
{
    public class BaseUrl_Android : IBaseUrl
    {
        public string Get()
        {
            return "file:///android_asset/";
        }
    }
}

Android平台下,Assets文件夹下的文件也可以通过Forms.Context.Assets属性访问,代码如下:

var assetManager = Xamarin.Forms.Forms.Context.Assets;
using (var streamReader = new StreamReader(assetManager.Open("local.html")))
{
    var html = streamReader.ReadToEnd();
}
Windows Phone

注意: 在Windows Phone 8.1下WebView不支持本地内容,但是在Windows Phone 8下支持。

在Windows Phone平台下,HTML,CSS和图片文件位于项目根目录,并且生成操作应该修改为Content,如下图:

Windows Phone平台下,BaseUrl的值应该设置为""

[assembly: Dependency(typeof(BaseUrl_Windows))]
namespace WorkingWithWebview.Windows
{
    public class BaseUrl_Windows : IBaseUrl
    {
        public string Get()
        {
            return "";
        }
    }
}

WebView可以通过几个方法和属性来进行导航:

  • GoForward()——如果CanGoForward等于true,调用GoForward导航到下一个访问页面。
  • GoBack()——如果CanGoBack等于true,调用GoBack将会导航到最后一个访问过的页面。
  • CanGoBack——如果有页面可以返回则该值等于true,如果浏览的是起始URL则该值返回false
  • CanGoForward——如果用户返回了某个页面并且可以向前访问某个已经访问过的页面则该值为true

在页面内部,WebView不支持多点触控。所以重点是需要针对移动端优化内容,使其呈现时不需要额外的缩放等操作。

对于应用程序来说,在WebView中展示链接比在设备的浏览器中展示更常见。在这种情况下,允许正常的导航非常有用,但是当用户在起始页面点击返回按钮时,程序会返回到一个正常的App页面中。

下面演示如何使用内建的方法和属性启用这种场景。

首先在一个page页面中创建一个浏览器视图:

<?xml version="1.0" encoding="UTF-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
x:Class="WebViewDemo.InAppDemo"
Title="In App Browser">
    <ContentPage.Content>
        <StackLayout>
            <StackLayout Orientation="Horizontal" Padding="10,10">
                <Button Text="Back" HorizontalOptions="StartAndExpand" Clicked="backClicked" />
                <Button Text="Forward" HorizontalOptions="End" Clicked="forwardClicked" />
            </StackLayout>
            <WebView x:Name="Browser" WidthRequest="1000" HeightRequest="1000" />
        </StackLayout>
    </ContentPage.Content>
</ContentPage>

后台代码:

public partial class InAppDemo : ContentPage
{
    //sets the URL for the browser in the page at creation
    public InAppDemo(string URL)
    {
        InitializeComponent();
        Browser.Source = URL;
    }

    private void backClicked(object sender, EventArgs e)
    {
        //check to see if there is anywhere to go back to
        if (Browser.CanGoBack)
        {
            Browser.GoBack();
        }
        else { //if not, leave the view
            Navigation.PopAsync();
        }
    }

    private void forwardClicked(object sender, EventArgs e)
    {
        if (Browser.CanGoForward)
        {
            Browser.GoForward();
        }
    }
}

最后呈现效果如下:

Events

WebView通过触发两个事件来帮助你响应状态变更:

  • Navigating——当WebView开始加载一个新页面时触发。
  • Navigated——当一个页面加载完毕并且导航停止时触发。

如果你能预感到加载网页将会耗费比较长的时间,可以考虑使用这两个事件实现一个状态指示器。代码如下:

界面XAML代码:

<?xml version="1.0" encoding="UTF-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
x:Class="WebViewDemo.LoadingDemo" Title="Loading Demo">
    <ContentPage.Content>
    <StackLayout>
      <Label x:Name="LoadingLabel"
        Text="Loading..."
        HorizontalOptions="Center"
        isVisible="false" />
      <WebView x:Name="Browser"
      HeightRequest="1000"
      WidthRequest="1000"
      Navigating="webOnNavigating"
      Navigated="webOnEndNavigating" />
    </StackLayout>
    </ContentPage.Content>
</ContentPage>

后台两个事件处理:

void webOnNavigating (object sender, WebNavigatingEventArgs e)
{
    LoadingLabel.IsVisible = true;
}

void webOnEndNavigating (object sender, WebNavigatedEventArgs e)
{
    LoadingLabel.IsVisible = false;
}

当页面加载中时输出结果如下:

当页面加载完成时输出如下:

Performance

最近的各大web浏览器都已经采用了一些被世人所熟知的流行技术,如硬件加速渲染和JavaScript编译。不幸的是,出于安全限制,大多数高级功能在iOS的WebViewUIWebView里无法使用。Xamarin.Forms里的WebView在iOS平台下实际上是使用的UIWebView。如果这个限制对你的使用造成了困扰,你需要在平台内部使用支持快速浏览等功能的WKWebView进行重新渲染。但是需要注意WKWebView仅支持iOS 8以上的系统。

WebView在Android的默认设置中跟内建浏览器一样快。

在Windows Phone 8和Windows Phone 8.1里的WebBrowser控件不支持最新的HTML5相关新特性,并且它常常出现性能问题。需要注意测试网站在Windows Phone的WebView中究竟会怎样呈现,如果仅在IE浏览器中测试是不够的。

Permissions

为了让WebView正常工作,你必须知道各个平台的权限设置。注意在一些平台,WebView在debug模式下可以工作,但是在最后发布时的release模式下却不能。这就是权限造成的问题,比如Android上的internet访问权限,在Xamarin Studio的调试模式下默认是打开的。

  • Windows Phone 8.0——需要ID_CAP_WEBBROWSERCOMPONENT权限来使用控件,需要ID_CAP_NETWORKING来访问因特网。
  • Windows Phone 8.1——需要Internet才能访问网络内容。
  • Android——需要Internet才能访问网络内容,访问本地内容不需要特殊的权限。
  • iOS——不需要特殊的权限。

Layout

不像大多数其他Xamarin.Forms视图,在StackLayoutRelativeLayout中嵌套WebView时必须指明它的HeightRequestWidthRequest属性。如果你没有指明这些属性,那么WebView将不会渲染。

下面的例子展示了WebView的渲染布局代码:

StackLayout中指明HeightRequestWidthRequest

<StackLayout>
    <Label Text="test" />
    <WebView Source="http://www.xamarin.com/"
        HeightRequest="1000"
        WidthRequest="1000" />
</StackLayout>

RelativeLayout中指明HeightRequestWidthRequest

<RelativeLayout>
    <Label Text="test"
        RelativeLayout.XConstraint= "{
      ConstraintExpression
                                      Type=Constant, Constant=10}"
        RelativeLayout.YConstraint= "{
      ConstraintExpression
                                      Type=Constant, Constant=20}" />
    <WebView Source="http://www.xamarin.com/"
        RelativeLayout.XConstraint="{ConstraintExpression Type=Constant,
                                     Constant=10}"
        RelativeLayout.YConstraint="{ConstraintExpression Type=Constant,
                                     Constant=50}"
        WidthRequest="1000" HeightRequest="1000" />
</RelativeLayout>

AbsoluteLayout中不用指明HeightRequestWidthRequest

<AbsoluteLayout>
    <Label Text="test" AbsoluteLayout.LayoutBounds="0,0,100,100" />
    <WebView Source="http://www.xamarin.com/"
      AbsoluteLayout.LayoutBounds="0,150,500,500" />
</AbsoluteLayout>

Grid中不用指明HeightRequestWidthRequestGrid是少数的几个不用指明宽和高的布局容器:

<Grid>
    <Grid.RowDefinitions>
        <RowDefinition Height="100" />
        <RowDefinition Height="*" />
    </Grid.RowDefinitions>
    <Label Text="test" Grid.Row="0" />
    <WebView Source="http://www.xamarin.com/" Grid.Row="1" />
</Grid>

原文链接:
https://developer.xamarin.com/guides/xamarin-forms/user-interface/webview/
相关Demo:
Working with WebView:WebView的简单演示
WebView:WebView的简单演示
HybridWebView:WebView的高级演示,包括平台自定义渲染WebView和JavaScript和C#代码交互。

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://blog.csdn.net/golduty2/article/details/80991700

智能推荐

攻防世界_难度8_happy_puzzle_攻防世界困难模式攻略图文-程序员宅基地

文章浏览阅读645次。这个肯定是末尾的IDAT了,因为IDAT必须要满了才会开始一下个IDAT,这个明显就是末尾的IDAT了。,对应下面的create_head()代码。,对应下面的create_tail()代码。不要考虑爆破,我已经试了一下,太多情况了。题目来源:UNCTF。_攻防世界困难模式攻略图文

达梦数据库的导出(备份)、导入_达梦数据库导入导出-程序员宅基地

文章浏览阅读2.9k次,点赞3次,收藏10次。偶尔会用到,记录、分享。1. 数据库导出1.1 切换到dmdba用户su - dmdba1.2 进入达梦数据库安装路径的bin目录,执行导库操作  导出语句:./dexp cwy_init/[email protected]:5236 file=cwy_init.dmp log=cwy_init_exp.log 注释:   cwy_init/init_123..._达梦数据库导入导出

js引入kindeditor富文本编辑器的使用_kindeditor.js-程序员宅基地

文章浏览阅读1.9k次。1. 在官网上下载KindEditor文件,可以删掉不需要要到的jsp,asp,asp.net和php文件夹。接着把文件夹放到项目文件目录下。2. 修改html文件,在页面引入js文件:<script type="text/javascript" src="./kindeditor/kindeditor-all.js"></script><script type="text/javascript" src="./kindeditor/lang/zh-CN.js"_kindeditor.js

STM32学习过程记录11——基于STM32G431CBU6硬件SPI+DMA的高效WS2812B控制方法-程序员宅基地

文章浏览阅读2.3k次,点赞6次,收藏14次。SPI的详情简介不必赘述。假设我们通过SPI发送0xAA,我们的数据线就会变为10101010,通过修改不同的内容,即可修改SPI中0和1的持续时间。比如0xF0即为前半周期为高电平,后半周期为低电平的状态。在SPI的通信模式中,CPHA配置会影响该实验,下图展示了不同采样位置的SPI时序图[1]。CPOL = 0,CPHA = 1:CLK空闲状态 = 低电平,数据在下降沿采样,并在上升沿移出CPOL = 0,CPHA = 0:CLK空闲状态 = 低电平,数据在上升沿采样,并在下降沿移出。_stm32g431cbu6

计算机网络-数据链路层_接收方收到链路层数据后,使用crc检验后,余数为0,说明链路层的传输时可靠传输-程序员宅基地

文章浏览阅读1.2k次,点赞2次,收藏8次。数据链路层习题自测问题1.数据链路(即逻辑链路)与链路(即物理链路)有何区别?“电路接通了”与”数据链路接通了”的区别何在?2.数据链路层中的链路控制包括哪些功能?试讨论数据链路层做成可靠的链路层有哪些优点和缺点。3.网络适配器的作用是什么?网络适配器工作在哪一层?4.数据链路层的三个基本问题(帧定界、透明传输和差错检测)为什么都必须加以解决?5.如果在数据链路层不进行帧定界,会发生什么问题?6.PPP协议的主要特点是什么?为什么PPP不使用帧的编号?PPP适用于什么情况?为什么PPP协议不_接收方收到链路层数据后,使用crc检验后,余数为0,说明链路层的传输时可靠传输

软件测试工程师移民加拿大_无证移民,未受过软件工程师的教育(第1部分)-程序员宅基地

文章浏览阅读587次。软件测试工程师移民加拿大 无证移民,未受过软件工程师的教育(第1部分) (Undocumented Immigrant With No Education to Software Engineer(Part 1))Before I start, I want you to please bear with me on the way I write, I have very little gen...

随便推点

Thinkpad X250 secure boot failed 启动失败问题解决_安装完系统提示secureboot failure-程序员宅基地

文章浏览阅读304次。Thinkpad X250笔记本电脑,装的是FreeBSD,进入BIOS修改虚拟化配置(其后可能是误设置了安全开机),保存退出后系统无法启动,显示:secure boot failed ,把自己惊出一身冷汗,因为这台笔记本刚好还没开始做备份.....根据错误提示,到bios里面去找相关配置,在Security里面找到了Secure Boot选项,发现果然被设置为Enabled,将其修改为Disabled ,再开机,终于正常启动了。_安装完系统提示secureboot failure

C++如何做字符串分割(5种方法)_c++ 字符串分割-程序员宅基地

文章浏览阅读10w+次,点赞93次,收藏352次。1、用strtok函数进行字符串分割原型: char *strtok(char *str, const char *delim);功能:分解字符串为一组字符串。参数说明:str为要分解的字符串,delim为分隔符字符串。返回值:从str开头开始的一个个被分割的串。当没有被分割的串时则返回NULL。其它:strtok函数线程不安全,可以使用strtok_r替代。示例://借助strtok实现split#include <string.h>#include <stdio.h&_c++ 字符串分割

2013第四届蓝桥杯 C/C++本科A组 真题答案解析_2013年第四届c a组蓝桥杯省赛真题解答-程序员宅基地

文章浏览阅读2.3k次。1 .高斯日记 大数学家高斯有个好习惯:无论如何都要记日记。他的日记有个与众不同的地方,他从不注明年月日,而是用一个整数代替,比如:4210后来人们知道,那个整数就是日期,它表示那一天是高斯出生后的第几天。这或许也是个好习惯,它时时刻刻提醒着主人:日子又过去一天,还有多少时光可以用于浪费呢?高斯出生于:1777年4月30日。在高斯发现的一个重要定理的日记_2013年第四届c a组蓝桥杯省赛真题解答

基于供需算法优化的核极限学习机(KELM)分类算法-程序员宅基地

文章浏览阅读851次,点赞17次,收藏22次。摘要:本文利用供需算法对核极限学习机(KELM)进行优化,并用于分类。

metasploitable2渗透测试_metasploitable2怎么进入-程序员宅基地

文章浏览阅读1.1k次。一、系统弱密码登录1、在kali上执行命令行telnet 192.168.26.1292、Login和password都输入msfadmin3、登录成功,进入系统4、测试如下:二、MySQL弱密码登录:1、在kali上执行mysql –h 192.168.26.129 –u root2、登录成功,进入MySQL系统3、测试效果:三、PostgreSQL弱密码登录1、在Kali上执行psql -h 192.168.26.129 –U post..._metasploitable2怎么进入

Python学习之路:从入门到精通的指南_python人工智能开发从入门到精通pdf-程序员宅基地

文章浏览阅读257次。本文将为初学者提供Python学习的详细指南,从Python的历史、基础语法和数据类型到面向对象编程、模块和库的使用。通过本文,您将能够掌握Python编程的核心概念,为今后的编程学习和实践打下坚实基础。_python人工智能开发从入门到精通pdf