JBoss Rich Faces SVN: r14864 - branches/community/3.3.X/docs/photo_album_app_guide/en/src/main/resources/images.
by richfaces-svn-commits＠lists.jboss.org
Author: msorokin
Date: 2009-07-09 11:10:11 -0400 (Thu, 09 Jul 2009)
New Revision: 14864
Added:
branches/community/3.3.X/docs/photo_album_app_guide/en/src/main/resources/images/giagram.png
Log:
https://jira.jboss.org/jira/browse/RF-5768
Page Flow diagram
Added: branches/community/3.3.X/docs/photo_album_app_guide/en/src/main/resources/images/giagram.png
===================================================================
(Binary files differ)
Property changes on: branches/community/3.3.X/docs/photo_album_app_guide/en/src/main/resources/images/giagram.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
15 years, 8 months
JBoss Rich Faces SVN: r14863 - branches/community/3.3.X/docs/userguide/en/src/main/resources/images.
by richfaces-svn-commits＠lists.jboss.org
Author: atsebro
Date: 2009-07-09 07:16:44 -0400 (Thu, 09 Jul 2009)
New Revision: 14863
Removed:
branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_2.png
Log:
Deleted: branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_2.png
===================================================================
(Binary files differ)
15 years, 8 months
JBoss Rich Faces SVN: r14862 - branches/community/3.3.X/docs/userguide/en/src/main/docbook/included.
by richfaces-svn-commits＠lists.jboss.org
Author: atsebro
Date: 2009-07-09 07:16:08 -0400 (Thu, 09 Jul 2009)
New Revision: 14862
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loadBundle.desc.xml
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loadBundle.xml
Log:
RF-7481: a4j:loadBundle component description review
Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loadBundle.desc.xml
===================================================================
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loadBundle.desc.xml 2009-07-08 19:43:43 UTC (rev 14861)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loadBundle.desc.xml 2009-07-09 11:16:08 UTC (rev 14862)
@@ -7,9 +7,9 @@
</keywordset>
</sectioninfo>
<title>Description</title>
- <para>The <emphasis role="bold">
- <property><a4j:loadBundle></property>
- </emphasis> component is similar to the same component from the JSF Core library. The component loads a resource bundle
- localized for the Locale of the current view and exposes it (as a Map) in the request attributes of the current request.</para>
+ <para>
+ The <emphasis role="bold"><property><a4j:loadBundle></property></emphasis> component is similar to JSF <emphasis role="bold"><property><f:loadBundle></property></emphasis>:
+ it loads a resource bundle localized for the Locale of the current view and stores properties as a Map in the current request attributes of the current request.
+ </para>
</section>
</chapter>
\ No newline at end of file
Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loadBundle.xml
===================================================================
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loadBundle.xml 2009-07-08 19:43:43 UTC (rev 14861)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loadBundle.xml 2009-07-09 11:16:08 UTC (rev 14862)
@@ -31,73 +31,181 @@
</tgroup>
</table>
- <section>
- <title>Creating on a page</title>
-
- <para>To create the simplest variant on a page use the following syntax:</para>
-
- <para>
- <emphasis role="bold">Example:</emphasis></para>
- <programlisting role="XML"><![CDATA[<a4j:loadBundle baseName="demo.bundle.Messages" var="Message"/>]]></programlisting>
-
- </section>
-
- <section>
- <title>Creating the Component Dynamically Using Java</title>
-
- <para>
- <emphasis role="bold">Example:</emphasis></para>
- <programlisting role="JAVA"><![CDATA[import org.ajax4jsf.component.html.AjaxLoadBundle;
+ <section>
+ <title>Creating the Component with a Page Tag</title>
+ <para>
+ To create the simplest variant on a page use the following syntax:
+ </para>
+ <para>
+ <emphasis role="bold">Example:</emphasis>
+ </para>
+ <programlisting role="XML"><![CDATA[<a4j:loadBundle baseName="demo.bundle.Messages" var="Message"/>]]></programlisting>
+ </section>
+
+ <section>
+ <title>Creating the Component Dynamically Using Java</title>
+ <para>
+ <emphasis role="bold">Example:</emphasis>
+ </para>
+ <programlisting role="JAVA"><![CDATA[import org.ajax4jsf.component.html.AjaxLoadBundle;
...
AjaxLoadBundle myBundle = new AjaxLoadBundle();
-...
- ]]></programlisting>
-
- </section>
+...]]></programlisting>
+ </section>
+
+ <section>
+ <title>Details of usage</title>
+ <para>
+ Internationalization and Localization are the processes of adaptation of web applications for different languages and cultures.
+ When you develop English and German versions of a site it can be said that you localize the site for England and Germany.
+ Language is not the only thing that undergoes the localization — dates, times, numbers, currencies, phone numbers, addresses, graphics, icons, colors, personal titles and even favourite sounds are also varies from country to country.
+ It means that an internationalized application may have lots of different type information, which should be changed depending on user location.
+ </para>
+ <para>
+ There are several approaches of organizing the localization.
+ The JSF <emphasis role="bold"><property><h:loadBundle></property></emphasis> loads bundles into the request scope when page is being rendered and updates all the needed areas in a crowd.
+ Ajax requests work in their own request scopes, so bundle information loaded in such way became unavailable.
+ The approach provided by RichFaces <emphasis role="bold"><property><a4j:loadBundle></property></emphasis> component enriches one given by the JSF <emphasis role="bold"><property><h:loadBundle></property></emphasis> with Ajax capability:
+ It allows to use reference to a particular bundle item during an Ajax update.
+ </para>
+ <para>
+ Using of the <emphasis role="bold"><property><a4j:loadBundle></property></emphasis> is pretty simple.
+ Imagine a small application that says "Hello!" in different languages where switching between translations (localization in our case) occurs on clicking the corresponding links, like you have used to see on lots of sites.
+ In our JSF with RichFaces application (those who feel not strong in that should better read the "<link linkend="GettingStarted">Getting started with RichFaces</link>" chapter) create resource bundles with "Hello!" message for three different languages: English, German and Italian.
+ Resource bundles are represented with <code>*.properties</code> extention files that keep items in <code>Key(Name)/Value</code> pairs.
+ A key for an item should be the same for all locales.
+ </para>
+ <figure>
+ <title>
+ Resource bundles <code>*.properties</code> files with Keys and Values for multi-language application. View in JBDS.
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/loadBundle_init.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Мessage resource bundles should be registered in the Faces configuration (<code>faces-config.xml</code>) file of your application as <code><message-bundle></code> inside the <code><application></code> element.
+ Name of a resource should be specified without language or country code and without <code>.properties</code> extension.
+ Supported locales should be specified inside the <code><supported-locale></code> element.
+ </para>
+ <para>
+ <emphasis role="bold">Registering resource bundles in the Faces configuration file:</emphasis>
+ </para>
+ <programlisting role="XML"><![CDATA[<application>
+ <locale-config>
+ <default-locale>en</default-locale>
+ <supported-locale>en</supported-locale>
+ <supported-locale>de</supported-locale>
+ <supported-locale>it</supported-locale>
+ </locale-config>
+ <message-bundle>demo.message</message-bundle>
+</application>]]></programlisting>
+
+ <para>
+ For the application we will use JSF <code>javax.faces.component.UIViewRoot.setLocale</code> method that will set a needed Locale
+ (each link will invoke corresponding method — there are, off course, another ways to do that).
+ </para>
+ <para>
+ <emphasis role="bold"><code>ChangeLocale</code> Java class with three methods for setting the correponding Locale:</emphasis>
+ </para>
+ <programlisting role="JAVA"><![CDATA[package demo;
- <section>
- <title>Key attributes and ways of usage</title>
- <para>
+ import java.util.Locale;
+ import javax.faces.context.FacesContext;
- <emphasis role="bold"><property><a4j:loadBundle></property>
- </emphasis>allows to use reference to bundle messages during the Ajax re-rendering.
-<emphasis role="bold"><property><a4j:loadBundle></property>
- </emphasis> is a substitute for the
-<emphasis role="bold"><property><f:loadBundle></property>
- </emphasis> in JSF 1.1 which is not a JSF component originally.
+ public class ChangeLocale {
+ public String germanAction() {
+ FacesContext context = FacesContext.getCurrentInstance();
+ context.getViewRoot().setLocale(Locale.GERMAN);
+ return null;
+ }
-<emphasis role="bold"><property><f:loadBundle></property>
- </emphasis> is a jsp tag that load the bundle messages into the request scope when page is rendered. As soon as each Ajax request
-works in own request scope, the bundles loaded with
-<emphasis role="bold"><property><f:loadBundle></property>
- </emphasis> are unavailable.
-Instead of
-<emphasis role="bold"><property><f:loadBundle></property>
- </emphasis> that might be located anywhere on a page, the
+ public String englishAction() {
+ FacesContext context = FacesContext.getCurrentInstance();
+ context.getViewRoot().setLocale(Locale.ENGLISH);
+ return null;
+ }
+
+ public String italianAction() {
+ FacesContext context = FacesContext.getCurrentInstance();
+ context.getViewRoot().setLocale(Locale.ITALIAN);
+ return null;
+ }
+}]]></programlisting>
+
+ <para>
+ Recently, the JSP page will look as following:
+ </para>
+
+ <programlisting role="XML"><![CDATA[<h:form>
+ <a4j:loadBundle var="msg" basename="demo.message"/>
+ <h:outputText id="messageBundle" value="#{msg.greeting}"/>
+ <a4j:commandLink value="De" action="#{changeLocale.germanAction}" reRender="messageBundle" />
+ <a4j:commandLink value="Eng" action="#{changeLocale.englishAction}" reRender="messageBundle" />
+ <a4j:commandLink value="It" action="#{changeLocale.italianAction}" reRender="messageBundle" />
+</h:form> ]]></programlisting>
+
+ <para>
+ As an output we will get a simple application with English "Hello!" by default.
+ Clicking on links "De", "Eng" and "It" will show the messages specified within the corresponding <code>*.properties</code> file.
+ To reference to a particular bundle item during an Ajax update it is necessary to point the component(s) that shold be re-rendered (in this example it is done with the help of <emphasis role="bold"><property><a4j:commandLink></property></emphasis> <emphasis><property>"reRender"</property></emphasis> attribute).
+ The <emphasis role="bold"><property><a4j:loadBundle></property></emphasis> should be declared inside the f:view (this does not matter when using Facelets).
+ </para>
+
+ <figure>
+ <title>
+ Using of the RichFaces <emphasis role="bold"><property><a4j:loadBundle></property></emphasis> component for application localization.
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/loadBundle2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ <section>
+ <title>Relevant resources links</title>
+ <para>
+ Vizit the <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/bundle.jsf?c=loadBundle">LoadBundle page</ulink> at RichFaces LiveDemo for additional information on the component.
+ </para>
+ <para>
+ More useful examples and articles:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink url="http://java.sun.com/javaee/javaserverfaces/1.1_01/docs/tlddocs/f/loadBund...">loadBundle tag reference</ulink> at java.sun portal;
+ </para>
+ </listitem>
- <emphasis role="bold"><property><a4j:loadBundle></property>
- </emphasis> should be declared inside the
+ <listitem>
+ <para>
+ <ulink url="http://java.sun.com/docs/books/tutorial/i18n/resbundle/propfile.html">Backing a ResourceBundle with Properties Files</ulink> at java.sun portal;
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <ulink url="http://www.objectsource.com/j2eechapters/Ch19-I18N_and_L10N.htm">Internationalization and Localization of J2EE application</ulink> explains main principles of the internationalization of a web application;
+ </para>
+ </listitem>
- <emphasis role="bold"><property><f:view></property>
- </emphasis> (this does not matter in case on using Facelets)
-JSF 1.2 introduces the bundle registered in the faces-config.xml. This fixed the problem with
- <emphasis role="bold"><property><f:loadBundle></property>
- </emphasis>.
-Therefore, you can use this JSF 1.2 way to declare your bundles.
+ <listitem>
+ <para>
+ <ulink url="http://www.laliluna.de/javaserver-faces-message-resource-bundle-tutorial....">one more useful tutorial</ulink> explains the internationalization of a web application using JSF message resource bundle;
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <ulink url="http://www.i-coding.de/www/en/jsf/application/locale.html">Some special problem with JSF internationalization</ulink> and solution from the i-coding.de portal.
+ </para>
+ </listitem>
- </para>
- </section>
- <section>
- <title>Relevant resources links</title>
- <para>
- <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/bundle.jsf?c=loadBundle">On RichFaces LiveDemo page </ulink> you can found some additional information for <emphasis role="bold"
- ><property><a4j:loadBundle></property></emphasis> component usage.
- </para>
- <para>
- <ulink url="http://java.sun.com/javaee/javaserverfaces/1.1_01/docs/tlddocs/f/loadBund...">On RichFaces LiveDemo page </ulink> you can found some additional information about <emphasis role="bold"><property><f:loadBundle></property></emphasis> component.
- </para>
- <para>
- <ulink url="http://java.sun.com/javaee/javaserverfaces/1.1_01/docs/tlddocs/f/view.html">On RichFaces LiveDemo page </ulink> you can found some additional information about <emphasis role="bold"><property><f:view></property></emphasis> component.
- </para>
+ </itemizedlist>
+
</section>
</chapter>
\ No newline at end of file
15 years, 8 months
JBoss Rich Faces SVN: r14861 - branches/community/3.3.X/docs/userguide/en/src/main/resources/images.
by richfaces-svn-commits＠lists.jboss.org
Author: atsebro
Date: 2009-07-08 15:43:43 -0400 (Wed, 08 Jul 2009)
New Revision: 14861
Added:
branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle2.png
Log:
RF-7481: a4j:loadBundle component description review
Added: branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle2.png
===================================================================
(Binary files differ)
Property changes on: branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
15 years, 8 months
JBoss Rich Faces SVN: r14860 - branches/community/3.3.X/docs/userguide/en/src/main/resources/images.
by richfaces-svn-commits＠lists.jboss.org
Author: atsebro
Date: 2009-07-08 15:28:23 -0400 (Wed, 08 Jul 2009)
New Revision: 14860
Added:
branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_2.png
Log:
RF-7481: a4j:loadBundle component description review
Added: branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_2.png
===================================================================
(Binary files differ)
Property changes on: branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
15 years, 8 months
JBoss Rich Faces SVN: r14859 - branches/community/3.3.X/docs/userguide/en/src/main/resources/images.
by richfaces-svn-commits＠lists.jboss.org
Author: atsebro
Date: 2009-07-08 15:06:47 -0400 (Wed, 08 Jul 2009)
New Revision: 14859
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_init.png
Log:
RF-7481: a4j:loadBundle component description review
Modified: branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_init.png
===================================================================
(Binary files differ)
15 years, 8 months
JBoss Rich Faces SVN: r14858 - tags.
by richfaces-svn-commits＠lists.jboss.org
Author: abelevich
Date: 2009-07-08 14:33:40 -0400 (Wed, 08 Jul 2009)
New Revision: 14858
Added:
tags/rf_313072/
Log:
Copied: tags/rf_313072 (from rev 14857, branches/enterprise/3.3.X)
15 years, 8 months
JBoss Rich Faces SVN: r14857 - branches/community/3.3.X/docs/userguide/en/src/main/resources/images.
by richfaces-svn-commits＠lists.jboss.org
Author: atsebro
Date: 2009-07-08 14:12:29 -0400 (Wed, 08 Jul 2009)
New Revision: 14857
Added:
branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_init.png
Log:
RF-7481: a4j:loadBundle component description review
Added: branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_init.png
===================================================================
(Binary files differ)
Property changes on: branches/community/3.3.X/docs/userguide/en/src/main/resources/images/loadBundle_init.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
15 years, 8 months
JBoss Rich Faces SVN: r14856 - branches/community/3.3.X/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts.
by richfaces-svn-commits＠lists.jboss.org
Author: abelevich
Date: 2009-07-08 12:55:35 -0400 (Wed, 08 Jul 2009)
New Revision: 14856
Modified:
branches/community/3.3.X/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combobox.js
Log:
https://jira.jboss.org/jira/browse/RF-7286
Modified: branches/community/3.3.X/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combobox.js
===================================================================
--- branches/community/3.3.X/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combobox.js 2009-07-08 16:54:52 UTC (rev 14855)
+++ branches/community/3.3.X/ui/combobox/src/main/resources/org/richfaces/renderkit/html/scripts/combobox.js 2009-07-08 16:55:35 UTC (rev 14856)
@@ -292,6 +292,7 @@
}
}
this.comboList.hideWithDelay();
+ this.setValue(false);
} else {
this.doActive();
}
@@ -326,12 +327,31 @@
}
if (this.isValueSet(event) && isSearchSuccessful) {
- this.setValue();
+ var value = this.getActiveItemValue();
+ if(value && this.directInputSuggestions) {
+ this.doDirectSuggestion(value);
+ }
}
this.comboValue.value = this.field.value;
}
},
+ getActiveItemValue: function(){
+ var value;
+ if (this.comboList.activeItem) {
+ value = jQuery(this.comboList.activeItem).text();
+ value = value.replace(/\xA0/g," ").strip();
+ }
+ return value;
+ },
+
+ doDirectSuggestion: function(value) {
+ var startInd = this.field.value.length;
+ var endInd = value.length;
+ this.field.value = value;
+ Richfaces.ComboBox.textboxSelect(this.field, startInd, endInd);
+ },
+
wasTextDeleted : function(event) {
if ((event.keyCode == Event.KEY_BACKSPACE)
|| (event.keyCode == Event.KEY_DELETE)
@@ -342,7 +362,7 @@
},
isValueSet : function(event) {
- /*if (this.field.prevValue) {
+ /* if (this.field.prevValue) {
if (this.field.prevValue.toLowerCase() != this.field.value.toLowerCase()) {
return true;
}
@@ -360,38 +380,46 @@
},
setValue : function(toSetOnly) {
- if (!this.comboList.activeItem) {
- return;
+//
+// if(this.comboValue.value != value) {
+// Richfaces.invokeEvent(this.onchange, this.combobox, "onchange", {value:value});
+// }
+
+// if (this.comboList.activeItem) {
+//
+// var value = jQuery(this.comboList.activeItem).text();
+// value = value.replace(/\xA0/g," ").strip();
+ var value = this.getActiveItemValue();
+ if(value && toSetOnly) {
+// var oV = this.field.value;
+// if (oV == value) {
+// if (Prototype.Browser.Gecko) {
+// this.field.value = "";
+// this.comboValue.value = "";
+// }
+// }
+// this.field.prevValue = value;
+// this.field.value = value;
+// this.comboValue.value = value;
+ this.comboValue.value = value;
+ this.comboList.doSelectItem(this.comboList.activeItem);
+ this.combobox.fire("rich:onselect", {});
}
+// else if (this.directInputSuggestions) {
+// var startInd = this.field.value.length;
+// var endInd = value.length;
+// this.comboValue.value = value;
+// Richfaces.ComboBox.textboxSelect(this.field, startInd, endInd);
+// }
+// }
+
+ var newValue = this.comboValue.value;
+ var oldValue = this.field.prevValue;
- var value = jQuery(this.comboList.activeItem).text();
- value = value.replace(/\xA0/g," ").strip();
-
- if(this.comboValue.value && (this.comboValue.value != value)) {
- Richfaces.invokeEvent(this.onchange, this.combobox, "onchange", {value:value});
- }
-
-
- if (toSetOnly) {
- var oV = this.field.value;
- if (oV == value) {
- if (Prototype.Browser.Gecko) {
- this.field.value = "";
- this.comboValue.value = "";
- }
- }
- this.field.prevValue = value;
- this.field.value = value;
- this.comboValue.value = value;
- this.comboList.doSelectItem(this.comboList.activeItem);
- this.combobox.fire("rich:onselect", {});
- } else {
- if (this.directInputSuggestions) {
- var startInd = this.field.value.length;
- var endInd = value.length;
- this.field.value = value;
- Richfaces.ComboBox.textboxSelect(this.field, startInd, endInd);
- }
+ if(newValue && (newValue != oldValue)) {
+ this.field.prevValue = newValue;
+ this.field.value = newValue;
+ Richfaces.invokeEvent(this.onchange, this.combobox, "onchange", {value:newValue});
}
},
15 years, 8 months