【新特性速递】FineUIPro/Mvc/Core 全新移动端访问体验(示例首页)!

移动端支持

虽然 FineUIPro 早在 2016 年就已经完成对移动端的适配工作,并新增了 50 多个官网示例。

 

并且,我们也新增了一个移动端的首页 http://pro.fineui.com/mobile/main.aspx ,通过手机浏览器打开这个页面,看到的效果还是很不错的:

菜单的层次切换也是典型的左右滑动效果,看下动图:

 

示例首页的移动端支持

但是官网示例首页一直没有对移动端做适配,表现在你通过手机访问 http://pro.fineui.com/ 时,看到的和PC端的显示效果一模一样:

给人的感觉就是文字很小,很模糊,也不好点击,只有手工放大才行。

这个体验其实很糟糕,尽管我们一直在说,对于管理系统而言,PC端的显示效果一般不能直接用于移动端,毕竟移动端的屏幕尺寸有限,你不可能把PC端的20列的表格直接照搬到手机端显示。

 

但是,如果能够赏心悦目的在手机上查看官网示例首页,又何乐而不为呢?很多时候,我们只是没想到,实现起来并不是难事。

来看下新版官网示例首页的移动端效果(从 FineUIPro v5.5.0 开始支持):

 

由于手机端屏幕尺寸有限,所以默认左侧菜单是折叠起来的,当点击折叠按钮时,整体页面右移,显示左侧菜单。动起来的效果更迷人:

 

实现原理分析

如果仔细观察上面的动图,可以清楚的看到,默认左侧菜单是【折叠】的,只不过这个折叠并不是真正意义的折叠,而只是隐藏在左侧而已。

换句话说,初始页面加载时,整体页面左移了260px(也即是左侧菜单的宽度),点击折叠按钮时,整体页面右移260px像素而已,道理很简单吧。

下面的图片就更直观了,初始页面加载后:

可以看到最外层的 mainPanel 是应用了 CSS3 样式:-webkit-transform: translate3d(-260px,0,0);

这个样式让整体页面左移了 260px,为了看到隐藏的内容,我们把 -260px 改为 -130px,让左侧露出半个脑袋:

全露出来:

其实在点击折叠按钮时,FineUIPro内部就是通过改变这个CSS样式来实现的左侧菜单的显示隐藏效果的。

是不是很简单!

 

实现代码一瞥

1. Web.config增加配置项(MobileAdaption="true")

完整的FineUIPro节点如下所示:

<FineUIPro DebugMode="true" CustomTheme="pure_black" EnableAnimation="true" MobileAdaption="true" JSLibrary="All" />

 

2. 自定义CSS样式

body.mobileview .mainpanel {
    transition: all .3s;
    -webkit-transition: all .3s;
    transform: translate3d(-260px,0,0);
    -webkit-transform: translate3d(-260px,0,0);
}

body.mobileview .mainpanel.showsidebar {
    transform: translate3d(0,0,0);
    -webkit-transform: translate3d(0,0,0);
}

body.mobileview .mainpanel .f-region-split {
    display: none !important;
}

body.mobileview .mainpanel .sidebarregion {
    box-shadow: none;
}

body.mobileview .mainpanel .bodyregion .showsidebar-mask {
    position: absolute;
    left: 0;
    top: 0;
    background-attachment: fixed;
    width: 100%;
    height: 100%;
    z-index: 20000;
    background-color: rgba(0,0,0,.3);
}

 

这里面主要有三部分:

  1. 显示隐藏左侧菜单的样式: .showsidebar
  2. 隐藏模式下让分隔条不可见: .sidebarregion
  3. 菜单显示模式下,显示主区域的遮罩层:.showsidebar-mask

 

3. 自定义JS代码

这部分有点复杂,关键代码如下:

3.1 判断何时启用移动视图的函数

function isSmallWindowWidth() {
    var windowWidth = $(window).width();
    return windowWidth < 992;
}

可以看到,我们是以页面宽度作为边界条件,如果页面小于992px,则启用移动视图

 

3.2 如何启用移动视图

function checkMobileView(shouldLayout) {
    var isMobileView = $('body').hasClass("mobileview");
    var needLayout = false;

    // 如果窗体宽度小于992px,则启用移动视图
    if (isSmallWindowWidth()) {
        if (!isMobileView) {
            $('body').addClass("mobileview");
            F.viewPortExtraWidth = SIDEBAR_WIDTH_CONSTANT;
            needLayout = true;
        }
    } else {
        if (isMobileView) {
            $('body').removeClass("mobileview");
            F.viewPortExtraWidth = 0;
            needLayout = true;
        }
    }

    if (needLayout && shouldLayout) {
        // 应用布局,代码省略
    }
}

两行代码启用视图视图:

  1. 给body节点添加 mobileview 样式
  2. 设置 F.viewPortExtraWidth=260,也就是告诉FineUIPro将视口的宽度多扩展260px,以便左移后刚好隐藏左侧菜单

注:简单设置 F.viewPortExtraWidth 没有任何效果,必须在 F.ready 运行之前设置,或者设置之后调用面板的doLayout函数!

 

3.3 点击折叠按钮图标

// 点击折叠/展开按钮
function onFoldClick(event) {
    if (isSmallWindowWidth()) {
        var sidebarregionEl = $('.sidebarregion');
        var bodyregionEl = $('.bodyregion');

        // 创建遮罩层
        var maskEl = bodyregionEl.find('.showsidebar-mask');
        if (!maskEl.length) {
            maskEl = $('<div class="showsidebar-mask"></div>').appendTo(bodyregionEl.find('>.f-panel-bodyct'));
            maskEl.on('click', function () {
                if (isSmallWindowWidth()) {
                    hideSidebarAndMask();
                }
            });

            sidebarregionEl.on('click', '.leftregion a.f-tree-cell-text', function () {
                if (isSmallWindowWidth()) {
                    hideSidebarAndMask();
                }
            });
        }

        if (getFoldButtonStatus()) {
            showSidebarAndMask();
        } else {
            hideSidebarAndMask();
        }

    } else {
        toggleSidebar();
    }
}

这里面有两个DOM节点的事件处理,都是在移动视图下才会执行的,分别是:

  1. 遮罩层的点击事件:点击遮罩层,会隐藏左侧菜单
  2. 左侧菜单项的点击事件:点击菜单项会在主区域打开IFRAME页面,并隐藏左侧菜单

 

注意事项

  1. 本文介绍的内容会在FineUIPro/Mvc/Core v5.5.0 中实现。
  2. 由于移动端支持是企业版功能,所以本效果在基础版中不可用。

 

posted @ 2019-04-01 15:41 三生石上(FineUI控件) 阅读(...) 评论(...) 编辑 收藏