텍스트 구성 요소 text-component

Last update: Mon Aug 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
핵심 구성 요소

작성 대상:

개발자
관리자
사용자

핵심 구성 요소는 바로 편집 기능이 있는 서식 있는 텍스트 편집 및 작성 구성 요소입니다.

사용량 usage

텍스트 구성 요소는 인라인 편집기와 전체 화면 포맷으로 간편한 텍스트 편집이 가능한 강력한 서식 있는 텍스트 편집기를 제공합니다.

편집 대화 상자에는 전체 화면 편집 대화 상자에서 전체 기능을 사용할 수 있고 제한된 옵션이 제공되는 인라인 편집 기능이 있습니다. 디자인 대화 상자를 통해 콘텐츠 작성자용 템플릿에서 텍스트 서식 옵션을 구성할 수 있습니다.

버전 및 호환성 version-and-compatibility

현재 버전의 텍스트 구성 요소는 2018년 1월 핵심 구성 요소 릴리스 2.0.0과 함께 도입된 v2입니다. 이 문서에서는 해당 구성 요소에 대해 설명합니다.

다음 표에서 구성 요소의 모든 지원 버전, 구성 요소 버전과 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 살펴볼 수 있습니다.

구성 요소 버전

AEM 6.4

AEM 6.5

AEM as a Cloud Service

릴리스 2.17.4 및 이전 버전과 호환 가능

호환 가능

핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 핵심 구성 요소 버전을 참조하십시오.

샘플 구성 요소 출력 sample-component-output

텍스트 구성 요소를 경험하고 구성 옵션의 샘플뿐만 아니라 HTML 및 JSON 출력을 확인하려면 구성 요소 라이브러리를 참조하십시오.

기술 세부 사항 technical-details

텍스트 구성 요소에 대한 최신 기술 설명서는 GitHub에서 확인할 수 있습니다.

핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오.

텍스트 구성 요소 및 리치 텍스트 편집기 the-text-component-and-the-rich-text-editor

핵심 구성 요소는 AEM 리치 텍스트 편집기(RTE)를 활용합니다. RTE를 통해 텍스트 콘텐츠를 편집할 수 있는 다양한 기능이 콘텐츠 작성자에게 제공됩니다. RET는 매우 유연하게 구성되고 다양한 옵션을 제공합니다. RTE를 구성하는 방법에 대한 자세한 내용은 문서 리치 텍스트 편집기 구성 및 리치 텍스트 편집기 플러그인 구성에서 확인할 수 있습니다.

이 문서의 나머지 부분에서 즉시 사용 가능한 RTE 구성과 함께 핵심 구성 요소의 텍스트 구성 요소에 대한 표준 구성을 보여 줍니다.

NOTE

RTE의 UI 구성에서 활성화되는 옵션만 텍스트 구성 요소에서 사용할 수 있습니다.

편집 대화 상자 edit-dialog

편집 대화 상자는 사용자가 텍스트를 작성할 서식 있는 표준 텍스트 서식 도구를 제공합니다.

텍스트 구성 요소의 편집 대화 상자

볼드체

선택한 텍스트에 볼드체 서식 지정을 적용하거나 커서 다음에 입력한 텍스트를 볼드체로 서식 지정하는 데 사용됩니다,

키보드 단축키로 Ctrl+B 를 사용할 수 있습니다.

이탤릭체

선택한 텍스트에 이탤릭체 서식 지정을 적용하거나 커서 다음에 입력한 텍스트를 이탤릭체로 서식 지정하는 데 사용됩니다,

키보드 단축키로 Ctrl+I 를 사용할 수 있습니다.

밑줄

선택한 텍스트에 밑줄 서식 지정을 적용하거나 커서 다음에 입력한 텍스트를 밑줄로 서식 지정하는 데 사용됩니다,

키보드 단축키로 Ctrl+U 를 사용할 수 있습니다.

아래 첨자

선택한 텍스트나 커서 다음에 입력한 텍스트를 아래 첨자로 서식 지정하는 데 사용됩니다,

위 첨자

선택한 텍스트나 커서 다음에 입력한 텍스트를 위 첨자로 서식 지정하는 데 사용됩니다,

텍스트로 붙여넣기

서식 지정 없이 복사한 텍스트를 일반 텍스트로 붙여넣습니다.

이 옵션을 선택하면 서식 지정 없이 텍스트를 일반 텍스트로 붙여넣을 수 있는 창이 텍스트에 삽입되기 전 미리보기로 열립니다. 확인 표시를 탭하거나 클릭하여 수락하고 x를 탭하거나 클릭하여 취소합니다.

텍스트로 붙여넣기 예제

Word에서 붙여넣기

이 옵션을 선택하면 서식 지정을 유지하면서 텍스트를 일반 텍스트로 붙여넣을 수 있는 창이 텍스트에 삽입되기 전 미리보기로 열립니다. 확인 표시를 탭하거나 클릭하여 수락하고 x를 탭하거나 클릭하여 취소합니다.

Word에서 붙여넣기 사례

하이퍼링크

이 옵션을 사용하여 선택한 텍스트를 하이퍼링크로 변환하거나 이미 정의된 링크를 수정합니다. 이 옵션은 텍스트가 이미 선택되고 링크를 설정하는 추가 옵션으로 창을 여는 경우에만 활성화됩니다.

하이퍼링크 예

경로 입력
- 선택 열기 대화 상자를 통해 AEM의 경로를 선택합니다.
- 링크가 AEM 내에 없는 경우 절대 URL을 입력합니다.
  - 절대 경로가 아닌 경로는 AEM의 상대 경로로 해석됩니다.
링크에 대한 대체 설명 텍스트 입력
링크 비헤이비어 선택
- 대상
- 동일한 탭
- 새 탭
- 상위 프레임
- 맨 위 프레임
확인 표시를 탭하거나 클릭하여 링크를 적용하거나 x를 탭하거나 클릭하여 취소합니다.

연결 해제

이 옵션을 사용하여 선택한 텍스트에 이미 적용된 링크를 제거합니다. 이 옵션은 링크가 이미 선택된 경우에만 활성화됩니다.

찾기

찾기 아이콘

지정된 텍스트 문자열의 발생 횟수를 알아보려면 이 옵션을 사용하여 텍스트를 검색합니다. 이 옵션을 선택하면 검색 옵션을 지정하는 창이 열립니다.

찾기 사례 :

검색할 텍스트를 입력하고 찾기 를 탭하거나 클릭하여 검색을 시작합니다. x를 탭하거나 클릭하여 취소합니다.
사례에 따라 정확하게 일치시키려면 사례 일치 옵션을 선택한 다음 검색을 시작합니다.
일치가 발견되면 강조 표시되고 검색 대화 상자가 흐리게 표시됩니다. 흐리게 표시된 대화 상자에서 찾기 버튼을 다시 탭하거나 클릭하여 다음 발생 횟수를 검색합니다.

찾기 사례 확인 :

추가 발생 항목이 없는 경우 메시지가 표시되고 텍스트 시작부터 검색이 다시 시작됩니다.

찾기 사례(더 이상 발생 횟수 없음)

바꾸기

지정된 텍스트 문자열의 발생 횟수를 알아보려면 이 옵션을 사용하여 텍스트를 검색하고 일치하는 문자열을 다른 문자열로 대체합니다. 이 옵션을 선택하면 검색 옵션을 지정하는 창이 열리고 옵션을 대체합니다.

바꾸기 사례

검색할 텍스트와 대체해야 할 텍스트를 입력합니다.

찾기 를 탭하거나 클릭하여 검색을 시작합니다. x를 클릭하거나 탭하여 취소합니다.
사례에 따라 정확하게 일치시키려면 사례 일치 옵션을 선택한 다음 검색을 시작합니다.
모두 바꾸기 를 선택하여 한 번에 모든 발생 항목을 바꿉니다.

일치가 발견되면 강조 표시되고 검색 대화 상자가 흐리게 표시됩니다. 흐리게 표시된 대화 상자에서 찾기 버튼을 다시 클릭하여 다음 발생 항목을 검색하거나, 바꾸기 버튼을 선택하여 강조 표시 및 일치된 텍스트를 대체합니다. 일치하는 항목이 있는 경우에만 바꾸기 버튼이 활성화됩니다.

찾기를 클릭하면 찾기 및 바꾸기 대화 상자가 투명해지고, 바꾸기를 클릭하면 불투명해집니다. 이로써 작성자는 대체될 텍스트를 검토할 수 있습니다.

NOTE

바꾸기 기능을 사용하면 찾기 문자열과 동시에 대체할 바꾸기 문자열을 입력해야 합니다. 단, 계속 찾기를 클릭하여 문자열을 대체하기 전에 검색할 수 있습니다. 찾기를 클릭한 후 바꾸기 문자열을 입력하면 검색은 텍스트 시작으로 재설정됩니다.

왼쪽으로 텍스트 정렬

왼쪽 여백으로 텍스트를 정렬하는 데 사용됩니다.

텍스트를 가운데로

가운데로 텍스트를 정렬하는 데 사용됩니다.

오른쪽으로 텍스트 정렬

오른쪽 여백으로 텍스트를 정렬하는 데 사용됩니다.

글머리 기호

선택한 텍스트 서식을 글머리 기호 목록으로 지정하거나 커서 다음에 글머리 기호 목록을 삽입하는 데 사용됩니다.

글머리 기호 목록을 종료하려면 글머리 기호 버튼을 다시 탭 또는 클릭하거나 캐리지 리턴을 2번 입력합니다.

번호 매기기

선택한 텍스트 서식을 번호 매기기 목록으로 지정하거나 커서 다음에 번호 매기기 목록을 삽입하는 데 사용됩니다.

번호 매기기 목록을 종료하려면 번호 매기기 버튼을 다시 탭 또는 클릭하거나 캐리지 리턴을 2번 입력합니다.

내어쓰기

선택한 텍스트나 커서 다음에 입력한 텍스트의 들여쓰기 레벨을 낮추는 데 사용됩니다,

선택한 텍스트나 커서의 위치가 이미 들여 쓴 경우에만 활성화됩니다.

들여쓰기

선택한 텍스트나 커서 다음에 입력한 텍스트의 들여쓰기 레벨을 높이는 데 사용됩니다,

표

표를 텍스트에 삽입하는 데 사용됩니다. 이 옵션을 선택하면 표의 세부 정보를 지정하는 창이 열립니다.

표 예제

열 - 표의 열 수 (필수)
행 - 표의 행 수 (필수)
폭 - 표의 폭
높이 - 표의 높이
셀 패딩 - 셀 내용 앞뒤 공백
셀 간격 - 셀 간 간격
테두리 - 표 테두리 라인 두께
- 표 머리말의 경우:
  - 첫 번째 행을 사용해야 합니다.
  - 첫 번째 열을 사용해야 합니다.
  - 첫 번째 행과 첫 번째 열을 사용해야 합니다.
  - 또는 머리말을 사용해서는 안 됩니다.
캡션 - 표의 캡션

맞춤법 검사

텍스트 맞춤법을 검사하는 데 사용됩니다. 오자는 빨간색 점선으로 밑줄이 그어져 있습니다.

맞춤법 검사와 맞춤법 검사 사전 맞춤화에 대한 자세한 내용은 리치 텍스트 편집기 플러그인 구성 문서에서 확인할 수 있습니다.

특수 문자 special-characters

특수 문자를 텍스트에 삽입하는 데 사용됩니다. 이 옵션을 선택하면 창이 열리고 사용할 수 있는 문자가 표시됩니다.

특수 문자 예제

원하는 문자를 탭하거나 클릭하여 커서 다음 텍스트에 삽입합니다. 여러 문자들을 삽입할 수 있습니다. x를 탭하거나 클릭하여 선택 창을 닫습니다.

소스 편집

텍스트의 HTML 소스를 확인하고 수정하는 데 사용됩니다.

원시 HTML을 보려면 소스 편집 아이콘을 탭하거나 클릭하여 서식이 지정된 보기에서 텍스트 콘텐츠를 변경합니다. 이 모드에서 다른 모든 서식 지정 옵션이 비활성화됩니다. 서식이 지정된 보기로 돌아가려면 소스 편집 아이콘을 다시 탭하거나 클릭합니다.

CAUTION

원시 HTML에 액세스하는 경우와 마찬가지로 소스 편집 옵션을 사용할 때 주의해야 합니다

XSS 위험이 있는 경우 소스 편집 을 통해 입력된 HTML을 스캔합니다. 그리고 삽입한 스크립트를 제거하면 결과 페이지에 나타나지 않습니다. 소스 편집 을 통해 입력한 HTML의 형식이 잘못되어도 페이지용 템플릿이 깨질 수 있습니다. 그 결과 페이지가 예고 없이 서식 지정되거나 렌더링되어 사용할 수 없게 됩니다.

NOTE

XSS 위험 및 특정 스크립트가 존재하는 경우 소스 편집 을 통해 입력된 HTML을 스캔하여 발견된 위험이 자동으로 제거되기 때문에 지속되는 실제 콘텐츠가 소스 편집 에 입력된 내용과 달라질 수 있습니다. 따라서 소스 편집 을 통해 변경 사항을 저장하려면 먼저 소스 편집 을 종료하고 저장하기 전에 일반 편집기에서 텍스트를 조회해야 합니다.