SvgIcon
Rendert SVG-Icons inline aus der OoSvgIcons-Bibliothek – kein HTTP-Request, typsicher,
beliebig skalierbar. Neue Icons einfach als Konstante in OoSvgIcons.cs ergänzen.
Alle Icons
Aufruf:
<SvgIcon Svg="@OoSvgIcons.Dateitypen.Pdf" /> –
Größe via Size oder IconSize.
Neue Konstanten in OoSvgIcons.cs erscheinen hier automatisch.
Dateitypen
Blank
Excel
Jpg
Movie
Outlook
Pdf
PowerPoint
Svg
Txt
Html
Json
Word
Word2
Zip
Größen via Size und IconSize
Skalierung über den
Size-Parameter (OoSize.Xxxs … OoSize.Xl); ohne Angabe ist das Icon 1.25rem groß.
IconSize setzt eine freie CSS-Größe und hat Vorrang vor Size.
Xxxs
Xxs
Xs
Sm
Md
Lg
Xl
Standard
IconSize="48px"
Size Xl + IconSize 1rem
Icon zur Dateiendung
OoSvgIcons.Dateitypen.GetSvgFuerExtension(endung) liefert das passende Icon – mit oder ohne führenden Punkt,
unabhängig von Groß-/Kleinschreibung; unbekannte Endungen ergeben Blank.
Wert: .pdf
bericht.PDF
daten.xlsx
brief.docx
folien.pptx
foto.jpg
film.mp4
mail.msg
notiz.md
seite.html
logo.svg
archiv.7z
unbekannt.xyz
Inline in Text
SvgIcon fügt sich als Inline-Element in Fließtext ein.
Das Dokument wird als Word-Datei gespeichert oder als exportiert.
Hover-Effekte
Da SVG-Farben als
Eigene Effekte weiterhin via
fill-Attribute eingebettet sind, funktioniert color nicht.
Die Lösung ist CSS filter – direkt als Parameter HoverEffect am SvgIcon setzen.
None
Standard
Brighten
Aufhellen
Dim
Abdunkeln
Lift
Anheben
Colorize
Grau → FarbeEigene Effekte weiterhin via
class oder style möglich. Vom Elternelement:.mein-button:hover .oo-svgicon { filter: brightness(1.3); }In Buttons
SvgIcon als
ChildContent im Button – kombiniert mit Text oder allein als Icon-Button.
In SmartLinks
SvgIcon als
ChildContent im SmartLink – als normaler Link oder mit Button-Styling.
In Badges & Text-Kombinationen
SvgIcon neben Text in Cards, Labels und sonstigen Layouts.
Jahresbericht.pdf
2,4 MB · PDF
Daten.xlsx
512 KB · Excel
Backup.zip
18 MB · Archiv
Barrierefreiheit
Ohne Angaben ist das Icon dekorativ (
aria-hidden="true"). Mit aria-label wird es als Bild
(role="img") vorgelesen; ein explizites aria-hidden wird übernommen.
dekorativ
aria-label + title
class & style
class und style werden an das Root-Element durchgereicht.
Neues Icon hinzufügen
So einfach geht es:
- SVG-Markup kopieren (z.B. von SimpleIcons, Material Symbols, eigene Vektoren).
- In
OoSvgIcons.cseine neuepublic const stringanlegen –
in einer bestehenden Kategorie-Klasse oder einer neuenstatic class. - Verwenden:
<SvgIcon Svg="@OoSvgIcons.MeineKategorie.MeinIcon" />
SKILL.md – Svgicon
---
name: SvgIcon
description: Onesown Blazor Komponente SvgIcon (Common). Verwende diesen Skill wenn du die SvgIcon-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# SvgIcon
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** Common
**Basisklasse:** `OoComponentBase`
Rendert ein SVG-Icon inline aus der -Bibliothek.
**Live-Demo:** https://components.schini.com/demo/svgicon
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Svg`` | ``string`` | **Pflicht** | Das SVG-Markup als String. Typischerweise eine Konstante aus , z.B. OoSvgIcons.Dateitypen.Pdf. |
| ``IconSize`` | ``string`` | | Optionale feste Breite/Höhe in CSS-Einheiten, z.B. "2rem" oder "48px". Relative Werte wie "1.2em" beziehen sich auf die Schriftgröße des Elternelements. Hat Vorrang vor Size. Ohne IconSize und Size ist das Icon 1.25rem groß. |
| ``HoverEffect`` | ``SvgIconHoverEffect`` | ``SvgIconHoverEffect.None`` | Optionaler Hover-Effekt. Alle Varianten basieren auf CSS filter und funktionieren unabhängig von den eingebetteten SVG-Farben. |
## Geerbte Parameter (OoComponentBase)
Alle nicht deklarierten HTML-Attribute (``class``, ``style``, ``data-*``, ``aria-*``, ...) werden an das Root-Element weitergereicht.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` | | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. |
## Hinweise
- Natives HTML-Attribut class wird automatisch an das Root-Element weitergegeben
- Natives HTML-Attribut style wird automatisch an das Root-Element weitergegeben
- Alle weiteren nicht deklarierten Attribute (data-*, aria-*, id, tabindex, …) werden ebenfalls weitergereicht
- Größe der Komponente via Size mit OoSize-Konstanten steuern (OoSize.Xs bis OoSize.Xl)
- Verwendung: <c><SvgIcon Svg="@OoSvgIcons.Dateitypen.Pdf" /></c>
- Größe: über den <c>Size</c>-Parameter (OoSize.Xxxs … OoSize.Xl), <c>IconSize</c> oder per Inline-<c>style</c>.
- Das SVG-Markup wird direkt ins DOM gerendert (kein HTTP-Request) – nur vertrauenswürdiges Markup übergeben, nie Benutzereingaben.
- Dateiendung → Icon: <c>OoSvgIcons.Dateitypen.GetSvgFuerExtension(".pdf")</c>.
- Barrierefreiheit: dekorative Icons erhalten automatisch <c>aria-hidden="true"</c>. Mit <c>aria-label</c> (oder <c>aria-labelledby</c>)
- wird das Icon als Bild (<c>role="img"</c>) vorgelesen; ein explizit gesetztes <c>aria-hidden</c> wird unverändert übernommen.
- Hover-Effekte: <c>HoverEffect="SvgIconHoverEffect.Lift"</c> etc.