Bidi: 혼합 페르시아어/영어 콘텐츠
유니코드 양방향(BiDi) 알고리즘은 혼합 방향 텍스트를 자동으로 재정렬하지만, 때로는 잘못된 방향으로 재정렬하기도 합니다. 이 스킬은 언제 개입해야 하는지와 정확히 어떻게 해야 하는지를 알려줍니다.
1. 정신 모델
- 기본 방향은 가장 가까운 조상 요소의
dir속성에서 가져옵니다(페이지: RTL). - 강한 LTR 콘텐츠(라틴 문자)의 실행은 내장되어 LTR 방향으로 흐릅니다.
- 중립 문자(구두점, 숫자 인접 기호: + - / $ %)는 주변의 방향을 따릅니다. 이것이 뒤섞임이 발생하는 지점입니다.
2. 개입 도구 상자
| 도구 | 사용 시기 | 예시 |
|---|---|---|
<bdi> 요소 | 페르시아어 텍스트 내 방향을 알 수 없는 인라인 외래 단어 | «فایل report_final.pdf را ببینید» |
<span dir="ltr"> | 내부적으로 왼쪽 정렬하려는 알려진 LTR 요소 | <span dir="ltr">+98 912 345 6789</span> |
dir="auto" | 사용자 생성 또는 예측할 수 없는 콘텐츠 | 채팅 버블, 댓글, 파일 이름 |
CSS unicode-bidi: plaintext | 스타일이 적용된 span에서 dir="auto"와 동일 | .user-content { unicode-bidi: plaintext; } |
isolate (bdi의 기본값) | 요소가 인접 요소를 재정렬하지 못하도록 방지 | <bdi>의 기본 동작 |
3. 표준 사례
전화번호
페르시아어 텍스트에서 +98 912는 종종 +가 잘못된 쪽에 렌더링됩니다.
تلفن پشتیبانی: <span dir="ltr">+98 21 9100 2000</span>
외화 가격
RTL 텍스트에 있는 $99는 99$로 표시됩니다:
اشتراک جهانی: <span dir="ltr">$99/mo</span> — اشتراک داخلی: ۹۹٬۰۰۰ تومان
이메일, URL, 핸들
به <bdi>[email protected]</bdi> ایمیل بزنید.
مستندات: <bdi>https://docs.example.co/fa</bdi>
문장 중간의 라틴 브랜드 이름
일반적으로 일반 텍스트로 괜찮지만, 페르시아어 접미사 뒤에는 문제가 발생합니다:
«نسخهی جدید Node.js» — «Node.js»는 안전함; «های Node.js»는 라틴 실행 부분이 접미사와 결합되면 <bdi>가 필요함: <bdi>Node.js</bdi>های는 잘못됨 — «افزونههای Node.js»로 다시 표현하세요.
코드 및 명령 — 항상 LTR 블록
<pre dir="ltr" style="text-align: left;">npm install raast</pre>
페르시아어 문장의 인라인 명령: <code dir="ltr">npx create-next-app</code>.
혼합 항목 목록
항목 마커(۱ ۲ ۳)는 RTL 흐름에 속하며, 긴 LTR 항목 내부는 항목별로 분리된 상태를 유지합니다 — 라틴 문자/숫자로 시작하는 항목에는 <bdi>를 넣으세요.
제품 식별자, 시리얼 번호 및 기술 ID
가장 많이 뒤섞이는 범주 — 문자, 숫자, 대시가 혼합됨:
شماره سریال: <bdi dir="ltr">SN-9F42-KM18</bdi>
کد پیگیری: <bdi dir="ltr">TRK-IR-14050823-0042</bdi>
شناسه محصول: <bdi dir="ltr">SKU 88451-B</bdi>
규칙:
- 식별자는 복사 시 바이트 정확해야 합니다 — 격리(Isolation)는 렌더링만 변경하고 문자열 자체는 변경하지 않습니다.
- RTL 문장 내에서 후행 대시/숫자 실행은
<bdi>없이 재정렬됩니다(예:88451-B→B-88451). - JS로 구축된 데이터베이스 조회: 논리 문자열을 유지하고, 표시를 위해 "미리 뒤집지" 마십시오.
- 테이블의 ID 열에는 고정 폭 모노 폰트 +
dir="ltr"+text-align: start를 사용하십시오.
사용자 생성 콘텐츠(채팅, 댓글, 파일 이름)
- 컨테이너:
dir="auto"+ CSSunicode-bidi: plaintext— 각 메시지는 첫 번째 강한 문자로 방향을 정합니다. - 페르시아어 사용자가 영어 텍스트를 붙여넣거나 그 반대의 경우에도 수동으로
dir을 전환하지 않고 올바르게 읽혀야 합니다. dir="rtl"+text-align: start만으로 페이지 방향을 UGC에 강제하지 마십시오. 첫 번째 강한 문자 규칙이plaintext의 핵심입니다.- 파일 이름/다운로드:
<bdi>로 렌더링하여 확장자(.pdf,.zip)가 분리되지 않도록 합니다.
4. 양식 입력
dir="auto": 입력 필드는 첫 번째 강한 문자의 방향을 채택합니다 — 이름/메시지 필드에 적합.- 명시적
dir="ltr": 이메일, 전화, 사용자 이름, 카드 번호, URL, 가격(text-align: end와 함께 사용하면 RTL 사용자의 커서 시작 위치가 오른쪽이 됨... 그러나 실제로는 ltr 입력 필드에서 커서 편의를 위해text-align: start를 유지하세요. 테스트 필요).
5. 뒤섞인 출력 디버깅 — 체크리스트
- 요소가 래핑/격리되었습니까? (bdi / span dir=ltr)
- 중립 문자(
+ - / . , ( ))가 방향 경계에 인접해 있습니까? 격리 또는 RLM(\u200F)/LRM(\u200E) 마크를 추가하십시오. - LTR 요소의 후행 구두점이 잘못된 끝으로 이동합니까? → 격리 내부에 후행 공백을 포함시키십시오.
- JS로 문자열을 구성했습니까? 양방향은 렌더링 문제입니다 — 코드에서 재정렬하지 말고 DOM/CSS를 수정하십시오.
- 보이지 않는 문자 덤프: 양방향 검사기나
JSON.stringify()로 텍스트를 붙여넣어 U+200E/F 배치를 확인하십시오.
6. RLM/LRM — 메스
‏ (U+200F) / ‎ (U+200E)는 격리가 불가능할 때(예: 일반 텍스트 이메일, CSV 셀) 중립 문자를 한쪽으로 강제합니다:
متن فارسی +98 -> 번호에 +를 붙여 유지
드물게 사용하십시오 — 일부 폰트에서 보이는 모지바케(mojibake)가 발생할 수 있습니다. 웹에서는 구조적 격리를 선호하십시오.
7. 제목, 메타 및 한 줄 컨텍스트
- 혼합 스크립트가 있는
<title>: 브라우저는 탭에서 양방향을 합리적으로 렌더링하지만, 페이지 언어로 시작하십시오: «raast — مهارتهای RTL» 대신 «مهارتهای RTL — raast»: 페이지 언어의 강한 스크립트를 먼저 넣으십시오. aria-label문자열도 동일한 규칙을 따릅니다. 화면 읽기 프로그램이 유니코드 양방향 마크를 처리하므로 유지하십시오.- JSON/API 페이로드: 항상 논리적 순서를 저장하십시오. 표시를 위해 미리 뒤집지 마십시오.