| English | Polish | Comment |
|---|---|---|
| ahead-of-time compilation | kompilacja z wyprzedzeniem | |
| API reference | dokumentacja API | |
| array | tablica | |
| arrow function | funkcja strzałkowa | za pierwszym razem dopisek (ang. *arrow function*) |
| assertion; to assert | asercja lub sprawdzenie; wykonać sprawdzenie lub sprawdzać, testować | |
| asset | zasób | |
| boilerplate | kod szablonowy | za pierwszym razem (ang. *boilerplate*) |
| breaking older browsers | nie jest kompatybilny ze starszymi przeglądarkami | |
| bug | błąd | |
| build pipeline | potok budowania | |
| bundler | bundler | |
| callback | funkcja zwrotna | za pierwszym razem dopisem (ang. *callback*) |
| camelCase | notacja "camelCase" | odmiana: camelCasem, ale: camelCase'owi, camelCase'a lub z dodatkiem słowa "notacja" - wtedy odmieniamy tylko to słowo |
| CDN | CDN | |
| child component | komponent potomny | |
| client(s) | klient(y) | NIE: klienci |
| commit | (na Gicie) commit, commitem, (poza Gitem) czas. akceptować, wdrażać, potwierdzać | |
| component wrapping | opakowywanie komponentu | |
| concept, idea | koncepcja, zagadnienie | |
| controlled component | komponent kontrolowany | |
| data | wartość, dane | |
| debugging | debugowanie | |
| destructuring assignment | przypisanie destrukturyzujące | |
| Dev Tools | Narzędzia deweloperskie | |
| development server | serwer deweloperski | |
| dispatcher | dyspozytor | za pierwszym razem dopisem (ang. *dispatcher*) |
| dispatching an event | przesyłanie zdarzenia | |
| dummy component | sztuczny komponent | |
| element | element | |
| event handler | procedura obsługi zdarzenia | |
| fallback | zastępczy lub awaryjny | |
| focus | fokus | "ustawianie fokusu na polu formularza" lub "aktywowanie pola formularza" |
| framework | framework | |
| generic | generyczny, ogólny, ogólnego użytku | |
| Git, GitHub | Git, Gitem, Gicie; GitHub, GitHubem, GitHubie | |
| Glossary | Słownik pojęć | |
| hands-on tutorial | praktyczny tutorial | |
| HTML entities | encje HTML | |
| immutable | niezmienny | za pierwszym razem dopisek (ang. *immutable*) |
| inline condition | warunek wewnątrzliniowy | |
| input (data) | dane wejściowe | |
| JavaScript | M:JavaScript, D:JavaScriptu, C:JavaScriptowi, B:JavaScriptu, N:JavaScriptem, Ms:JavaScripcie, W:JavaScript | przymiotnik piszemy małymi literami: "javascriptowy" |
| lazy initialization | leniwa inicjalizacja | za pierwszym razem (ang. *lazy initialization*) |
| library | biblioteka | |
| lowercase | małymi literami | NIE piszemy: "z małej litery"! |
| local storage | pamięć lokalna | |
| minify, minification | czas. minifikować, rzecz. minifikacja | |
| mocked component, component mock | atrapa komponentu | |
| opt-in | (stosowane) wedle własnego uznania | |
| output (data) | dane wyjściowe, rezultat, wynik | |
| overview | ogólne informacje | |
| playground | środowisko eksperymentalne | |
| polyfill | łatka | |
| primitive | typ podstawowy | |
| Promise | obietnica | za pierwszym razem (ang. *promise*) |
| property | właściwość | zmienna w obiekcie |
| read-only | tylko do odczytu | |
| render | czas. renderować, rzecz. renderowanie | alternatywa: "wyświetlać" |
| (HTTP) request | rzecz. żądanie (HTTP), czas. wysyłać żądanie | |
| (HTTP) response | rzecz. odpowiedź (HTTP) | |
| reusable | wielokrotnego użytku | |
| sandbox | środowisko izolowane | |
| roadmap | plan działania | |
| section | podrozdział, rozdział, sekcja | |
| shallow rendering | renderowanie płytkie | |
| Single Page Application, SPA | aplikacja jednostronicowa | |
| snapshot | zrzut | |
| spread operator | operator rozszczepienia | |
| state | stan | |
| store | magazyn | |
| string | "ciąg znaków" lub "łańcuch znaków" lub "napis" lub "literał znakowy" | |
| syntactic sugar | lukier składniowy | za pierwszym razem (ang. *syntactic sugar*) |
| tag [HTML] | znacznik [HTML] | |
| template literal | literał szablonowy | za pierwszym razem (ang. *template literal*) |
| term | pojęcie | |
| throws an exception | rzuca wyjątek | |
| two-way binding | wiązanie dwukierunkowe | alternatywnie "one-way binding" jako "jednokierunkowe" |
| UI | "UI" lub "interfejs użytkownika" | |
| uncontrolled component | komponent niekontrolowanie | |
| update | czas. aktualizuje, rzecz. aktualizacja | |
| uppercase | wielkimi literami | NIE piszemy: "z wielkiej litery"! |
| Versioned Documentation | Dokumentacja wersji | |
| wrapper component | komponent opakowujący |
Tytuły (np. rozdziałów, książek, utworów) piszemy w cudzysłowie bądź też bez cudzysłowu, ale kursywą (patrz: poradnia PWN)
Przykłady:
- ... znajdziesz w rozdziale pt. "Jak łączyć się z API"?
- ... znajdziesz w rozdziale pt. Jak łączyć się z API?
- Nazwy własne odmieniamy zgodnie z obowiązującymi zasadami w języku polskim (przydatna okazuje się tu wyszukiwarka Poradni PWN). Przykłady: Link 1, Link 2, Link 3.
- Nie piszemy "Ci", "Tobie", "Twój", lecz "ci", "tobie", "twój".
- Staramy się, żeby tekst był spójny i logiczny, nawet jeśli taki nie jest w oryginale.
- Ten samouczek jest dość nieformalny i ma być przyjazny dla czytelnika, dlatego możemy spokojnie pisać "mamy", "robimy" itp.
- Nie piszmy "zrobiłeś", "przeczytałeś" (ze wskazaniem na rodzaj męski), bo to jest kiepsko odbierane (nawet nie chodzi o równouprawnienie i tym podobne, a o sam "dysonans" podczas czytania przez kobiety ;)).
Co można tłumaczyć:
- komentarze
- stringi, jeśli są tylko tekstem wyświetlanym na stronie
Czego nie można tłumaczyć:
- nazw zmiennych, funkcji, klas
- słów kluczowych
- stringów, które są interpretowane przez kod (np. klasy w CSS)