ASP.NET Core의 스크립트 태그 도우미

  • 아티클

작성자: Rick Anderson

스크립트 태그 도우미는 기본 또는 대체 스크립트 파일에 대한 링크를 생성합니다. 일반적으로 기본 스크립트 파일은 콘텐츠 배달 네트워크(CDN)에 위치합니다.

CDN은:

  • 웹앱으로 자산을 호스팅하는 것과 비교해서 몇 가지 성능 이점을 제공합니다.
  • 자산에 대한 유일한 원본으로 의존해서는 안 됩니다. CDN을 항상 사용할 수 있는 것은 아니므로 안정적인 대체(fallback) 항목을 사용해야 합니다. 일반적으로 대체(fallback) 항목은 웹앱을 호스트하는 사이트입니다.

스크립트 태그 도우미를 사용하면 스크립트 파일에 CDN 및 CDN을 사용할 수 없는 경우를 대비한 대체를 지정할 수 있습니다. 스크립트 태그 도우미는 로컬 호스팅의 견고성과 함께 CDN의 성능 이점을 제공합니다.

다음 Razor 태그는 대체가 포함된 script 요소를 보여줍니다.

<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>

<script> 요소의 defer 특성을 사용하여 CDN 스크립트 로드를 지연시키지 마세요. 스크립트 태그 도우미는 asp-fallback-test 식을 즉시 실행하는 JavaScript를 렌더링합니다. CDN 스크립트 로딩이 지연되면 해당 식이 실패합니다.

일반적으로 사용되는 Script 태그 도우미 특성

모든 Script 태그 도우미 특성, 속성 및 메서드는 Script 태그 도우미를 참조하세요.

src

사용할 외부 스크립트의 주소입니다.

asp-append-version

asp-append-version에 src 특성과 함께 true 값을 지정하면 고유한 버전이 생성됩니다.

태그 도우미로 외부 wwwroot의 고정적인 파일 버전을 생성하려면 여러 위치에서 파일 제공을 참조하세요.

asp-fallback-src

기본 스크립트가 실패할 경우 대체할 Script 태그의 URL입니다.

asp-fallback-src-exclude

기본 스크립트가 실패하는 경우 대체 목록에서 제외할 JavaScript 스크립트의 globbed 파일 패턴에 대한 쉼표로 구분된 목록입니다. GLOB 패턴은 애플리케이션의 webroot 설정을 기준으로 평가됩니다. asp-fallback-src-include와 함께 사용해야 합니다.

asp-fallback-src-include

기본 스크립트가 실패하는 경우 대체될 JavaScript 스크립트의 globbed 파일 패턴에 대한 쉼표로 구분된 목록입니다. GLOB 패턴은 애플리케이션의 webroot 설정을 기준으로 평가됩니다.

asp-fallback-test

대체 테스트에 사용할 기본 스크립트에 정의된 스크립트 메서드입니다. 자세한 내용은 FallbackTestExpression를 참조하세요.

asp-order

ITagHelper 인스턴스 집합이 실행되면 인스턴스의 Init(TagHelperContext) 메서드가 먼저 지정된 순서로 호출된 다음 ProcessAsync(TagHelperContext, TagHelperOutput) 메서드가 지정된 순서로 호출됩니다. 낮은 값이 먼저 실행됩니다.

asp-src-exclude

로드에서 제외할 JavaScript 스크립트의 globbed 파일 패턴에 대한 쉼표로 구분된 목록입니다. GLOB 패턴은 애플리케이션의 webroot 설정을 기준으로 평가됩니다. asp-src-include와 함께 사용해야 합니다.

asp-src-include

로드할 JavaScript 스크립트의 globbed 파일 패턴에 대한 쉼표로 구분된 목록입니다. GLOB 패턴은 애플리케이션의 webroot 설정을 기준으로 평가됩니다.

asp-suppress-fallback-integrity

무결성 해시를 asp-fallback-src 값과 비교할지 여부를 결정하는 부울 값입니다.

추가 리소스