You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -178,7 +165,7 @@ import { translate } from '@docusaurus/Translate';
178
165
<KolAlert_type="info"_variant="card">
179
166
<small>
180
167
🧪 Das Server-Side-Rendering von Web Components ist eine neue spannende Funktionalität, wo noch Anpassungen an den
181
-
Prerenderer notwendig sein werden und wird daher unsererseits als experimentell eingestuft (<KolLink_href="https://web.dev/declarative-shadow-dom/"_target="web.dev"_label={`https://web.dev`} />).
168
+
Prerenderer notwendig sein werden und wird daher unsererseits als experimentell eingestuft (<KolLink_label="https://web.dev"_href="https://web.dev/declarative-shadow-dom/"_target="blank" />).
182
169
</small>
183
170
</KolAlert>
184
171
</p>
@@ -232,7 +219,7 @@ import { translate } from '@docusaurus/Translate';
232
219
</li>
233
220
</ul>
234
221
Die komplette Beschreibung der SemVer finden Sie hier:{''}
Copy file name to clipboardExpand all lines: docs/03-faq.mdx
+6-6Lines changed: 6 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -31,7 +31,7 @@ import { KolLink } from '@public-ui/react';
31
31
-**Was besagt die Lizenzierung?**<br/>
32
32
Die EUPL erlaubt die uneingeschränkte Nutzung der Artefakt, die auf konfigurative Weise an die eigenen Bedürfnisse angepasst werden können.
33
33
Andererseits erzwingt sie die Offenlegung von Änderungen, die beim Kopieren von Quellcode aus KoliBri hervorgegangen sind (Copy-Left).
34
-
Mehr hierzu finden Sie in der <KolLink_href="/docs/project/license"_label="Lizenz" />.
34
+
Mehr hierzu finden Sie in der <KolLink_label="Lizenz"_href="/docs/project/license" />.
35
35
36
36
## Theming und Styling
37
37
@@ -40,20 +40,20 @@ import { KolLink } from '@public-ui/react';
40
40
-**Wie funktioniert das Theming?**<br/>
41
41
In der Regel werden Web Components mit festem Styling erstellt. KoliBri trennt die semantisch barrierefreien Komponenten vom Styling und stellt dafür eine Register-Methode zum Kombinieren zur Verfügung. Da die Web Components im Browser grundsätzlich registriert (define) werden müssen, besteht hier die Möglichkeit, die Komponenten mit einem definierten Theme zu laden.
42
42
-**Wie kann man ein eigenes Theme erstellen?**<br/>
43
-
Wir arbeiten stets daran, das Erstellen und Pflegen von Themes weiter zu vereinfachen. Hierzu dienen z.B. das Basis-Styling (reines Layout) der Komponenten ab Version 1.5. Aufsetzen kann man einfach durch die Erstellung einer Theme-Definition, z.B. mit einem eigenen Theme-Projekt (NPM-Paket) mittels der <KolLink_href="https://github.com/public-ui/kolibri/blob/45726c50d7f28c9c595442b2241582816eca5670/packages/create-kolibri/templates/kolibri-library/packages/components/src/global/script.ts#L8"_label="TS-Datei"_target="github"/>. Hilfreich um Erstellen und Pflegen von Themes ist auch unser <KolLink_href="/designer/"_label="Theme-Designer"_target="designer"/>.
43
+
Wir arbeiten stets daran, das Erstellen und Pflegen von Themes weiter zu vereinfachen. Hierzu dienen z.B. das Basis-Styling (reines Layout) der Komponenten ab Version 1.5. Aufsetzen kann man einfach durch die Erstellung einer Theme-Definition, z.B. mit einem eigenen Theme-Projekt (NPM-Paket) mittels der <KolLink_label="TS-Datei"_href="https://github.com/public-ui/kolibri/blob/45726c50d7f28c9c595442b2241582816eca5670/packages/create-kolibri/templates/kolibri-library/packages/components/src/global/script.ts#L8"_target="blank"/>. Hilfreich um Erstellen und Pflegen von Themes ist auch unser <KolLink_label="Theme-Designer"_href="/designer/"_target="blank"/>.
44
44
-**Warum muss CSS in JavaScript verwalten werden?**<br/>
45
45
Das Stylen von KoliBri-Komponenten erfolgt nicht allein eingebundenes CSS oder die Verwendung von CSS-Frameworks (wie z.B. Bootstrap, Material-UI, Tailwind CSS, etc.), sondern
46
46
über das technische Setzen von CSS an der Komponente. Das hat den Vorteil, dass die Komponenten vom äußeren CSS unabhängig sind. Die Robustheit ist ein architektonischen Qualitätsziel. Sie spiegelt sich darin wieder, das nur die Komponente selbst über ihr Styling entscheidet.
47
47
-**Wozu braucht man das Schema?**<br/>
48
-
KoliBri basiert auf einer ausgeklügelten <KolLink_href="/docs/concepts/architecture"_label="Architektur" />. Beispielsweise dient das kleine Schema-Paket (@public-ui/schema) dazu, die Tag-Namen und Sprach-Keys der KoliBri-Komponenten unabhängig von der konkreten Implementierung zu definieren. Dies ermöglicht bei der Theme-Erstellung ein komplett losgelöstes Arbeiten mit Autovervollständigung, ohne aber die Komponenten und deren Abhängigkeiten zu benötigen. Das hat Vorteile bei manchen Integrationsszenarien, wie z.B. bei statischen Seiten oder Content-Management-Systemen (CMS).
48
+
KoliBri basiert auf einer ausgeklügelten <KolLink_label="Architektur"_href="/docs/concepts/architecture" />. Beispielsweise dient das kleine Schema-Paket (@public-ui/schema) dazu, die Tag-Namen und Sprach-Keys der KoliBri-Komponenten unabhängig von der konkreten Implementierung zu definieren. Dies ermöglicht bei der Theme-Erstellung ein komplett losgelöstes Arbeiten mit Autovervollständigung, ohne aber die Komponenten und deren Abhängigkeiten zu benötigen. Das hat Vorteile bei manchen Integrationsszenarien, wie z.B. bei statischen Seiten oder Content-Management-Systemen (CMS).
49
49
50
50
## Technisches
51
51
52
52
-**Wieso können KoliBri-Komponenten wirklich barrierefrei sein?**<br/>
53
53
Die KoliBri-Komponenten sind softwarearchitektonisch so designed, dass sie sich nur über Properties instrumentieren lassen und nicht über eignenes reingebbares HTML. Das bedeutet, dass die Komponenten nur über die API (Properties) gesteuert werden können. Das ist ein Qualitätsmerkmal, da die Komponenten so nicht von außen manipuliert werden können. Die Komponenten sind sehr restriktiv und können somit in sich immer barrierefrei sein.<br/>
54
-
Um aus dieser Restriktivität ausbrechen zu können, gibt es den <KolLink_href="/docs/concepts/expert-slot"_label="Expert-Slot" />, der es ermöglicht, eigenes HTML in die Komponente einzubetten. Die Barrierefreiheit über den Expert-Slot liegt in den Händen des Experten (Developers) und sollte nur in Ausnahmefällen verwendet werden.
54
+
Um aus dieser Restriktivität ausbrechen zu können, gibt es den <KolLink_label="Expert-Slot"_href="/docs/concepts/expert-slot" />, der es ermöglicht, eigenes HTML in die Komponente einzubetten. Die Barrierefreiheit über den Expert-Slot liegt in den Händen des Experten (Developers) und sollte nur in Ausnahmefällen verwendet werden.
55
55
-**Warum werden die Eigenschaften von Komponenten manchmal abweichend vom HTML-Naming benannt?**<br/>
56
-
Um die Erlernbarkeit von KoliBri zu einfach zu halten, wird in der Regel immer das Naming des HTML verwenden. Doch auch der HTML-Standard ist in seinem Naming über mehrerer Element (Komponenten) nicht einheitlich. Und daher kommt es dazu, dass wir in KoliBri für gleichartige Eigenschaften übergreifend einheitliche Namen gewählt haben. Mehr dazu finden Sie im Konzept <KolLink_href="/docs/concepts/properties"_label="Eigenschaften" />.
56
+
Um die Erlernbarkeit von KoliBri zu einfach zu halten, wird in der Regel immer das Naming des HTML verwenden. Doch auch der HTML-Standard ist in seinem Naming über mehrerer Element (Komponenten) nicht einheitlich. Und daher kommt es dazu, dass wir in KoliBri für gleichartige Eigenschaften übergreifend einheitliche Namen gewählt haben. Mehr dazu finden Sie im Konzept <KolLink_label="Eigenschaften"_href="/docs/concepts/properties" />.
57
57
58
58
## Barrierefreiheit
59
59
@@ -62,4 +62,4 @@ import { KolLink } from '@public-ui/react';
62
62
63
63
## Noch Fragen offen?
64
64
65
-
Wenn noch Fragen offen sind, dann schreiben Sie uns gerne eine E-Mail an <KolLink_href="mailto:kolibri@itzbund.de"_label="kolibri@itzbund.de"_target="email"_icons="codicon codicon-mail" />.
65
+
Wenn noch Fragen offen sind, dann schreiben Sie uns gerne eine E-Mail an <KolLink_href="mailto:kolibri@itzbund.de"_label="kolibri@itzbund.de"_icons="codicon codicon-mail" />.
Alle Pakete/Artefakte von KoliBri werden in der öffentlichen <kol-link_href="https://www.npmjs.com/search?q=%40public-ui"_label="NPM-Registry"_target="npmjs"></kol-link> versioniert bereitgestellt.
11
+
Alle Pakete/Artefakte von KoliBri werden in der öffentlichen <KolLink_label="NPM-Registry"_href="https://www.npmjs.com/search?q=%40public-ui"_target="blank" /> versioniert bereitgestellt.
<span>Klicken Sie hier, um den Designer in einem neuen Browser-Fenster zu öffnen.</span>
24
-
</div>
25
-
</KolLink>
7
+
<KolLink_label="Klicken Sie hier, um den Designer in einem neuen Browser-Fenster zu öffnen."_href="/designer"_target="blank"_icons={{ left:'codicon codicon-paintcan' }} />
26
8
</KolCard>
27
9
</div>
28
10
@@ -32,8 +14,7 @@ Mithilfe des KoliBri-Designers können Benutzer für die KoliBri-Bibliothek schn
32
14
Die fertigen Styles können anschließend als Theme heruntergeladen und im eigenen Projekt eingefügt werden.
33
15
34
16
<kol-alert_label="Designer oder Scss"_type="info"_variant="card">
35
-
KoliBri bietet zum Erstellen von Themes auch einen <kol-link_href="/docs/concepts/styling/scss"_label="Scss" />
36
-
-Ansatz an. Je nach persönlichen Präferenzen kann der Designer oder Scss verwendet werden.
17
+
KoliBri bietet zum Erstellen von Themes auch einen <KolLink_label="Scss"_href="/docs/concepts/styling/scss" />-Ansatz an. Je nach persönlichen Präferenzen kann der Designer oder Scss verwendet werden.
0 commit comments