리치 텍스트 편집기 구성 configure-the-rich-text-editor

리치 텍스트 편집기(RTE)는 작성자가 텍스트 콘텐츠를 편집할 수 있는 다양한 기능을 제공합니다. WYSIWYG 텍스트 편집 환경을 위해 아이콘, 선택 상자, 도구 모음 및 메뉴가 제공됩니다.

작성에 RTE 기능을 사용하는 방법은 작성에 서식 있는 텍스트 편집기 사용을 참조하세요. 작성 구성 요소에서 사용할 수 있는 기능을 활성화, 비활성화 및 확장하도록 RTE를 구성할 수 있습니다. 다음 워크플로우는 Experience Manager에서 RTE 구성 작업을 완료하는 권장 순서를 보여 줍니다.

그림: RTE를 구성하는 방법을 배우는 단계 순서

터치 지원 UI 및 클래식 UI 이해 understand-touch-enabled-ui-and-classic-ui

터치 지원 UI는 Experience Manager을 위한 표준 사용자 인터페이스입니다. Adobe은 작성 환경을 위해 반응형 디자인이 포함된 터치 사용 UI를 도입했습니다. 터치 지원 UI는 터치 및 데스크탑 디바이스용으로 설계되었습니다. 인터페이스는 기존 클래식 UI와 상당히 다릅니다.

그림: 터치 사용 UI의 리치 텍스트 편집기 도구 모음

그림: 클래식 UI의 리치 텍스트 편집기 도구 모음

다양한 편집 모드 editingmodes

작성자는 다양한 구성 요소 모드를 사용하여 Experience Manager에서 텍스트 콘텐츠를 만들고 편집할 수 있습니다. 다른 편집 모드에서 RTE 사용 구성 요소의 사용자 경험 및 컨텐츠를 작성하고 형식을 지정하기 위한 도구 모음 옵션은 RTE 구성에 따라 다릅니다.

인라인 편집 inline-editing

열면(느리게 두 번 클릭) 페이지 내에서 콘텐츠를 편집할 수 있습니다. 매우 기본적인 옵션이 있는 작은 도구 모음이 표시됩니다.

그림: 터치 사용 UI에서 기본 도구 모음을 사용하여 인라인 편집

클래식 UI에서 구성 요소를 천천히 더블 클릭하면 인라인 편집이 가능하고 주황색 윤곽선이 콘텐츠를 강조 표시합니다. 컨텐츠 파인더가 열려 있으면 사용 가능한 RTE 서식 옵션이 있는 도구 모음이 창 맨 위에 표시됩니다. 컨텐츠 파인더가 열리지 않으면 서식 옵션이 표시되지 않으며 기본 텍스트 편집만 수행할 수 있습니다.

전체 화면 편집 full-screen-editing

Experience Manager 구성 요소를 전체 화면 보기에서 열어 페이지 콘텐츠를 숨기고 사용 가능한 화면을 차지할 수 있습니다. 인라인 편집은 가장 많은 편집 옵션을 제공하므로 전체 화면 편집을 고려하십시오. 인라인 편집 모드를 사용할 때 간단한 도구 모음에서 을(를) 클릭하여 열 수 있습니다.

대화 상자 전체 화면 모드에서는 세부 RTE 도구 모음과 함께 대화 상자에서 사용할 수 있는 옵션 및 구성 요소도 사용할 수 있습니다. 다른 구성 요소와 함께 RTE가 포함된 대화 상자에만 적용됩니다.

그림: 터치 사용 UI에서 전체 화면 모드로 편집할 때 자세한 RTE 도구 모음

대화 상자 편집 dialog-editing

구성 요소를 두 번 클릭하면 콘텐츠를 편집할 수 있는 대화 상자가 열립니다. 대화 상자가 기존 페이지 위에 열립니다. 일부 특정 시나리오에서는 대화 상자가 팝업 창으로 열립니다. 예를 들어 텍스트 구성 요소가 다중 열 페이지 레이아웃의 열에 속하고 대화 상자에 사용할 수 있는 영역이 적은 경우.

터치 사용 UI의

그림: 터치 사용 UI의 대화 상자 편집 모드

그림: 편집을 위한 자세한 도구 모음이 포함된 클래식 UI의 대화 상자

RTE 플러그인 및 관련 기능 정보 aboutplugins

이 기능은 각각 다음과 같은 일련의 플러그인을 통해 사용할 수 있습니다.

RTE의 기본 기능은 해당 플러그인과 관련된 노드의 features 속성 값으로 활성화되거나 비활성화됩니다.

다음 표에는 현재 플러그인이 나열되어 있습니다.

구성 경로 및 위치 이해 understand-the-configuration-paths-and-locations

작성자를 위해 제공한 RTE 편집 모드(및 UI)는 RTE 플러그인을 활성화할 때 구성 세부 정보에 대한 위치를 결정합니다.

Touch UI의 대화 상자 편집 모드에서만 적용되는 다음 속성을 구성합니다.

터치 사용 대화 상자에서 RTE를 사용하는 경우 문제를 방지하기 위해 속성 useFixedInlineToolbar을(를) true로 설정해야 합니다.

즉석 편집 사용자 지정 customizing-in-place-editing

다음 속성을 구성하여 텍스트 편집기가 시작되는 HTML 선택기를 정의할 수 있습니다.

대화 상자 모드의 해당 속성은 name입니다.

플러그인을 활성화하여 RTE 기능 활성화 enable-rte-functionalities-by-activating-plug-ins

RTE 기능은 기능 속성이 있는 일련의 플러그인을 통해 사용할 수 있습니다. 각 플러그인의 다양한 기능을 활성화하거나 비활성화하도록 기능 속성을 구성할 수 있습니다.

RTE 플러그인에 대한 자세한 구성은 RTE 플러그인을 활성화하고 구성하는 방법을 참조하십시오.

샘플: RTE를 구성하는 방법을 보여 주는 이 샘플 구성을(를) 다운로드합니다. 이 패키지에서는 모든 기능이 활성화됩니다.

RTE 도구 모음 구성 dialogfullscreen

AEM을 사용하면 리치 텍스트 편집기에 대한 인터페이스를 다양한 편집 모드에 대해 다르게 구성할 수 있습니다. 기본 설정은 아래에 제공됩니다. 요구 사항에 따라 이러한 기본값을 재정의할 수 있습니다. 작성자에게 제공할 도구 모음 기능만 사용자 지정합니다. 모든 도구 모음 구성을 지정할 필요는 없습니다.

dialogFullScreen에 대한 도구 모음을 구성하려면 다음 샘플 구성을 사용하십시오.

<uiSettings jcr:primaryType="nt:unstructured">
  <cui jcr:primaryType="nt:unstructured">
    <inline
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,#justify,#lists,links#modifylink,links#unlink,#paraformat]">
      <popovers jcr:primaryType="nt:unstructured">
        <justify
          jcr:primaryType="nt:unstructured"
          items="[justify#justifyleft,justify#justifycenter,justify#justifyright,justify#justifyjustify]"
          ref="justify"/>
        <lists
          jcr:primaryType="nt:unstructured"
          items="[lists#unordered,lists#ordered,lists#outdent,lists#indent]"
          ref="lists"/>
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </inline>
    <dialogFullScreen
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,justify#justifyleft,justify#justifycenter,justify#justifyright,justify#justifyjustify,lists#unordered,lists#ordered,lists#outdent,lists#indent,links#modifylink,links#unlink,table#createoredit,#paraformat,image#imageProps]">
      <popovers jcr:primaryType="nt:unstructured">
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </dialogFullScreen>
    <tableEditOptions
      jcr:primaryType="nt:unstructured"
      toolbar="[table#insertcolumn-before,table#insertcolumn-after,table#removecolumn,-,table#insertrow-before,table#insertrow-after,table#removerow,-,table#mergecells-right,table#mergecells-down,table#mergecells,table#splitcell-horizontal,table#splitcell-vertical,-,table#selectrow,table#selectcolumn,-,table#ensureparagraph,-,table#modifytableandcell,table#removetable,-,undo#undo,undo#redo,-,table#exitTableEditing,-]">
    </tableEditOptions>
  </cui>
</uiSettings>

인라인 모드와 전체 화면 모드에서는 서로 다른 UI 설정이 사용됩니다. toolbar 속성은 도구 모음의 단추를 지정하는 데 사용됩니다.

예를 들어 단추가 기능(예: Bold)이면 PluginName#FeatureName(예: links#modifylink)로 지정됩니다.

단추가 팝오버(플러그인의 일부 기능 포함)이면 #PluginName(예: #format)로 지정됩니다.

단추 그룹 사이의 구분 기호(|)는 -(으)로 지정할 수 있습니다.

인라인 또는 전체 화면 모드 아래의 팝업 노드에는 사용 중인 팝오버 목록이 포함됩니다. 'popovers' 노드 아래의 각 하위 노드의 이름은 플러그인(예: format) 이름을 따서 지정합니다. 여기에는 플러그인의 기능 목록을 포함하는 속성 'items'가 있습니다(예: format#bold).

RTE 사용자 인터페이스 설정 및 콘텐츠 정책 rtecontentpolicies

관리자는 위에서 설명한 대로 구성을 수행하는 대신 콘텐츠 정책을 사용하여 RTE 옵션을 제어할 수 있습니다. 콘텐츠 정책은 편집 가능한 템플릿의 일부로 사용되는 경우 구성 요소의 디자인 속성을 정의합니다. 예를 들어 RTE를 사용하는 텍스트 구성 요소를 편집 가능한 템플릿과 함께 사용하는 경우 콘텐츠 정책에서 굵게 옵션을 사용할 수 있고 몇 가지 단락 서식 옵션을 사용할 수 있도록 정의할 수 있습니다. 콘텐츠 정책은 재사용이 가능하며 여러 템플릿에 적용할 수 있습니다.

RTE에서 사용할 수 있는 옵션은 사용자 인터페이스 구성에서 콘텐츠 정책으로 다운스트림됩니다.

예를 들어 텍스트 핵심 구성 요소 설명서를 볼 수 있습니다.

도구 모음 아이콘과 명령 간의 매핑 사용자 정의 iconstoolbar

RTE 도구 모음에 표시되는 Coral 아이콘과 사용 가능한 명령 간의 매핑을 사용자 정의할 수 있습니다. 코랄 아이콘 이외의 다른 아이콘은 사용할 수 없습니다.

다음은 Bold 명령을 Coral 아이콘 textItalic에 매핑하는 샘플 코드 조각입니다.

<text jcr:primaryType="nt:unstructured" sling:resourceType="cq/gui/components/authoring/dialog/richtext" name="./text" useFixedInlineToolbar="{Boolean}true">
    <rtePlugins jcr:primaryType="nt:unstructured">
        <format jcr:primaryType="nt:unstructured" features="bold,italic"/>
    </rtePlugins>
    <uiSettings jcr:primaryType="nt:unstructured">
        <cui jcr:primaryType="nt:unstructured">
            <inline jcr:primaryType="nt:unstructured"
                toolbar="[format#bold,format#italic,format#underline,links#modifylink,links#unlink]">
            </inline>
            <icons jcr:primaryType="nt:unstructured">
                <bold jcr:primaryType="nt:unstructured"
                    command="format#bold"
                    icon="textItalic"/>
            </icons>
        </cui>
    </uiSettings>
</text>

CoralUI 2 리치 텍스트 편집기로 전환 switch-to-coralui-rich-text-editor

페이지에서 CoralUI 2 RTE clientlib 또는 CoralUI 3 RTE clientlib을 포함할 수 있습니다. 기본적으로 리치 텍스트 편집기에는 CoralUI 3 RTE clientlib이 포함됩니다. CoralUI 2 RTE로 전환하려면 다음 단계를 수행하십시오.

추가 정보 further-information

RTE 구성에 대한 자세한 내용은 AEM Widget API 참조를 참조하십시오.

특히, 사용 가능한 플러그인 및 관련 옵션을 보려면 다음과 같이 하십시오.

RTE를 확장하거나 사용자 지정하는 데 사용할 수 있습니다. 예를 들어 링크를 만들 때 페이지에서 사용할 수 있는 앵커를 나열하려면 LinkPlugin의 고유한 구현을 제공할 수 있습니다.

알려진 제한 사항 known-limitations

AEM RTE 기능에는 다음과 같은 제한 사항이 있습니다.

모범 사례 및 팁 best-practices-and-tips

RTE의 빈번한 문제 해결 troubleshoot-issues-with-aem-rich-text-editor

여러 표 셀을 선택하는 방법

테이블에서 여러 셀을 선택하려면 Ctrl 또는 Cmd 키를 누른 다음 테이블 셀을 하나씩 클릭합니다.

이제 선택한 셀의 속성을 설정하여 선택 항목에 대한 작업을 수행합니다.

구성 단추를 사용하여 구성 요소를 편집할 때 하이퍼링크가 손실됨

구성 단추를 사용하여 텍스트 구성 요소를 편집하여 하이퍼링크를 추가합니다. 하이퍼링크를 다시 편집하고 두 번째로 유효성을 검사할 때 하이퍼링크가 손실될 수 있습니다.

해결 방법은 편집 대화 상자가 두 번째로 표시될 때 텍스트 구성 요소를 클릭한 다음 링크 유효성 검사를 실행하는 것입니다.

이 문제는 AEM 6.3 이상에서 해결되었습니다.

소스 편집 모드에서 추가된 HTML 컨텐츠가 손실됩니다

XSS 유발 HTML을 추가하지 마십시오. RTE가 아닌 AEM은 XSS antisamy 규칙을 준수하도록 일부 HTML 콘텐츠를 제거할 수 있습니다.

붙여넣은 HTML이 저장되었는지 확인하려면 CRXDE(콘텐츠 노드)에 저장된 콘텐츠를 확인합니다.

저장하지 않았다면 HTML이 RTE의 규칙을 준수하지 않아 RTE에서 제거했어야 합니다.

CRXDE에 저장했지만 페이지에서 렌더링되지 않은 경우(렌더링을 확인하려면 페이지의 미리 보기를 참조), AEM XSS 규칙에 의해 제거됩니다.

다중 필드 구성 요소가 예상대로 작동하지 않습니다

다중 필드 구성 요소를 만들려면 CoralUI 3만 사용하십시오. CoralUI 2 구성 요소 대화 상자를 사용하지 마십시오.

또한 다중 필드 구현 코드와 노드 구조가 올바른지 확인하십시오.

관리자가 사용할 수 있는 구성을 작성자가 사용할 수 없습니다

인터페이스 구성 업데이트가 작성자 계정이 아닌 관리자에 대해 반영되는 경우 구성 노드의 이름이 config이(가) 아닌지 확인하십시오. configPath 속성을 사용합니다.