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

{% comment %}

download this version or see the full list of changes.

Changes

Features

{% endcomment %}

See the full list of changes.

See the full list of changes.

See the full list of changes.

See the full list of changes.

See the full list of changes.

See the full list of changes.

See the full list of changes.

See the full list of changes.

See the full list of changes.

See the full list of changes.

See the full list of changes.

download this version or see the full list of changes.

Note: This was a hotfix release to fix a problem in Chrome 28 where document.createElement('nav', undefined) result returns undefined.

download this version or see the full list of changes.

"MDV" has been broken up into several new repositories to sepearate out the prollyfills from the {{site.project_title}} pieces. New repos:

• polymer-expressions - {{site.project_title}}'s template binding syntax.
• NodeBind - prollyfill for Node.bind()
• TemplateBinding - prollyfill for Template Bindings.
• observe-js - library for observing Arrays, Objects, and PathValues

Changes

• {{site.project_title}}'s Loader has been renamed to PolymerLoader in preparation for ES6 Modules (commit)

Features

• created() replaces the ready() lifecycle callback in the Polymer() constructor. ready() is still supported for backwards compatibility (commit)
• <polymer-element noscript> is back (commit). See registering an element.

• <polymer-anchor-position> -> <polymer-anchor-point> (commit)
• <polymer-signals> now bubbles on-* events properly (commit)

• Added WIP <polymer-ui-breadcrumbs> (commit)
• Fixed #12 - <polymer-ui-accordion multi> overreacts to click events
• <polymer-ui-overlay> allows override z-index (commit)

• noscript works etter with the polyfill (commit)
• Support type-extension form of document.createElement() (commit)
• HTMLELementElement implementation was removed as per spec removal (commit)

• Attribute dirtying is now smarter (commit)

download this version or see the full list of changes.

Features

• Native Custom Elements are on by default if they're feature detected. Enable them in Chrome Canary under about:flags.

Changes

• ?register flag now forces Custom Elements polyfill. It used to turn the native API on (commit)

• polymer.min.js builds now have a @version string in the file (commit)
• Fixed #230 - events on distributed nodes aren't bubbled to parent nodes under Shadow DOM polyfill.
• Extended elements fully register before their extendees do (commit)
• HTMLImports polyfill defers processing of <polymer-element>s until HTMLImportsLoaded is fired (commit)

• <polymer-grid> supports external items (commit)
• Re-factoring (commit) and fixes (commit) for using <polymer-overlay> under the polyfills.

• Added <polymer-ui-arrow> (commit)
• Added <polymer-ui-dialog> demos that use native <dialog> (commit)
• <polymer-ui-overlay> got an optional backdrop (commit)

• Added Template.clear() for unrolling bindings (commit)
• Path in bind(name, model, path) is now optional and defaults to empty string (commit)
• createBinding() has been removed (commit)
• Support empty if (commit)

• Add support for document.documentElement.appendChild (commit)
• Lifecycle callbacks, document.register(), Range, and the .form property have been wrapped and properly work under the polyfill now (commit, commit, commit, commit)

download this version or see the full list of changes.

Changes

• Auto-registrationn of <polymer-element>s (e.g. not needing <script>Polymer()</script>) has been temporarily removed due to timing issue with the way native Custom Elements (will) work.

Features

• Changes to bound property values now reflected back out to the HTML attribute. Note, properties that are objects are not reflected back. Fixes #188.
• Experimental support for native Custom Elements using document.register(). Enable in about:flags) and use the ?register flag.
• Custom element entered/leftDocument() callbacks are not supported. inserted/removed are still supoorted for backwards compatibility (commit)

• Using Polymer.register() now throws a deprecation warning (commit)
• Improved IE10 compatibility (commit, commit)

• Added <polymer-grid-layout> (commit)
• Added <polymer-shared-lib>, element for loading libraries (commit)
• Added <polymer-flex-panel>, a flexbox container (commit)
• Added overlay animations to <polymer-overlay> ([commit](https://github.com/Polymer/polymer- elements/commit/c88b9b3edc4cfda068ebd9387ad50bc000915dbc))
• Begins of <polymer-list> (commit)
• Better multi-selection support in <polymer-selector> (commit)
• <polymer-meta> now allows for different types of data (commit)

• Added <polymer-ui-menu-button>, a button which can have menu-items inside it that appears in an overlay menu when the button is selected (commit)
• Added <polymer-ui-overlay> (commit)
• Added another version of <polymer-ui-overlay> that uses <dialog> polyfill (commit)
• Renamed <polymer-ui-list-item> to <polymer-ui-field> (commit)

• Added <google-map> (commit)

• Ensure ShadowRoots have .host and .olderShadowRoot properties (commit)
• The polling handler {{site.project_title}} uses in MDV (when Object.observe() is not available) has been exposed (commit)

• Native Custom Elements are opt-in via ?register flag.
• Custom Elements observation now handles .olderShadowRoots (commit)

• Add .detail to tap gesture. Gives click count. (commit)

• Move .olderShadowRoot to ShadowRoot (commit)
• Fixed issue with .previousElementSibling (commit)

See the full list of changes.

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.

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

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

• Script execution is more specific to JS (commit)

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

• 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)

• 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)

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

• 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)

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

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.

• 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.

• 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.

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)

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)

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)

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)

See the full list of changes.

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

• Added <polymer-meta> for storing metadata (commit)

• Added <polymer-ui-ratings> (commit)

• Added <polymer-ui-toggle-button> (commit)

• Added <polymer-ui-tabs> (commit)

• Initial work on Polymer Elements Playground

• Added port of Memory Game

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

See the full list of changes.

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)

• 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)

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

See the full list of changes.

• Correct event type for checkbox bindings (commit)

• Only enable cache busting in debug mode (commit)

• Fixed #151 - HTMLLegendElement issue in FF21.

• Fix for <button> in IE (commit)

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

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

See the full list of changes.

• Project has a build status at http://build.chromium.org/p/client.toolkit/waterfall and tests are being run on Browserstack (commit)

• Base example components were removed and separated into their own toolkit-ui repo, while the toolkit-elements repo contains non-visual elements.

• A sandbox tool was added to projects.

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)

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)

See the full list of changes

• HTMLImports.getDocumentUrl() added (commit)

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

• Caching is configurable with .cache [commit)

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)

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)

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)

• 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.

• The constructor attribute is now supported (commit)

• 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)

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.

• 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.

• 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.

• 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)

• 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.