Skript-Taghilfsprogramm in ASP.NET Core
Von Rick Anderson
Das Skript-Taghilfsprogramm generiert einen Link zu einer primären oder Fallback-Skriptdatei. Die primäre Skriptdatei befindet sich in der Regel in einem Content Delivery Network (CDN).
Für ein CDN gilt Folgendes:
- Es bietet einige Leistungsvorteile im Vergleich zum Hosten einer Ressource mit der Web-App.
- Es sollte nicht als einzige Quelle für eine Ressource verwendet werden. CDNs sind nicht immer verfügbar, daher sollte eine zuverlässige Fallbackquelle eingerichtet werden. Hierbei handelt es sich üblicherweise um die Website, auf der die Web-App gehostet wird.
Mit dem Skript-Taghilfsprogramm können Sie ein CDN für die Skriptdatei und eine Fallbackquelle angeben, wenn das CDN nicht verfügbar ist. Das Skript-Taghilfsprogramm bietet den Leistungsvorteil eines CDN kombiniert mit der Stabilität des lokalen Hostings.
Im folgenden Razor-Markup wird ein script
-Element mit einem Fallback veranschaulicht:
<script src="https://ajax.aspnetcdn.com/ajax/jquery/jquery-3.3.1.js"
asp-fallback-src="~/lib/jquery/dist/jquery.js"
asp-fallback-test="window.jQuery"
crossorigin="anonymous"
integrity="sha384-tsQFqpEReu7ZLhBV2VZlAu7zcOV+rXbYlF2cqB8txI/8aZajjp4Bqd+V6D5IgvKT">
</script>
Verwenden Sie nicht das defer-Attribut des <script>
-Elements, um das Laden des CDN-Skripts auszusetzen. Das Hilfsprogramm für Skripttags rendert JavaScript-Code, der sofort den Ausdruck asp-fallback-test ausführt. Der Ausdruck schlägt fehl, wenn das Laden des CDN-Skripts ausgesetzt wird.
Häufig verwendete Attribute des Skript-Taghilfsprogramms
Sie finden alle Attribute, Eigenschaften und Methoden des Skript-Taghilfsprogramms in der Referenz zur ScriptTagHelper-Klasse.
src
Adresse des zu verwendenden externen Skripts.
asp-append-version
Wenn asp-append-version
mit dem Wert true
zusammen mit einem src
-Attribut angegeben wird, wird eine eindeutige Version generiert.
Informationen darüber, wie ein Taghilfsprogramm eine Version für eine statische Datei außerhalb von wwwroot
generiert, finden Sie unter Bereitstellen von Dateien von mehreren Speicherorten.
asp-fallback-src
Die URL eines Skripttags, das als Fallback verwendet wird, falls die primäre URL nicht verfügbar ist.
asp-fallback-src-exclude
Eine durch Trennzeichen getrennte Liste mit Globdateimustern von JavaScript-Skripts, die aus der Fallbackliste ausgeschlossen werden sollen, falls das primäre Skript fehlschlägt. Die Globmuster werden relativ zur webroot
-Einstellung der Anwendung bewertet. Muss zusammen mit asp-fallback-src-include
verwendet werden.
asp-fallback-src-include
Eine durch Trennzeichen getrennte Liste mit Globdateimustern von JavaScript-Skripts, auf die ein Fallback ausgeführt werden soll, falls das primäre Skript fehlschlägt. Die Globmuster werden relativ zur webroot
-Einstellung der Anwendung bewertet.
asp-fallback-test
Die im primären Skript definierte Skriptmethode, die für den Fallbacktest verwendet wird. Weitere Informationen finden Sie unter FallbackTestExpression.
asp-order
Wenn eine Reihe von ITagHelper
-Instanzen ausgeführt wird, werden ihre Init(TagHelperContext)
-Methoden zuerst in der angegebenen Reihenfolge aufgerufen. Anschließend werden ihre ProcessAsync(TagHelperContext, TagHelperOutput)
-Methoden in der angegebenen Reihenfolge aufgerufen. Niedrigere Werte werden zuerst ausgeführt.
asp-src-exclude
Eine durch Trennzeichen getrennte Liste mit Globdateimustern von JavaScript-Skripts, die vom Laden ausgeschlossen werden sollen. Die Globmuster werden relativ zur webroot
-Einstellung der Anwendung bewertet. Muss zusammen mit asp-src-include
verwendet werden.
asp-src-include
Eine durch Trennzeichen getrennte Liste mit Globdateimustern von JavaScript-Skripts, die geladen werden sollen. Die Globmuster werden relativ zur webroot
-Einstellung der Anwendung bewertet.
asp-suppress-fallback-integrity
Boolescher Wert, der bestimmt, ob ein Integritätshash mit dem Wert „asp-fallback-src“ verglichen wird.
Zusätzliche Ressourcen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für