Changes between Version 6 and Version 7 of S3/S3SQLForm

Timestamp:

02/21/13 09:26:40 (13 years ago)

Author:

Dominic König

Comment:

--

S3/S3SQLForm

@@ -139 +139 @@
 
 Where multiple sub-forms for the same component (but with different filters) shall be embedded, they must each have a distinct "name" argument. Otherwise this argument is optional.
+
+=== Sorting of Inline-Components ====
+
+It is possible to sort the inline-items by specifying an {{{orderby}}} option:
+
+{{{
+    s3forms.S3SQLInlineComponent(
+        "location",
+        label = T("Countries"),
+        fields = ["location_id"],
+        orderby = "location_id$name"
+    ),
+}}}
+
+To specify the sort order, the {{{orderby}}}-option also accepts a tuple like: {{{("location_id$name", "desc")}}}.
+
+    '''Note:''' the field selector used in orderby must give exactly one value per row (i.e. use only forward-links, not component fields or list:types), otherwise the same component item would appear multiple times in the form (due to the left join involved).
 == Current Status ==