View source for XForms 1.2 Modularization

__NOTOC__
== XForms 1.2 Modularization ==

=== Overview ===

* The ''' Data Layer ''' Specifications
** The ''' Data Island ''' Module
** The ''' Data Binding Attributes ''' Module
** The ''' Data Accessors ''' Module (setvalue, insert, delete)
* The ''' Submission ''' Module
* The ''' XPath Functions ''' Modules
* The ''' Model Layer ''' Specifications
** The ''' Model Container ''' Module
** The ''' Model Item Property Binding ''' Module
** The ''' Validation ''' Module (constraint, required, type, datatypes)
** The ''' XML Schema Validation ''' Module
** The ''' Relevant ''' Module
** The ''' Readonly ''' Module
** The ''' Calculate ''' Module
* The ''' User Interface Layer ''' Specifications
** The ''' Form Controls '''  module
** The ''' Input Form Controls ''' (input, textarea, select1, select, range, ...)
** The ''' Output Form Control ''' module
** The ''' trigger control ''' and ''' submit control ''' modules
** The ''' Container Form Controls ''' Modules (group, switch, repeat)
** The ''' Label ''', ''' Hint ''', ''' Help ''', ''' Alert ''', and ''' Message ''' Modules
* The ''' XForms ''' Module

=== More Detailed ===

* Specifications for ''' Data Layer '''
** The ''' Data Island ''' module - ''' Charlie '''
*** Create instance element that provides data separately from the document
*** instance element may have id attribute and may have child element
*** Function for getInstanceDocument()
*** Function for replaceInstanceDocument()
*** Function to load instance, which dispatches event data-instance-load, cancelable and bubbles, the default processing of which loads the instance.
*** Optional to implement src and resource attributes are added to the instance element
* The ''' [http://www.w3.org/MarkUp/Forms/specs/XForms1.2/modules/instance/bindingAttributes/index-all.html "Data Binding Attributes"] ''' module - ''' John '''
** Defines notion of inscope evaluation context
*** Current default for outermost SNB or NSB is  an instance data island, but should be defined generically so that consuming profile defines the root
* Create instance attribute with IDREF content to set starting instance, default to instance from starting inscope evaluation context
** Defines the Single Node Binding attribute group
** Defines the Nodeset Binding attribute group
** Put ref in SNB group
** Put nodeset in the NSB group
** Put context in SNB and NSB groups
** Add instance() function, included in the extension functions group
** Add two parameter id() function, included in the extension functions group
** Add context() function, included in the extension functions group
** This module needs to be able to answer the following questions:
*** What is the initial inscope eval context of this element?
*** What is the amended inscope eval context of this element?
*** What is the result of the SNB or NSB?
*** Was there an expresssed SNB or NSB (as opposed to the result being equal to the amended context)?
* The ''' Data Accessors ''' module - ''' Charlie '''
** Defines setvalue with SNB
** Defines insert with NSB
** Defines delete with NSB
** Defines xforms-insert and xforms-delete
*** Current default is an instance data island, but should be targeted at a location defined by the consuming profile
* Adds setvalue, insert, delete to Actions group
* The ''' submission ''' Module - ''' Uli and John '''
** Includes [[Need event for submission result received]] event
** xforms-submit, xforms-submit-done, xforms-submit-error, xforms-submit-serialize
** submission element and attributes
*** submission module attributes: Common, resource, action, mode, method, serialization, version, indent, mediatype, encoding, omit-xml-declaration, standalone, cdata-section-elements, separator, includenamespaceprefixes 
*** XForms driver module would define attributes ref, bind, validate, relevant, replace, target, instance
* submission module child elements: header, method, resource, Actions element group
** submission module: send action element, load action element
* Specifications for ''' XPath Functions ''' - ''' John '''
** Define an extension functions group, identify by a URI for purpose of unique naming only
** Define that a host language can optionally import the extension functions group into the XPath function library as NCName functions
** Data Integrity functions module, included in the extension functions group
** Date and Time functions module, included in the extension functions group
** Conditional functions module, included in the extension functions group
** Math functions module, included in the extension functions group
* The ''' Model Layer ''' Specifications
** [[Model module]] (model element, functions attr, model events, add @model to SNB and NSB bindings)
*** Defines model element as a container
*** Define model content group, initially to contain zero or more instances; other modules able to add to the model content group
*** The model provides scope limiting behavior to binding attributes and instance() function invocations in its subtree
*** Defer the @functions attribute because it seems to be the small part of the notion of mustunderstand, which has been removed
*** The property() function 
*** Adds @ model to SNB and NSB groups
*** Define the reset action and initial instance storage
*** Define a change list management facility (by listening for text data mutations, which may come from setvalue, calculate, or external DOM access)
* [[The bind Module]] ''' Nick '''
** Define the bind element
** Add bind element to model content group
** Add @bind to SNB and NSB attribute groups 
** Change from nodeset attr to Node Set Binding attributes
*** Note that this adds context attribute to the bind element, which is good
*** The context attribute changes context for other attributes but does not, in and of itself, change the node to which MIPS are applied (e.g. if no nodeset is expressed)
*** Note that a containing model restricts instance attribute to within itself
*** Note that a containing model restricts model attr to be itself
*** If a bind element has a bind attribute, then the bind element is ignored
* Define rebuild action and xforms-rebuild event for model element ''(if we move xforms-rebuild event to model module this allows us not to refer the model module (it can use the rebuild action ))''
** Need to define the generic MIP decoration mechanism
*** Allow attributes but also a child element called property
*** The property element should have name and calculable value attributes
*** For static property values, use property element content
*** ''Property is re-evaluated on when rebuild action is called''
* ''Appendix that shows how infoset contributions should be implemented when using DOM''
** [[The calculate Module]] (calculate) ''' John '''
*** Define recalculate action and xforms-recalculate event for model
*** Add master dependency graph notion to rebuild
*** Consumer of change list from model module
* [[The validation Module]] 
** Attributes constraint, required, type (for datatype only)
** [[The Core XForms Typelib Module]] (adds the 'must' datatypes in xsd and xforms namespaces)
** Define revalidate action and xforms-revalidate event for model element
* [[The XML Schema Validation Module]]
** schema attr on model
** inline schema
** xsi:type
** full schema validation
** ability to refer to schema-defined datatypes in type
* [[The relevant Module]] (relevant)
** [[The readonly Module]] (readonly)
*** This module needs to say that conformant implementations will not allow performing of mutations on readonly nodes (according to the rules XForms currently defines)
*** This affects getInstanceDocument() so that it returns a DOM whose methods respect non-mutability of readonly nodes
*** This affects the setvalue, insert and delete data accessors
*** This affects submission instance replacement
* [[The p3ptype Module]] (p3ptype) ''' MarkB and Paul '''
* The ''' User Interface Layer ''' specifications
** The [[Form Controls]] module
*** Defines the setfocus action
*** Define the refresh action and the xforms-refresh event for model elements
*** Define UI binding as extending from Single Node Binding to get behaviors of MIPs and notification events (xforms-valid, xforms-invalid, xforms-value-changed, etc.)
*** Consumer of change list from model module
*** This module allows custom form controls to use UI bindings 
* [[Input Form Controls module]] (input, textarea, select1, select, range, upload, ...)
** [[Output Form Control module]] - ''' Keith '''
** The [[trigger control]] module - ''' Keith '''
** The [[submit control]] module - ''' Keith '''
** Container Form Controls 
*** The group module
*** The switch module
**** Includes the toggle action
** The [[Repeat Module]] 
*** repeat element
*** setindex action
*** Augment definition of references and dependencies based on index changes
** The [[repeat attributes]] Module
** The [[Label]] module
** The [[Hint]] Module
** The [[Help]] Module
** The [[Alert]] Module
** The [[Message]] Module - ''' MarkB '''
* The ''' XForms ''' Module - ''' Steven '''
** Pull together various modules into a package
*** Data Instance module
*** XPath extension functions library module
*** Actions module based on XML Events 2
*** Data Accessors module
*** Binding attributes
*** The model and bind modules
*** calculate, relevant, readonly
*** Core validation module (constraint, required, type, core typelib)
*** XML Schema validation module
*** The submission module
*** The UI module, UI binding attributes module
*** The input controls module
*** The output module
*** The label module   
*** The container controls modules (group, switch and repeat modules)
*** The message, hint, help, and alert modules
* Provide composition-level semantics for the modules
** Define binding attributes context based on instances
** Ability to use NCNames to invoke functions of the XPath extensions library
** Add label as required to various input controls and optional on other form controls (e.g. trigger, output, group)
** Add help, hint, alert to various form controls
* Define driver-level processing model
** Define xforms-model-construct, xforms-model-construct-done, xforms-ready, xforms-model-destruct
* Based on XML Events 2 as Actions module
** XForms defines an enhanced evaluation context for if and while
* Deferred update concept contributed to Actions module