Skip to content

Latest commit

 

History

History
469 lines (282 loc) · 27.6 KB

changelog.md

File metadata and controls

469 lines (282 loc) · 27.6 KB
layout title
default
Changelog

This document lists the notable changes across the entirety of the project, including polyfill repos, tools, projects, and UI elements.

2013-07-11 {#2013-07-11}

See the full list of changes.

{{site.project_title}}

General

All hail <polymer-element>!

Declaring elements is now <polymer-element name="tag-name"> (was <element name="tag-name">). Elements are now auto registered, so a script tag is no longer required:

<polymer-element name="tag-name">
  <template>...</template>
</polymer-element>

Features

More complex elements are registered with Polymer('tag-name', {prototype}) (was Polymer.register(this, {prototype})). This allows for more flexible script decoupling:

  1. <script src> works now
  2. <script> can come before or inside the element, but not after

Changes

  1. Script scope is no longer special (e.g. this no longer refers to the element).
  2. Closures are not longer supported for private variables. Private vars should be done with the standard methods like anonymous self calling functions.

Core

  • `.resetStyleInheirtance' can now be defined on the element's prototype (commit)
  • Shadow DOM shhim styling has been moved into platform as ShadowCSS (commit)

Platform

  • Polyfill <template>/<element> styling not use !important. Fixes #191.
  • Add array() and forEach() to NodeList, NamedNodeMap, HTMLCollection (commit)

Custom Elements

  • Script execution is more specific to JS (commit)

HTML Imports

  • Scripts within <template> content are now executed. Fixes #22.
  • Non-JS script tags are no longer parsed (commit)

MDV

  • CompoundBindings have been sped up (commit, commit)
  • Binds have a more consistent API (commit)
  • Initial work on MDV benchmarking (commit)
  • Ensure getInstanceModel() is only called when a new instance will be created. Allows for the common case of inserting an instance via a DocumentFragment (commit)

Pointer Events

  • Use ES6 Map where available (commit)
  • allShadows() method added to find all shadow roots (commit)
  • Handle IE 11 use of string .pointerType (commit)
  • Don't override native PointerEvent (commit)
  • Use shadow.olderShadowRoot when possible. Fixes #81.
  • Touch will try to use touch-action or use the old MutationObserver method (commit)

Shadow DOM

  • Event.path always originates from the target (commit)
  • Fixed issue where FF24 doesn't support document.createEvent('FocusEvent') (commit)

Elements & Projects

polymer-elements

  • Added <polymer-overlay> (commit)
  • Added <polymer-key-helper> (commit)
  • Added <polymer-file> (commit)
  • Added <polymer-animation> elements (commit)
  • Added <polymer-media-query> (commit)
  • Added <polymer-selector> (commit)

polymer-ui-elements

  • Added <polymer-ui-accordian> (commit)
  • Added <polymer-ui-splitter> (commit)
  • Added responsive design to toolbar (commit)

2013-06-17 {#2013-06-17}

Notice: This release contains important changes to the structure of the project. {:.centered .alert .alert-info}

The repo structure was "flattened" such that platform and polymer repos no longer contain submodules. Instead, the dependencies need to be checked out as siblings. For example, platform now expects HTMLImports, CustomElements, PointerEvents, MDV, ShadowDOM, etc. to be siblings. polymer expects to be siblings with all of them. Unless you're working directly on {{site.project_title}}, it's safe to stick with polymer-all.

{{site.project_title}}

General

  • The Bower component has been updated to reflect this release.
  • {{site.project_title}}-based TodoMVC app (source) was published.
  • MDV Expression Syntax is on by default (commit). No changes are necessary for your current usage of templates. New features include support for inline math expressions, named scoping, and more. Read more.
  • To reduce memory leaks, elements created 1.) in JavaScript (e.g. document.createElement('x-foo')) and 2.) not in the DOM will lose their bindings, asynchronously. (commit)
    • If you want an element to remain active when it's not in the document (e.g. it keeps its MDV bindings and *Changed methods), you must call this.cancelUnbindAll() after it's been created or removed. The ready() callback is a good place for creation time.
    • If you call cancelUnbindAll() and never put the element back in the DOM, it is your responsibility to eventually call this.unbindAll()/asyncUnbindAll(). Otherwise, you will leak memory.

Core

  • Arrays and Objects are supported as attributes (commit)
  • Polyfill support for :scope instead of @host (commit)
  • Style are correctly applied to type extension custom elements (e.g. [is="x-foo"]) (commit)
  • The other lifecycle callbacks (inserted, removed, attributeChanged) can be setup in the Polymer.register() call in addition to ready. Note: these names are shorter than the spec's API.

Platform

Custom Elements

See the full list of changes.

  • Support non-enumerable properties defined on HTMLElement prototypes (commit)
  • Boostrap on DOMContentLoaded instead of window.load. Go immediately if document.readyState === 'complete' (commit)
  • .constructor references correct name defined in <element>'s contructor attribute (commit)
  • Update to new source map syntax (from //@ to //#) (commit)

HTML Imports

See the full list of changes.

  • Loading now kicks off immediately if document.readyState === 'complete' (commit)
  • Do not load external stylesheets that are not in <element>. Also support external stylesheets inside of <template> (commit)
  • Update to new source map syntax (from //@ to //#) (commit)

MDV

See the full list of changes.

  • Support binding to HTMLSelectElement.selectedIndex (commit)
  • HTMLTemplateElement.createInstance() now takes model & syntax string (e.g. template.createInstance(model, 'MDV')) (commit)
  • Implement two-way binding to HTMLTextArea.value (commit)
  • Named scopes are supported (e.g. {%raw%}<template repeat="{{item in items}}">{%endraw%}) (commit). Read more.
  • Implement MDV Syntax expressions (commit)
  • Allow <template if="{%raw%}{{expr}}{%endraw%}"> to be equivalent to <template bind if="{%raw%}{{expr}}{%endraw%}"> (commit)

Pointer Events

See the full list of changes.

  • Split mouse/touch/MS events into their own modules (commit)
  • Touches that fall off the screen are handled more gracefull (commit)

Shadow DOM

See the full list of changes.

  • Alias .createShadowRoot() to .webkitCreateShadowRoot() (commit)
  • Remove shadowRoot.insertionParent per spec (common)
  • Implement event.path (commit)

Elements & Projects

2013-06-05 {#2013-06-05}

{{site.project_title}}

See the full list of changes.

  • asend() is deprecated. Please use asyncFire() instead (commit)
  • asyncMethod() now uses requestAnimationFrame() if no timeout duration is given (commit)
  • Support was added for event.path (commit, commit)
  • Support for "{{site.project_title}}" custom MDV syntax (commit, commit, commit)
  • More explicit anti-FOUC prevention (commit)
  • Process of putting template content into shadowRoots was changed to prevent 404 requests (commit). Fixes #153

Platform

See the full list of changes.

HTML Imports

See the full list of changes.

  • Use DOMContentLoaded instead of window.onload to trigger importing (commit)
  • Added .status === 0 check for imports to work in Cordova and across file:// (commit)
  • Expose HTMLImports.xhr hook (commit)

Elements & Projects

polymer-elements

  • Added <polymer-page>element (commit)

  • Added <polymer-view-source-link> element (commit)

  • Added <polymer-localstorage> (commit)

  • Version of <polymer-layout> that uses CSS flexbox (commit)

  • Added <polymer-ui-sidebar-menu> (formerly known as ribbon) (commit)

  • Added <polymer-ui-icon> example file (commit)

  • Initial commit of Gallery (commit)

2013-05-15 {#2013-05-15}

This release mainly contained important platform fixes for IE and Firefox.

See the full list of changes.

Platform

Custom Elements

HTML Imports

MDV

  • Correct event type for checkbox bindings (commit)

HTML Imports

  • Only enable cache busting in debug mode (commit)

Shadow DOM

  • Fixed #151 - HTMLLegendElement issue in FF21.

Pointer Events/Gestures

  • Fix for <button> in IE (commit)

2013-05-13 {#2013-05-13}

Notice: This release contains important changes to the structure of the project. {:.centered .alert .alert-info}

Project renamed to Polymer! https://github.com/polymer

2013-05-09 {#2013-05-09}

{{site.project_title}}

See the full list of changes.

Elements and animations

  • New g-overlay element with web animations (commit) and g-tabspanel (commit)

  • Added g-fadein, g-fadeout animations (commit) and g-shake, a configurable shake animation (commit)

Features & bug fixes

  • Element registration now puts a .elementElement property on the prototpe to reference the <element> (commit)

  • pseudo-scoping now works on Firefox and IE where cssRule.selectorText is readonly (commit)

  • Attributes de-serialization is more predicable. For example, numbers are treated as numbers, srings as strings, dates as Date, etc. (commit, commit, commit)

  • MDV v3 is now turned on by default.

    • Added .unbind() and additional machinery for MDV bindings (commit)

    • MDV bindings are more comprehensive, with Node, Text, and <input> elements (commit)

  • Toolkit.getBinding(element, name) no longer generates an exception if element is null [commit)

Platform

Custom Elements

See the full list of changes.

  • Implement life cycle callbacks (inserted|removed|attributeChanged) using MutationObsevers. Note: you can no longer add lifecycle callbacks to a lifecycle object. They must be on the prototpye. (commit)

  • document.register() only triggers document-wide upgrade when called after initial load is complete (commit)

  • document.register() tests were updated to align with spec changes (commit)

  • Added support for native document.webkitRegister() (if available) (commit)

  • attributeChanged callback only fires when attribute has actually been modified (commit)

  • <style> elements are now (correctly) ignored if they're in the main document (commit)

HTML Imports

See the full list of changes

  • HTMLImports.getDocumentUrl() added (commit)

  • HTMLImports.readyTime added for primative timing data [commit)

  • Caching is configurable with .cache [commit)

MDV

See the full list of changes

  • Now using ChangeSummary v3 (commit)

  • Removed .effectiveContent API (commit)

  • Removed HTMLTemplateElement.bindTree in favor of template.model (commit)

  • Exposed HTMLTemplateElement.parseAndBind_ (commit)

  • Implemented .getInstanceModel for returning the model associated with a template (commit)

Pointer Events / Gestures

See the full list of changes here and here.

  • touch-action: user is an alias for touch-action: none (commit)

  • Fix pointercapture throws on IE10 (commit)

  • Expose .clientXY, .pageXY, .screenXY of track gestures. (commit)

Shadow DOM

See the full list of changes

  • Implemented .querySelector|All() and .getElementById() (commit, commit)

  • Implemented .elementFromPoint for document and ShadowRoot (commit)

  • Wrapped MutationRecord interface now that Blink has it. (commit)

  • document.write() is now overriden and wrapped in the polyfill (commit)

2013-04-17 {#2013-04-17}

Toolkit

  • If you're writing a Toolkit component, there's no longer need to include platform.js alongside toolkit.js. toolkit.js now loads platform.js under the hood.

Platform

CustomElements

  • The constructor attribute is now supported (commit)

HTML Imports

  • Fixed issue with imports loaded at the same url would not have the content associated with them (commit)

  • Polyfill now correctly checks for HTMLTemplateElement before using it (commit)

  • If HTMLTemplateElement.bootstrap is available, then bootstrap templates in imported documents. (commit)

2013-04-11 {#2013-04-11}

Notice: This release contains important changes to the structure of the project. {:.centered .alert .alert-info}

  • The toolkit repository now brings in the platform repository as a submodule.
  • Until now, the dev branch has been the development branch and master has been the stable release. Now, the stable branch is the default "stable" codebase. master branches are the in-development tip of tree. The stable branch is also the default view on Github.

Toolkit

  • g-component.html no longer exists as the Tookit kernel. It has been replaced with loading in toolkit.js instead.
  • Added debug runtime flags to conditionally load debug version of platform.js.

2013-02-25 {#2013-02-25}

Toolkit

  • Changed "toolkit/src" folder name to "toolkit/components". Update your source paths accordingly.

  • Introduced selectedClass property to g-selector component. (commit)

  • g-selector now sends an activate event which is fired whenever an item is activated (can occur when the currently selected item is activated). The select event is fired only when the selected item changes. (commit)

  • g-menu-button: the menu now closes in response to the selector's activate event (commit)

  • g-selection: selecting the same item is now a no-op (commit)

  • Added support for 2-way bindings on input elements (commit)

  • g-ajax: Response is bindable; params can be set as json or object.

  • g-panels: Added autoselect property that controls if keys/swipes can select panels; added canselect event to control if a panel can be selected.

Platform

  • Landed version 2 of the Shadow DOM shim. See the pull request for details.

  • ShadowRoot now installs shadow reference on node.webkitShadowRoot, as per spec. Fixes #68. (commit)

  • Loader: allow stylesheets and scripts in components defined in document. (commit)

Tools

  • Shadow DOM inspector Added a tool for inspecting Shadow DOM trees. You can invoke the tool via window.sinspect(node), where node is the element to start inspecting from. If not specified then it will use document.body.

To use the tool, open the JavaScript console and type sinspect().

Note: The tool opens in a pop-up window so you may have to unblock it.