UIML Revised Specification, Working Document

Following is the existing Revised UIML Specification, Working Draft 3.1, 11 March 2004. Initial contents are taken from this version in order to start with a well defined version.

The existing specification has been entered her until 2006-07-13 14:17 GMT. So every change therafter will be a modification of the original one.

Content

Preamble

1. Introduction_to_UIML_3

   • 1.1 UIML,_an_Open_Specification
     1.2 Relationship_of_UIML_to_XML,_XSL,_XForms,_and_CSS
     1.3 Purpose_of_This_Document
     1.4 Terminology
     1.5 Note_about_Harmonia,_Inc._Rendering_Engines
     

2. Structure_of_a_UIML_Document

   • 2.1 Overview_on_UIML
     

     • 2.1.1 Dynamic_Interfaces_Through_a_Virtual_UI_Tree
       2.1.2 Interface_Behavior
       2.1.3 Philosophy_Behind_UIML’s_Tags
       2.1.4 First_UIML_Example:_Hello_World
       

     2.2 UIML_Document_Structure
     

     • 2.2.1 Second_UIML_Example
       

     2.3 UIML_Namespace
     2.4 UIML_Mime_Type
     

3. Table_of_UIML_Elements

4. The_<uiml>_and_<head>_Elements

   • 4.1 The_<uiml>_Element
     4.2 The_<head>_Element
     

     • 4.2.1 The_<meta>_Element
       

5. Interface_Description

   • 5.1 Overview_of_<interface>
     5.2 Attributes_Common_to_Multiple_Elements
     

     • 5.2.1 The_id_and_class_Attributes
       5.2.2 The_source_and_how_Attributes
       5.2.3 The_export_Attributes
       

     5.3 The_<interface>_Element Added template-parameters and layout as child
     5.4 The_<structure>_Element Added template-parameters as child
     

     • 5.4.1 Dynamic_Structure
       5.4.2 The_<part>_Element Added variable, layout and template-parameters as child plus explanations
       

     5.5 The_<style>_Element Added template-parameters as child
     

     • 5.5.1 The_<property>_Element Added variable and template-parameters as child
       

       • 5.5.1.1 Where_Property_Names_Are_Defined
         5.5.1.2 Semantics_of_<property>_Element
         5.5.1.3 Legal_Values_for_<property>_Elements
         5.5.1.4 Using_event-class_with_<property>_Elements
         5.5.1.5 Resolving_Conflicting_Property_Values
         

       5.5.2 Using_Properties_to_Achieve_Platform_Independence
       

       • 5.5.2.1 Rules_to_Assign_rendering_Property
         

     5.6 The_<layout>_Element New
     

     • 5.6.1 The_<constraint_Element New
       5.6.2 The_<rule_Element New
       5.6.3 The_<alias>_Element New
       

     5.7 The_<content>_Element
     

     • 5.7.1 The_<constant>_Element Added template-parameters as child
       5.7.2 The_<reference>_Element
       

     5.8 The_<behavior>_Element Added variable and template-parameters as child plus explanations
     

     • 5.8.1 Examples_of_<behavior>,_<_rule>,_<condition>,_and_<action>_Elements
       5.8.2 The_<rule>_Element Added template-parameters as child
       5.8.3 The_<condition>_Element
       5.8.4 The_<equal>_Element Deprecated!
       5.8.5 The_<event>_Element Added property as child and defined a way to set properties on fired events
       

       • 5.8.5.1 Exceptions_as_Events
         5.8.5.2 Extracting_Data_from_Events REMOVED: Merged with 5.8.5
         5.8.5.3 Special_Events
         

       5.8.6 The_<op>_Element Added variable as child
       

       • 5.8.6.1 Semantics_of_<op> Arithmetic operations plus small example added
         5.8.6.2 Resolution_of_Conditional_Statements
         

       5.8.7 The_<action>_Element Added variable as child
       5.8.8 The_<call>_Element Updated to replace name with component-id and method-id
       

       • 5.8.8.1 Overview_on_<call>
         5.8.8.2 Invocation_via_Direct_Specification
         5.8.8.3 Method_Parameters_and_Return_Values_Types
         5.8.8.4 Invoking_Methods_Upon_External_Objects_in_RMI,_CORBA,_LDAP,_and_EJB
         

       5.8.9 The_<repeat>_Element Added variable as child plus explanations
       5.8.10 The_<iterator>_Element Added variable as child plus explanations
       

       • 5.8.10.1 Using_<iterator>_in_<property>_and_<param>

       5.8.11 The_<restructure>_Element Added template-parameters as child
       

       • 5.8.11.1 Syntax_of_<restructure>
         5.8.11.2 Semantics_of_<restructure>
         5.8.11.3 Examples_of_<restructure>
         

       5.8.12 The_<when-true>_Element
       5.8.13 The_<when-false>_Element
       5.8.14 The_<by-default>_Element
       5.8.15 The_<param>_Element Added variable as child
       

     5.9 The_<variable>_Element New Added template-parameters as child
     

     • 5.9.1 Definition_of_variables New
       5.9.2 Scoping_and_lifetime New
       5.9.3 Examples_with_variables New
       

6. Peer_Components

   • 6.1 The_<peers>_Element Added template-parameters and alias as child
     6.2 The_<presentation>_Element Added template-parameters as child
     

     • 6.2.1 Naming_an_Existing_Vocabulary_in_<presentation>
       

       • 6.2.1.1 Labeling_Base_Vocabularies_with_Attribute_base
         6.2.1.2 Labeling_Custom_Vocabularies_with_Attribute_source
         6.2.1.3 Permitted_Optimization_for_Rendering_Engine
         6.2.1.4 Multiple_Presentation_Elements
         6.2.1.5 Suggested_Use_of_Base_Attribute_in_Authoring_Tools
         

       6.2.2 Creating_a_New_Vocabulary_Using_<presentation>
       

       • 6.2.2.1 Defining_Legal_Part_Class_Names_Via_<d-class>
         6.2.2.2 Defining_Legal_Property_Names_for_<part>_Classes_via_<d-property>
         6.2.2.3 Defining_Legal_Events_and_Listeners_for_Part_Classes_Via_<d-class>
         6.2.2.4 Defining_Legal_Event_Property_Names_Via_<d-class>
         

       6.3 The_<logic>_Element Added template-parameters as child
       6.4 Subelements of <presentation> and <logic>
       

       • 6.4.1 The_<d-component>_Element Added template-parameters as child
         6.4.2 The_<d-class>_Element Added template-parameters as child
         6.4.3 The_<d-property>_Element
         6.4.4 The_<d-method>_Element
         6.4.5 The_<d-param>_Element Added a mechanism to enumerate valid values of the param
         6.4.6 The_<script>_Element Added template-parameters as child
         

7. Reusable_Interface_Components Changed
   

   • 7.1 Templates_Specification New
     

     • 7.1.1 The_<template>_Element Changed and moved from 7.1, added d-template-parameters element and layout
       7.1.2 The_Placeholder New
       7.1.3 The_<d-template-parameters>_Element New
       7.1.4 The_<d-template-param>_Element New
       

     7.2 Rules_for_Templates Comment from Robbie: Possible merger with section 7.1.2?
     

     • 7.2.1 Combine_Using_Replace Comment from Robbie: Possible merger with section 7.1.2?
       7.2.2 Combine_Using_Union Comment from Robbie: Possible merger with section 7.1.2?
       7.2.3 Combine_Using_Cascade Comment from Robbie: Possible merger with section 7.1.2?
       

     7.3 Practical_use_of_templates New
     7.4 Template Parametrization New
     

     • 7.4.1 Motivation_for_Template_Parametrization New
       7.4.2 Parametrized_Elements New
       7.4.3 Syntax_for_Template_Parametrization New
       

       • 7.4.3.1 The_<template-parameters>_Element New
         7.4.3.2 The_<template-param>_Element New
         

       7.4.4 Syntax_Refinements New Comment from Robbie: TC should decide which refinements should go in the spec since now 7.4.4 seems to be optional...
       

       • 7.4.4.1 Identifier_list New
         7.4.4.2 Reserved_names_with_dollar_signs New
         

       7.4.5 Extension_of_the_parametrization_technique New
       

     7.6 Multiple_Inclusions Comment from Robbie: Template experts should look what has to remain here
     7.7 The_export_Attribute Comment from Robbie: Template experts should look what has to remain here
     

8. Alternative_Organizations_of_a_UIML_Document

   • 8.1 Normal_XML_Mechanism
     8.2 UIML_Template_Mechanism
     

References
Appendix A UIML_3.0_Document_Type_Definition
Appendix B Behavior_Rule_Selection_Algorithm
Appendix C Changes_from_UIML_2.0a_Specification_(1/17/2001)
Appendix D Previous_versions
Appendix E Notices