다음은 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
주어진 text
와 phrase
에서, 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 가이드를 참조하세요.
3 Navigation
라우팅 하위 시스템에 의존하는 링크와 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 문서에서 더 자세한 정보를 확인하세요.
3.3 link_to
내부적으로 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 문서에서 더 자세한 정보를 확인할 수 있습니다.
4.3 strip_links
모든 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>')
# => <잘못된 & 링크
자세한 정보는 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 문서를 참조하세요.
5.2 auto_discovery_link_tag
브라우저와 피드 리더가 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 문서에서 더 자세한 정보를 확인하세요.
5.3 favicon_link_tag
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>
가장 일반적인 속성 중 일부는 async
와 defer
입니다. 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 문서를 참고하세요.
5.7 preload_link_tag
브라우저가 소스를 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 문서에서 더 자세한 정보를 확인하세요.
5.8 stylesheet_link_tag
인자로 지정된 소스에 대한 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
주어진 name
과 options
를 사용하여 독립적인 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
는 캐시에서 무시됩니다. 따라서 프래그먼트 캐시될 요소에는 사용하지 않아야 합니다.
참고: capture
와 content_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 문서를 참조하세요.