Jak przetłumaczyć interfejs aplikacji internetowej

Jak przetłumaczyć interfejs aplikacji internetowej

Ostatnia aktualizacja: 12 września 2026

Aby przetłumaczyć interfejs aplikacji internetowej, masz dwie realne możliwości. Możesz wyodrębnić wszystkie ciągi tekstowe do plików lokalizacyjnych dołączanych do aplikacji albo uruchomić warstwę nad wyrenderowanym DOM-em, która podmienia tekst w miarę jego pojawiania się. Większość zespołów kończy na połączeniu obu podejść, a to, które z nich wykonuje większą część pracy, zależy od tego, jaka część interfejsu zawiera teksty produktowe, a jaka treści.

Ten poradnik dotyczy ekranów aplikacji, a nie stron docelowych: paneli, ustawień, formularzy, przycisków, pustych stanów, komunikatów o błędach i wiadomości e-mail wysyłanych przez aplikację. Tryby awarii są inne, a większość porad dotyczących „tłumaczenia witryny” nie sprawdza się w prawdziwym interfejsie produktu.

Warto włożyć w to wysiłek. CSA Research przeprowadziło ankietę wśród 8,709 konsumentów z 29 krajów i ustaliło, że 40% nigdy nie kupi w witrynach w innych językach. Główny specjalista ds. badań tej organizacji, dr Donald A. DePalma, ujął to jasno: „jeśli firma zdecyduje się nie lokalizować procesu zakupowego, ryzykuje utratę 40% lub więcej całego dostępnego rynku”.

Interfejs aplikacji działa zupełnie inaczej niż strona marketingowa

Strona docelowa to stały blok tekstu umieszczony w kodzie HTML w chwili jego wczytania. Aplikacja to maszyna, która generuje tekst. Błąd walidacji pojawia się dopiero wtedy, gdy ktoś prześle nieprawidłowy formularz. Komunikat typu toast znika po czterech sekundach. Treść okna modalnego nie znajduje się w dokumencie, dopóki kliknięcie jej nie utworzy. Pusty stan wyświetla się tylko na kontach bez danych, co zwykle oznacza, że nigdy nie zobaczysz go na własnym komputerze.

To ważne, bo każde podejście musi odpowiedzieć na jedno pytanie: w którym momencie ciąg tekstowy staje się tekstem? Pliki lokalizacyjne odpowiadają na nie podczas kompilacji. Warstwa działająca w czasie wykonywania odpowiada za każdym razem, gdy zmienia się DOM. Każde rozwiązanie, które reaguje tylko przy wczytaniu strony, przeoczy większość elementów produktu.

Gramatyka zawodzi, zanim zawiedzie układ

Najpierw pojawiają się problemy z liczebnikami. W angielskim są dwie formy liczby mnogiej, a wiele fragmentów kodu po cichu zakłada, że tak jest wszędzie. Unicode CLDR definiuje sześć kategorii liczby mnogiej: zero, jeden, dwa, kilka, wiele i pozostałe. Arabski używa wszystkich sześciu dla liczebników głównych, rosyjski i polski używają czterech, a japoński i koreański jednej. Ciągu {count} items nie da się naprawić, dopisując na końcu „s”. Błędna forma sprawia, że interfejs wygląda na zepsuty, a nie tylko obcojęzyczny.

Następne są daty i liczby. Ta sama suma zamówienia jest zapisywana jako 1,299.50 w USA, 1.299,50 w Niemczech i 1 299,50 we Francji. Nie potrzebujesz do tego biblioteki, ponieważ Intl.NumberFormat i Intl.DateTimeFormat są wbudowane w każdą współczesną przeglądarkę. Formatowanie to jedyny element i18n aplikacji, który platforma naprawdę rozwiązała za ciebie.

Przetłumaczone etykiety nie mieszczą się w zaprojektowanych przez ciebie przyciskach

Rozrost tekstu to błąd układu, który ujawnia się dopiero w środowisku produkcyjnym. Wytyczne W3C dotyczące długości tekstu w tłumaczeniu przytaczają tabelę rozrostu IBM, której kształt jest odwrotny do tego, czego większość osób się spodziewa: należy zakładać, że ciągi źródłowe o długości do dziesięciu znaków mogą wydłużyć się o 200 do 300 procent, natomiast ciągi dłuższe niż siedemdziesiąt znaków stabilizują się na poziomie około 130 procent.

Rozważ to w kontekście interfejsu. Najdłuższe akapity to najbezpieczniejsze elementy strony. Problemy dotyczą przycisków, etykiet kart i pozycji menu. Na tej samej stronie W3C zmierzono, że słowo „views” jest po niemiecku 2.8 razy dłuższe niż po angielsku. Drugim aspektem jest kierunek pisma: W3C wymienia dwanaście pism pisanych od prawej do lewej w 215 językach, a RTL to problem CSS, nie tłumaczenia.

Opcja pierwsza: biblioteka i18n działająca podczas kompilacji

Każdy tekst widoczny dla użytkownika opakowujesz wywołaniem funkcji, wyodrębniasz je do plików JSON dla poszczególnych lokalizacji i dołączasz do aplikacji. i18next to domyślny wybór w JavaScript, z około 16 milionami pobrań pakietu npm tygodniowo dla podstawowego pakietu i kolejnymi 11.6 milionami dla react-i18next (npm, tydzień rozpoczynający się 5 września 2026). Dokumentacja samej biblioteki trafnie opisuje jej zakres: „i18next wykracza poza zapewnianie standardowych funkcji i18n, takich jak liczba mnoga, kontekst, interpolacja i formatowanie”.

To właśnie jest główny argument przemawiający za tym rozwiązaniem. Zyskujesz kategorie liczby mnogiej, interpolację, warianty zależne od kontekstu, przestrzenie nazw ładowane na żądanie, a co najważniejsze, tłumaczenia przechowywane poza przeglądarką, dzięki czemu wiadomości e-mail, pliki PDF i błędy API korzystają z jednego katalogu. Kosztem jest czas pracy inżynierów: ktoś musi opakować ciągi tekstowe i pilnować, by nieprzetłumaczone teksty nie trafiały do każdego pull requesta.

Opcja druga: warstwa tłumaczeń działająca w czasie rzeczywistym

Drugie podejście nie wymaga zmian w kodzie. Skrypt obserwuje wyrenderowany DOM, zbiera widoczny tekst i zastępuje go w miarę pojawiania się kolejnych węzłów. Ponieważ reaguje na zmiany, a nie na ładowanie stron, obsługuje modale, powiadomienia typu toast i wiersze danych, które pojawiają się później w wyniku odpowiedzi API.

Największą zaletą jest szybkość. W ciągu jednego popołudnia zyskujesz przetłumaczony interfejs, bez ruszania komponentów, co sprawdza się w przypadku narzędzi wewnętrznych, paneli administracyjnych i produktów na wczesnym etapie rozwoju. To podejście obsługuje też treści tworzone przez użytkowników, czego pliki lokalizacyjne z założenia nie potrafią, ponieważ żaden etap kompilacji nie wie, co wpiszą Twoi klienci.

Ważniejsze są jednak ograniczenia. To podejście nie przetłumaczy ciągu znaków, który nigdy nie trafia do DOM, więc nie obejmuje e-maili transakcyjnych, powiadomień push ani odpowiedzi API. Przy pierwszym renderowaniu dodaje dodatkową rundę komunikacji sieciowej, więc przygotuj się na krótkie mignięcie nieprzetłumaczonej treści.

Gdzie wyznaczyć granicę między nimi

W praktyce granicę wyznacza sposób zarządzania treścią, a nie technologia. Jeśli ciąg znaków jest częścią specyfikacji produktu, a jego treść podlega weryfikacji i zatwierdzeniu, powinien znaleźć się w plikach lokalizacyjnych. Projekt Fluent Mozilli najlepiej pokazuje dlaczego: „Tłumacze powinni móc korzystać z pełnych możliwości wyrazowych swojego języka bez proszenia deweloperów o pozwolenie”. Nie da się tego osiągnąć za pomocą systemu, który widzi wyłącznie wyrenderowany tekst po angielsku.

Wszystko inne to treści: tekst pomocy, dzienniki zmian, marketing w aplikacji i wszystko, co napisali sami użytkownicy. Do tego właśnie stworzono WeLocale: wystarczy jeden znacznik script, tłumaczenie z AI zastosowane do bieżącego DOM-u, w tym do treści ładowanych po otwarciu strony, oraz edytor, w którym poprawisz każdy ciąg znaków błędnie przetłumaczony przez maszynę. WeLocale naprawdę nie jest odpowiednim narzędziem, jeśli przetłumaczone ciągi znaków są częścią specyfikacji produktu.

Pułapki, które wychodzą na jaw w drugim tygodniu

Ustaw atrybut lang i zmieniaj go wraz ze zmianą języka. Czytniki ekranu pobierają z niego reguły wymowy. Kryterium sukcesu WCAG 2.2 3.1.2 wymaga, aby „język każdego fragmentu lub wyrażenia w treści można było ustalić programowo”, a ekrany aplikacji z tekstem w wielu językach to dokładnie przypadek, z myślą o którym je opracowano.

Nie przejmuj się SEO w przypadku treści za logowaniem. Roboty indeksujące nigdy ich nie widzą, więc hreflang i indeksowalne adresy URL dla poszczególnych języków to w tym przypadku niepotrzebna praca. Mają znaczenie tylko w publicznie dostępnych częściach witryny.

Przemyśl strategię buforowania. Pakiety lokalizacyjne powinny być niezmienne i mieć odciski palca, a tłumaczenia tworzone w czasie działania aplikacji powinny być buforowane lokalnie, aby powracający użytkownicy nie pobierali ich ponownie. Napisz też test, który umieści najdłuższy niemiecki ciąg znaków w Twoim najwęższym przycisku.

FAQ

Czy mogę przetłumaczyć aplikację React lub Vue bez przepisywania komponentów? Tak, za pomocą warstwy działającej w czasie rzeczywistym, która obserwuje DOM i zastępuje tekst po wyrenderowaniu go przez framework. Obsługuje modale, powiadomienia typu toast i dane otrzymywane z API. Nie obejmuje ciągów znaków, które nigdy nie są renderowane w przeglądarce, takich jak e-maile transakcyjne czy komunikaty o błędach API.

A co z tekstem wpisywanym przez użytkowników? Pliki lokalizacyjne nie pomogą, ponieważ żaden etap kompilacji nie wie, co wpisze użytkownik. Treści tworzone przez użytkowników trzeba tłumaczyć w czasie rzeczywistym, za pomocą warstwy działającej na poziomie DOM-u albo wywołania API tłumaczeniowego we własnym kodzie przed wyświetleniem treści.

Czy potrzebuję znaczników hreflang w panelu aplikacji? Nie. Strony za logowaniem nigdy nie są indeksowane przez roboty, więc hreflang i indeksowalne adresy URL dla poszczególnych języków nic tam nie dają. Dodaj je do stron publicznych: witryny marketingowej, dokumentacji, strony z cennikiem i samego ekranu logowania.

Chcesz tego na swojej stronie? Dodaj ponad 50 języków jednym snippetem, bez zmian w kodzie.

Wypróbuj WeLocale za darmo