This is an automated email from the ASF dual-hosted git repository. git-site-role pushed a commit to branch asf-site in repository https://gitbox.apache.org/repos/asf/struts-site.git
The following commit(s) were added to refs/heads/asf-site by this push: new f3f48ab Updates production by Jenkins f3f48ab is described below commit f3f48ab7df6b3ccbb01cb56aed02606019eefd8c Author: jenkins <bui...@apache.org> AuthorDate: Fri Mar 2 06:00:56 2018 +0000 Updates production by Jenkins --- .../tag-developers/optiontransferselect-tag.html | 67 ++++++++------- content/tag-developers/url-tag.html | 98 ++++++++++------------ 2 files changed, 84 insertions(+), 81 deletions(-) diff --git a/content/tag-developers/optiontransferselect-tag.html b/content/tag-developers/optiontransferselect-tag.html index 2c6c9d0..bfb2ae4 100644 --- a/content/tag-developers/optiontransferselect-tag.html +++ b/content/tag-developers/optiontransferselect-tag.html @@ -159,17 +159,13 @@ <p> <p> NOTE: The id and doubleId need not be supplied as they will generated provided that the optiontransferselect tag is being used in a form tag. The generated id - and doubleId will be <form_id>_<optiontransferselect_nameame> and - <form_id>_<optiontransferselect_doublename> respectively. - - - - - -__Parameters__ - + and doubleId will be <form_id>_<optiontransferselect_nameame> and + <form_id>_<optiontransferselect_doubleName> respectively. + </p> +</p> +<p><strong>Parameters</strong></p> <p> <table width="100%"> @@ -2061,26 +2057,41 @@ __Parameters__ </p> +<p><strong>Examples</strong></p> + +<div class="highlighter-rouge"><pre class="highlight"><code> + <span class="c"><!-- minimum configuration --></span> + <span class="nt"><s:optiontransferselect</span> + <span class="na">label=</span><span class="s">"Favourite Cartoons Characters"</span> + <span class="na">name=</span><span class="s">"leftSideCartoonCharacters"</span> + <span class="na">list=</span><span class="s">"{'Popeye', 'He-Man', 'Spiderman'}"</span> + <span class="na">doubleName=</span><span class="s">"rightSideCartoonCharacters"</span> + <span class="na">doubleList=</span><span class="s">"{'Superman', 'Mickey Mouse', 'Donald Duck'}"</span> + <span class="nt">/></span> + + <span class="c"><!-- possible configuration --></span> + <span class="nt"><s:optiontransferselect</span> + <span class="na">label=</span><span class="s">"Favourite Cartoons Characters"</span> + <span class="na">name=</span><span class="s">"leftSideCartoonCharacters"</span> + <span class="na">leftTitle=</span><span class="s">"Left Title"</span> + <span class="na">rightTitle=</span><span class="s">"Right Title"</span> + <span class="na">list=</span><span class="s">"{'Popeye', 'He-Man', 'Spiderman'}"</span> + <span class="na">multiple=</span><span class="s">"true"</span> + <span class="na">headerKey=</span><span class="s">"headerKey"</span> + <span class="na">headerValue=</span><span class="s">"--- Please Select ---"</span> + <span class="na">emptyOption=</span><span class="s">"true"</span> + <span class="na">doubleList=</span><span class="s">"{'Superman', 'Mickey Mouse', 'Donald Duck'}"</span> + <span class="na">doubleName=</span><span class="s">"rightSideCartoonCharacters"</span> + <span class="na">doubleHeaderKey=</span><span class="s">"doubleHeaderKey"</span> + <span class="na">doubleHeaderValue=</span><span class="s">"--- Please Select ---"</span> + <span class="na">doubleEmptyOption=</span><span class="s">"true"</span> + <span class="na">doubleMultiple=</span><span class="s">"true"</span> + <span class="nt">/></span> + + +</code></pre> +</div> -__Examples__ - - - - - -```xml - - <-- minimum configuration --> - <s:optiontransferselect label="Favourite Cartoons Characters" name="leftSideCartoonCharacters" list="{'Popeye', 'He-Man', 'Spiderman'}" doublename="rightSideCartoonCharacters" doublelist="{'Superman', 'Mickey Mouse', 'Donald Duck'}" /> - - <-- possible configuration --> - <s:optiontransferselect label="Favourite Cartoons Characters" name="leftSideCartoonCharacters" lefttitle="Left Title" righttitle="Right Title" list="{'Popeye', 'He-Man', 'Spiderman'}" multiple="true" headerkey="headerKey" headervalue="--- Please Select ---" emptyoption="true" doublelist="{'Superman', 'Mickey Mouse', 'Donald Duck'}" doublename="rightSideCartoonCharacters" doubleheaderkey="doubleHeaderKey" doubleheadervalue="--- Please Select ---" doubleemptyoption="true" doublemultiple= [...] - - -``` - - -</optiontransferselect_doublename></form_id></optiontransferselect_nameame></form_id></p></p> </section> </article> diff --git a/content/tag-developers/url-tag.html b/content/tag-developers/url-tag.html index e1aa5dc..a1977ee 100644 --- a/content/tag-developers/url-tag.html +++ b/content/tag-developers/url-tag.html @@ -152,59 +152,58 @@ <p> <p>This tag is used to create a URL.</p> - <p>You can use the <param /> tag inside the body to provide + <p>You can use the <param> tag inside the body to provide additional request parameters. If the value of a param is an Array or an Iterable all the values will be added to the URL.</p> - <b>NOTE:</b> - <p>By default request parameters will be separated using escaped ampersands (i.e., &). + <p><b>NOTE:</b>By default request parameters will be separated using escaped ampersands (i.e., &). This is necessary for XHTML compliance, however, when using the URL generated by this tag - with the <s:property> tag, the <b>escapeAmp</b> attribute should be used to disable - ampersand escaping. + with the <s:property> tag, the <b>escapeAmp</b> attribute should be used to disable + ampersand escaping.</p> - <b>NOTE:</b> - <p>When includeParams is 'all' or 'get', the parameter defined in a <param /> + <p><b>NOTE:</b>When includeParams is 'all' or 'get', the parameter defined in a <param> tag will take precedence over any params included due to the includeParams attribute. For example, in Example 3 below, if there is a id parameter in the url where the page this - tag is included like http://<host>:<port>/<context>/editUser.action?id=3333&name=John - the generated url will be http://<host>:<port>/<context>/editUser.action?id=22&name=John - because the parameter defined in the param tag will take precedence. - - - - -__Setting a default value for includeParams__ - -The property _struts.url.includeParams_ can be used to set the default value of the _includeParams_ attribute. + tag is included like http://<host>:<port>/<context>/editUser.action?id=3333&name=John + the generated url will be http://<host>:<port>/<context>/editUser.action?id=22&name=John + because the parameter defined in the param tag will take precedence.</p> +</p> -**Setting the default value of includeParams** +<p><strong>Setting a default value for includeParams</strong></p> +<p>The property <em>struts.url.includeParams</em> can be used to set the default value of the <em>includeParams</em> attribute.</p> -```xml +<p><strong>Setting the default value of includeParams</strong></p> -<struts> +<div class="highlighter-rouge"><pre class="highlight"><code> +<span class="nt"><struts></span> ... - <constant name="struts.url.includeParams" value="none" /> + <span class="nt"><constant</span> <span class="na">name=</span><span class="s">"struts.url.includeParams"</span> <span class="na">value=</span><span class="s">"none"</span> <span class="nt">/></span> ... -</struts> - -``` +<span class="nt"></struts></span> -See _Constant Configuration_ for further information. +</code></pre> +</div> +<p>See <em>Constant Configuration</em> for further information.</p> -> +<blockquote> -> +</blockquote> -> As of Struts 2.1.3 the includeParams constant defaults to "none". +<blockquote> -> +</blockquote> -__Parameters__ +<blockquote> + <p>As of Struts 2.1.3 the includeParams constant defaults to “none”.</p> +</blockquote> +<blockquote> +</blockquote> +<p><strong>Parameters</strong></p> <p> <table width="100%"> @@ -480,35 +479,28 @@ __Parameters__ </p> +<p><strong>Examples</strong></p> -__Examples__ - - - - - -```xml - - <-- Example 1 --> - <s:url value="editGadget.action"> - <s:param name="id" value="%{selected}" /> - </s:url> - - <-- Example 2 --> - <s:url action="editGadget"> - <s:param name="id" value="%{selected}" /> - </s:url> +<div class="highlighter-rouge"><pre class="highlight"><code> + <span class="c"><!-- Example 1 --></span> + <span class="nt"><s:url</span> <span class="na">value=</span><span class="s">"editGadget.action"</span><span class="nt">></span> + <span class="nt"><s:param</span> <span class="na">name=</span><span class="s">"id"</span> <span class="na">value=</span><span class="s">"%{selected}"</span> <span class="nt">/></span> + <span class="nt"></s:url></span> - <-- Example 3--> - <s:url includeparams="get"> - <s:param name="id" value="%{'22'}" /> - </s:url> + <span class="c"><!-- Example 2 --></span> + <span class="nt"><s:url</span> <span class="na">action=</span><span class="s">"editGadget"</span><span class="nt">></span> + <span class="nt"><s:param</span> <span class="na">name=</span><span class="s">"id"</span> <span class="na">value=</span><span class="s">"%{selected}"</span> <span class="nt">/></span> + <span class="nt"></s:url></span> + <span class="c"><!-- Example 3--></span> + <span class="nt"><s:url</span> <span class="na">includeParams=</span><span class="s">"get"</span><span class="nt">></span> + <span class="nt"><s:param</span> <span class="na">name=</span><span class="s">"id"</span> <span class="na">value=</span><span class="s">"%{'22'}"</span> <span class="nt">/></span> + <span class="nt"></s:url></span> -``` +</code></pre> +</div> -</context></port></host></context></port></host></p></s:property></p></p> </section> </article> -- To stop receiving notification emails like this one, please contact git-site-r...@apache.org.