重新想象 Windows 8.1 Store Apps (80) - 控件增强: WebView 之基本应用, POST 数据, 与 JavaScript 交互

<Page
    x:Class="Windows81.Controls.WebView.Demo"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:Windows81.Controls.WebView"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d">

    <Grid Background="Transparent">
        <StackPanel Margin="120 0 0 0">

            <Button Name="btnNavigateUrl" Content="导航到指定的 url" Click="btnNavigateUrl_Click" />

            <WebView Name="webView" Width="800" Height="2000" HorizontalAlignment="Left" Margin="0 10 0 0" />

        </StackPanel>
    </Grid>

    <Page.BottomAppBar>
        <AppBar x:Name="appBar" IsSticky="True" Padding="10,0">
            <StackPanel Name="buttonPanel" Orientation="Horizontal" HorizontalAlignment="Left">
                <AppBarButton Icon="Play" Label="SymbolIcon" />
            </StackPanel>
        </AppBar>
    </Page.BottomAppBar>
</Page>

/*
 * 本例演示 WebView 的基本应用
 * 
 * WebView - 内嵌浏览器
 *     
 * 
 * 提示：
 * 在 win8 中 WebView 会挡住所有元素（包括 AppBar），而在 win8.1 中不会再有这种情况了
 * 如果想看看 win8 中全屏 WebView 如何不挡 AppBar，以及如何使用 WebViewBrush 以达到不遮挡其他元素的目的，请参看：http://www.cnblogs.com/webabcd/archive/2013/03/04/2942242.html
 * 
 * 注：win8 和 win8.1 中的 WebView 有很多区别，在 win8.1 中使用 WebView 请参考本系列教程，在 win8 中使用 WebView 请看考：http://www.cnblogs.com/webabcd/archive/2013/03/04/2942242.html
 */

using System;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Media;

namespace Windows81.Controls.WebView
{
    public sealed partial class Demo : Page
    {
        public Demo()
        {
            this.InitializeComponent();
        }

        private void btnNavigateUrl_Click(object sender, RoutedEventArgs e)
        {
            // 导航到指定的 url
            webView.Navigate(new Uri("http://www.sina.com.cn/", UriKind.Absolute));
            // webView.Source = new Uri("http://webabcd.cnblogs.com/", UriKind.Absolute);

            // web 页面中的某一个 frame 加载前
            webView.FrameNavigationStarting += webView_FrameNavigationStarting;
            // web 页面中的某一个 frame 加载中
            webView.FrameContentLoading += webView_FrameContentLoading;
            // web 页面中的某一个 frame 的 DOM 加载完成
            webView.FrameDOMContentLoaded += webView_FrameDOMContentLoaded;
            // web 页面中的某一个 frame 导航完成（成功或失败）
            webView.FrameNavigationCompleted += webView_FrameNavigationCompleted;

            // web 页面加载前
            webView.NavigationStarting += webView_NavigationStarting;
            // web 页面加载中
            webView.ContentLoading += webView_ContentLoading;
            // web 页面的 DOM 加载完成
            webView.DOMContentLoaded += webView_DOMContentLoaded;
            // web 页面导航完成（成功或失败）
            webView.NavigationCompleted += webView_NavigationCompleted;

            // 当脚本运行时，可能会导致 app 无响应。此事件会定期执行，然后可查看 ExecutionTime 属性，如果要暂停脚本，则将 StopPageScriptExecution 属性设置为 true 即可
            webView.LongRunningScriptDetected +=webView_LongRunningScriptDetected;
            // 在 WebView 对 SmartScreen 筛选器报告为不安全的内容显示警告页面时发生
            webView.UnsafeContentWarningDisplaying +=webView_UnsafeContentWarningDisplaying;
            // 在 WebView 尝试下载不受支持的文件时发生
            webView.UnviewableContentIdentified +=webView_UnviewableContentIdentified;


            // 用于导航 web 的一系列 api，顾名思义，不解释了
            // webView.CanGoBack;
            // webView.GoBack();
            // webView.CanGoForward;
            // webView.GoForward();
            // webView.Stop();
            // webView.Refresh();


            RotateTransform rt = new RotateTransform();
            rt.Angle = 5;
            // 支持 RenderTransform 了
            webView.RenderTransform = rt;

            // 支持 Opacity 了
            webView.Opacity = 0.3;

            // 支持 Focus 了
            // webView.Focus(FocusState.Programmatic);
        }


        void webView_FrameNavigationStarting(Windows.UI.Xaml.Controls.WebView sender, WebViewNavigationStartingEventArgs args)
        {
            // 是否取消此 url 的加载
            // args.Cancel = true;

            // args.Uri
        }
        void webView_FrameContentLoading(Windows.UI.Xaml.Controls.WebView sender, WebViewContentLoadingEventArgs args)
        {
            // args.Uri
        }
        void webView_FrameDOMContentLoaded(Windows.UI.Xaml.Controls.WebView sender, WebViewDOMContentLoadedEventArgs args)
        {
            // args.Uri
        }
        void webView_FrameNavigationCompleted(Windows.UI.Xaml.Controls.WebView sender, WebViewNavigationCompletedEventArgs args)
        {
            // 导航是否成功
            // args.IsSuccess

            // 导航失败时，失败原因的 WebErrorStatus 枚举
            // args.WebErrorStatus
        }
        

        void webView_NavigationStarting(Windows.UI.Xaml.Controls.WebView sender, WebViewNavigationStartingEventArgs args)
        {
            // 是否取消此 url 的加载
            // args.Cancel = true;

            // args.Uri
        }
        void webView_ContentLoading(Windows.UI.Xaml.Controls.WebView sender, WebViewContentLoadingEventArgs args)
        {
            // args.Uri
        }
        void webView_DOMContentLoaded(Windows.UI.Xaml.Controls.WebView sender, WebViewDOMContentLoadedEventArgs args)
        {
            // args.Uri
        }
        void webView_NavigationCompleted(Windows.UI.Xaml.Controls.WebView sender, WebViewNavigationCompletedEventArgs args)
        {
            // 导航是否成功
            // args.IsSuccess

            // 导航失败时，失败原因的 WebErrorStatus 枚举
            // args.WebErrorStatus
        }


        // 在 WebView 尝试下载不受支持的文件时发生
        void webView_UnviewableContentIdentified(Windows.UI.Xaml.Controls.WebView sender, WebViewUnviewableContentIdentifiedEventArgs args)
        {
            // 引用页
            // args.Referrer

            // args.Uri
        }

        // 在 WebView 对 SmartScreen 筛选器报告为不安全的内容显示警告页面时发生
        void webView_UnsafeContentWarningDisplaying(Windows.UI.Xaml.Controls.WebView sender, object args)
        {
            
        }

        // 当脚本运行时，可能会导致 app 无响应。此事件会定期执行，然后可查看 ExecutionTime 属性，如果要暂停脚本，则将 StopPageScriptExecution 属性设置为 true 即可
        void webView_LongRunningScriptDetected(Windows.UI.Xaml.Controls.WebView sender, WebViewLongRunningScriptDetectedEventArgs args)
        {
            // 获取 WebView 执行的一个长时间运行的脚本的运行时间（单位：毫秒）
            // args.ExecutionTime

            // 是否暂停在 WebView 中执行的已运行很长时间的脚本
            // args.StopPageScriptExecution
        }
    }
}

<Page
    x:Class="Windows81.Controls.WebView.Post"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:Windows81.Controls.WebView"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d">

    <Grid Background="Transparent">
        <StackPanel Margin="120 0 0 0">

            <WebView Name="webView" Width="800" Height="300" HorizontalAlignment="Left" />

        </StackPanel>
    </Grid>

</Page>

/*
 * 本例演示如何通过 POST 请求和 HTTP 头加载 url
 * 
 * WebView - 内嵌浏览器
 *     
 * 
 * 提示：
 * 在 win8 中 WebView 会挡住所有元素（包括 AppBar），而在 win8.1 中不会再有这种情况了
 * 如果想看看 win8 中全屏 WebView 如何不挡 AppBar，以及如何使用 WebViewBrush 以达到不遮挡其他元素的目的，请参看：http://www.cnblogs.com/webabcd/archive/2013/03/04/2942242.html
 * 
 * 注：win8 和 win8.1 中的 WebView 有很多区别，在 win8.1 中使用 WebView 请参考本系列教程，在 win8 中使用 WebView 请看考：http://www.cnblogs.com/webabcd/archive/2013/03/04/2942242.html
 */

using System;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.Web.Http;

namespace Windows81.Controls.WebView
{
    public sealed partial class Post : Page
    {
        public Post()
        {
            this.InitializeComponent();

            this.Loaded += Post_Loaded;
        }

        void Post_Loaded(object sender, RoutedEventArgs e)
        {
            HttpRequestMessage httpRequestMessage = new HttpRequestMessage(HttpMethod.Post, new Uri("http://localhost:39630/WebViewPost.aspx")); // 此测试 aspx 在 WebServer 项目中

            // 构造 post 数据（无法 form 提交，因为试了很久，无法将 ContentType 设置为 "application/x-www-form-urlencoded"）
            httpRequestMessage.Content = new HttpStringContent("hello webabcd");

            // 构造 http header 数据
            httpRequestMessage.Headers.Append("myHeader", "hello header");

            // NavigateWithHttpRequestMessage() - 通过 POST 请求和 HTTP 头加载 url
            webView.NavigateWithHttpRequestMessage(httpRequestMessage);
        }
    }
}

/*
 * 用于 WebView 演示如何通过 POST 请求和 HTTP 头加载 url
 */

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace WebServer
{
    public partial class WebViewPost : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            Request.InputStream.Position = 0;
            StreamReader str = new StreamReader(Request.InputStream);
            string postData = str.ReadToEnd();
            str.Dispose();

            // 显示 post 过来的数据
            Response.Write("post data: " + postData);
            Response.Write("<br />");
            // 显示请求的一个自定义的 http 头
            Response.Write("my header: " + Request.Headers["myHeader"]);
        }
    }
}

<Page
    x:Class="Windows81.Controls.WebView.Interact"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:Windows81.Controls.WebView"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d">

    <Grid Background="Transparent">
        <StackPanel Margin="120 0 0 0">

            <TextBlock Name="lblMsg" FontSize="14.667" />
            
            <Button Name="btnInvokeJavaScript" Content="app 调用 WebView 加载内容中的 JavaScript 函数" Click="btnInvokeJavaScript_Click" Margin="0 10 0 0" />

            <Button Name="btnAccessDOM" Content="通过 eval 访问 DOM" Click="btnAccessDOM_Click" Margin="0 10 0 0" />

            <Button Name="btnRegisterJavaScript" Content="通过 eval 向页面中注册 JavaScript 脚本" Click="btnRegisterJavaScript_Click" Margin="0 10 0 0" />

            <!--
                通过 ms-appx-web 加载包内的 html 页面
            -->
            <WebView Name="webView" Width="400" Height="300" Source="ms-appx-web:///Controls/WebView/WebViewInteract.html" HorizontalAlignment="Left" Margin="0 10 0 0" />

        </StackPanel>
    </Grid>
</Page>

/*
 * 本例演示 WebView 如何与 JavaScript 交互
 * 
 * WebView - 内嵌浏览器
 *     DocumentTitle - html 中的 title
 *     DefaultBackgroundColor - html 中的背景色
 *     InvokeScriptAsync() - 调用 JavaScript 中的指定函数，并返回执行结果
 *     ScriptNotify - 当接收到从 JavaScript 发过来的数据时所触发的事件（事件参数：NotifyEventArgs），通过在 html 中调用 window.external.notify 来实现 js 调用 app
 *     
 * NotifyEventArgs
 *     Value - js 传递给 app 的数据
 * 
 * 本例通过加载同目录下的 WebViewInteract.html 来演示 app 与 js 的交互
 * 
 * 
 * 
 * 提示：
 * 在 win8 中 WebView 会挡住所有元素（包括 AppBar），而在 win8.1 中不会再有这种情况了
 * 如果想看看 win8 中全屏 WebView 如何不挡 AppBar，以及如何使用 WebViewBrush 以达到不遮挡其他元素的目的，请参看：http://www.cnblogs.com/webabcd/archive/2013/03/04/2942242.html
 *
 * 注：win8 和 win8.1 中的 WebView 有很多区别，在 win8.1 中使用 WebView 请参考本系列教程，在 win8 中使用 WebView 请看考：http://www.cnblogs.com/webabcd/archive/2013/03/04/2942242.html
 */

/*
 * 特别注意：
 * 1、在 win8.1 中如果要允许外部网页引发 ScriptNotify 事件，则必须在 appxmanifest 中设置允许的 URI，必须是 https 协议的，类似如下
 *    <ApplicationContentUriRules>
 *       <Rule Match="https://aaa.aaa.aaa" Type="include" />
 *    </ApplicationContentUriRules>
 * 2、如果使用的是本地 html 数据则无此限制，比如通过 NavigateToString 或 ms-appx-web 来加载 html 时
 * 3、另外如果是 http 的话，可以将 html 下载到本地，然后加载此 html，而 html 中的 url 引用则可以引用远程的（如果需要替换 html 中的 url 引用则可以参考 Local.xaml 的方式）
 */

using System;
using System.Collections.Generic;
using Windows.UI.Popups;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;

namespace Windows81.Controls.WebView
{
    public sealed partial class Interact : Page
    {
        public Interact()
        {
            this.InitializeComponent();

            webView.ScriptNotify += webView_ScriptNotify;
            webView.NavigationCompleted += webView_NavigationCompleted;
        }

        void webView_NavigationCompleted(Windows.UI.Xaml.Controls.WebView sender, WebViewNavigationCompletedEventArgs args)
        {
            if (args.IsSuccess)
            {
                lblMsg.Text = "html title: " + webView.DocumentTitle;
                lblMsg.Text += Environment.NewLine;
                lblMsg.Text += "html backgroundColor: " + webView.DefaultBackgroundColor.ToString();
            }
        }

        async void webView_ScriptNotify(object sender, NotifyEventArgs e)
        {
            // 获取 js 传递过来的数据（js 端通向 app 传递数据的方法：window.external.notify(‘js to app‘);）
            await new MessageDialog(e.Value).ShowAsync();
        }

        // app 调用 js
        private async void btnInvokeJavaScript_Click(object sender, RoutedEventArgs e)
        {
            List<string> arguments = new List<string> { "webabcd" };
            // 调用 js 方法：sayHelloToJs(‘webabcd‘); 并返回结果
            string result = await webView.InvokeScriptAsync("sayHelloToJs", arguments);

            await new MessageDialog(result).ShowAsync();
        }

        // 通过 eval 方式访问 DOM
        private async void btnAccessDOM_Click(object sender, RoutedEventArgs e)
        {
            // 获取 document.title 的值
            List<string> arguments = new List<string> { "document.title" };
            string result = await webView.InvokeScriptAsync("eval", arguments);

            await new MessageDialog(result).ShowAsync();
        }

        // 通过 eval 向页面中注册 JavaScript 脚本
        private async void btnRegisterJavaScript_Click(object sender, RoutedEventArgs e)
        {
            // 向 html 中注册脚本
            List<string> arguments = new List<string> { "function xxx(){return ‘由 app 向 html 注册的脚本返回的数据‘;}" };
            await webView.InvokeScriptAsync("eval", arguments);

            // 调用刚刚注册的脚本
            string result = await webView.InvokeScriptAsync("xxx", null);

            await new MessageDialog(result).ShowAsync();
        }
    }
}

<!--此 html 用于演示 app 与 js 间的交互-->

<!doctype html>
<html>
<head>
    <title>I am html title</title>
    <script type=‘text/javascript‘>
        function sayHelloToJs(name) {
            return ‘app to js: ‘ + name;
        }

        function sayHelloToApp() {
            // 传递数据给 app
            window.external.notify(‘js to app‘);
        }
    </script>
</head>
<body>
    <input type=‘button‘ onclick=‘sayHelloToApp();‘ value=‘js 调用 app 中的方法‘ />
</body>
</html>