CODE 사용자 인터페이스를 사용자 지정하고 특정 툴바를 숨기는 방법

간단히 말해서, CODE에서는 전체 툴바 스타일을 '간소화' 또는 '탭 보기' 설정으로 변경할 수 있습니다. 노트북 탭 하나 또는 명령 하나를 숨기려면 WOPI 호스트의 PostMessage API를 사용하는 것이 좋습니다. 뷰어의 일반 메뉴로는 모든 사용자에게 개별 명령을 영구적으로 제거할 수 없습니다. 관리자는 서버의 기본 인터페이스 모드를 설정할 수 있으며, CODE를 내장한 호스트는 세션 수준에서 숨기기 또는 표시 메시지를 보낼 수 있습니다.

사용 중인 액세스 권한에 맞는 방법을 선택하세요. 문서 공간만 더 확보하려면 도구 모음을 축소하거나 간략 보기로 전환하세요. WOPI 통합에서 도움말 탭이나 서식 명령을 제외해야 하는 경우, 편집기가 준비된 후 해당 PostMessage를 전송하세요. 인쇄, 다운로드 또는 편집과 같은 작업을 방지하려면 관련 WOPI 기능 또는 권한을 사용하세요. 버튼을 숨기는 것은 표시 방식을 변경하는 것이지 권한을 변경하는 것이 아닙니다.

적절한 맞춤 설정을 선택하세요

관련 SDK 설명서에 따르면 해당 기능은 Hide_NotebookTab24.04.11.1 버전과 Hide_Command24.04.11.2 버전부터 사용 가능하다고 명시되어 있습니다. CODE 릴리스 패키지와 통합자 빌드는 다를 수 있으므로 API 메시지를 사용하기 전에 실제로 실행 중인 서버 버전을 확인하십시오.

간략 보기와 탭 보기 중 기본 보기를 변경합니다.

간략 보기에서는 메뉴와 더 작은 도구 모음을 사용합니다. 탭 보기에서는 컨트롤이 노트북 막대 탭으로 그룹화됩니다. 서버 설정은 이며 user_interface.mode, 지원되는 값은 compact및 입니다 . 및 tabbed와 같은 이전 레이블은 이러한 이름으로 대체되어 더 이상 사용되지 않습니다.classicnotebookbar

관리자가 제어하는 ​​기본값을 설정하려면 다음 섹션 <mode>내의 기존 항목을 편집하십시오 .<user_interface>coolwsd.xml

<user_interface>
  <mode type="string" desc="Controls the user interface style. The 'default' means: Take the value from ui_defaults, or decide for one of compact or tabbed (default|compact|tabbed)" default="default">tabbed</mode>
</user_interface>

compact간략한 메뉴를 사용하려면 대신 를 사용하십시오 tabbed. 실제 구성 파일에서는 두 번째 모드 항목을 추가하는 대신 기존 모드 항목을 변경하십시오. 정확한 구성 경로 및 재시작 절차는 CODE가 패키지, 컨테이너 또는 다른 플랫폼을 통해 설치되었는지에 따라 다릅니다. 해당 배포의 구성 방법을 따르고 필요에 따라 서비스를 재시작하거나 다시 로드한 다음 새 문서 세션을 열어 기본 설정을 확인하십시오.

이 설정은 기본 인터페이스 모드를 지정하는 것이며 특정 명령을 숨기는 것은 아닙니다. 사용자 또는 통합자는 서버의 저장된 UI 상태 구성에 따라 우선 순위가 있는 인터페이스 기본 설정을 저장할 수 있습니다. 브라우저가 계속해서 다른 보기로 다시 열리는 경우, 서버 설정을 변경하기 전에 새 세션을 실행하고 통합자의 사용자 기본 설정 동작을 확인하십시오.

명령은 제거하지 않고 도구 모음을 접습니다.

단순히 문서 공간을 늘리는 것이 목적이라면 탭으로 구분된 노트북바를 접는 것만으로도 충분한 경우가 많습니다. SDK에서 제공하는 Collapse_Notebookbar메시지는 노트북바 버튼을 숨기지만 탭 이름은 그대로 유지되므로 사용자는 언제든지 다시 컨트롤을 확장할 수 있습니다. 또한 동일한 메시지는 간략 보기에서도 버튼 스트립을 숨깁니다. 이는 편집 기능을 비활성화하는 것이 아니라 되돌릴 수 있는 표시 변경 사항입니다.

지원되는 인터페이스에서 사용자는 탭 스트립을 조작하여 노트북바를 접거나 펼칠 수 있습니다. 클릭 또는 더블 클릭 동작은 뷰 및 릴리스 버전에 따라 다를 수 있습니다. 사용자가 접힌 바를 복원해야 하는 경우 탭 이름이 계속 표시되도록 하고, 사용자가 사용하는 동일한 CODE 빌드에서 해당 동작을 테스트하십시오.

WOPI 통합에서 탭 또는 명령 하나를 숨기기

세션별 ​​숨기기 기능을 사용하려면 CODE를 iframe에 삽입하고 해당 iframe으로 메시지를 보낼 수 있는 호스트 애플리케이션이 필요합니다. 이는 일반적인 설정이 아니므로 별도의 수정 없이 바로 사용할 수 없습니다 coolwsd.xml. PostMessage API는 MessageId타임스탬프와 선택적 응답을 포함하는 메시지를 사용합니다 Values. WOPI 호스트는 에디터 명령을 보내기 전에 준비 상태 교환을 완료해야 합니다. 호스트 페이지에 대한 WOPI를 구성 PostMessageOrigin하고 브라우저 메시지 대상으로 정확한 CODE iframe 출처를 사용하십시오. 와일드카드 대상 출처는 사용하지 마십시오.

호스트가 적절한 App_LoadingStatus준비 이벤트를 수신하고 메시지를 보낸 후에 Host_PostmessageReady는 숨기기 메시지를 보낼 수 있습니다. 예를 들어, 다음 호출은 열려 있는 편집기 세션에서 도움말 탭과 밑줄 명령을 숨깁니다.

const frame = document.getElementById("collaboraFrame");
const collaboraOrigin = "https://office.example.com";

function sendToCollabora(MessageId, Values = {}) {
  frame.contentWindow.postMessage({
    MessageId,
    SendTime: Date.now(),
    Values
  }, collaboraOrigin);
}

// Call after the WOPI PostMessage readiness exchange.
sendToCollabora("Hide_NotebookTab", { id: "Help" });
sendToCollabora("Hide_Command", { id: ".uno:Underline" });

자신의 CODE iframe의 출처로 바꿔주세요 office.example.com. 예시는 메시지 형식을 보여주는 것이며, 실제 호스트 iframe의 수명 주기에 맞춰 연결하고 응답하기 전에 수신 메시지의 출처를 검증해야 합니다. CODE 문서에 따르면 이전에 전송된 호스트 메시지는 Host_PostmessageReady무시될 수 있습니다.

어떤 메시지를 사용해야 할까요?

• Hide_NotebookTab탭 보기에서 전체 탭에 사용합니다. `< 탭id ID>`와 같은 탭 ID입니다 Help. `<탭 ID Show_NotebookTab>`를 누르면 변경 사항이 되돌려집니다. 탭은 표시 메시지가 도착할 때까지 해당 세션 동안 숨겨진 상태로 유지됩니다.
• Hide_Command: 해당 명령이 메뉴, 도구 모음 및 상황별 메뉴에서 사라지도록 하려면 이 옵션을 사용하십시오. 예를 들어 ID가 .uno:Underline. Show_Command인 경우 이 옵션을 사용하면 해당 명령의 ID가 반전됩니다. 이 옵션은 해당 명령을 이러한 모든 영역에서 제거하는 것이 의도된 결과일 때만 사용하십시오.
• Hide_Button명령에 대한 모든 UI 항목을 숨기는 대신 특정 버튼 하나만 숨기려는 경우에 사용합니다. 해당 버튼의 ID는 툴바 버튼 ID이며, 반드시 UNO 명령 이름과 일치하는 것은 아닙니다. Collabora 문서에 따르면 이러한 ID는 일반적으로 안정적이지만 보장되는 것은 아닙니다. 사용 중인 빌드 및 장치 폼 팩터에 맞는 소스 코드와 대조하여 ID를 확인하십시오 .
• Hide_Menubar: 이 기능은 메뉴 모음을 전체적으로 숨깁니다. 명령별로 제어하는 ​​기능이 아니며, 노트북바 탭을 숨기는 기능과 혼동해서는 안 됩니다.

postMessage API는 통합 호스트용으로 설계되었습니다. Nextcloud, ownCloud 또는 다른 플랫폼을 사용하는 경우, 사용자 지정 호스트 코드를 작성하기 전에 해당 커넥터에서 지원되는 설정이 제공되는지 확인하십시오. 편집기 페이지에 CSS를 삽입하지 마십시오. CSS는 릴리스 간에 불안정하며 시각적으로만 컨트롤을 숨길 뿐입니다.

변경 사항이 사용 사례에 적합한지 확인하십시오.

사용자와 동일한 브라우저, 문서 유형, 권한 및 CODE 릴리스를 사용하여 테스트 문서를 엽니다. 선택한 모드를 확인하고, 의도한 탭이나 명령만 숨겨지는지 확인한 다음, 해당 메시지 표시 또는 도구 모음 확장 작업이 제대로 작동하는지 테스트합니다. 통합 기능이 Writer, Calc, Impress 세 가지 모두를 지원하는 경우 각 모듈에 대해 이 과정을 반복합니다. 모듈 간에 사용 가능한 명령 및 도구 모음 ID가 반드시 동일하지는 않습니다.

숨겨진 컨트롤이 여전히 표시되는 경우 호스트가 메시지를 전송했는지 Host_PostmessageReady, WOPI PostMessageOrigin및 iframe 대상 출처가 올바른지, 메시지에 예상 ID와 철자가 사용되었는지 확인하십시오. 또한 서버 버전이 문서화된 기능 기준선과 일치하는지 확인하십시오. 시각적으로 숨기는 데 성공하더라도 기본 문서 엔진에서 명령이 제거되거나 보안 제한이 설정되지는 않습니다. 액세스 제어에는 WOPI 권한 및 백엔드 정책을 사용하십시오.

공식 참고 자료

• Collabora Online SDK 매뉴얼, 24.04: 구성 및 PostMessage API
• Collabora 온라인 SDK PostMessage API 문서
• CODE 26.04 릴리스 노트
• CODE 21.11 릴리스 노트: 간략 보기 및 탭 보기 전환 기능 추가