abstract class Polymer

Forces polymer to register any pending elements. Can be used to abort waiting for elements that are partially defined.

Loads an HTMLImport for each url specified in the urls array. Notifies when all the imports have loaded by calling the callback function argument. This method can be used to lazily load imports. For example, For example,…

Loads the set of HTMLImports contained in node. Returns a future that resolves when all the imports have been loaded. This method can be used to lazily load imports. For example, given a template:…

Deprecated: Use import instead.

Like document.register but for Polymer elements.…

Register a custom element that has no associated <polymer-element>. Unlike register this will always perform synchronous registration and by the time this method returns the element will be available using document.createElement or by modifying the HTML to include the element.

Attach event listeners on the host (this) element.

Invokes a function asynchronously. The context of the callback function is function is bound to 'this' automatically. Returns a handle which may be passed to cancelAsync to cancel the asynchronous call.…

Fire an event asynchronously. See async and fire.

Invokes a function asynchronously. This will call Polymer.flush() and then return a new Timer with the provided method and timeout.…

Called at detached time to signal that an element's bindings should be cleaned up. This is done asynchronously so that users have the chance to call cancelUnbindAll to prevent unbinding.

Called by the DOM when this element has been inserted into the live document.…

Called by the DOM whenever an attribute on this has been changed.

If attribute name is mapped to a property, deserialize value into that property.

Called by TemplateBinding/NodeBind to setup a binding to the given property. It's overridden here to support property bindings in addition to attribute bindings that are supported by default.

Called by TemplateBinding when all bindings on an element have been executed. This signals that all element inputs have been gathered and it's safe to ready the element, create shadow-root and start data-observation.

Bind the name property in this element to bindable. Note in Dart it is necessary to also define the field:…

Cancel an operation scheduled by async.

/ Call in detached to prevent the element from unbinding when it is / detached from the dom. The element is unbound as a cleanup step that / allows its memory to be reclaimed. If cancelUnbindAll is used, consider calling unbindAll when the element is no longer needed. This will allow its memory to be reclaimed.

Remove className from old, add class to anew, if they exist.

Creates a CompoundObserver to observe property changes. NOTE, this is only done if there are any properties in the _observe object.

Force any pending property changes to synchronously deliver to handlers specified in the observe object. Note: normally changes are processed at microtask time.

Convert representation of value based on type and currentValue.

Called by the DOM when this element has been removed from the live document.…

Calls methodOrCallback with args if it is a closure, otherwise, treat it as a method name in object, and invoke it.

Implement to access custom elements in dom descendants, ancestors, or siblings. Because custom elements upgrade in document order, elements accessed in ready or attached may not be upgraded. When domReady is called, all registered custom elements are guaranteed to have been upgraded.

Given a <polymer-element>, find an associated template (if any) to be used for shadow-root generation.…

Fire a CustomEvent targeting onNode, or this if onNode is not supplied. Returns the new event.

Deprecated use shadowRoots instead.

Inject HTML which contains markup bound to this element into a target element (replacing target element content).

Installs external stylesheets and <style> elements with the attribute polymer-scope='controller' into the scope of element. This is intended to be called during custom element construction.

Creates the document fragment to use for each instance of the custom element, given the <template> node. By default this is equivalent to:…

Call methodName method on this object with args.

Utility function that stamps a <template> into light-dom.

Deprecated: This is no longer a public method.

Locate nodes with id and store references to them in $ hash.

Handler for property changes; routes changes to observing methods. Note: array valued properties are observed for array splices.

Returns a future when node changes, or when its children or subtree changes.…

Start observing property changes.

Perform init-time actions based on static information in the <polymer-element> instance argument.…

Walks the prototype-chain of this element and allows specific classes a chance to process static declarations.…

If this class is used as a mixin, this method must be called from inside of the created() constructor.…

Return the published property matching name, or null.

Helper to implement a property with the given name. This is used for normal and computed properties. Normal properties can provide the initial value using the initialValue function. Computed properties ignore initialValue, their value is derived from the expression in the ComputedProperty annotation that appears above the getter that uses this helper.

Lifecycle method called when the element has populated it's shadowRoot, prepared data-observation, and made itself ready for API interaction. To wait until the element has been attached to the default view, use attached or domReady.

Bookkeeping observers for memory management.

Invoke callback in wait, unless the job is re-registered, which resets the timer. If wait is not supplied, this will use window.requestAnimationFrame instead of a Timer.…

Utility function that creates a shadow root from a <template>.…

This method should rarely be used and only if cancelUnbindAll has been called to prevent element unbinding. In this case, the element's bindings will not be automatically cleaned up and it cannot be garbage collected by by the system. If memory pressure is a concern or a large amount of elements need to be managed in this way, unbindAll can be called to deactivate the element's bindings and allow its memory to be reclaimed.

Helper to implement a setter of a property with the given name on a polymer element. This can be used on normal properties and also on computed properties, as long as the expression used for the computed property is assignable (see ComputedProperty).