新蒲京200.c软件下载-app官网网址 > 活动 >

用Web Components创设单页面应用

用Web Components塑造单页面应用

2015/01/19 · JavaScript · Web Components

本文由 伯乐在线 - 周进林 翻译,Mxt 校稿。未经许可,禁绝转发!
俄语出处:www.polymer-project.org。招待参加翻译组。

你是哪些选用Polymer营造七个单页应用的?那么些难点我们在Polymer团队里已经问过无数遍了。我们的答案(长久以来地)是“使用组件(component)!”。可是,使用新技巧去化解现存的主题素材频频不会马上得到肯定的效果与利益。怎么着把一批模块化组件组合到四个巨型的实用的运用中去?

在本教程,小编将会给你体现什么去营造三个意义风姿罗曼蒂克体化的单页应用:

图片 1

  • 全然采纳Polymer的主干因素构建
  • 使用响应式设计
  • 利用数据绑定脾性过渡视图
  • 行使UTiguanL路由和深层链接性子
  • 可访问键盘
  • 按需动态载入内容(可选)

 张开演示

运用布局

兼顾布局是初叶四个档期的顺序的主要职分之豆蔻梢头。作为着力因素集结的意气风发有些,Polymer通过多少个构产生分 来支撑应用程序的构架(<core-header-panel>, <core-drawer-panel>, <core-toolbar>)。这个零器件本人就很好用,不过为了更加快地最早项目,大家打算器重于<core-scaffold>。有了它你能够透过建构多少个为主的成分就会做出三个响应式的位移端布局。

<core-scaffold>的子成分能够是点名特定的因素或应用一定的价签(或双边联手行使)。举例,使用<nav>成分成立应用抽屉菜单。你可以在自由的要素里应用navigation属性(e.g <core-header-panel navigation>)。工具栏通过工具属性标志。它的兼具别的子元素都定义在重大内容区域里。

例子

XHTML

<body unresolved fullbleed> <core-scaffold id="scaffold"> <nav>Left drawer</nav> <core-toolbar tool>Application</core-toolbar> <div>Main content</div> </core-scaffold> </body>

1
2
3
4
5
6
7
<body unresolved fullbleed>
  <core-scaffold id="scaffold">
    <nav>Left drawer</nav>
    <core-toolbar tool>Application</core-toolbar>
    <div>Main content</div>
  </core-scaffold>
</body>

让我们共同来深刻那一个内容的每风度翩翩有个别

抽屉菜单

你放在导航成分里的符号都定义在滑走的接纳抽屉菜单里。为了大家的对象 ,小编百折不回使用标题(<core-toolbar>卡塔尔国和导航链接 (<core-menu>卡塔尔国:

XHTML

<nav> <core-toolbar><span>Single Page Polymer</span></core-toolbar> <core-menu selected="0"> <paper-item noink> <core-icon icon="label-outline"></core-icon> <a href="#one">Single</a> </paper-item> <paper-item noink> <core-icon icon="label-outline"></core-icon> <a href="#two">page</a> </paper-item> ... </core-menu> </nav>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<nav>
  <core-toolbar><span>Single Page Polymer</span></core-toolbar>
  <core-menu selected="0">
    <paper-item noink>
      <core-icon icon="label-outline"></core-icon>
      <a href="#one">Single</a>
    </paper-item>
    <paper-item noink>
      <core-icon icon="label-outline"></core-icon>
      <a href="#two">page</a>
    </paper-item>
    ...
  </core-menu>
</nav>

瞩目,今后<core-menu selected=”0″>被硬编码为筛选第三个条目。我们随后会把它改为动态的。

工具栏

工具栏横跨了页面最上部并包括了职能按键Logo。满意这种功效的全面成分是<core-toolbar>:

XHTML

<!-- flex makes the bar span across the top of the main content area --> <core-toolbar tool flex> <!-- flex spaces this element and jusifies the icons to the right-side --> <div flex>Application</div> <core-icon-button icon="refresh"></core-icon-button> <core-icon-button icon="add"></core-icon-button> </core-toolbar>

1
2
3
4
5
6
7
<!-- flex makes the bar span across the top of the main content area -->
<core-toolbar tool flex>
  <!-- flex spaces this element and jusifies the icons to the right-side -->
  <div flex>Application</div>
  <core-icon-button icon="refresh"></core-icon-button>
  <core-icon-button icon="add"></core-icon-button>
</core-toolbar>

重在内容

聊到底生机勃勃部分是为您的源委而留的。它能够是此外的因素。<div>是叁个很好的精选:

XHTML

<div layout horizontal center-center fit> <!-- fill with pages --> </div>

1
2
3
<div layout horizontal center-center fit>
  <!-- fill with pages -->
</div>

fit属性表示首要区域的剧情会遍布父成分的宽带和冲天,layout horizontal center-center属性表示使用弹性框(flexbox)来使内容居春日垂直居中。

创建“视图”

多视图(恐怕多页面)可以动用<core-pages>或然<core-animated-pages>来成立。在一遍只体现二个子成分时,八个要素都很有用。而使用<core-animated-pages>的益处是,它提供了越来越多的暗中同意和灵活的页面过渡。

上面包车型地铁现身说法(demo)使用了<core-animated-pages>成分的slide-from-right过渡效果。首先,导入成分定义和slide-from-right过渡效果。

XHTML

<link rel="import" href="components/core-animated-pages/core-animated-pages.html"> <link rel="import" href="components/core-animated-pages/transitions/slide-from-right.html">

1
2
<link rel="import" href="components/core-animated-pages/core-animated-pages.html">
<link rel="import" href="components/core-animated-pages/transitions/slide-from-right.html">

下一场插入你的内容:

XHTML

<div layout horizontal center-center fit> <core-animated-pages selected="0" transitions="slide-from-right"> <section layout vertical center-center> <div>Single</div> </section> <section layout vertical center-center> <div>page</div> </section> ... </core-animated-pages> </div>

1
2
3
4
5
6
7
8
9
10
11
<div layout horizontal center-center fit>
  <core-animated-pages  selected="0" transitions="slide-from-right">
    <section layout vertical center-center>
      <div>Single</div>
    </section>
    <section layout vertical center-center>
      <div>page</div>
    </section>
    ...
  </core-animated-pages>
</div>

瞩目,现在<core-animated-pagesselected=”0″>那行代码是硬编码去筛选第大器晚成页。可是我们随后会把它写成动态的。

明日您应该有所了三个着力的施用,不过此地有部分小的难点亟待留意。多亏损Polymer每一个元素提供的布局属性和暗许样式,你能够不写任何的CSS代码就能够实现三个响应式应用。当然,从material design调色板里获得一些灵感,设置不到10 CSS规则就足以让这几个应该变得更加赏心悦目。

展示:没设置CSS     展示:设置CSS

运用数据绑定

咱俩有着了二个用到,但那不值得后生可畏提。那离D凯雷德Y还远着。近似的暗记在此边再现:

XHTML

<nav> <core-menu selected="0"> <paper-item noink> <core-icon icon="label-outline"></core-icon> <a href="#one">Single</a> </paper-item> <paper-item noink> <core-icon icon="label-outline"></core-icon> <a href="#two">page</a> </paper-item> <paper-item noink> <core-icon icon="label-outline"></core-icon> <a href="#three">app</a> </paper-item> ... </core-menu> </nav>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<nav>
  <core-menu selected="0">
    <paper-item noink>
      <core-icon icon="label-outline"></core-icon>
      <a href="#one">Single</a>
    </paper-item>
    <paper-item noink>
      <core-icon icon="label-outline"></core-icon>
      <a href="#two">page</a>
    </paper-item>
    <paper-item noink>
      <core-icon icon="label-outline"></core-icon>
      <a href="#three">app</a>
    </paper-item>
    ...
  </core-menu>
</nav>

那无差别于不是动态的。当客户接受一个美食做法条款时,页面不会更新。幸运的是,这个标题都得以采纳Polymer的数码绑定天性自在清除。

机动绑定模板(template)

为了利用<polymer-element>外的绑定数据,包装多少个Yo应用?利用内部的电动绑定<template>成分:

XHTML

<body unresolved fullbleed> <template is="auto-binding"> <core-scaffold id="scaffold"> ... </core-scaffold> </template> </body>

1
2
3
4
5
6
7
<body unresolved fullbleed>
  <template is="auto-binding">
    <core-scaffold id="scaffold">
      ...
    </core-scaffold>
  </template>
</body>

提示,<template>自动绑定元素允许大家在重要页面里应用{{}},表达式和on-*来声称事件微处理机。

利用数据模型( data model)简化标志

行使数据模型来发出标志能够大大方方收缩你写标志的数量。在大家的案例里,全部的菜单条款和页面都得以选取后生可畏对<template repeat>成分来表现。

XHTML

<core-menu valueattr="hash" selected="{{route}}"> <template repeat="{{page in pages}}"> <paper-item hash="{{page.hash}}" noink> <core-icon icon="label-outline"></core-icon> <a href="#{{page.hash}}">{{page.name}}</a> </paper-item> </template> </core-menu> <core-animated-pages valueattr="hash" selected="{{route}}" transitions="slide-from-right"> <template repeat="{{page in pages}}"> <section hash="{{page.hash}}" layout vertical center-center> <div>{{page.name}}</div> </section> </template> </core-animated-pages>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<core-menu valueattr="hash" selected="{{route}}">
  <template repeat="{{page in pages}}">
    <paper-item hash="{{page.hash}}" noink>
      <core-icon icon="label-outline"></core-icon>
      <a href="#{{page.hash}}">{{page.name}}</a>
    </paper-item>
  </template>
</core-menu>
 
<core-animated-pages valueattr="hash" selected="{{route}}"
                     transitions="slide-from-right">
  <template repeat="{{page in pages}}">
    <section hash="{{page.hash}}" layout vertical center-center>
      <div>{{page.name}}</div>
    </section>
  </template>
</core-animated-pages>

下边包车型地铁标识由上边包车型地铁数据模型来驱动:

XHTML

<script> var template = document.querySelector('template[is="auto-binding"]'); template.pages = [ {name: 'Single', hash: 'one'}, {name: 'page', hash: 'two'}, {name: 'app', hash: 'three'}, ... ]; </script>

1
2
3
4
5
6
7
8
9
<script>
  var template = document.querySelector('template[is="auto-binding"]');
  template.pages = [
    {name: 'Single', hash: 'one'},
    {name: 'page', hash: 'two'},
    {name: 'app', hash: 'three'},
    ...
  ];
</script>

小心,<core-animated-pages>和<core-menu>通过绑定它们的selected属性来涉及在一起。以往,当客商点击一个导航条款时,页面会做出相应的立异。valueattr=”hash”设置告诉四个成分在各样条约里使用hash属性作为筛选的值。

XHTML

<!-- data-bind the menu selection with the page selection --> <core-menu valueattr="hash" selected="{{route}}"> ... <core-animated-pages valueattr="hash" selected="{{route}}">

1
2
3
4
<!-- data-bind the menu selection with the page selection -->
<core-menu valueattr="hash" selected="{{route}}">
...
<core-animated-pages valueattr="hash" selected="{{route}}">

展示

UGL450L路由(U瑞鹰L routing)和深层链接

<flatiron-director>是叁个包裹了flatiron director JS library(一个JS库)的web组件。改换它的route属性把U中华VL#号(U索罗德L hash)更新到均等的值。

当大家想在页面加载时保持上次的视图时,数据绑定再一次派上用项。把路由(director.js里的director)、菜单和页面成分连接起来并使它们一同。当三个更新时,其余的等同跟着更新。

XHTML

<flatiron-director route="{{route}}" autoHash> ... <core-menu selected="{{route}}"> ... <core-animated-pages selected="{{route}}">

1
2
3
4
5
<flatiron-director route="{{route}}" autoHash>
...
<core-menu selected="{{route}}">
...
<core-animated-pages selected="{{route}}">

深层链接-当模板策动好时,最早化路由。

XHTML

template.addEventListener('template-bound', function(e) { // Use URL hash for initial route. Otherwise, use the first page. this.route = this.route || DEFAULT_ROUTE; };

1
2
3
4
template.addEventListener('template-bound', function(e) {
// Use URL hash for initial route. Otherwise, use the first page.
this.route = this.route || DEFAULT_ROUTE;
};

其它路由库

即使您不希罕<flatiron-director>,能够推行<app-router>或者<more-routing>。它们都是能够完结更复杂成效的路由(通配符,HTML5历史API,动态内容)。笔者个人更爱好<flatiron-director>,因为它大约易用况兼能够和<core-animated-pages>很好地协作使用

例子: <more-routing>

XHTML

<more-route-switch> <template when-route="user"> <header>User {{params.userId}}</header> <template if="{{ route('user-bio').active }}"> All the details about {{params.userId}}. </template> </template> <template when-route="/about"> It's a routing demo! <a _href="{{ urlFor('user-bio', {userId: 1}) }}">Read about user 1</a>. </template> <template else> The index. </template> </more-route-switch>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<more-route-switch>
  <template when-route="user">
    <header>User {{params.userId}}</header>
    <template if="{{ route('user-bio').active }}">
      All the details about {{params.userId}}.
    </template>
  </template>
  <template when-route="/about">
    It's a routing demo!
    <a _href="{{ urlFor('user-bio', {userId: 1}) }}">Read about user 1</a>.
  </template>
  <template else>
    The index.
  </template>
</more-route-switch>

例子: <app-router>

XHTML

<app-route path="/home" import="/pages/home-page.html"></app-route> <app-route path="/customer/*" import="/pages/customer-page.html"></app-route> <app-route path="/order/:id" import="/pages/order-page.html"></app-route> <app-route path="*" import="/pages/not-found-page.html"></app-route>

1
2
3
4
<app-route path="/home" import="/pages/home-page.html"></app-route>
<app-route path="/customer/*" import="/pages/customer-page.html"></app-route>
<app-route path="/order/:id" import="/pages/order-page.html"></app-route>
<app-route path="*" import="/pages/not-found-page.html"></app-route>

键盘导航

键盘协助的基本点不止是为了便于的访问,它相像会使SPA客户刚到更开心。

<core-a11y-keys>是叁个尺度浏览器键盘事件的松手组件。它能够在你的使用里增添键盘扶助。这里有八个例子:

XHTML

<core-a11y-keys target="{{parentElement}}" keys="up down left right space space+shift" on-keys-pressed="{{keyHandler}}"></core-a11y-keys>

1
2
3
<core-a11y-keys target="{{parentElement}}"
keys="up down left right space space+shift"
on-keys-pressed="{{keyHandler}}"></core-a11y-keys>

注意

事件的target属性数据绑定到大家的自行绑定模块的parentElement属性。在这里个案例里,它是<body>元素。

key属性包蕴三个以空格分隔成分的列表,列表中蕴藏了要监听键位。当那几个组合的其中二个被按下,<core-a11y-keys>触发叁个keys-pressed事件并调用你的回调函数。

keys-pressed事件的微管理机使用<core-animated-pages>的selectNext/selectPrevious API去步向下生机勃勃页或许重回上风流倜傥页:

JavaScript

template.keyHandler = function(e, detail, sender) { var pages = document.querySelector('#pages'); switch (detail.key) { case 'left': case 'up': pages.selectPrevious(); break; case 'right': case 'down': pages.selectNext(); break; case 'space': detail.shift ? pages.selectPrevious() : pages.selectNext(); break; } };

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
template.keyHandler = function(e, detail, sender) {
  var pages = document.querySelector('#pages');
 
  switch (detail.key) {
    case 'left':
    case 'up':
      pages.selectPrevious();
      break;
    case 'right':
    case 'down':
      pages.selectNext();
      break;
    case 'space':
      detail.shift ? pages.selectPrevious() : pages.selectNext();
      break;
  }
};

按需加载内容

生龙活虎旦你想顾客在你的使用里导航时动态加载内容要如何做?只需一些改动,大家就可以援救动态加载页面。

率先,更新数据模型,使它含有内容的UENVISIONL:

JavaScript

template.pages = [ {name: 'Intro', hash: 'one', url: '/tutorial/intro.html'}, {name: 'Step 1', hash: 'two', url: '/tutorial/step-1.html'}, ... ];

1
2
3
4
5
template.pages = [
{name: 'Intro', hash: 'one', url: '/tutorial/intro.html'},
{name: 'Step 1', hash: 'two', url: '/tutorial/step-1.html'},
...
];

然后改变菜单链接指向page.url并不是#:

XHTML

<paper-item hash="{{page.hash}}" noink> <a href="{{page.url}}">{{page.name}}</a> </paper-item>

1
2
3
<paper-item hash="{{page.hash}}" noink>
<a href="{{page.url}}">{{page.name}}</a>
</paper-item>

最后,使用大家的<core-ajax>好朋友来获取内容:

XHTML

<core-ajax id="ajax" auto url="{{selectedPage.page.url}}" handleAs="document" on-core-response="{{onResponse}}"> </core-ajax>

1
2
3
<core-ajax id="ajax" auto url="{{selectedPage.page.url}}"
handleAs="document" on-core-response="{{onResponse}}">
</core-ajax>

您能够把<core-ajax>看作是一个内容调整器。它的url属性数据绑定到selectedPage.page.url。那意味着,无论什么样时候多个新的菜系条约被入选,XHCRUISER(XMLHttpRequest的缩写,译者注卡塔尔(قطر‎就能去得到相应的页面。当core-response触发时,onResponse就能够把文书档案重回的风华正茂有的插入预先保留的器皿里。

JavaScript

template.onResponse = function(e, detail, sender) { var article = detail.response.querySelector('scroll-area article'); var pages = document.querySelector('#pages'); this.injectBoundHTML(article.innerHTML, pages.selectedItem.firstElementChild); };

1
2
3
4
5
6
7
template.onResponse = function(e, detail, sender) {
  var article = detail.response.querySelector('scroll-area article');
 
  var pages = document.querySelector('#pages');
  this.injectBoundHTML(article.innerHTML,
                       pages.selectedItem.firstElementChild);
};

AJAX实例演示

润饰和告竣

此处有部分小工夫和秘籍你可以用来修正您的选择。

当三个菜单条款被接受后,关闭应用的抽屉菜单(drawer):

JavaScript

<core-menu ... on-core-select="{{menuItemSelected}}">

1
<core-menu ... on-core-select="{{menuItemSelected}}">

JavaScript

template.menuItemSelected = function(e, detail, sender) { if (detail.isSelected) { scaffold.closeDrawer(); } };

1
2
3
4
5
template.menuItemSelected = function(e, detail, sender) {
  if (detail.isSelected) {
    scaffold.closeDrawer();
  }
};

为导航接纳条目款项设置分化的Logo:

XHTML

<paper-item noink> <ore-icon icon="label{{route != page.hash ? '-outline' : ''}}"></core-icon> <core-animated-pages ... on-tap="{{cyclePages}}">

1
2
3
<paper-item noink>
  &lt;ore-icon icon="label{{route != page.hash ? '-outline' : ''}}">&lt;/core-icon>
<core-animated-pages ... on-tap="{{cyclePages}}">

JavaScript

template.cyclePages = function(e, detail, sender) { // If click was on a link, navigate and don't cycle page. if (e.path[0].localName == 'a') { return; } e.shiftKey ? sender.selectPrevious(true) : sender.selectNext(true); };

1
2
3
4
5
6
7
8
template.cyclePages = function(e, detail, sender) {
  // If click was on a link, navigate and don't cycle page.
  if (e.path[0].localName == 'a') {
    return;
  }
  e.shiftKey ? sender.selectPrevious(true) :
               sender.selectNext(true);
};

结束语

前段时间,你应当精通使用Polymer和web组件构建的单页应用的主干构架了。那可能和营造守旧的运用有所分裂,但总之,组件让事情变得轻便多了。当你重用(宗旨)组件和采纳Polymer的多少绑定本性时,你能够写更加少的CSS/JS。能够写更加少的代码的以为到真好!

赞 收藏 评论

有关小编:周进林

图片 2

茫茫大海中的风姿罗曼蒂克枚技士,为了发展为二个男神人类而拼命着。关心java、python、linux、vim等(博客园和讯:@酒肉和尚--进林) 个人主页 · 小编的篇章 · 20 ·  

图片 3