Internationalization
All apps built with Appfarm Create support internationalization by default. By using the built-in UI components you ensure that your apps can be easily translated and maintained in different languages.
The default language for a solution, as well as the calendar locale and date and number formatting is set to English (US). We recommend using English as the base language when creating your UI as it makes it easier to provide support and it's often a preferred source language if you choose to translate the UI.
If you do choose to build your UI using a language other than English (US), you can set that language as the default under Internationalization > Languages by changing the Base Language of the default language.
Customize date and number formatting
Calendar locale
The locale used when formatting dates and displaying Datetime related strings, for example "Monday" and "February".
Date format
Short date
Date
Long date
Below is an example of how calendar locale and date format work together to format dates:
Number format
Currency
Add a new language
If you need a language that is not currently available, please get in touch.
Translate your apps
Adding and editing translations
Translations can be added and edited in two places in Appfarm Create.
Directly within the UI designer.
Under Internationalization > Translations.
To add translations directly within the UI designer, look for any property with a globe icon. Click the icon to view and edit all translations for that property. A button to translate all using Google Translate is available. Existing translations will not be affected.
All default language strings and translations are listed under Internationalization > Translations.
Translations are saved instantly as you type. For UI components that support line breaks, you can add a line break by typing Shift + Return/Enter
.
Each row includes a context reference, identifying which component and property the string is located in. Click on the reference to be taken directly to that property in the UI designer.
It's also possible to run Google Translate individually for each row. Empty translation values will be replaced with a translation. Existing translations will not be affected. This can be a useful starting point for translations. A human can then review the text and correct translations as required. You will see the best results when you have English as a base language.
Sorting and filtering
The strings can be filtered down to specific apps and enums.
To search for a specific value, use the Find functionality in your browser Ctrl/Cmd + F
.
Import and export
User interface strings and all stored translations can be exported to a CSV file for translation and review. The file is comma delimited. The contents of the file is determined by any sorting and filtering you have applied. The CSV file is structured as follows:
The first value is a unique ID (key) referencing the location of the string in the solution.
The second value contains the source (default language) string.
Any additional values contain the translations, if any, stored for that string. These values follow the same order that the languages are listed in Appfarm Create.
A translated CSV file can be imported back into Appfarm Create. The two first header rows will be skipped. The import loops through all lines and values, and updates translations where the value (trimmed of whitespace) is not empty or is different from the existing trimmed translation value stored in Appfarm Create. Both comma and semicolon delimited files are accepted.
Functions
If you have text in your app that is returned by a function, it will not be shown under Translations. For example, return `Hello ${firstName}`
won't be included in the list of strings. To translate such text you can add if statements to check the active language and return the appropriately translated string.
Last updated