rubyonrails.org에서 더 보기:

GitHub에서 이 파일을 읽지 마세요. 가이드는 https://guides.rubyonrails.org 에서 제공됩니다.

Action View Helpers

이 가이드를 읽고 나면 다음을 알 수 있습니다:

  • 날짜, 문자열, 숫자를 포맷하는 방법
  • 텍스트와 태그를 다루는 방법
  • 이미지, 비디오, stylesheet 등을 링크하는 방법
  • View에서 Atom feed와 JavaScript를 다루는 방법
  • 컨텐츠를 캐시, 캡처, 디버그, 살균(sanitize)하는 방법

다음은 Action View에서 사용 가능한 가장 일반적으로 사용되는 helper들을 설명합니다. 이는 좋은 시작점이 되지만, 모든 helper에 대해 더 자세히 다루고 있는 전체 API Documentation을 검토하는 것도 권장됩니다.

1 Formatting

1.1 날짜

이 helper들은 날짜나 시간 요소를 사람이 읽기 쉬운 형태로 표시하는데 도움을 줍니다.

1.1.1 distance_of_time_in_words

Time 또는 Date 객체, 또는 초 단위의 정수 사이의 대략적인 시간 간격을 나타냅니다. 더 자세한 근사값을 원한다면 include_seconds를 true로 설정하세요.

distance_of_time_in_words(Time.current, 15.seconds.from_now)  
# => 1분 미만
distance_of_time_in_words(Time.current, 15.seconds.from_now, include_seconds: true)
# => 20초 미만

우리는 Time.now 대신 Time.current를 사용합니다. 그 이유는 Time.now가 서버의 타임존을 기준으로 Time 객체를 반환하는 반면, Time.current는 Rails에 설정된 타임존을 기준으로 현재 시간을 반환하기 때문입니다.

자세한 내용은 distance_of_time_in_words API 문서를 참조하세요.

1.1.2 time_ago_in_words

Time 또는 Date 객체나 초 단위의 정수와 Time.current 사이의 대략적인 시간 차이를 보고합니다.

time_ago_in_words(3.minutes.from_now) # => 3분

time_ago_in_words API 문서 에서 더 자세한 정보를 확인하세요.

1.2 숫자

숫자를 포맷된 문자열로 변환하는 메소드 모음입니다. 전화번호, 통화, 백분율, 정밀도, 위치 표기법, 파일 크기를 위한 메소드들이 제공됩니다.

1.2.1 number_to_currency

숫자를 통화 문자열로 포맷팅합니다(예: $13.65).

number_to_currency(1234567890.50) # => ₩1,234,567,890.50

number_to_currency API 문서에서 더 자세한 정보를 확인하세요.

1.2.2 number_to_human

사용자가 더 읽기 쉽도록 숫자를 보기 좋게 출력(형식화 및 근사화)합니다. 매우 큰 숫자를 다룰 때 유용합니다.

number_to_human(1234)    # => 1.23 천
number_to_human(1234567) # => 1.23 백만

number_to_human API Documentation에서 더 자세한 정보를 확인하세요.

1.2.3 number_to_human_size

바이트 크기를 더 이해하기 쉬운 형태로 포맷팅합니다. 사용자에게 파일 크기를 보고할 때 유용합니다.

number_to_human_size(1234)    # => 1.21 KB
number_to_human_size(1234567) # => 1.18 MB

number_to_human_size API 문서에서 더 자세한 정보를 확인하세요.

1.2.4 number_to_percentage

숫자를 백분율 문자열로 형식화합니다.

number_to_percentage(100, precision: 0) # => 100%

number_to_percentage API 문서에서 더 자세한 정보를 확인하세요.

1.2.5 number_to_phone

숫자를 전화번호 형식으로 포맷팅합니다(기본값은 미국식).

number_to_phone(1235551234) # => 123-555-1234 

number_to_phone API 문서에서 더 자세한 정보를 확인하세요.

1.2.6 number_with_delimiter

구분자를 사용하여 천 단위로 그룹화된 숫자를 포맷합니다.

number_with_delimiter(12345678) # => 12,345,678

number_with_delimiter API 문서에서 더 자세한 정보를 확인하세요.

1.2.7 number_with_precision

기본값 3으로 설정된 지정된 precision 수준으로 숫자를 포맷합니다.

number_with_precision(111.2345)               # => 111.235
number_with_precision(111.2345, precision: 2) # => 111.23

number_with_precision API 문서에서 자세한 내용을 확인하세요.

문자열을 필터링, 포맷팅, 변환하기 위한 메서드 집합입니다.

1.3 텍스트

1.3.1 excerpt

주어진 textphrase에서, excerpt는 첫 번째 phrase 발견 위치를 찾아 추출하고, radius로 지정된 주변 텍스트를 함께 가져옵니다. 결과의 시작/끝이 텍스트의 시작/끝과 일치하지 않는 경우 생략 표시가 앞/뒤에 추가됩니다.

excerpt("This is a very beautiful morning", "very", separator: " ", radius: 1)
# => ...a very beautiful...

excerpt("This is also an example", "an", radius: 8, omission: "<chop> ")
# => <chop> is also an example

excerpt API 문서에서 더 자세한 정보를 확인할 수 있습니다.

1.3.2 pluralize

숫자 값을 기준으로 단어의 단수형 또는 복수형을 반환합니다.

pluralize(1, "person") # => 1 person 
pluralize(2, "person") # => 2 people
pluralize(3, "person", plural: "users") # => 3 users

pluralize API Documentation 에서 더 자세한 정보를 확인할 수 있습니다.

1.3.3 truncate

주어진 text를 주어진 length만큼 자릅니다. 텍스트가 잘린 경우, 생략 표시가 length를 초과하지 않는 전체 길이로 결과에 추가됩니다.

truncate("Once upon a time in a world far far away")
# => "Once upon a time in a world..."

truncate("Once upon a time in a world far far away", length: 17) 
# => "Once upon a ti..."

truncate("one-two-three-four-five", length: 20, separator: "-")
# => "one-two-three..."

truncate("And they found that many people were sleeping better.", length: 25, omission: "... (continued)")
# => "And they f... (continued)"

truncate("<p>Once upon a time in a world far far away</p>", escape: false)
# => "<p>Once upon a time in a wo..."

truncate API 문서에서 더 자세한 내용을 확인하세요.

1.3.4 word_wrap

텍스트를 line_width 폭을 넘지 않는 길이의 줄로 감싸줍니다.

word_wrap("Once upon a time", line_width: 8)
# => 주어진 line_width에 맞춰 줄바꿈된 문자열:
# => "Once\nupon a\ntime"

API Documentation word_wrap에 대한 자세한 정보는 여기를 참조하세요.

2 Forms

Form helper는 일반적인 HTML 요소만 사용하는 것과 비교하여 모델 작업을 단순화합니다. Form helper는 모델을 기반으로 폼을 생성하는데 맞춤화된 다양한 메서드를 제공합니다. 일부 메서드는 text field, password field, select dropdown 등과 같은 특정 유형의 입력에 대응됩니다. 폼이 제출되면 폼 내의 입력값들이 params 객체로 그룹화되어 컨트롤러로 전송됩니다.

Form helper에 대해 더 자세히 알아보려면 Action View Form Helpers 가이드를 참조하세요.

라우팅 하위 시스템에 의존하는 링크와 URL을 구축하기 위한 메서드 모음입니다.

3.1 button_to

전달된 URL로 제출되는 폼을 생성합니다. 폼에는 name 값을 가진 submit 버튼이 포함됩니다.

<%= button_to "로그인", sign_in_path %>

다음과 같은 HTML을 출력합니다:

<form method="post" action="/sessions" class="button_to">
  <input type="submit" value="로그인" />
</form>

button_to API 문서에서 더 자세한 정보를 확인하세요.

3.2 current_page?

현재 요청 URL이 주어진 options와 일치하면 true를 반환합니다.

<% if current_page?(controller: 'profiles', action: 'show') %>
  <strong>현재 profile 페이지에 있습니다</strong>
<% end %>

current_page? API 문서에서 더 자세한 정보를 확인하세요.

내부적으로 url_for로부터 얻은 URL에 대한 링크를 생성합니다. 주로 RESTful 리소스에 대한 링크를 생성하는 데 사용되며, 특히 model을 link_to의 인자로 전달할 때 자주 사용됩니다.

link_to "Profile", @profile
# => <a href="/profiles/1">Profile</a>

link_to "Book", @book # 복합 기본키 [:author_id, :id]가 주어진 경우
# => <a href="/books/2_1">Book</a>

link_to "Profiles", profiles_path
# => <a href="/profiles">Profiles</a>

link_to nil, "https://example.com"
# => <a href="https://example.com">https://example.com</a>

link_to "Articles", articles_path, id: "articles", class: "article__container"
# => <a href="/articles" class="article__container" id="articles">Articles</a>

만약 링크의 target이 name 파라미터에 맞지 않는다면 block을 사용할 수 있습니다.

<%= link_to @profile do %>
  <strong><%= @profile.name %></strong> -- <span>확인해보세요!</span>
<% end %>

다음의 HTML이 출력됩니다:

<a href="/profiles/1">
  <strong>David</strong> -- <span>확인해보세요!</span>
</a>

link_to API 문서에서 더 자세한 정보를 확인하세요.

3.4 mail_to

Generates a mailto link tag to the specified email address. You can also specify the link text, additional HTML options, and whether to encode the email address.

mail_to "john_doe@gmail.com"
# => <a href="mailto:john_doe@gmail.com">john_doe@gmail.com</a>

mail_to "me@john_doe.com", cc: "me@jane_doe.com", 
        subject: "이것은 예제 이메일입니다"  
# => <a href="mailto:"me@john_doe.com?cc=me@jane_doe.com&subject=This%20is%20an%20example%20email">"me@john_doe.com</a>

더 자세한 내용은 mail_to API 문서를 참고하세요.

3.5 url_for

제공된 options 세트에 대한 URL을 반환합니다.

url_for @profile
# => /profiles/1

url_for [ @hotel, @booking, page: 2, line: 3 ]
# => /hotels/1/bookings/1?line=3&page=2

url_for @post # composite primary key [:blog_id, :id]가 주어진 경우
# => /posts/1_2

4 Sanitization

원하지 않는 HTML 요소를 텍스트에서 제거하기 위한 메서드 모음입니다. 이 helper들은 안전하고 유효한 HTML/CSS만이 렌더링되도록 보장하는 데 특히 유용합니다. 또한 사용자 입력의 잠재적으로 악의적인 내용을 view에서 렌더링하기 전에 escape하거나 제거함으로써 XSS 공격을 방지하는 데도 유용할 수 있습니다.

이 기능은 내부적으로 rails-html-sanitizer gem에 의해 구동됩니다.

4.1 sanitize

sanitize 메서드는 모든 태그를 HTML 인코딩하고, 명시적으로 허용되지 않은 모든 속성을 제거합니다.

sanitize @article.body

게시물 본문을 안전하게 sanitize하여 출력합니다.

:attributes 또는 :tags 옵션이 전달되면, 언급된 attributes와 tags만 허용되고 다른 것은 허용되지 않습니다.

sanitize @article.body, tags: %w(table tr td), attributes: %w(id class style)

@article.body를 sanitize 하되, 허용할 태그는 table, tr, td만으로 제한하고 허용할 속성은 id, class, style으로 제한합니다.

예를 들어 테이블 태그를 default에 추가하는 것과 같이 여러 사용에 대한 기본값을 변경하려면:

# config/application.rb
class Application < Rails::Application
  config.action_view.sanitized_allowed_tags = %w(table tr td)
end

API 문서의 sanitize에서 더 자세한 정보를 확인하세요.

4.2 sanitize_css

Sanitizes a block of CSS code, particularly when it comes across a style attribute in HTML content. sanitize_css is particularly useful when dealing with user-generated content or dynamic content that includes style attributes.

The sanitize_css method below will remove the styles that are not allowed.

sanitize_css("background-color: red; color: white; font-size: 16px;")

sanitize_css API 문서에서 더 자세한 정보를 확인할 수 있습니다.

모든 link 태그를 제거하고 링크 텍스트만 남겨둡니다.

strip_links("<a href='https://rubyonrails.org'>Ruby on Rails</a>")
# => Ruby on Rails

strip_links("이메일: <a href='mailto:me@email.com'>me@email.com</a>")
# => 이메일: me@email.com.

strip_links("블로그: <a href='http://myblog.com/'>방문</a>.")
# => 블로그: 방문.

strip_links API 문서에서 더 자세한 정보를 확인하세요.

4.4 strip_tags

HTML에서 주석과 특수 문자를 포함한 모든 HTML 태그를 제거합니다.

strip_tags("Strip <i>these</i> tags!")
# => Strip these tags!

strip_tags("<b>Bold</b> no more! <a href='more.html'>See more</a>")
# => Bold no more! See more

strip_links('<<a href="https://example.org">잘못된 & 링크</a>')
# => &lt;잘못된 &amp; 링크

자세한 정보는 strip_tags API Documentation을 참조하세요.

5 Assets

이미지, JavaScript 파일, 스타일시트, 피드와 같은 asset들을 view에 연결하는 HTML을 생성하기 위한 메서드 모음입니다.

기본적으로 Rails는 public 폴더의 현재 호스트에 있는 asset들과 연결하지만, 애플리케이션 설정(일반적으로 config/environments/production.rb)에서 config.asset_host를 설정하여 전용 asset 서버의 asset들과 연결하도록 Rails를 설정할 수 있습니다.

예를 들어, asset 호스트가 assets.example.com이라고 가정해봅시다:

config.asset_host = "assets.example.com"

image_tag에 대한 URL은 다음과 같이 됩니다:

image_tag("rails.png")
# => <img src="//assets.example.com/images/rails.png" />

5.1 audio_tag

문자열 소스의 경우 단일 태그로, 또는 여러 소스를 위한 배열 내의 중첩된 source 태그로 소스가 포함된 HTML audio 태그를 생성합니다. sources는 전체 경로, public audios 디렉토리의 파일, 또는 Active Storage attachments가 될 수 있습니다.

audio_tag("sound")
# => <audio src="/audios/sound"></audio>

audio_tag("sound.wav", "sound.mid") 
# => <audio><source src="/audios/sound.wav" /><source src="/audios/sound.mid" /></audio>

audio_tag("sound", controls: true)
# => <audio controls="controls" src="/audios/sound"></audio>

내부적으로 audio_tag는 오디오 경로를 생성하기 위해 AssetUrlHelpers의 audio_path를 사용합니다.

더 자세한 정보는 audio_tag API 문서를 참조하세요.

브라우저와 피드 리더가 RSS, Atom 또는 JSON 피드를 자동으로 감지하는데 사용할 수 있는 link 태그를 반환합니다.

auto_discovery_link_tag(:rss, "http://www.example.com/feed.rss", { title: "RSS Feed" })
# => RSS Feed를 자동으로 찾을 수 있도록 하는 link 태그를 반환합니다 <link rel="alternate" type="application/rss+xml" title="RSS Feed" href="http://www.example.com/feed.rss" />

auto_discovery_link_tag API 문서에서 더 자세한 정보를 확인하세요.

asset pipeline에 의해 관리되는 favicon의 link 태그를 반환합니다. source는 전체 경로이거나 assets 디렉토리에 존재하는 파일일 수 있습니다.

favicon_link_tag 
# => <link href="/assets/favicon.ico" rel="icon" type="image/x-icon" /> 

favicon_link_tag API 문서에서 자세한 내용을 확인하세요.

5.4 image_tag

소스에 대한 HTML image tag를 반환합니다. source는 전체 경로가 될 수도 있고, app/assets/images 디렉토리에 있는 파일이 될 수도 있습니다.

image_tag("icon.png")
# => <img src="/assets/icon.png" />

image_tag("icon.png", size: "16x10", alt: "글 수정")
# => <img src="/assets/icon.png" width="16" height="10" alt="글 수정" />

내부적으로 image_tag는 이미지 경로를 생성하기 위해 AssetUrlHelpers의 image_path를 사용합니다.

자세한 내용은 image_tag API 문서를 참조하세요.

5.5 javascript_include_tag

주어진 각각의 소스에 대해 HTML script 태그를 반환합니다. 현재 페이지에 포함시키기 위해 app/assets/javascripts 디렉토리에 있는 JavaScript 파일의 파일명(.js 확장자는 선택사항)을 전달하거나, document root를 기준으로 한 전체 경로를 전달할 수 있습니다.

javascript_include_tag("common")
# => <script src="/assets/common.js"></script>

javascript_include_tag("common", async: true)
# => <script src="/assets/common.js" async="async"></script>

가장 일반적인 속성 중 일부는 asyncdefer입니다. async는 스크립트가 가능한 한 빨리 구문 분석되고 평가되도록 병렬로 로드되게 하며, defer는 문서가 구문 분석된 후에 스크립트가 실행되도록 지시합니다.

내부적으로 javascript_include_tag는 스크립트 경로를 생성하기 위해 AssetUrlHelpers의 javascript_path를 사용합니다.

자세한 내용은 javascript_include_tag API 문서를 참조하세요.

5.6 picture_tag

source에 대한 HTML picture 태그를 반환합니다. String, Array 또는 Block을 전달할 수 있습니다.

picture_tag("icon.webp", "icon.png")

이는 다음과 같은 HTML을 생성합니다:

<picture>
  <source srcset="/assets/icon.webp" type="image/webp" />
  <source srcset="/assets/icon.png" type="image/png" />
  <img src="/assets/icon.png" />
</picture>

더 자세한 정보는 picture_tag API 문서를 참고하세요.

브라우저가 소스를 preload하는데 사용할 수 있는 link 태그를 반환합니다. 소스는 asset pipeline에서 관리하는 리소스의 경로, 전체 경로 또는 URI가 될 수 있습니다.

preload_link_tag("application.css")
# => <link rel="preload" href="/assets/application.css" as="style" type="text/css" />

preload_link_tag API 문서에서 더 자세한 정보를 확인하세요.

인자로 지정된 소스에 대한 stylesheet 링크 태그를 반환합니다. 확장자를 지정하지 않으면 .css가 자동으로 추가됩니다.

stylesheet_link_tag("application")
# => <link href="/assets/application.css" rel="stylesheet" />

stylesheet_link_tag("application", media: "all")
# => <link href="/assets/application.css" media="all" rel="stylesheet" />

media는 링크의 media type을 지정하는 데 사용됩니다. 가장 일반적인 media type은 all, screen, print, speech입니다.

내부적으로 stylesheet_link_tag는 스타일시트 경로를 만들기 위해 AssetUrlHelpers의 stylesheet_path를 사용합니다.

자세한 내용은 stylesheet_link_tag API 문서를 참조하세요.

5.9 video_tag

문자열 소스의 경우 단일 태그로, 여러 소스의 경우 중첩된 source 태그가 있는 배열로 소스가 있는 HTML video 태그를 생성합니다. sources는 전체 경로, public videos 디렉토리의 파일 또는 Active Storage 첨부 파일이 될 수 있습니다.

video_tag("trailer")
# => <video src="/videos/trailer"></video>

video_tag(["trailer.ogg", "trailer.flv"])
# => <video><source src="/videos/trailer.ogg" /><source src="/videos/trailer.flv" /></video>

video_tag("trailer", controls: true)
# => <video controls="controls" src="/videos/trailer"></video>

내부적으로 video_tag는 비디오 경로를 생성하기 위해 video_path from the AssetUrlHelpers 를 사용합니다.

자세한 정보는 video_tag API Documentation 을 참조하세요.

6 JavaScript

view에서 JavaScript를 사용하기 위한 메서드들의 집합입니다.

6.1 escape_javascript

JavaScript 구문에서 캐리지 리턴과 작은따옴표, 큰따옴표를 이스케이프 처리합니다. 이 메서드는 텍스트 문자열을 받아서 브라우저가 파싱을 시도할 때 유효하지 않은 문자가 포함되지 않도록 보장하는 데 사용됩니다.

예를 들어, 큰따옴표가 포함된 인사말이 있는 partial이 있다면, JavaScript alert에서 사용하기 위해 인사말을 이스케이프 처리할 수 있습니다.

<%# app/views/users/greeting.html.erb %>
내 이름은 <%= current_user.name %>이고, "우리 웹사이트에 오신 것을 환영합니다!"라고 말하고 싶습니다!
<script>
  var greeting = "<%= escape_javascript render('users/greeting') %>";
  alert(`안녕하세요, ${greeting}`);
</script>

이것은 따옴표를 올바르게 escape 처리하여 alert 박스에 인사말을 표시합니다.

자세한 내용은 escape_javascript API Documentation을 참조하세요.

6.2 javascript_tag

제공된 코드를 감싸는 JavaScript 태그를 반환합니다. <script> 태그의 동작을 제어하기 위해 options hash를 전달할 수 있습니다.

javascript_tag("alert('All is good')", type: "application/javascript")

위 코드는 다음의 HTML 태그를 생성합니다: <script type="application/javascript">alert('All is good')</script>

<script type="application/javascript">
//<![CDATA[
alert('모두 잘 되었습니다')
//]]>
</script>

콘텐츠를 argument로 전달하는 대신 block을 사용할 수도 있습니다.

<%= javascript_tag type: "application/javascript" do %>
  alert("내 앱에 오신 것을 환영합니다!")
<% end %>

javascript_tag API 문서에서 더 자세한 정보를 확인하세요.

7 대체 태그

HTML 태그를 프로그래밍 방식으로 생성하는 메서드들의 집합입니다.

7.1 tag

주어진 nameoptions를 사용하여 독립적인 HTML tag를 생성합니다.

모든 tag는 다음과 같이 만들 수 있습니다:

tag.some_tag_name(선택적 content, options)

tag 이름으로는 예를 들어 br, div, section, article 또는 실제로 어떤 tag라도 사용할 수 있습니다.

예를 들어, 일반적인 사용은 다음과 같습니다:

tag.h1 "All titles fit to print"
# => <h1>All titles fit to print</h1>

tag.div "Hello, world!"
# => <div>Hello, world!</div>

또한, 생성된 태그에 속성을 추가하기 위해 옵션을 전달할 수 있습니다.

tag.section class: %w( kitties puppies )
# => <section class="kitties puppies"></section>

추가로, HTML data-* 속성은 data 옵션을 사용하여 tag 헬퍼에 전달할 수 있습니다. 이때 하위 속성의 키-값 쌍을 포함하는 해시를 사용합니다. 이 하위 속성들은 JavaScript와 잘 작동하도록 대시(-)로 구분된 data-* 속성으로 변환됩니다.

tag.div data: { user_id: 123 }
# => <div data-user-id="123"></div>

tag API 문서에서 더 자세한 정보를 확인하세요.

7.2 token_list

Returns a string of tokens built from the arguments provided. This method is also aliased as class_names.

token_list("cats", "dogs")
# => "cats dogs"

token_list(nil, false, 123, "", "foo", { bar: true })
# => "123 foo bar"

mobile, alignment = true, "center"
token_list("flex items-#{alignment}", "flex-col": mobile)
# => "flex items-center flex-col"
class_names("flex items-#{alignment}", "flex-col": mobile) # using the alias
# => "flex items-center flex-col"

8 캡처 블록

템플릿이나 레이아웃 파일의 다른 부분에서 사용할 수 있는 생성된 마크업을 추출할 수 있는 메서드 집합입니다.

capture를 통해 블록을 변수로 캡처하는 방법과 content_for를 통해 레이아웃에서 사용할 마크업 블록을 캡처하는 방법을 제공합니다.

8.1 capture

capture 메서드를 사용하면 템플릿의 일부를 변수로 추출할 수 있습니다.

<% @greeting = capture do %>
  <p>환영합니다! 현재 날짜와 시간은 <%= Time.current %>입니다</p>
<% end %>

그런 다음 이 변수를 템플릿, 레이아웃 또는 헬퍼 어디에서나 사용할 수 있습니다.

<html>
  <head>
    <title>환영합니다!</title>
  </head>
  <body>
    <%= @greeting %>
  </body>
</html>

capture의 반환값은 블록에 의해 생성된 문자열입니다.

@greeting
# => "제 반짝이는 새 웹 페이지에 오신 것을 환영합니다! 현재 날짜와 시간은 2018-09-06 11:09:16 -0500 입니다"

See the capture API Documentation for more information.

8.2 content_for

content_for를 호출하면 나중에 사용할 수 있도록 마크업 블록을 식별자에 저장합니다. 저장된 콘텐츠를 다른 템플릿, 헬퍼 모듈 또는 레이아웃에서 식별자를 yield의 인수로 전달하여 후속 호출할 수 있습니다.

일반적인 사용 사례는 content_for 블록에서 페이지의 제목을 설정하는 것입니다.

특별한 페이지의 뷰에서 content_for 블록을 정의하고, 레이아웃 내에서 yield합니다. content_for 블록이 사용되지 않는 다른 페이지의 경우, 비어 있어 아무것도 yield되지 않습니다.

<%# app/views/users/special_page.html.erb %>
<% content_for(:html_title) { "특별 페이지 제목" } %>
<%# app/views/layouts/application.html.erb %>
<html>
  <head>
    <title><%= content_for?(:html_title) ? yield(:html_title) : "기본 제목" %></title>
  </head>
</html>

위의 예에서 content_for? 술어 메서드를 사용하여 제목을 조건부로 렌더링하는 것을 볼 수 있습니다. 이 메서드는 content_for를 사용하여 콘텐츠가 캡처되었는지 확인하여, 뷰의 내용에 따라 레이아웃의 부분을 조정할 수 있게 합니다.

또한 헬퍼 모듈 내에서 content_for를 사용할 수 있습니다.

# app/helpers/title_helper.rb
module TitleHelper
  def html_title
    content_for(:html_title) || "기본 제목"
  end
end

이제 레이아웃에서 html_title을 호출하여 content_for 블록에 저장된 내용을 가져올 수 있습니다. special_page의 경우와 같이 렌더링되는 페이지에 content_for 블록이 설정되어 있다면 해당 제목을 표시합니다. 그렇지 않으면 "기본 제목"이라는 기본 텍스트를 표시합니다.

경고: content_for는 캐시에서 무시됩니다. 따라서 프래그먼트 캐시될 요소에는 사용하지 않아야 합니다.

참고: capturecontent_for의 차이점이 무엇인지 궁금할 수 있습니다.

capture는 마크업 블록을 변수에 캡처하는 데 사용되고, content_for는 나중에 사용하기 위해 마크업 블록을 식별자에 저장하는 데 사용됩니다. 내부적으로 content_for는 실제로 capture를 호출합니다. 그러나 주요 차이점은 여러 번 호출될 때의 동작에 있습니다.

content_for는 반복적으로 호출될 수 있으며, 제공된 순서대로 특정 식별자에 대해 받은 블록을 연결합니다. 각 후속 호출은 단순히 이미 저장된 내용에 추가됩니다. 반면에 capture는 이전 호출을 추적하지 않고 블록의 내용만 반환합니다.

자세한 내용은 content_for API 문서를 참조하세요.

9 성능

9.1 benchmark

비용이 많이 드는 작업이나 병목 지점이 될 수 있는 부분을 benchmark 블록으로 감싸서 해당 작업의 실행 시간을 측정할 수 있습니다.

<% benchmark "데이터 파일 처리" do %>
  <%= expensive_files_operation %>
<% end %>

이렇게 하면 로그에 데이터 파일 처리 (0.34523)와 같은 내용이 추가되어, 코드를 최적화할 때 시간을 비교하는 데 사용할 수 있습니다.

참고: 이 헬퍼는 Active Support의 일부이며, 컨트롤러, 헬퍼, 모델 등에서도 사용할 수 있습니다.

자세한 내용은 benchmark API 문서를 참조하세요.

9.2 cache

전체 액션이나 페이지 대신 뷰의 일부분을 캐시할 수 있습니다. 이 기술은 메뉴, 뉴스 주제 목록, 정적 HTML 조각 등을 캐시하는 데 유용합니다. 뷰 로직의 일부를 캐시 블록으로 감싸고 다음 요청이 들어올 때 캐시 저장소에서 제공할 수 있게 합니다.

cache 메서드는 캐시하고자 하는 내용을 포함하는 블록을 받습니다.

예를 들어, 애플리케이션 레이아웃의 푸터를 cache 블록으로 감싸서 캐시할 수 있습니다.

<% cache do %>
  <%= render "application/footer" %>
<% end %>

또한 모델 인스턴스를 기반으로 캐시할 수도 있습니다. 예를 들어, cache 메서드에 article 객체를 전달하여 페이지의 각 기사를 개별적으로 캐시할 수 있습니다.

<% @articles.each do |article| %>
  <% cache article do %>
    <%= render article %>
  <% end %>
<% end %>

애플리케이션이 이 페이지에 대한 첫 번째 요청을 받으면 Rails는 고유한 키로 새 캐시 항목을 작성합니다. 키는 다음과 같은 형태를 가집니다:

views/articles/index:bea67108094918eeba32cd4a6f786301/articles/1

자세한 내용은 프래그먼트 캐싱cache API 문서를 참조하세요.

10 기타

10.1 atom_feed

Atom Feed는 콘텐츠를 배포하는 데 사용되는 XML 기반 파일 형식으로, 사용자가 피드 리더에서 콘텐츠를 탐색하거나 검색 엔진이 사이트에 대한 추가 정보를 발견하는 데 도움을 주는 데 사용될 수 있습니다.

이 헬퍼는 Atom 피드를 쉽게 만들 수 있게 해주며, 주로 XML을 생성하기 위한 Builder 템플릿에서 사용됩니다. 다음은 전체 사용 예시입니다:

# config/routes.rb
resources :articles
# app/controllers/articles_controller.rb
def index
  @articles = Article.all

  respond_to do |format|
    format.html
    format.atom
  end
end
# app/views/articles/index.atom.builder
atom_feed do |feed|
  feed.title("기사 목록")
  feed.updated(@articles.first.created_at)

  @articles.each do |article|
    feed.entry(article) do |entry|
      entry.title(article.title)
      entry.content(article.body, type: "html")

      entry.author do |author|
        author.name(article.author_name)
      end
    end
  end
end

자세한 내용은 atom_feed API 문서를 참조하세요.

10.2 debug

객체의 YAML 표현을 pre 태그로 감싸서 반환합니다. 이는 객체를 검사하는 매우 읽기 쉬운 방법을 제공합니다.

my_hash = { "first" => 1, "second" => "two", "third" => [1, 2, 3] }
debug(my_hash)
<pre class="debug_dump">---
first: 1
second: two
third:
- 1
- 2
- 3
</pre>

자세한 내용은 debug API 문서를 참조하세요.



맨 위로