[Thymeleaf] 텍스트 국제화(Text Internationalization)란? [타임리프를 활용한 다국어 지원, th:text, #{...}]

2024. 5. 10. 17:18·▣ Tools/Thymeleaf🌿
728x90


- 텍스트 국제화(Text Internationalization)란?

텍스트 국제화는 다국어 지원을 위해 사용되는 기술이다. 웹 애플리케이션이나 소프트웨어를 다국어로 제공할 때, 각 언어에 맞는 텍스트를 표시해야 하는데, 텍스트 국제화는 이러한 다국어 지원을 가능하게 한다.

텍스트 국제화를 사용하면 애플리케이션에서 텍스트를 하드코딩하지 않고, 대신에 각 텍스트에 고유한 식별자를 부여하고 이 식별자에 해당하는 텍스트를 메시지 파일에 저장한다. 이 메시지 파일은 다국어 지원을 위해 여러 언어로 작성될 수 있다.

- 사용 방법

기본적으로 Thymeleaf는 '#{}' 구문을 사용하여 메시지 소스에서 텍스트를 가져오도록 구성되어 있으며, 이는 주로 프로퍼티 파일에서 가져온 메시지를 나타내는 데 사용된다. 프로퍼티 파일에는 각 언어별로 텍스트가 저장되어 있어서, 언어 설정에 따라 다른 언어의 텍스트를 가져올 수 있다.

1) 한국어 메시지 파일(messages_ko.properties)

welcome.message=안녕하세요! 환영합니다!

2) 영어 메시지 파일(messages_en.properties)

welcome.message=Hello! Welcome!

- 폴더 구조

src
└── main
    └── resources
        └── messages
            ├── messages_en.properties
            ├── messages_fr.properties
            ├── messages_ko.properties
            └── messages_ja.properties

사용자의 언어 설정은 주로 HTTP 요청의 Accept-Language 헤더를 기반으로 서버에서 결정된다. 서버는 이 헤더를 해석하여 사용자의 기본 언어 설정을 파악하고, 이 정보를 사용하여 적절한 다국어 컨텐츠를 제공한다.

아래 코드에서 th:text="#{welcome.message}"는 다국어 메시지 소스에서 welcome.message에 해당하는 텍스트를 가져와서 화면에 표시한다. 만약 해당 메시지가 없는 경우 Fallback Message가 대신 표시된다.
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>다국어 메시지 테스트</title>
</head>
<body>
    <p th:text="#{welcome.message}">Fallback Message</p>
</body>
</html>

728x90
'▣ Tools/Thymeleaf🌿' 카테고리의 다른 글
  • [Thymeleaf] 템플릿 조각(Fragment)이란? [타임리프 코드 재사용성 높이는 방법, th:fragment, th:replace]
  • [Thymeleaf] 타임리프에서 많이 쓰는 기본적인 문법들 [변수 표현식, 반복문, 조건문, 속성 바인딩]
  • [Thymeleaf] 타임리프(Thymeleaf)란? [타임리프 개념 및 기본적인 문법]
예르미(yermi)
예르미(yermi)
끊임없이 제 자신을 계발하는 개발자입니다👨🏻‍💻
  • 예르미(yermi)
    예르미의 코딩노트
    예르미(yermi)
  • 전체
    오늘
    어제
    • 분류 전체보기 (937)
      • ◎ Java (133)
        • Java☕ (93)
        • JSP📋 (26)
        • Applet🧳 (6)
        • Interview👨🏻‍🏫 (8)
      • ◎ JavaScript (48)
        • JavaScript🦎 (25)
        • jQuery🌊 (8)
        • React🌐 (2)
        • Vue.js🔰 (6)
        • Node.js🫒 (3)
        • Google App Script🐑 (4)
      • ◎ HTML5+CSS3 (17)
        • HTML5📝 (8)
        • CSS3🎨 (9)
      • ──────────── (0)
      • ▣ Framework (67)
        • Spring🍃 (36)
        • Spring Boot🍀 (12)
        • Bootstrap💜 (3)
        • Selenium🌕 (6)
        • MyBatis🐣 (10)
      • ▣ Tools (47)
        • API🎯 (18)
        • Library🎲 (15)
        • JitPack🚀 (3)
        • Jenkins👨🏻 (7)
        • Thymeleaf🌿 (4)
      • ▣ Server (32)
        • Apache Tomcat🐱 (14)
        • Apache HTTP Server🛡️ (1)
        • Nginx🧶 (7)
        • OracleXE💿 (4)
        • VisualSVN📡 (4)
      • ▣ OS : 운영체제 (18)
        • cmd : 명령프롬프트💻 (10)
        • Linux🐧 (8)
      • ▣ SQL : Database (56)
        • Oracle SQL🏮 (26)
        • PL SQL💾 (9)
        • MySQL🐬 (6)
        • MariaDB🦦 (6)
        • H2 Database🔠 (3)
        • SQL 실전문제🐌 (6)
      • ────────── (0)
      • ◈ Human Project (86)
        • Mini : Library Service📚 (15)
        • 화면 설계 [HTML]🐯 (10)
        • 서버 프로그램 구현🦁 (15)
        • Team : 여수어때🛫 (19)
        • Custom : Student🏫 (9)
        • Custom : Board📖 (18)
      • ◈ Yermi Project (40)
        • 조사모아(Josa-moa)📬 (5)
        • Riddle-Game🧩 (6)
        • 맛있을 지도🍚 (2)
        • 어디 가! 박대리!🙋🏻‍♂️ (5)
        • 조크베어🐻‍❄️ (4)
        • Looks Like Thirty🦉 (2)
        • Toy Project💎 (12)
        • 오픈소스 파헤치기🪐 (4)
      • ◈ Refactoring (15)
        • Mini : Library Service📚 (8)
        • 서버 프로그램 구현🦁 (1)
        • Team : 여수어때🛫 (0)
        • 쿼리 튜닝일지🔧 (6)
      • ◈ Coding Test (89)
        • 백준(BOJ)👨🏻‍💻 (70)
        • 프로그래머스😎 (2)
        • 코드트리🌳 (7)
        • 알고리즘(Algorithm)🎡 (10)
      • ◈ Study (102)
        • 기초튼튼 개발지식🥔 (25)
        • HTTP 웹 지식💡 (4)
        • 클린코드(Clean Code)🩺 (1)
        • 디자인패턴(GoF)🥞 (12)
        • 다이어그램(Diagram)📈 (4)
        • 파이썬(Python)🐍 (16)
        • 에러노트(Error Note)🧱 (34)
        • 웹 보안(Web Security)🔐 (6)
      • ◈ 공부모임 (39)
        • 혼공학습단⏰ (18)
        • 코드트리 챌린지👊🏻 (2)
        • 개발도서 100독👟 (8)
        • 나는 리뷰어다🌾 (11)
      • ◈ 자격증 공부 (37)
        • 정보처리기사🔱 (16)
        • 정보처리산업기사🔅 (9)
        • 컴퓨터활용능력 1급📼 (12)
      • ─────────── (0)
      • ◐ 기타 (113)
        • 알아두면 좋은 팁(tip)✨ (46)
        • 개발자의 일상🎈 (44)
        • 개발도서 서평🔍 (10)
        • 개발관련 세미나🎤 (2)
        • 블로그 꾸미기🎀 (9)
        • 사도신경 프로젝트🎚️ (2)
  • 인기 글

  • 최근 댓글

  • 태그

    SQL
    Project
    꿀팁
    백준 티어
    Error Note
    html
    BOJ
    jsp
    Oracle
    자바스크립트
    코딩 테스트
    일상
    Database
    코딩
    Java
    spring
    javascript
    프로그래밍
    백준
    CSS
  • 250x250
  • hELLO· Designed By정상우.v4.10.3
예르미(yermi)
[Thymeleaf] 텍스트 국제화(Text Internationalization)란? [타임리프를 활용한 다국어 지원, th:text, #{...}]
상단으로

티스토리툴바