You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2017/04/28 09:53:40 UTC
[5/7] isis-site git commit: ISIS-1603: inline prompts
http://git-wip-us.apache.org/repos/asf/isis-site/blob/952d8154/content/guides/rgant/rgant.html
----------------------------------------------------------------------
diff --git a/content/guides/rgant/rgant.html b/content/guides/rgant/rgant.html
index 44fca97..182d980 100644
--- a/content/guides/rgant/rgant.html
+++ b/content/guides/rgant/rgant.html
@@ -3243,7 +3243,17 @@ WrapperFactory wrapperFactory;</code></pre>
</table>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -3357,7 +3367,17 @@ WrapperFactory wrapperFactory;</code></pre>
</table>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -3399,7 +3419,17 @@ WrapperFactory wrapperFactory;</code></pre>
<p>There can be multiple "fa-" classes, eg to mirror or rotate the icon. There is no need to include the mandatory <code>fa</code> "marker" CSS class; it will be automatically added to the list. The <code>fa-</code> prefix can also be omitted from the class names; it will be prepended to each if required.</p>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -3452,7 +3482,17 @@ WrapperFactory wrapperFactory;</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -3512,7 +3552,17 @@ WrapperFactory wrapperFactory;</code></pre>
<p>The other values of the <code>Where</code> enum have no meaning for a collection.</p>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -3566,7 +3616,17 @@ WrapperFactory wrapperFactory;</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -3677,7 +3737,17 @@ WrapperFactory wrapperFactory;</code></pre>
<p>If there are multiple actions associated with a single property then the positioning can be mix\u2019ed-and-match\u2019ed as required. If the <code>PANEL</code> or <code>PANEL_DROPDOWN</code> are used, then (as the screenshots above show) the actions from potentially multiple properties grouped by that panel will be shown together.</p>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -4492,7 +4562,17 @@ WrapperFactory wrapperFactory;</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -4526,7 +4606,17 @@ WrapperFactory wrapperFactory;</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -4575,7 +4665,17 @@ WrapperFactory wrapperFactory;</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -4646,7 +4746,17 @@ WrapperFactory wrapperFactory;</code></pre>
<p>The other values of the <code>Where</code> enum have no meaning for a collection.</p>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -4694,7 +4804,17 @@ WrapperFactory wrapperFactory;</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -4757,7 +4877,17 @@ WrapperFactory wrapperFactory;</code></pre>
<p>It is also possible to specify a global default for the page size of standalone collections, using the <a href="../rgcfg/rgcfg.html#_rgcfg_configuring-core">configuration property</a> <code>isis.viewer.paged.parented</code>.</p>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -4788,7 +4918,17 @@ WrapperFactory wrapperFactory;</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -4890,7 +5030,17 @@ WrapperFactory wrapperFactory;</code></pre>
<p>Without this annotation, the order would have been inverted (because the natural ordering places items not completed before those items that have been completed.</p>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -11198,6 +11348,16 @@ container.persist(cust);</code></pre>
</div></td>
</tr>
<tr>
+ <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgant/rgant.html#_rgant-PropertyLayout_promptStyle"><code>promptStyle()</code></a></p></td>
+ <td class="tableblock halign-left valign-top"><p class="tableblock"><code>DIALOG</code>, <code>INLINE</code>, <code>AS_CONFIGURED</code><br> (<code>AS_CONFIGURED</code>)</p></td>
+ <td class="tableblock halign-left valign-top">
+ <div>
+ <div class="paragraph">
+ <p>(<code>1.15.0-SNAPSHOT</code>) how a property prompt should be displayed within the UI</p>
+ </div>
+ </div></td>
+ </tr>
+ <tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="../rgant/rgant.html#_rgant-PropertyLayout_renderedAsDayBefore"><code>renderedAsDayBefore()</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>, <code>false</code><br> (<code>false</code>)</p></td>
<td class="tableblock halign-left valign-top">
@@ -11288,7 +11448,17 @@ container.persist(cust);</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -11317,7 +11487,17 @@ container.persist(cust);</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -11403,7 +11583,17 @@ container.persist(cust);</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -11475,7 +11665,17 @@ container.persist(cust);</code></pre>
<p>Here the <code>stepsToReproduce</code> will be displayed in a text area of 10 rows.</p>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -11538,7 +11738,17 @@ container.persist(cust);</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -11565,7 +11775,54 @@ container.persist(cust);</code></pre>
</div>
</div>
<div class="sect2">
- <h3 id="_rgant-PropertyLayout_renderedAsDayBefore">31.6. <code>renderedAsDayBefore()</code></h3>
+ <h3 id="_rgant-PropertyLayout_promptStyle">31.6. <code>promptStyle()</code> (<code>1.15.0-SNAPSHOT</code>)</h3>
+ <button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-PropertyLayout_promptStyle.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button>
+ <div class="paragraph">
+ <p>The <code>promptStyle()</code> attribute is used to specify whether, when editing a domain object property, the new value for the property is prompted by way of a dialog box, or is prompted using an inline panel (replacing the property on the page).</p>
+ </div>
+ <div class="paragraph">
+ <p>If the attribute is not set, then the value of the <a href="../rgcfg/rgcfg.html#_rgcfg_configuring-core">configuration property</a> <code>isis.objects.promptStyle</code> is used. If this is itself not set, then a dialog box is used.</p>
+ </div>
+ <div class="paragraph">
+ <p>For example:</p>
+ </div>
+ <div class="listingblock">
+ <div class="content">
+ <pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">Customer</span> {
+ <span class="annotation">@PropertyLayout</span>(
+ promptStyle=PromptStyle.INLINE <i class="conum" data-value="1"></i><b>(1)</b>
+ )
+ <span class="directive">public</span> <span class="type">int</span> getNotes(){ ... }
+ <span class="directive">public</span> <span class="type">void</span> setNotes(<span class="predefined-type">String</span> notes) { ... }
+}</code></pre>
+ </div>
+ </div>
+ <div class="colist arabic">
+ <table>
+ <tbody>
+ <tr>
+ <td><i class="conum" data-value="1"></i><b>1</b></td>
+ <td>prompt for the new value for the property using an inline panel</td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="paragraph">
+ <p>Alternatively, the <code>promptStyle()</code> can be specified using <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layouts</a>.</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - provide an example here </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ </div>
+ <div class="sect2">
+ <h3 id="_rgant-PropertyLayout_renderedAsDayBefore">31.7. <code>renderedAsDayBefore()</code></h3>
<button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-PropertyLayout_renderedAsDayBefore.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button>
<div class="paragraph">
<p>The <code>renderedAsDayBefore()</code> attribute applies only to date properties whereby the date will be rendered as the day before the value actually held in the domain object. It is ignored for properties of other types. This attribute is also supported for <a href="../rgant/rgant.html#_rgant-ParameterLayout_renderedAsDayBefore">parameters</a>.</p>
@@ -11597,7 +11854,17 @@ container.persist(cust);</code></pre>
</div>
</div>
<div class="paragraph">
- <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based"><code>.layout.json</code></a> can be used instead, eg:</p>
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - change to .layout.xml syntax instead. </td>
+ </tr>
+ </tbody>
+ </table>
</div>
<div class="listingblock">
<div class="content">
@@ -11610,7 +11877,7 @@ container.persist(cust);</code></pre>
</div>
</div>
<div class="sect2">
- <h3 id="_rgant-PropertyLayout_typicalLength">31.7. <code>typicalLength()</code></h3>
+ <h3 id="_rgant-PropertyLayout_typicalLength">31.8. <code>typicalLength()</code></h3>
<button type="button" class="button secondary" onclick="window.location.href="https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-PropertyLayout_typicalLength.adoc"" style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i class="fa fa-pencil-square-o"></i> Edit</button>
<div class="paragraph">
<p>The <code>typicalLength()</code> attribute indicates the typical length of a string property. It is ignored for properties of other types. The attribute is also supported for <a href="../rgant/rgant.html#_rgant-ParameterLayout_typicalLength">parameters</a>.</p>
@@ -11632,6 +11899,19 @@ container.persist(cust);</code></pre>
}</code></pre>
</div>
</div>
+ <div class="paragraph">
+ <p>As an alternative to using the annotation, the dynamic <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layout</a> can be used instead, eg:</p>
+ </div>
+ <div class="admonitionblock note">
+ <table>
+ <tbody>
+ <tr>
+ <td class="icon"> <i class="fa icon-note" title="Note"></i> </td>
+ <td class="content"> FIXME - provide a .layout.xml example here. </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
</div>
</div>
</div>
@@ -12599,8 +12879,9 @@ container.persist(cust);</code></pre>
<li><a href="#_rgant-PropertyLayout_labelPosition">31.3. <code>labelPosition()</code></a></li>
<li><a href="#_rgant-PropertyLayout_multiLine">31.4. <code>multiLine()</code></a></li>
<li><a href="#_rgant-PropertyLayout_named">31.5. named()</a></li>
- <li><a href="#_rgant-PropertyLayout_renderedAsDayBefore">31.6. <code>renderedAsDayBefore()</code></a></li>
- <li><a href="#_rgant-PropertyLayout_typicalLength">31.7. <code>typicalLength()</code></a></li>
+ <li><a href="#_rgant-PropertyLayout_promptStyle">31.6. <code>promptStyle()</code> (<code>1.15.0-SNAPSHOT</code>)</a></li>
+ <li><a href="#_rgant-PropertyLayout_renderedAsDayBefore">31.7. <code>renderedAsDayBefore()</code></a></li>
+ <li><a href="#_rgant-PropertyLayout_typicalLength">31.8. <code>typicalLength()</code></a></li>
</ul> </li>
<li><a href="#_rgant-RequestScoped">32. <code>@RequestScoped</code> (<code>javax</code>)</a></li>
<li><a href="#_rgant-Title">33. <code>@Title</code></a>