com.github.fluorumlabs.disconnect.polymer.mixins.HasDisableUpgradeMixin Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of disconnect-polymer Show documentation

Polymer 3 bindings for Disconnect Zero

There is a newer version: 0.1.0-alpha2

package com.github.fluorumlabs.disconnect.polymer.mixins;

import com.github.fluorumlabs.disconnect.polymer.elements.mixins.DisableUpgradeMixin;
import com.github.fluorumlabs.disconnect.zero.component.Component;

/**
 * Element class mixin that allows the element to boot up in a non-enabled state when the disable-upgrade
 * attribute is present. This mixin is designed to be used with element classes like PolymerElement that perform initial
 * startup work when they are first connected. When the
 * disable-upgrade attribute is removed, if the element is connected, it
 * boots up and "enables" as it otherwise would; if it is not connected, the element boots up when it is next
 * connected.
 * 
 * Using disable-upgrade with PolymerElement prevents any data propagation to the element, any element DOM
 * from stamping, or any work done in connected/disconnctedCallback from occuring, but it does not prevent work done in
 * the element constructor.
 * 

 * Note, this mixin must be applied on top of any element class that itself implements a connectedCallback
 * so that it can control the work done in connectedCallback. For example,
 *
 * 
MyClass = DisableUpgradeMixin(class extends BaseClass {...});
 * 
 *
 * @param  the type parameter
 * @param  the type parameter
 */
public interface HasDisableUpgradeMixin>
		extends HasElementMixin {
}