博客园客户端UAP开发随笔 -- App连接云端内容的桥梁:WebView

当你辛苦的从网上爬下来一篇文章之后,怎么在你的应用内展示这些包含HTML标记的文章?如果你使用的是Javascript开发应用,恭喜你,直接塞进页面就可以了,同时说明你很熟悉页面开发,而现在windows也支持这种方式。但是对于使用XAML开发的应用怎么办呢?我们还有WebView控件可以用。

越来越多的服务器端API返回的数据使用HTML了,所以我们也不得不对WebView多了解一些。

WebView有个Bug:放在Grid里时,最右侧有一个pixel缝隙时隐时现。要小心,别让PM抓住你的小辫子。另外,在一个App里大量使用WebView要小心内存。在Silverlight中,一个WebBrowser(不叫WebView)要占用大概30M吧,如果把Script disable掉可以省很多。在WinRT中情况就好多了,我开过6个WebView也就150M。

准备工作

WebView控件可以用来展示在线页面,应用内的离线页面,甚至是内存中拼接出来的html字符串也可以。下面我们介绍下这3个方式的使用:

首先在页面上添加一个WebView控件和3个按钮,这里需要注意的是,最好是吧WebView放在Grid中,因为这样WebView默认会填充整个区域,而在StackPanel中则不行。

 

<Page
    x:Class="WebViewTest.MainPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:WebViewTest"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d"
    Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">

    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="1*"></RowDefinition>
            <RowDefinition Height="50"></RowDefinition>
        </Grid.RowDefinitions>

        <WebView x:Name="wv" Margin="10,20"/>

        <StackPanel Grid.Row="1" Orientation="Horizontal">
            <Button x:Name="online" Click="online_Click">在线页面</Button>
            <Button x:Name="offline" Click="offline_Click">应用文件</Button>
            <Button x:Name="memory" Click="memory_Click">内存中</Button>
        </StackPanel>
    </Grid>
</Page>

跑起来之后,我们的页面是下面的丑样子,这是因为我们还没加载内容。。。

技术分享

展示在线页面

    展示在线页面是最基本的需求了,使用这个功能,你就可以做一个自定义的浏览器了。。

    这个功能实现非常简单,我们在online_Click中添加一行代码就可以了。

private void online_Click(object sender, RoutedEventArgs e)
        {
            this.wv.Navigate(new Uri("http://www.microsoft.com"));
        }

如上面的代码,我们只需要调用WebView的Navigate方法,传入网页的地址即可。现在点击在线页面按钮,我们的应用有点浏览器的影子了。。

技术分享

展示应用文件

   通常我们会在应用内使用离线的页面文件来展示内容,比如一个帮助页面,或者用来展示内容的页面框架(这个之后会介绍)。

   这个功能的实现其实使用的方法和在线是一样的,都是调用Navigate,只是在Uri上有区别,因为我们要使用的是应用内的文件,这里我们需要在构造Uri的时候,使用ms-appx-web这个Uri Scheme,更多关于Uri Scheme的内容,请点击这里

private void offline_Click(object sender, RoutedEventArgs e)
        {
            // ms-appx-web 表示我们要读取的是应用内的一个文件,并且是在Web区域,相对路径是Data/help.html, 
            this.wv.Navigate(new Uri("ms-appx-web:///Data/help.html"));
        }

技术分享

展示内存中字符串的内容

private void memory_Click(object sender, RoutedEventArgs e)
        {
            var html = "&lt;h1&gt;我是一个字符串&lt;/h1&gt;";

            this.wv.NavigateToString(html);
        }

技术分享

和dom交互

使用WebView我们可以很方便的展示HTML页面,但是如果我们想要对dom做一些操作的话,还是需要使用javascript,比如调节字体大小,颜色等。这里用到的是InvokeScriptAsync方法,这个方法异步调用页面内指定的javascript方法。

首先为之前的帮助页面添加一个方法changeColor,用来修改h2的字体颜色:

<!DOCTYPE html>

<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8" />
    <title></title>
    <script>

        function changeColor()
        {
            document.getElementsByTagName("h2")[0].style.color = "red";
        }

    </script>
</head>
<body>
    <h2>这是个帮助页面</h2>
    <p>这里是帮助内容</p>
</body>
</html>

然后在主页面上添加一个按钮(方法同前,这里就略过了),在点击事件中调用这个方法:

private async void runCustomScript_Click(object sender, RoutedEventArgs e)
        {
            // 第一个参数是页面内的方法名,第二个是传入的参数列表,这个例子没有用到,这里用来演示下怎么用
            await wv.InvokeScriptAsync("changeColor", new []{"arg1", "arg2"});
        }

点击之后,我们标题就红了。

技术分享

在前面的代码中,其实存在一个潜在的问题,如果我们页面有点复杂,在dom还没有加载分析完成的时候,方法changeColor或标题可能还不存在,这样我们的调用不但不会有效果,还会引起异常。

所以需要在进行dom相关操作之前确认页面已经加载分析完成,WebView.DOMContentLoaded这个事件是在dom文档分析完成之后触发的,这样我们所有的dom操作就不会有错了。

public sealed partial class MainPage : Page
    {
        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
        }

        private void online_Click(object sender, RoutedEventArgs e)
        {
            this.wv.Navigate(new Uri("http://www.microsoft.com"));
        }

        private void offline_Click(object sender, RoutedEventArgs e)
        {
            // ms-appx-web 表示我们要读取的是应用内的一个文件,并且是在Web区域,相对路径是Data/help.html, 
            this.wv.Navigate(new Uri("ms-appx-web:///Data/help.html"));
        }

        private void memory_Click(object sender, RoutedEventArgs e)
        {
            var html = "&lt;h1&gt;我是一个字符串&lt;/h1&gt;";
            this.wv.NavigateToString(html);
        }

        public MainPage()
        {
            this.InitializeComponent();

            this.NavigationCacheMode = NavigationCacheMode.Required;

            this.wv.DOMContentLoaded += wv_DOMContentLoaded;
        }

        // 我们新加入一个变量,用来标识当前页面是否分析完成
        bool domLoaded = false;

        void wv_DOMContentLoaded(WebView sender, WebViewDOMContentLoadedEventArgs args)
        {
            domLoaded = true;
        }

        private async void runCustomScript_Click(object sender, RoutedEventArgs e)
        {
            if (domLoaded)
            {
                // 第一个参数是页面内的方法名,第二个是传入的参数列表,这个例子没有用到,这里用来演示下怎么用
                await wv.InvokeScriptAsync("changeColor", new[] { "arg1", "arg2" });
            }
        }
    }

使用模板页

现在如果你把页面的内容加的更多一些的话,你会发现WebView有一小段时间是空白的,这个就是在页面分析渲染完成之前的间隙。。。

要解决这个问题,我们可以先让WebView加载下面这样一个很小的模板页。

<!DOCTYPE html>

<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8" />
    <title></title>

    <script>
        function setContent(content)
        {
            var container = document.getElementById("container");
            container.innerHTML = content;
        }
    </script>
</head>
<body>
    <div id="container"></div>
</body>
</html>

这个模板页里只有一个简单框架和一个用来填充内容的方法,因为模板页很小且是本地的,所以加载渲染的很快,不会有白色的闪烁。然后通过调用javascript方法来把内容写入到dom中。

private async void runCustomScript_Click(object sender, RoutedEventArgs e)
        {
            if (domLoaded)
            {
                await wv.InvokeScriptAsync("setContent", new[] { "&lt;h2&gt;我是一个有很多内容的html页面,真的很多。。。&lt;/h2&gt;"});
            }
        }

技术分享

小结

以上介绍了使用WebView的基本方法,还有一些别的技巧我们以后再说,比如调整成夜间模式,比如检测手势左右滑动,比如监测页面跳转......哎,有的公司就是靠这些技巧用WebView控件包装一下做了浏览器,但是可悲(或者可笑)的是,一些用户还在评论中说:不错,速度很快,流畅。除非有服务器端的数据压缩,否则能快到哪里去呢?

分享代码,改变世界!

Windows Phone Store App link:

http://www.windowsphone.com/zh-cn/store/app/博客园-uap/500f08f0-5be8-4723-aff9-a397beee52fc

Windows Store App link:

http://apps.microsoft.com/windows/zh-cn/app/c76b99a0-9abd-4a4e-86f0-b29bfcc51059

GitHub open source link:

https://github.com/MS-UAP/cnblogs-UAP

MSDN Sample Code:

https://code.msdn.microsoft.com/CNBlogs-Client-Universal-477943ab

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。