Rule Builder – SVG-Stil konfigurieren – C#

SVG Style

Das SVG-Element <style> wird verwendet, um interne Stile innerhalb eines SVG-Dokuments zu definieren. Es ermöglicht Entwicklern, CSS-Regeln direkt auf SVG-Elemente anzuwenden und bietet so eine bequeme Möglichkeit, das Erscheinungsbild von SVG-Grafiken zu steuern.

Die Aspose.SVG Builder API bietet die Klasse SVGStyleElementBuilder, bei der es sich um einen Element-Builder zum Erstellen eines SVG-Elements <style> handelt. Diese Klasse erleichtert die Erstellung und Konfiguration eines SVG-Elements <style> mit CSS-Regeln.

In diesem Artikel geht es um die Klasse RuleBuilder, eine Builder-Klasse zum Erstellen von CSS-Stilregeln. Diese Klasse wird verwendet, um dynamisch eine Reihe von CSS-Stilen zu erstellen, indem verschiedene Attribute und deren Werte festgelegt werden.

Rule Builder – RuleBuilder-Klasse

Der Rule Builder ermöglicht Entwicklern die programmgesteuerte Anwendung von CSS-Regeln für SVG-Dokumente innerhalb von C#-Code und bietet so Flexibilität und Kontrolle über das visuelle Erscheinungsbild von SVG-Elementen. Dieses Beispiel zeigt, wie man ein SVG-Element <style> erstellt, ihm eine CSS-Regel @font-face hinzufügt und die AddRule()-Methode zum Definieren von Schriftstilen für Textelemente in einem SVG-Dokument:

using Aspose.Svg.Builder;
using System.Drawing;
using System.IO;

// Configure an SVG document's style with external font-face rules in C# using Rule Builder

// Initialize an SVG document
using (SVGDocument document = new SVGDocument())
{
    // Create an <svg> element and use Builder API to add other rules and elements to it
    SVGSVGElement svg = new SVGSVGElementBuilder()
        
       .AddDefs(def => def
            .AddStyle(st => st
                .Type("text/css")
                .AddRule("@font-face", r => r
                    .FontFamily("VeinlineRegular")
                    .Attribute("src", "url(https://assets.ithillel.ua/wiki/VeinlineRegular.ttf)")
                )
                .AddRule("text", t => t
                    .FontFamily("VeinlineRegular")
                    .FontSize(30, LengthType.Pt)
                )
            )
        )
            .AddText(t => t
            .X(20).Y(60).Fill(Color.DarkRed).FontWeight(FontWeight.Bold)
            .AddContent("Configure SVG Style")
            )
            .AddText(t => t
            .X(20).Y(150)
            .AddContent("Set your SVG style with Rule Builder!")
            )
        .Build(document.FirstChild as SVGSVGElement);

    // Save the SVG document
    document.Save(Path.Combine(OutputDir, "font-face.svg"));
}

@font-face-Regel

Mit der CSS-Regel @font-face können Sie Schriftarten für die Anzeige von Text auf Webseiten angeben, die entweder von einem Remote-Server oder vom Computer des Benutzers heruntergeladen werden können. Die Regel definiert einen benutzerdefinierten Schriftfamiliennamen und gibt die Quell-URL der Schriftdatei an.

• Die Methode FontFamily() legt das Attribut font-family für ein SVG-Element fest. Es gibt den Schriftartnamen an, der zum Festlegen der Schriftarteigenschaften verwendet wird.
• Die Attribute()-Methode der RuleBuilder-Klasse legt ein scr-Attribut für das <style>-Element mit der Quell-URL der Schriftartdatei fest.

Im obigen Beispiel definiert die @font-face-Regel eine benutzerdefinierte Schriftartfamilie mit dem Namen “VeinlineRegular”. Diese Regel stellt sicher, dass die Schriftart geladen wird und für die Verwendung im SVG-Dokument verfügbar ist.

AddRule()-Methode

Die Methode AddRule() ist Teil des Rule Builder, mit dem Sie CSS-Regeln in SVG-Dokumenten erstellen können. Es benötigt zwei Parameter: den Namen des CSS-Selektors und einen Lambda-Ausdruck, der die Eigenschaften des Stils mithilfe von RuleBuilder definiert.

Im obigen C#-Beispiel werden zwei Regeln hinzugefügt:

• Die erste Regel definiert die @font-face-Regel, die die Verfügbarkeit der Schriftart VeinlineRegular garantiert. – Die zweite Regel wendet die Schriftfamilie VeinlineRegular an und legt die Schriftgröße für alle Textelemente im SVG auf 30 Punkt fest.

Bauherren innerhalb der Bauherren

Die SVG Builder-API führt Syntax Sugar ein, um den Prozess der SVG-Erstellung und -Bearbeitung weiter zu verfeinern. Dazu gehören verschachtelte Builder für verschiedene SVG-Elemente, die eine intuitivere und effizientere Möglichkeit bieten, komplexe SVG-Strukturen zu definieren. Ein Builder-in-Builder-Muster beinhaltet die Verwendung mehrerer Builder-Klassen, wobei ein Builder in einem anderen verschachtelt ist, um die Konstruktion komplexer Objekte oder Strukturen zu erleichtern.

Der folgende Codeausschnitt zeigt, wie man RuleBuilder, ein Beispiel für einen Builder innerhalb eines Builders, verwendet, um SVG-Grafiken programmgesteuert zu erstellen und zu formatieren:

• Innerhalb des SVGSVGElementBuilder wird ein Stilblock mit der Methode AddStyle() hinzugefügt.
• Innerhalb des RuleBuilder werden CSS-Regeln mithilfe der Methode AddRule() definiert, indem Selektoren (z. B. “circle”, “text”) angegeben und Eigenschaften (z. B. Füllfarbe, Strichfarbe angewendet werden, Schriftfamilie), um auf SVG-Elemente abzuzielen.

using Aspose.Svg.Builder;
using System.Drawing;
using System.IO;

// Create SVG with styled circle and text elements using C# Rule Builder API and fluent syntax

// Initialize an SVG document
using (SVGDocument document = new SVGDocument())
{
    // Create an <svg> element and use Builder API to add other rules and elements to it
    SVGSVGElement svg = new SVGSVGElementBuilder()
       
        .AddStyle(st => st
            .AddRule("circle", r => r
                .Fill(paint: Paint.None)
                .Stroke(color: Color.DarkRed)
                .StrokeWidth(60)
            )
            .AddRule("text", t => t
                .Fill(color: Color.Red)
                .Stroke(color: Color.Teal)
                .StrokeWidth(1)
                .FontFamily("Arial")
                .FontSize(30, LengthType.Pt)
            )
        )
        .AddG(g => g
            .AddCircle(circle => circle.Cx(100).Cy(130).R(60).StrokeDashArray(2, 14))
            .AddText("Rule Builder", x: 230, y: 140)
        )
        .Build(document.FirstChild as SVGSVGElement);

    // Save the SVG document
    document.Save(Path.Combine(OutputDir, "rule-builder.svg"));
}

Abschluss

Aspose.SVG for .NET bietet eine Rule Builder-Funktion, die es Entwicklern ermöglicht, CSS-Regeln für SVG-Elemente mithilfe der SVG Builder-API programmgesteuert zu definieren.

• Die Verwendung der Klasse RuleBuilder vereinfacht das Erstellen und Anwenden von Stilen auf SVG-Elemente und erleichtert die Anpassung des Erscheinungsbilds von SVG-Grafiken in C#-Code.
• RuleBuilder bietet Flexibilität und Kontrolle über das visuelle Erscheinungsbild von SVG-Elementen.
• RuleBuilder fungiert als Builder im Builder, was die Erstellung komplexer Objekte oder Strukturen erleichtert und die Lesbarkeit des Codes verbessert, sodass er leichter verständlich ist.

Siehe auch

• Der Artikel Element Builders befasst sich eingehend mit den Element Buildern, die in der SVG Builder API verwendet werden. Sie erfahren mehr über die SVGElementBuilder-Klasse, ihre speziellen Builder und wie sie die SVG-Programmierung vereinfachen.
• Bitte lesen Sie den Artikel Path Builder, um mehr über die PathBuilder-Klasse zu erfahren, die die Erstellung und Bearbeitung von SVG-Pfaden vereinfachen soll. Der Artikel zeigt, wie der Path Builder eine intuitive Syntax zum programmgesteuerten Definieren von SVG-Pfaden bietet und es Entwicklern ermöglicht, den Prozess der Erstellung komplizierter Formen und Kurven zu optimieren.
• Im Artikel Paint Builder geht es um PaintBuilder, eine Builder-Klasse zum Erstellen von Farbwerten für SVG-Elemente. Diese Klasse wird verwendet, um den Wert der Attribute stroke oder fill für verschiedene SVG-Formen und -Elemente anzugeben, wenn diese mit Farbe, Muster oder Farbverlauf gefüllt werden.