Behavior Attachment

WORK IN PROGRESS

• element is DOM element.
• content is DOM content.
• document is HTML document

Comparison between the decorator and element behavior attachment.

	Decorator	Element
Purpose	Give existing content new behavior and/or appearance.	Create new content building blocks.
Paradigm	Aspect-Oriented Programming	Object-Oriented Programming
Compartmentalization and Reuse Vehicle	Aspect	Inheritance
Examples of Use	Add special UI treatment to all vcards in a document. Create an extension to provide extra download options for certain types of links.	Implement built-in HTML controls: input/textarea, media, etc. Define an element to represent a customizable calendar view. Define a button row control with application-specific grouping logic (see GMail button bars).
Identity	Does not change the identity of the element.	Creates a new type of element.
Lifetime	Transient, added and removed dynamically.	Permanent, originates with the element’s creation and exists through the lifetime.
Environment	Foreign document or limited control of content.	Full control of content.
Defining Traits	Unobtrusive Dynamic	Composable Interoperable
Shadow Tree	Each decorator must have its own shadow subtree, and the aggregate shadow tree of an element is composed out of these subtrees.	Only one tree, initialized as the element is created. Inherited shadow trees can be reused, nested in the element's tree.
DOM API	Should avoid adding any extra methods or properties to the DOM element that’s being decorated.	Explicitly interested in exposing methods or properties on the DOM element as its API.