【WP8.1】WebView笔记

浏览数：54 / 时间：2015年06月09日

之前在WP8的时候做过WebBrowser相关的笔记，在WP8.1的WebView和WebBrowser有些不一样，在这里做一些笔记

下面分为几个部分

　　1、禁止缩放

　　2、JS通知后台C#代码（notify）

　　3、C#调用JS方法

　　　　动态加载JS文件，动态注册事件方法（eval）

　　4、WebView导航

　　5、手势（WinJS）

　　6、常见问题

1、禁用缩放　　

body {
    /* Block area from manipulation actions (zoom, pan) */
    touch-action: pan-y;
}

　　这个值可以禁用掉缩放和横向手势

　　关于touch-action参见：https://msdn.microsoft.com/en-us/library/windows/apps/xaml/hh767313.aspx?f=255&MSPPError=-2147217396

2、JS通知后台C#代码（notify）　

window.external.notify(msg);

注意：这里的方法名是小写的，在WP8上后面的Notify方法的首字母是大小写都可以

3、C#调用JS方法（InvokeScriptAsync）

　　通过后台代码动态加载css，js，动态绑定事件和方法

　　3.1、先定义传输的数据格式

/// <summary>
/// JS消息格式
/// </summary>
public class JsInvokeModel
{
    [JsonProperty("type")]
    public string Type { get; set; }

    [JsonProperty("content1")]
    public string Content1 { get; set; }

    [JsonProperty("content2")]
    public string Content2 { get; set; }

    [JsonProperty("content3")]
    public string Content3 { get; set; }
}

　　3.2、XAML

<WebView x:Name="WebView" DOMContentLoaded="WebView_OnDOMContentLoaded" ScriptNotify="WebView_OnScriptNotify" />

　　3.3、下面是事件方法

//DOM树加载完成后执行
private async void WebView_OnDOMContentLoaded(WebView sender, WebViewDOMContentLoadedEventArgs args)
{
    //1、动态加载css
    var js = @"var myCss = document.createElement(""link"");
        myCss.rel = ""stylesheet"";
        myCss.type = ""text/css"";
        myCss.href = ""ms-appx-web:///Assets/Html/css/default.css"";
        document.body.appendChild(myCss);";
    await sender.InvokeScriptAsync("eval", new[] { js });

    //2、动态加载js库（json2）
    js = @"var myScript = document.createElement(""script"");
        myScript.type = ""text/javascript"";
        myScript.src = ""ms-appx-web:///Scripts/json2.min.js"";
        document.body.appendChild(myScript);";    
    await sender.InvokeScriptAsync("eval", new[] {js});
    
    //3、调用js执行自定义代码（为图片添加点击事件，并通知）
    js = @"var imgs = document.getElementsByTagName(""img"");
           for (var i = 0, len = imgs.length; i < len; i++) {
               imgs[i].onclick = function (e) {
                   var jsonObj = { type: ‘image‘, content1: this.src };
                   window.external.notify(JSON.stringify(jsonObj));
               };
           }";
    await sender.InvokeScriptAsync("eval", new[] {js});

    //4、动态加载手势
    js = @"var myScript = document.createElement(""script"");
        myScript.type = ""text/javascript"";
        myScript.src = ""ms-appx-web:///Assets/Html/js/gesture.js"";
        document.body.appendChild(myScript);
        window.external.notify(myScript.src+"""");";
    await sender.InvokeScriptAsync("eval", new[] { js });

    //5、为body添加手势监听
    js = @"var target = document.getElementsByTagName(""body"")[0];
           prepareTarget(target, eventListener);";
    await sender.InvokeScriptAsync("eval", new[] { js });
}

　　3.4、Notify监听

private void WebView_OnScriptNotify(object sender, NotifyEventArgs e)
{
    //这个事件函数可以监听到JS通知的消息，消息类型为文本
    //这里统一消息格式为：JsInvokeModel
    var model = JsonConvert.DeserializeObject<JsInvokeModel>(e.Value);
    switch (model.Type)
    {
        case "image":
            Info.Text = e.Value;
            break;
        case "swiperight":
            //右滑
            Info.Text = e.Value;            
            break;
        case "swipeleft":
            //左滑
            Info.Text = e.Value;
            break;
        case "text":
            Info.Text = e.Value;
            break;
    }
}

　　WebView虽然提供了同步方法InvokeScript，但是在WP8.1没有实现

　　　通过InvokeScriptAsync，可以做更多操作，例如，相信对于更换颜色（夜间模式），修改字体大小等

4、WebView导航

两种方式

//后退
    //WebView.GoBack();
    await WebView.InvokeScriptAsync("eval", new []{"history.go(-1)"});

    //刷新
    //WebView.Refresh();
    await WebView.InvokeScriptAsync("eval", new[] { "history.go()" });        

    //前进
    //WebView.GoForward();
    await WebView.InvokeScriptAsync("eval", new[] { "history.go(1)" });

5、手势

　　由于WebView的内部结构与WebBrowser不同，WebView无法监听到Manipulation事件

　　场景：当我们需要在PivotItem中放置WebView的时候，左右滑动无法切换PivotItem，下面通过JS手势监听WebView上面的手势操作，然后传到后台代码进行处理，这里没有做实时处理，只是监听了手势离开时的速度判断左右滑动

　　5.1、定义手势监听事件方法

var gesture;
//记录手势操作开始位置
var gestureStartX;

//触发Id,防止重复触发，触发Id与手势Id
var gestureId = 1;
var lastGestureId = 0;

//速度触发
var gestureVector = 1.5;

//注册手势事件
function prepareTarget(target, eventListener) {
    //var target = document.getElementById(targetId);
    target.addEventListener("MSGestureStart", eventListener, false);
    target.addEventListener("MSGestureEnd", eventListener, false);
    target.addEventListener("MSGestureChange", eventListener, false);
    target.addEventListener("MSInertiaStart", eventListener, false);
    //target.addEventListener("MSGestureTap", eventListener, false);
    //target.addEventListener("MSGestureHold", eventListener, false);
    target.addEventListener("pointerdown", onPointDown, false);
    target.addEventListener("pointerup", onPointUp, false);

    gesture = new MSGesture();
    gesture.target = target;
}

function onPointUp(e) {
    //把触发时间参数传到gesture
    gesture.addPointer(e.pointerId);
}

function onPointDown(e) {
    //把触发时间参数传到gesture
    gesture.addPointer(e.pointerId);
}

//手势事件
//具体的属性参见：https://msdn.microsoft.com/zh-cn/library/ie/hh772076%28v=vs.85%29.aspx
function eventListener(evt) {
    var myGesture = evt.gestureObject;
    if (evt.type == "MSGestureStart") {
        //开始触发，记录初始位置
        gestureStartX = evt.clientX;
    }
    else if (evt.type == "MSInertiaStart") {
        if (lastGestureId == gestureId || evt.velocityX == "undefined") {
            return;
        } else {
            //释放时触发惯性事件，判断手势释放时的速度
            if (evt.velocityX > gestureVector) {
                var jsonObj = { type: "swiperight" };
                window.external.notify(JSON.stringify(jsonObj));
                lastGestureId = gestureId;
            } else if (evt.velocityX < -gestureVector) {
                jsonObj = { type: "swipeleft" };
                window.external.notify(JSON.stringify(jsonObj));
                lastGestureId = gestureId;
            }
        }
    }
    else if (evt.type == "MSGestureChange") {
        //if (lastGestureId == gestureId) {
        //    return;
        //} else {
        //    var change = evt.clientX - gestureStartX;
        //    window.external.notify("clientX:" + change);
        //}
    } else if (evt.type == "MSGestureEnd") {
        //手势结束，Id+1
        gestureId = gestureId + 1;
        myGesture.reset();
    }
}

gesture.js

　　5.2、在WebView加载完成后，动态加载改JS文件，获取body标签，然后监听事件（参见3.3）

　　5.3、当事件触发的时候改变Pivot.SelectedIndex，这样就能实现在WebView上滑动切换PivotItem

private void WebView_OnScriptNotify(object sender, NotifyEventArgs e)
{
    //这个事件函数可以监听到JS通知的消息，消息类型为文本
    //这里统一消息格式为：JsInvokeModel
    var model = JsonConvert.DeserializeObject<JsInvokeModel>(e.Value);
    switch (model.Type)
    {
        case "image":
            Info.Text = e.Value;
            break;
        case "swiperight":
            Info.Text = e.Value;
            if (pivot.Items != null)
            {
                if (pivot.SelectedIndex > 0)
                {
                    pivot.SelectedIndex--;
                }
                else
                {
                    pivot.SelectedIndex = pivot.Items.Count - 1;
                }
            }
            break;
        case "swipeleft":
            Info.Text = e.Value;
            if (pivot.Items != null)
            {
                if (pivot.SelectedIndex < pivot.Items.Count - 1)
                {
                    pivot.SelectedIndex++;
                }
                else
                {
                    pivot.SelectedIndex = 0;
                }
            }
            break;
        case "text":
            Info.Text = e.Value;
            break;
    }
}