c3412a44fc
* docs: polish localized documentation - Rewrite Russian documentation for natural terminology and current source parity\n- Continue the Polish editorial pass across guides and SDK references\n- Refresh shared localized SDK API data imports * docs(pl): complete editorial pass - Rewrite the remaining advanced Vue SDK references\n- Refresh the Figma compatibility matrix against the canonical source\n- Align terminology and behavior across every Polish documentation page * docs(de): complete editorial pass - Rewrite German guides, automation docs, and Vue SDK references\n- Restore current AI, export, component, and variable behavior\n- Refresh the Penpot comparison and Figma compatibility matrix * docs(es): complete editorial pass - Rewrite Spanish guides, automation docs, and Vue SDK references\n- Restore current AI, export, component, and variable behavior\n- Refresh the Penpot comparison and Figma compatibility matrix * docs(fr): complete editorial pass - Rewrite French guides, automation docs, and Vue SDK references\n- Restore current AI, export, component, and variable behavior\n- Refresh the Penpot comparison and Figma compatibility matrix * docs: correct localized terminology - Replace unnecessary English prose with natural localized terminology\n- Derive documentation aliases from named directory roots\n- Preserve English only for identifiers, APIs, and exact product terms * docs(it): continue editorial pass - Rewrite Italian user guides and automation documentation\n- Update Vue SDK composables and component references\n- Restore current AI, export, component, and variable behavior * docs(it): complete editorial pass - Finish Italian advanced SDK and reference documentation\n- Refresh the Penpot comparison and Figma compatibility matrix\n- Replace literal machine translations with natural technical prose * docs(pl): refine property panel terminology * docs: refine remaining localized prose - Replace overfitted English prose in Polish feature documentation\n- Rewrite the Russian property-list reference in natural terminology * docs(ru): rewrite Penpot comparison naturally - Replace remaining English prose with natural Russian\n- Preserve code identifiers and library names only where required * docs: rewrite localized feature overviews naturally - Replace avoidable English prose in German, Spanish, and French\n- Keep identifiers and product names unchanged * docs(de): refine property panel terminology * docs: refine Spanish and French SDK terminology * docs(ru): continue full prose audit - Rewrite homepage, setup, navigation, and guide index naturally\n- Restore missing zoom shortcuts * docs(ru): audit user and automation guides - Rewrite selection, collaboration, and automation prose naturally\n- Preserve API identifiers while localizing ordinary terminology * docs(ru): audit CLI inspection and analysis * docs(ru): audit Vue SDK overview and guides * docs(ru): audit Vue SDK API prose - Localize ordinary component and composable terminology\n- Preserve API symbols and code identifiers * docs(ru): audit advanced and gradient API references * docs(ru): finish advanced API prose audit * docs(ru): audit JSX renderer guide * docs(ru): audit CLI export and scripting guides * docs(pl): audit Penpot comparison prose * docs(pl): audit selection and automation guides * docs(pl): audit homepage and variable guides * docs(pl): audit vector, layers, and Pen guides * docs(pl): audit Auto layout and shape guides * docs(pl): audit context menu and export guides * docs(pl): audit JSX and analysis guides * docs(pl): audit AI Chat guide * docs(pl): audit components and CLI inspection * docs(pl): audit scripting and SDK overview prose * docs(pl): audit SDK API indexes * docs(pl): audit SDK component references * docs(pl): audit SDK composable references * docs(ru): refine usePosition terminology * docs(pl): audit advanced SDK references * docs(pl): audit Figma compatibility matrix * docs(pl): finish residual SDK terminology audit * docs(pl): finish component terminology audit * docs(pl): finish SDK guide terminology audit * docs(de): begin full user guide prose audit * docs(de): audit navigation, Pen, and layers guides * docs(de): audit Auto Layout, shapes, menu, and export * docs(de): audit components, text, and vector guides * docs(de): audit variables and automation overview * docs(de): audit AI Chat and collaboration guides * docs(de): audit CLI inspection, analysis, and export * docs(de): audit scripting and JSX guides * docs(de): audit Vue SDK overview and guides * docs(de): audit SDK API indexes * docs(de): audit SDK component references * docs(de): audit SDK composable references * docs(de): audit advanced SDK references * docs(de): audit Penpot comparison prose * docs(de): audit Figma compatibility reference * docs(es): begin full user guide prose audit * docs(es): audit document organization guides * docs(es): audit editing workflow guides * docs(es): audit automation and collaboration prose * docs(es): audit CLI inspection and export guides * docs(es): audit CLI scripting guide * docs(es): audit JSX and feature overview prose * docs(es): audit Penpot comparison prose * docs(es): audit SDK overview and guides * docs(es): begin SDK component reference audit * docs(es): audit SDK navigation component references * docs(es): audit SDK color and layout components * docs(es): begin SDK composable reference audit * docs(es): audit SDK property composable references * docs(es): audit SDK editor composable references * docs(es): begin advanced SDK reference audit * docs(es): audit advanced SDK state references * docs(es): complete advanced SDK reference audit * docs(es): audit Figma compatibility reference * docs(es): complete residual terminology sweep * docs(fr): begin full prose second audit * docs(fr): audit AI and variables prose * docs(fr): audit core user guide prose * docs(fr): audit editing workflow guides * docs(fr): audit CLI and JSX prose * docs(fr): audit Penpot comparison prose * docs(fr): audit SDK overview and guides * docs(fr): begin SDK API reference audit * docs(fr): audit SDK navigation component references * docs(fr): audit SDK color and layout components * docs(fr): begin SDK composable reference audit * docs(fr): audit SDK property composable references * docs(fr): audit editor composables and advanced APIs * docs(fr): audit advanced SDK state references * docs(fr): complete advanced SDK reference audit * docs(fr): audit Figma compatibility reference * docs(fr): complete residual terminology sweep * docs(it): begin full prose second audit * docs(it): audit document workflow guides * docs(it): audit editing and automation prose * docs(it): audit CLI and JSX prose * docs(it): audit Penpot comparison and SDK guides * docs(it): begin SDK API reference audit * docs(it): audit SDK component and state references * docs(it): audit residual SDK references * docs(it): audit Figma compatibility reference * docs(it): complete residual terminology sweep * docs(i18n): verify residual locale terminology
71 lines
4.1 KiB
Markdown
71 lines
4.1 KiB
Markdown
---
|
|
title: Komponenty
|
|
description: Komponenty, egzemplarze, zestawy wariantów, nadpisania, synchronizacja i biblioteki w OpenPencil.
|
|
---
|
|
|
|
# Komponenty
|
|
|
|
Komponent jest elementem projektu przeznaczonym do ponownego użycia. Po zmianie głównego komponentu wszystkie powiązane egzemplarze aktualizują się automatycznie.
|
|
|
|
## Zasoby
|
|
|
|
Otwórz kartę **Assets** w lewym panelu, aby zobaczyć lokalne komponenty i włączone biblioteki. Dostępne są widok siatki, lista i wyszukiwanie według nazwy.
|
|
|
|
Zasób można dodać do obszaru roboczego kliknięciem, klawiszem <kbd>Enter</kbd> lub przeciągnięciem. Zasoby biblioteki pozostają dostępne bez sieci, jeśli ich wersja została wcześniej pobrana.
|
|
|
|
## Tworzenie komponentu
|
|
|
|
Zaznacz ramkę lub grupę i naciśnij <kbd>⌥</kbd><kbd>⌘</kbd><kbd>K</kbd>. Jeśli zaznaczono kilka obiektów, OpenPencil umieszcza je w nowym komponencie o granicach zgodnych ze wspólną ramką ograniczającą.
|
|
|
|
## Zestawy komponentów i warianty
|
|
|
|
Zaznacz co najmniej dwa komponenty i naciśnij <kbd>⇧</kbd><kbd>⌘</kbd><kbd>K</kbd>. OpenPencil połączy je w zestaw z fioletową przerywaną ramką.
|
|
|
|
Każdy komponent w zestawie może określać kilka wymiarów wariantu, na przykład `Size=Small`, `State=Hover` i `Theme=Dark`. Nie trzeba tworzyć wszystkich kombinacji. Wariant w lewym górnym rogu jest domyślny i służy jako zamiennik, gdy dokładna kombinacja nie istnieje.
|
|
|
|
## Właściwości komponentów
|
|
|
|
Komponenty obsługują właściwości tekstu, widoczności logicznej i zamiany egzemplarza. Powiąż właściwość z polem obiektu potomnego, aby zmieniać jej wartość w egzemplarzu bez odłączania.
|
|
|
|
## Biblioteki
|
|
|
|
Biblioteka publikuje komponenty jako niezmienne wersje. Każdy zasób ma stałe identyfikatory biblioteki, zasobu i wersji, dlatego różne egzemplarze mogą pozostać na różnych wersjach do jawnej aktualizacji.
|
|
|
|
### Publikowanie
|
|
|
|
Otwórz **Assets → Manage libraries → Publish library**, podaj stały identyfikator i nazwę biblioteki, wybierz zmiany i opublikuj. Niewybrane zmiany pozostaną oczekujące.
|
|
|
|
### Włączanie i wstawianie zasobów
|
|
|
|
Włącz bibliotekę w **Manage libraries**. Jej komponenty pojawią się obok lokalnych. Opublikowane definicje są tylko do odczytu; powiązane egzemplarze można nadal dostosowywać za pomocą właściwości i nadpisań.
|
|
|
|
### Aktualizacje
|
|
|
|
W **Manage libraries → Updates** można porównać bieżący i nowy egzemplarz, a następnie zaktualizować jeden egzemplarz, wszystkie egzemplarze zasobu, bieżącą stronę albo wszystkie strony.
|
|
|
|
OpenPencil zachowuje zgodne ustawienia tekstu, widoczności i zamiany egzemplarza. Jeśli dokładny wariant zniknął, przed potwierdzeniem pojawi się wariant zastępczy. Aktualizację można cofnąć.
|
|
|
|
### Praca bez sieci
|
|
|
|
Biblioteka może być lokalna albo znajdować się u skonfigurowanego dostawcy pamięci masowej. Pobrane wersje są zapisywane lokalnie. Powiązania i potrzebne definicje są również przechowywane w `.fig`, dzięki czemu dokument można otworzyć bez dostępu do zdalnej biblioteki.
|
|
|
|
## Egzemplarze
|
|
|
|
Kliknij komponent prawym przyciskiem i wybierz **Utwórz egzemplarz**. Aby odłączyć egzemplarz, zaznacz go i naciśnij <kbd>⌥</kbd><kbd>⌘</kbd><kbd>B</kbd> albo <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>B</kbd>.
|
|
|
|
Polecenie **Przejdź do głównego komponentu** otwiera komponent źródłowy, także na innej stronie.
|
|
|
|
## Synchronizacja i nadpisania
|
|
|
|
Zmiany głównego komponentu aktualizują szerokość, wysokość, zalewy, obwiednie, efekty, przezroczystość, promienie narożników, układ i przycinanie zawartości egzemplarzy.
|
|
|
|
Egzemplarz może nadpisać wybrane właściwości bez utraty powiązania. Dotyczy to między innymi nazwy, tekstu, czcionki, zalewów, obwiedni, efektów, przezroczystości i rozmiarów.
|
|
|
|
Dodanie obiektu potomnego do głównego komponentu dodaje jego kopię do istniejących egzemplarzy.
|
|
|
|
## Wskazówki
|
|
|
|
- Zmiana tekstu wewnątrz egzemplarza tworzy nadpisanie.
|
|
- Zestawy komponentów nadają się do wariantów o kilku wymiarach, takich jak rozmiar, stan i motyw.
|
|
- Publikuj zasoby z dokumentu źródłowego; opublikowane definicje są celowo tylko do odczytu.
|