Skip to content

고급 필터

이 참조 문서에서는 Liquid의 고급 필터와 사용 방법에 대한 개요를 제공합니다.

인코딩 필터

필터 이름 필터 설명 입력 예시 출력 예시
md5 md5로 인코딩된 문자열을 반환합니다 {{'hey' | md5}} 6057f13c496ecf7fd777ceb9e79ae285
sha1 sha1으로 인코딩된 문자열을 반환합니다 {{'hey' | sha1}} 7f550a9f4c44173a37664d938f1355f0f92a47a7
sha2 sha2(256비트, SHA-256이라고도 함)로 인코딩된 문자열을 반환합니다 {{'hey' | sha2}} fa690b82061edfd2852629aeba8a8977b57e40fcb77d1a7a28b26cba62591204
base64 base64로 인코딩된 문자열을 반환합니다 {{'blah' | base64_encode}} YmxhaA==
hmac_sha1_hex (이전 hmac_sha1) hmac-sha1 서명을 16진수 문자열로 인코딩하여 반환합니다 {{'hey' | hmac_sha1_hex: 'secret_key'}} 2a3969bed25bfeefb00aca4063eb9590b4df8f0e
hmac_sha1_base64 hmac-sha1 서명을 base64 문자열로 인코딩하여 반환합니다 {{'hey' | hmac_sha1_base64: 'secret_key'}} KjlpvtJb/u+wCspAY+uVkLTfjw4=
hmac_sha256_hex hmac-sha256 서명을 16진수 문자열로 인코딩하여 반환합니다 {{'hey' | hmac_sha256_hex: 'secret_key'}} 8df897f8da3d7992fe57c8dbc6f27578cfbf2dcc4d0fbb4000b8c924841d508e
hmac_sha256_base64 hmac-sha256 서명을 base64 문자열로 인코딩하여 반환합니다 {{'hey' | hmac_sha256_base64: 'secret_key'}} jfiX+No9eZL+V8jbxvJ1eM+/LcxND7tAALjJJIQdUI4=

URL 필터

필터 이름 필터 설명 입력 예시 출력 예시
url_escape URL에서 허용되지 않는 문자열 내 모든 문자를 식별하고 이스케이프된 형태로 대체합니다 {{'hey<>hi' | url_escape}} hey%3C%3Ehi
url_param_escape URL에서 허용되지 않는 문자열 내 모든 문자를 앰퍼샌드(&)를 포함하여 이스케이프된 형태로 대체합니다 {{'hey<&>hi' | url_param_escape}} hey%3C%26%3Ehi
url_encode URL에 적합한 형태로 문자열을 인코딩합니다 {{ 'google search' | url_encode }} google+search

등록정보 접근자 필터

필터 이름 필터 설명
property_accessor 해시와 해시 키를 받아 해당 키에 있는 값을 반환합니다

해시 예시: {"a" => 42, "b" => 0} 입력 예시: {{hash | property_accessor: 'a'}} 출력 예시: 42

또한 등록정보 접근자 필터를 사용하면 커스텀 속성을 해시 키로 템플릿화하여 특정 해시 값에 접근할 수 있습니다.

숫자 서식 필터

필터 이름 필터 설명 입력 예시 출력 예시
number_with_delimiter 숫자에 쉼표를 추가하여 서식을 지정합니다 {{ 123456 | number_with_delimiter }} 123,456

JSON 이스케이프 / 문자열 이스케이프 필터

필터 이름 필터 설명
json_escape 문자열 내 특수 문자(예: 큰따옴표 "" 및 백슬래시 ‘')를 이스케이프합니다.

이 필터는 JSON 사전에서 문자열을 개인화할 때 항상 사용해야 하며, 특히 웹훅에 유용합니다.

JSON 서식 필터

필터 이름 필터 설명
json_parse JSON 문자열을 오브젝트나 배열과 같은 해당 데이터 구조로 변환합니다.
as_json_string 오브젝트나 배열과 같은 데이터 구조를 해당 JSON 문자열로 변환합니다.
json_parse 입력 및 출력 예시

입력

1
2

{% assign my_data_string = '[{"id":"1","store_name":"demo-store"}]'  %}
{% assign my_data = my_data_string | json_parse %}

출력

1
2
3
4

{% for item in my_data %}
Item ID: {{ item.id }}
Item Name: {{ item.store_name }}
{% endfor %}
as_json_string 입력 및 출력 예시

입력

1
2
3

{% assign my_data_string = '[{"id":"1","store_name":"demo-store"}]'  %}
{% assign my_data = my_data_string | json_parse %}
{% assign json_string = my_data | as_json_string %}

출력

1

{{json_string}}
New Stuff!