#(number)
#endfor ``` ## 사용법 다음은 Leaf의 일반적인 사용 예시입니다. ### 조건문 Leaf는 `#if` 태그를 사용해서 다양한 조건을 평가할 수 있습니다. 예를 들어, 변수를 제공하면 해당 변수가 컨텍스트에 존재하는지 확인합니다. ```leaf #if(title): The title is #(title) #else: No title was provided. #endif ``` 다음과 같이 비교문을 작성할 수도 있습니다. ```leaf #if(title == "Welcome"): This is a friendly web page. #else: No strangers allowed! #endif ``` 조건의 일부로 다른 태그를 사용하려면, 내부 태그의 `#`은 생략해야 합니다. 예를 들면 다음과 같습니다. ```leaf #if(count(users) > 0): You have users! #else: There are no users yet :( #endif ``` `#elseif` 문도 사용할 수 있습니다. ```leaf #if(title == "Welcome"): Hello new user! #elseif(title == "Welcome back!"): Hello old user #else: Unexpected page! #endif ``` ### 반복문 항목의 배열을 제공하면, Leaf는 `#for` 태그를 사용해서 이를 반복하고 각 항목을 개별적으로 다룰 수 있게 해줍니다. 예를 들어, 행성의 목록을 제공하도록 Swift 코드를 업데이트할 수 있습니다. ```swift struct SolarSystem: Codable { let planets = ["Venus", "Earth", "Mars"] } return req.view.render("solarSystem", SolarSystem()) ``` 그런 다음 Leaf에서 다음과 같이 반복할 수 있습니다. ```leaf Planets:Welcome to Vapor!
#endexport #endextend ``` `#export`를 호출해서 일부 HTML을 저장하고, 현재 확장하고 있는 템플릿에서 사용할 수 있도록 합니다. 그런 다음 `main.leaf`를 렌더링하고, Swift에서 전달된 다른 컨텍스트 변수와 함께 필요할 때 내보낸(export) 데이터를 사용합니다. 예를 들어, `main.leaf`는 다음과 같을 수 있습니다. ```leafWelcome to Vapor!
``` ### 그 밖의 태그 #### `#count` `#count` 태그는 배열에 포함된 항목의 개수를 반환합니다. 예를 들면 다음과 같습니다. ```leaf Your search matched #count(matches) pages. ``` #### `#lowercased` `#lowercased` 태그는 문자열의 모든 글자를 소문자로 변환합니다. ```leaf #lowercased(name) ``` #### `#uppercased` `#uppercased` 태그는 문자열의 모든 글자를 대문자로 변환합니다. ```leaf #uppercased(name) ``` #### `#capitalized` `#capitalized` 태그는 문자열의 각 단어의 첫 글자를 대문자로, 나머지 글자를 소문자로 변환합니다. 자세한 내용은 [`String.capitalized`](https://developer.apple.com/documentation/foundation/nsstring/1416784-capitalized)를 참고하세요. ```leaf #capitalized(name) ``` #### `#contains` `#contains` 태그는 배열과 값을 두 개의 파라미터로 받아서, 첫 번째 파라미터의 배열이 두 번째 파라미터의 값을 포함하는지 여부를 true로 반환합니다. ```leaf #if(contains(planets, "Earth")): Earth is here! #else: Earth is not in this array. #endif ``` #### `#date` `#date` 태그는 날짜를 읽기 쉬운 문자열로 포맷합니다. 기본적으로 ISO8601 포맷을 사용합니다. ```swift render(..., ["now": Date()]) ``` ```leaf The time is #date(now) ``` 두 번째 인자로 사용자 지정 날짜 포맷터 문자열을 전달할 수 있습니다. 자세한 내용은 Swift의 [`DateFormatter`](https://developer.apple.com/documentation/foundation/dateformatter)를 참고하세요. ```leaf The date is #date(now, "yyyy-MM-dd") ``` 세 번째 인자로 날짜 포맷터의 타임 존 ID를 전달할 수도 있습니다. 자세한 내용은 Swift의 [`DateFormatter.timeZone`](https://developer.apple.com/documentation/foundation/dateformatter/1411406-timezone)과 [`TimeZone`](https://developer.apple.com/documentation/foundation/timezone)을 참고하세요. ```leaf The date is #date(now, "yyyy-MM-dd", "America/New_York") ``` #### `#unsafeHTML` `#unsafeHTML` 태그는 변수 태그(예: `#(variable)`)처럼 동작합니다. 그러나 `variable`이 포함할 수 있는 HTML을 이스케이프하지 않습니다. ```leaf The time is #unsafeHTML(styledTitle) ``` !!! note 이 태그를 사용할 때는 제공하는 변수가 사용자를 XSS 공격에 노출시키지 않도록 주의해야 합니다. #### `#comment` `#comment` 태그를 사용하면 렌더링된 출력물에는 나타나지 않는 주석을 템플릿에 추가할 수 있습니다. 이 태그는 문자열 파라미터를 받으며, 이는 렌더링 시 완전히 무시됩니다. ```leaf #comment("This is a single-line comment")