[isis] 02/02: ISIS-1786: updates doc for new configuration property

[da...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/isis.git

commit cc8a8495516c565f0134a8fd5aeb8a1e3500fe4e
Author: Dan Haywood <da...@haywood-associates.co.uk>
AuthorDate: Fri Dec 1 11:03:00 2017 +0000

    ISIS-1786: updates doc for new configuration property
---
 .../guides/rgcfg/_rgcfg_configuring-core.adoc      | 28 ++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_configuring-core.adoc b/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_configuring-core.adoc
index 7b3cf1e..14beaec 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_configuring-core.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_configuring-core.adoc
@@ -758,6 +758,16 @@ See xref:../ugbtb/ugbtb.adoc#_ugbtb_programming-model_layout-metadata-reader[Lay
 (`LEFT`)
 |Default for label position for all properties if not explicitly specified using xref:../rgant/rgant.adoc#_rgant-PropertyLayout_labelPosition[`@PropertyLayout#labelPosition()`]
 
+
+Further discussion xref:rgcfg.adoc#__rgcfg_configuring-core_isis-viewers-propertyLayout-labelPosition[below].
+
+|`isis.viewers.` +
+`collectionLayout.defaultView`
+|`hidden`, `table` +
+(`hidden`)
+|(`1.16.0-SNAPSHOT`) Default for the default view for all (parented) collections if not explicitly specified using xref:../rgant/rgant.adoc#_rgant-CollectionLayout_defaultView[`@CollectionLayout#defaultView()`]
+
+Further discussion xref:rgcfg.adoc#__rgcfg_configuring-core_isis-viewers-collectionLayout-defaultView[below].
 |===
 
 
@@ -846,3 +856,21 @@ isis.viewers.propertyLayout.labelPosition=LEFT
 
 If these are not present then Apache Isis will render according to internal defaults.
 At the time of writing, this means labels are to the left for all datatypes except multiline strings.
+
+
+[[__rgcfg_configuring-core_isis-viewers-collectionLayout-defaultView]]
+=== `collectionLayout.defaultView` (`1.16.0-SNAPSHOT`)
+
+Prior to `1.16.0-SNAPSHOT`, the framework renders (parented) collections as "hidden", ie collapsed.
+This can be overridden on a case-by-case basis using the xref:../rgant/rgant.adoc#_rgant-CollectionLayout_defaultView[`@CollectionLayout#defaultView()`] or the corresponding `<collectionLayout defaultView="...">` element in the `Xxx.layout.xml` layout file.
+The framework provices only one other view, "table".
+
+If the majority of collections should be displayed as "table" form, then it is more convenient to specify the default view globally.
+This can be done using a configuration property in `isis.properties`:
+
+[source,ini]
+----
+isis.viewers.collectionLayout.defaultView=table
+----
+
+If this configuration property is not present then Apache Isis will render according to its historical default, namely "hidden".

-- 
To stop receiving notification emails like this one, please contact
"commits@isis.apache.org" <co...@isis.apache.org>.