__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