[myfaces-tobago] branch tobago-5.x updated: Tobago 5.x (#3474)

[lo...@apache.org]

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

lofwyr pushed a commit to branch tobago-5.x
in repository https://gitbox.apache.org/repos/asf/myfaces-tobago.git


The following commit(s) were added to refs/heads/tobago-5.x by this push:
     new f868c95101 Tobago 5.x (#3474)
f868c95101 is described below

commit f868c95101ac9a7312f76fb61c8d7bcd32df4289
Author: Udo Schnurpfeil <lo...@apache.org>
AuthorDate: Wed Nov 30 16:54:38 2022 +0100

    Tobago 5.x (#3474)
    
    doc: client configuration
    
    issue: TOBAGO-2172
    issue: TOBAGO-2173
---
 .../webapp/content/500-config/Configuration.xhtml  | 68 ++++++++++++++++++++++
 1 file changed, 68 insertions(+)

diff --git a/tobago-example/tobago-example-demo/src/main/webapp/content/500-config/Configuration.xhtml b/tobago-example/tobago-example-demo/src/main/webapp/content/500-config/Configuration.xhtml
new file mode 100644
index 0000000000..0aebf8cbb2
--- /dev/null
+++ b/tobago-example/tobago-example-demo/src/main/webapp/content/500-config/Configuration.xhtml
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+-->
+
+<ui:composition template="/main.xhtml"
+                xmlns="http://www.w3.org/1999/xhtml"
+                xmlns:tc="http://myfaces.apache.org/tobago/component"
+                xmlns:ui="http://xmlns.jcp.org/jsf/facelets">
+
+  <tc:link label="Tag Library Documentation" image="#{request.contextPath}/image/feather-leaf.png"
+           link="#{apiController.tobagoTld}/tc/config.html"/>
+
+  <tc:section label="Configuration of application and page behavior">
+
+    <tc:section label="Application based">
+      Application based configurations can be defined in
+      <code>/WEB-INF/tobago-config.xml</code> in a web-application or in
+      <code>/META-INF/tobago-config.xml</code> in jar libraries.
+    </tc:section>
+
+    <tc:section label="Page based">
+      Page based configurations, which are used in the browser
+      can be defined with the <code>&lt;tc:config&gt;</code>
+      <tc:section label="Focus on error">
+        <p>
+          The default behavior in case of re-rendering a page, because of
+          error on the page is: The first error field will get the focus.
+        </p>
+        <p>
+          This can be switched off, with <code>focusOnError="false"</code>.
+        </p>
+      </tc:section>
+      <tc:section label="Wait overlay delay for AJAX">
+        <p>
+          Time before the overlay appears for AJAX calls.
+        </p>
+        <p>
+          Set with <code>waitOverlayDelayAjax="1000"</code>.
+        </p>
+      </tc:section>
+      <tc:section label="Wait overlay delay for full requests">
+        <p>
+          Time before the overlay appears for normal calls.
+        </p>
+        <p>
+          Set with <code>waitOverlayDelayFull="1000"</code>.
+        </p>
+      </tc:section>
+    </tc:section>
+
+  </tc:section>
+
+</ui:composition>