// =========================================================================
// ex21/Ex21Activity.kt - eine Anwendung in zwei Sprachen
// -------------------------------------------------------------------------
// Der Android-Weg:
// - die TEXTE der Anwendung sind RESSOURCEN: eine Datei
// res/values/strings.xml (die Standardsprache, hier Englisch) und eine
// Datei pro Übersetzung (res/values-fr/strings.xml). Jeder Text hat einen
// Namen; der Code kennt nur diesen Namen (R.string.ex21_hello), und
// Android wählt die Datei entsprechend der Sprache der Anwendung;
// - stringResource(R.string.ex21_hello, "Marie"): der Text, dessen
// Parameter (%1$s) ersetzt werden; pluralStringResource: ein Plural-
// text, dessen Form den Regeln der Sprache folgt;
// - die Sprache der Anwendung: die des Smartphones ... oder die, die die
// Anwendung selbst wählt, AppCompatDelegate.setApplicationLocales.
// Android ERZEUGT die Activity dann NEU, in der neuen Sprache: die Texte,
// die Datumsangaben, die Beträge und die Texte von Android selbst (der
// Kalender, seine Schaltflächen).
// Der RdvMedecins-Server liefert seinerseits nur SCHLÜSSEL ("ERRORS.LOGIN_TAKEN"):
// Sie werden über eine Tabelle (serverKeys) den Ressourcen zugeordnet.
// Die Activity ist eine AppCompatActivity: die Activity-Klasse, die die gewählte Sprache
// anwenden kann, sogar auf Android-Versionen vor
// 13.
// =========================================================================
@file:OptIn(ExperimentalMaterial3Api::class, ExperimentalLayoutApi::class)
package fr.stahe.examples.ex21
import android.os.Bundle
import androidx.activity.compose.setContent
import androidx.activity.enableEdgeToEdge
import androidx.appcompat.app.AppCompatActivity
import androidx.appcompat.app.AppCompatDelegate
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.ExperimentalLayoutApi
import androidx.compose.foundation.layout.FlowRow
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.width
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.DateRange
import androidx.compose.material3.Card
import androidx.compose.material3.DatePicker
import androidx.compose.material3.DatePickerDialog
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedButton
import androidx.compose.material3.SegmentedButton
import androidx.compose.material3.SegmentedButtonDefaults
import androidx.compose.material3.SingleChoiceSegmentedButtonRow
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.material3.rememberDatePickerState
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalConfiguration
import androidx.compose.ui.res.pluralStringResource
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.text.font.FontFamily
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
import androidx.core.os.LocaleListCompat
import fr.stahe.examples.R
import fr.stahe.examples.common.ExamplePage
import fr.stahe.examples.common.ExamplesTheme
import java.text.NumberFormat
import java.time.LocalDate
import java.time.format.DateTimeFormatter
import java.time.format.FormatStyle
import java.util.Currency
val languages = listOf("fr", "en")
// was der RdvMedecins-Server zurückgeben würde (vgl. Kapitel über die Blackbox)
data class ServerResponse(val statusCode: Int, val key: String, val params: Map<String, String>)
val serverResponses = listOf(
ServerResponse(409, "ERRORS.LOGIN_TAKEN", emptyMap()),
ServerResponse(429, "ERRORS.TOO_MANY_ATTEMPTS", mapOf("minutes" to "15")),
)
// der Schlüssel des Servers -> die Ressource, die ihn übersetzt
val serverKeys = mapOf(
"ERRORS.LOGIN_TAKEN" to R.string.errors_login_taken,
"ERRORS.TOO_MANY_ATTEMPTS" to R.string.errors_too_many_attempts,
)
class Ex21Activity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
enableEdgeToEdge()
setContent { ExamplesTheme { TranslatedPage() } }
}
}
// die Sprache der Anwendung wählen: Android speichert sie und erzeugt die Activity neu
fun changeLanguage(language: String) {
AppCompatDelegate.setApplicationLocales(LocaleListCompat.forLanguageTags(language))
}
@Composable
fun TranslatedPage() {
// rememberSaveable: Der Zähler übersteht die Neuerzeugung der Activity
var count by rememberSaveable { mutableIntStateOf(2) }
var calendarOpen by rememberSaveable { mutableStateOf(false) }
// die AKTUELLE Sprache: die der Konfiguration der Activity
val locale = LocalConfiguration.current.locales[0]
// Formatierer in der aktuellen Sprache
val date = LocalDate.now().format(DateTimeFormatter.ofLocalizedDate(FormatStyle.FULL).withLocale(locale))
val price = NumberFormat.getCurrencyInstance(locale).apply { currency = Currency.getInstance("EUR") }.format(1234.5)
ExamplePage(
title = stringResource(R.string.ex21_title),
// die Sprachen: "segmentierte" Schaltflächen in der Top-Bar
actions = {
SingleChoiceSegmentedButtonRow(Modifier.padding(end = 8.dp).width(120.dp)) {
languages.forEachIndexed { i, l ->
SegmentedButton(
selected = locale.language == l,
onClick = { changeLanguage(l) },
shape = SegmentedButtonDefaults.itemShape(i, languages.size),
icon = {},
) { Text(l.uppercase()) }
}
}
},
) {
Card(Modifier.fillMaxWidth()) {
Column(Modifier.padding(12.dp)) {
Text(stringResource(R.string.ex21_hello, "Marie"))
Text(stringResource(R.string.ex21_today, date))
Text(stringResource(R.string.ex21_price, price))
Spacer(Modifier.height(8.dp))
// der Plural: Die Kategorie "zero" existiert weder im Französischen noch im
// Englischen (0 ist im Französischen "one", im Englischen "other"): 0 wird
// separat behandelt
Text(
if (count == 0) stringResource(R.string.ex21_no_appointment) else pluralStringResource(R.plurals.ex21_appointments, count, count),
fontWeight = FontWeight.Bold,
)
FlowRow(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
TextButton(onClick = { count++ }) { Text(stringResource(R.string.ex21_add)) }
TextButton(onClick = { count-- }, enabled = count > 0) { Text(stringResource(R.string.ex21_remove)) }
}
// der Material-Kalender: Seine Texte folgen der Sprache der Anwendung
OutlinedButton(onClick = { calendarOpen = true }) {
Icon(Icons.Default.DateRange, contentDescription = null)
Spacer(Modifier.width(8.dp))
Text(stringResource(R.string.ex21_calendar))
}
}
}
Card(Modifier.fillMaxWidth()) {
Column(Modifier.padding(12.dp)) {
Text(stringResource(R.string.ex21_server_title), style = MaterialTheme.typography.titleSmall)
Text(stringResource(R.string.ex21_server_explanation))
Spacer(Modifier.height(8.dp))
for (r in serverResponses) {
Text("${r.statusCode} ${r.key}", fontFamily = FontFamily.Monospace, fontSize = 12.sp)
// die Ressource des Schlüssels; ihre Parameter in der Reihenfolge (*: "spreizt" das Array)
val id = serverKeys[r.key]
Text("→ " + if (id == null) r.key else stringResource(id, *r.params.values.toTypedArray()))
Spacer(Modifier.height(6.dp))
}
}
}
}
if (calendarOpen) {
val state = rememberDatePickerState()
DatePickerDialog(
onDismissRequest = { calendarOpen = false },
// die Texte OK / Abbrechen von Android selbst, in der Sprache der Anwendung
confirmButton = { TextButton(onClick = { calendarOpen = false }) { Text(stringResource(android.R.string.ok)) } },
dismissButton = { TextButton(onClick = { calendarOpen = false }) { Text(stringResource(android.R.string.cancel)) } },
) {
DatePicker(state = state)
}
}
}