Changed the QML Elements page groupings.

Task-number: QTBUG-16071
Reviewed-by: David Boddie

1 files changed, 156 insertions, 113 deletions

diff --git a/doc/src/declarative/elements.qdoc b/doc/src/declarative/elements.qdoc
index eaa6a82..698a277 100644
--- a/doc/src/declarative/elements.qdoc
+++ b/doc/src/declarative/elements.qdoc
@@ -29,118 +29,161 @@
   \page qdeclarativeelements.html
   \target elements
   \title QML Elements
-  \brief A dictionary of standard QML elements.
-
-  This is a dictionary of all standard QML elements made available
-  in the Qt Declarative module.
-
-  To see the QML elements listed by functional area, see the
-  \l{Groups Of Related QML Elements} page.
-
-	\table 
-	\header \o {2,1} \bold {Basic Visual Items}
-	\row \o \l {Item} \o Basic item element inherited by all visual items in QML
-	\row \o \l {Rectangle} \o Basic visual rectangle element
-	\row \o \l {Gradient} \o Defines a gradient between two or more colors
-	\row \o \l {GradientStop} \o Defines a color used in a \l {Gradient}
-	\row \o \l {Image} \o Allows the use of bitmaps to a scene
-	\row \o \l {BorderImage} (Item-specific) \o Defines an image as a border
-	\row \o \l {AnimatedImage} \o For playing animations stored as a series of frames
-	\row \o \l {Text} \o Allows the use of formatted text in a scene
-	\row \o \l {TextInput} \o Displays an editable line of text
-	\row \o \l {IntValidator} \o Validator for integer values
-	\row \o \l {DoubleValidator} \o Validator for non-integer values
-	\row \o \l {RegExpValidator} \o Validator for string regular expressions
-	\row \o \l {TextEdit} \o Displays multiple lines of editable formatted text
-
-	\header \o {2,1} \bold {Basic Interaction Items}
-	\row \o \l {MouseArea} \o Handles mouse interactions
-	\row \o \l {FocusScope} \o For keyboard focus handling 
-	\row \o \l {Flickable} \o Provides a surface that can be "flicked"  
-	\row \o \l {Flipable} \o Provides a surface that produces flipping effects
-	\row \o \l {GestureArea} (experimental) \o Enables simple gesture handling
-	 
-	\header \o {2,1} \bold {States}
-	\row \o \l {State} \o Defines sets of configurations of objects and properties
-	\row \o \l {PropertyChanges} \o Describes property changes within a state
-	\row \o \l {StateGroup} \o Contains a set of states and state transitions
-	\row \o \l {StateChangeScript} \o Allows script binding in a state
-	\row \o \l {ParentChange} (Item-specific) \o Re-parent an Item in a state change
-	\row \o \l {AnchorChanges} \o Change the anchors of an item in a state
-
-	\header \o {2,1} \bold {Animation and Transitions}
-	\row \o \l {Behavior} \o Specifies a default animation for property changes
-	\row \o \l {SequentialAnimation} \o Runs animations sequentially
-	\row \o \l {ParallelAnimation} \o Runs animations in parallel
-	\row \o \l {PropertyAnimation} \o Animates property changes
-	\row \o \l {NumberAnimation} \o Animates properties of type qreal
-	\row \o \l {Vector3dAnimation} \o Animates properties of type QVector3d
-	\row \o \l {ColorAnimation} \o Animates color changes
-	\row \o \l {RotationAnimation} \o Animates rotations
-	\row \o \l {ParentAnimation} \o Animates parent changes
-	\row \o \l {AnchorAnimation} \o Animates anchor changes
-	\row \o \l {PauseAnimation} \o Pauses an animation 
-	\row \o \l {SmoothedAnimation} \o Allows a property to smoothly track a value
-	\row \o \l {SpringAnimation} \o Allows a property to track a value in a spring-like motion
-	\row \o \l {PropertyAction} \o Sets immediate property changes during animation
-	\row \o \l {ScriptAction} \o Runs scripts during an animation
-	\row \o \l {Transition} \o Animates transitions during state changes
-
-	\header \o {2,1} \bold {Working with Data}
-	\row \o \l {Binding} \o Binds any value to any property
-	\row \o \l {ListModel} \o Defines a list of data
-	\row \o \l {ListElement} \o Defines a data item in a \l {ListModel}
-	\row \o \l {VisualItemModel} \o Contains items that already defines its own visual delegate
-	\row \o \l {VisualDataModel} \o Encapsulates a model and a delegate
-	\row \o \l {Package} \o Collection that enables sharing of items within different views
-	\row \o \l {XmlListModel} \o Specifies a model using XPath expressions 
-	\row \o \l {XmlRole}  \o Specifies a role for an \l {XmlListModel}
-
-	\header \o {2,1} \bold {Views}
-	\row \o \l {ListView} \o Provides a list visualization of a model
-	\row \o \l {GridView} \o Provides a grid visualization of a model
-	\row \o \l {PathView} \o Visualizes a model's contents along a path
-	\row \o \l {Path} \o Defines a path used by \l {PathView}
-	\row \o \l {PathLine}  \o Defines a line in \l {Path}
-	\row \o \l {PathQuad}  \o Defines a quadratic Bezier curve in a \l {Path}
-	\row \o \l {PathCubic}  \o Defines a cubic Bezier curve in a \l {Path}
-	\row \o \l {PathAttribute}  \o Allows the setting of attributes along a \l {Path}
-	\row \o \l {PathPercent}  \o Modifies the item distribution along a \l {Path}
-	\row \o \l {WebView} \o Allows the addition of web content to a canvas
-
-	\header \o {2,1} \bold {Positioners}
-	\row \o \l {Column} \o Arranges its children vertically
-	\row \o \l {Row} \o Arranges its children horizontally
-	\row \o \l {Grid} \o Positions its children in a grid
-	\row \o \l {Flow} \o Positions its children with wrapping support
-
-	\header \o {2,1} \bold {Utility}
-	\row \o \l {Connections} \o Explicitly connects signals and signal handlers
-	\row \o \l {Component} \o Encapsulate QML items as a component
-	\row \o \l {Timer} \o Provides timed triggers 
-	\row \o \l {QML:QtObject} {QtObject} \o Basic element containing only the objectName property
-	\row \o \l {QML:Qt} {Qt} \o The QML global Qt object provides useful enums and functions from Qt.
-	\row \o \l {WorkerScript} \o Enables the use of threads in QML
-	\row \o \l {Loader} \o Controls the loading of items or components
-	\row \o \l {Repeater} \o Uses a model to create multiples of components
-	\row \o \l {SystemPalette} \o Provides access to the Qt palettes
-	\row \o \l {FontLoader} \o Loads fonts by name or URL
-	\row \o \l {LayoutItem} \o Allows declarative UI elements inside Qt's Graphics View layouts 
-
-	\header \o {2,1} \bold {Transforms}
-	\row \o \l {Scale} \o Assigns item scaling behaviors
-	\row \o \l {Rotation} \o Assigns item rotation behaviors
-	\row \o \l {Translate} \o Assigns item translation behaviors
-
-	\header \o {2,1} \bold {Effects}
-	\row \o \l {Particles} (experimental) \o Generates and animates particles
-	\row \o \l {ParticleMotionLinear} \o Adds linear motion behavior to \l {Particles}
-	\row \o \l {ParticleMotionGravity} \o Adds gravitational motion to \l {Particles}
-	\row \o \l {ParticleMotionWander} \o Adds varied motions to \l {Particles}
-	\endtable
-	  
-  
-  
+  \brief A listing of standard QML elements.
+
+These are the functionally grouped lists of QML elements.
+
+Elements are declared with the their name and two curly braces. Elements may
+be nested in elements, thereby creating a parent-child relationship between the
+two elements.
+
+To see the QML elements listed by functional area, see the
+\l{Groups Of Related QML Elements} page.
+
+\section1 Basic QML Elements
+\list
+\o \l {Item} - Basic item element inherited by QML elements
+\o \l {Component} - Encapsulates QML elements during importing
+\o \l {QML:QtObject} {QtObject} - Basic element containing only the objectName property
+\endlist
+
+\section1 Graphics
+\list
+\o \l {Rectangle} - A rectangle element
+\o \l {Image} - For incorporating bitmaps into a scene
+\o \l {BorderImage} - Allows the use of images as borders
+\o \l {AnimatedImage} - For playing animations stored in a series of frames
+\o \l {Gradient} - For defining a color gradient
+\o \l {GradientStop} - Used to define a color within a \l {Gradient}
+\o \l {SystemPalette} - Provides access to the Qt palettes
+\endlist
+
+\section1 Text Handling
+\list
+\o \l {Text} - For inserting formatted text into a scene
+\o \l {TextInput} - Captures user key input
+\o \l {TextEdit} - Displays multiple lines of editable formatted text
+\o \l {IntValidator} - Validates values as integers
+\o \l {DoubleValidator} - Validates real values
+\o \l {RegExpValidator} - Validator for string regular expressions
+\o \l {FontLoader} - Loads fonts by name or URL
+\endlist
+
+\section1 Mouse and Interaction Area
+\list
+\o \l {MouseArea} - Sets up an area for mouse interaction
+\o \l {Keys} - Provides components with attached properties to handle key input.
+\o \l {FocusScope} - Element that mediate keyboard focus changes
+\o \l {Flickable} - Provides a surface that can be "flicked"
+\o \l {Flipable} - Provides a surface that produces "flipping" effects
+\o \l {GestureArea} - Enables simple gesture handling
+\endlist
+
+\section1 Positioners and Repeater
+\list
+\o \l {Column} - Arranges its children vertically
+\o \l {Row} - Arranges its children horizontally
+\o \l {Grid} - Positions its children in a grid
+\o \l {Flow} - Positions its children with wrapping support
+\o \l {Repeater} - Uses a model to create multiple components
+\endlist
+
+\section1 Transformations
+\list
+\o \l {Scale} - Assigns item scaling behaviors
+\o \l {Rotation} - Assigns item rotation behaviors
+\o \l {Translate} - Assigns item translation behaviors
+\endlist
+
+\section1 States
+\list
+\o \l {State} - Defines sets of configurations of objects and properties
+\o \l {PropertyChanges} - Describes property changes within a state
+\o \l {StateGroup} - Contains a set of states and state transitions
+\o \l {StateChangeScript} - Allows script binding in a state
+\o \l {ParentChange} - Re-parent an Item in a state change
+\o \l {AnchorChanges} - Change the anchors of an item in a state
+\endlist
+
+\section1 Animation and Transitions
+\list
+\o \l {Transition} - Animates transitions during state changes
+\o \l {SequentialAnimation} - Runs animations sequentially
+\o \l {ParallelAnimation} - Runs animations in parallel
+\o \l {Behavior} - Specifies a default animation for property changes
+\o \l {PropertyAction} - Sets immediate property changes during animation
+\o \l {PauseAnimation} - Introduces a pause in an animation
+\o \l {SmoothedAnimation} - Allows a property to smoothly track a value
+\o \l {SpringAnimation} - Allows a property to track a value in a spring-like motion
+\o \l {ScriptAction} - Runs scripts during an animation
+\endlist
+
+Elements that animate properties based on data types
+\list
+\o \l {PropertyAnimation} - Animates property changes
+\o \l {NumberAnimation} - Animates properties of type qreal
+\o \l {Vector3dAnimation} - Animates properties of type QVector3d
+\o \l {ColorAnimation} - Animates color changes
+\o \l {RotationAnimation} - Animates rotations
+\o \l {ParentAnimation} - Animates parent changes
+\o \l {AnchorAnimation} - Animates anchor changes
+\endlist
+
+\section1 Models and Data Handling
+\list
+\o \l {ListModel} - Defines a list of data
+\o \l {ListElement} - Defines a data item in a \l {ListModel}
+\o \l {VisualItemModel} - Contains items that already defines its own visual delegate
+\o \l {VisualDataModel} - Encapsulates a model and a delegate
+\o \l {XmlListModel} - Specifies a model using XPath expressions
+\o \l {XmlRole} - Specifies a role for an \l {XmlListModel}
+\o \l {Binding} - Binds any value to any property
+\o \l {Package} - Collection that enables sharing of items within different views
+\endlist
+
+\section1 Views
+\list
+\o \l {ListView} - Provides a list visualization of a model
+\o \l {GridView} - Provides a grid visualization of a model
+\o \l {PathView} - Visualizes a model's contents along a path. See \l {Path Definition}{Path Elements} for more information.
+\endlist
+
+\section1 Path Definition
+\list
+\o \l {Path} - Defines a path used by \l {PathView}
+\o \l {PathLine} - Defines a line in \l {Path}
+\o \l {PathQuad} - Defines a quadratic Bezier curve in a \l {Path}
+\o \l {PathCubic} - Defines a cubic Bezier curve in a \l {Path}
+\o \l {PathAttribute} - Allows the setting of attributes along a \l {Path}
+\o \l {PathPercent} - Modifies the item distribution along a \l {Path}
+\endlist
+
+\section1 Utility
+\list
+\o \l {Connections} - Explicitly connects signals and signal handlers
+\o \l {Timer} - Provides timed triggers
+\o \l {QML:Qt} {Qt} - The QML global Qt object provides useful enums and functions from Qt.
+\o \l {WorkerScript} - Enables the use of threads in QML
+\o \l {Loader} - Controls the loading of items or components
+\o \l {LayoutItem} - Allows declarative UI elements inside Qt's Graphics View layouts
+\endlist
+
+\section1 Graphical Effects
+\list
+\o \l {Particles} - Generates and animates particles
+\o \l {ParticleMotionLinear} - Adds linear motion behavior to \l {Particles}
+\o \l {ParticleMotionGravity} - Adds gravitational motion to \l {Particles}
+\o \l {ParticleMotionWander} - Adds varied motions to \l {Particles}
+\endlist
+
+\section1 Add-On Elements
+These elements are not included in the \c{QtQuick 1.0} module. Their respective QML bindings
+should first be obtained and installed.
+\list
+\o \l{WebView}{QtWebKit QML Module - WebView Element} - For displaying Web contents
+\o \l{http://doc.qt.nokia.com/qtmobility-1.1.0/qml-plugins.html}{Mobility QML Plugins}
+\endlist
+
 */
 
 
@@ -148,7 +191,7 @@
     \group qml-groups
     \title Groups Of Related QML Elements
 
-    \brief If you know what kind of QML element you want (Basic Visual, 
+    \brief If you know what kind of QML element you want (Basic Visual,
     Interaction, Animation, etc), look here.
 
     This is a list of functional groups of QML elements.