Início
» ESCRITÓRIO MS
»
Como personalizar a interface do usuário do CODE e ocultar barras de ferramentas específicas
Como personalizar a interface do usuário do CODE e ocultar barras de ferramentas específicas
Resposta curta: No CODE, altere o estilo geral da barra de ferramentas com a configuração de visualização Compacta ou em Abas. Para ocultar uma aba do notebook ou um comando, o método recomendado é a API PostMessage do host WOPI; os menus normais do visualizador não removem permanentemente comandos individuais para todos. Os administradores podem definir o modo de interface padrão para um servidor, enquanto os hosts que incorporam o CODE podem enviar mensagens de ocultação ou exibição em nível de sessão.
Escolha o método que melhor se adapta ao seu nível de acesso. Se você deseja apenas mais espaço para o documento, recolha a barra de ferramentas ou alterne para a visualização Compacta. Se a sua integração WOPI deve omitir a guia Ajuda ou um comando de formatação, envie a mensagem PostMessage correspondente após o editor estar pronto. Se o seu objetivo é impedir uma ação como impressão, download ou edição, utilize também a funcionalidade ou permissão WOPI relevante; ocultar um botão altera a apresentação, não a autorização.
Escolha a personalização certa.
O que você quer mudar?
Use este método
O que isso afeta
Use o menu compacto ou a barra de notas com abas por padrão.
Definido user_interface.modena configuração do servidor
Modo de interface padrão para essa implantação do CODE
Libere temporariamente mais espaço para o documento.
Recolha a barra de tarefas na interface do usuário ou envieCollapse_Notebookbar
Oculta os botões de guia; o usuário pode expandi-los novamente.
Ocultar uma aba da barra de ferramentas, como a Ajuda.
EnviarHide_NotebookTab
Uma aba em uma sessão de editor incorporado ao WOPI
Ocultar um comando em toda a interface do editor.
EnviarHide_Command
As entradas desse comando no menu, na barra de ferramentas e no menu contextual.
Ocultar apenas um botão específico da barra de ferramentas
Enviar Hide_Buttoncom o ID do botão
Um botão na barra de ferramentas; o ID pode variar de acordo com a interface do usuário e a versão.
O manual do SDK relevante indica Hide_NotebookTabque a funcionalidade está disponível a partir da versão 24.04.11.1 e também Hide_Commanda partir da versão 24.04.11.2. Os pacotes de lançamento do CODE e as versões de integração podem ser diferentes, portanto, verifique a versão do servidor que você está executando antes de confiar em uma mensagem da API.
Alterar a visualização padrão entre Compacta e com Abas
A visualização compacta usa um menu e uma barra de ferramentas menor. A visualização com abas agrupa os controles nas abas da barra de ferramentas. A configuração do servidor é `<nome_do_servidor>` user_interface.mode, com os valores suportados `<valor_do_servidor>` compacte ` <valor_do_servidor> tabbed`. Rótulos antigos, como `<nome_do_servidor>` e `<valor_do_servidor>`, estão obsoletos classice notebookbarforam substituídos por estes nomes.
Visão compacta ilustrativa: o editor utiliza uma linha de menu e uma barra de ferramentas de formatação estreita acima do documento.
Para definir um valor padrão controlado pelo administrador, edite a <mode>entrada existente na <user_interface>seção de 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>
Use `<mode> compact` em vez de `<mode>` tabbedpara o menu compacto. Em um arquivo de configuração real, altere a entrada de modo existente em vez de adicionar uma segunda. O caminho de configuração exato e o procedimento de reinicialização dependem se o CODE foi instalado como um pacote, contêiner ou por meio de outra plataforma. Siga o método de configuração dessa implantação, reinicie ou recarregue o serviço conforme necessário e abra uma nova sessão de documento para confirmar o padrão.
Isso define um modo de interface padrão; não oculta nenhum comando específico. Um usuário ou integrador pode ter preferências de interface salvas que têm precedência, dependendo da configuração de estado da interface do usuário salva do servidor. Se um navegador continuar abrindo em uma visualização diferente, teste uma nova sessão e verifique o comportamento das preferências do usuário do integrador antes de alterar mais configurações do servidor.
Recolher a barra de ferramentas sem remover os comandos
Quando o objetivo é simplesmente aumentar o espaço disponível no documento, recolher a barra de abas geralmente é suficiente. A Collapse_Notebookbarmensagem do SDK oculta os botões da barra de abas; os nomes das abas permanecem visíveis para que os usuários possam expandir os controles novamente. A mesma mensagem também oculta a barra de botões na visualização Compacta. Essa é uma alteração de exibição reversível, não uma forma de desativar os recursos de edição.
Visualização ilustrativa com abas, mostrando as abas da barra de ferramentas e os controles de formatação agrupados.
Em uma interface compatível, o usuário também pode recolher ou expandir a barra de ferramentas interagindo com a sua faixa de abas. O comportamento exato do clique ou clique duplo pode variar de acordo com a visualização e o momento em que o usuário solta a aba. Se os usuários precisarem restaurar uma barra recolhida, mantenha os nomes das abas visíveis e teste a ação na mesma versão do CODE que eles utilizam.
Ocultar uma guia ou comando em uma integração WOPI
O recurso de ocultação por sessão requer um aplicativo host que incorpore o CODE em um iframe e possa enviar mensagens para ele. Não se trata de uma configuração de uso geral que possa ser simplesmente copiada e colada coolwsd.xml. A API PostMessage utiliza mensagens com um ID MessageId, um timestamp e um ID opcional Values. O host WOPI deve concluir a troca de informações de prontidão antes de enviar comandos do editor. Configure o WOPI PostMessageOriginpara a página host e utilize a origem exata do iframe do CODE como destino da mensagem no navegador; não utilize uma origem de destino curinga.
Após o host receber o App_LoadingStatusevento de prontidão apropriado e enviá-lo Host_PostmessageReady, ele pode enviar uma mensagem de ocultação. Por exemplo, as chamadas a seguir ocultam a guia Ajuda e o comando sublinhado da sessão do editor aberta:
Exemplo ilustrativo de visualização em abas, com a aba Ajuda oculta e as demais abas da barra de ferramentas ainda visíveis.Exemplo ilustrativo de personalização do host WOPI: o comando sublinhado fica oculto, enquanto o restante da barra de ferramentas permanece visível.
Substitua office.example.compela origem do seu próprio iframe CODE. O exemplo ilustra o formato da mensagem; integre-a ao ciclo de vida real do iframe do host e valide a origem das mensagens recebidas antes de responder. A documentação do CODE observa que as mensagens do host enviadas anteriormente Host_PostmessageReadypodem ser ignoradas.
Qual mensagem você deve usar?
Hide_NotebookTabUse -o para uma aba inteira na visualização com abas. É ido ID da aba, como por exemplo , `tab1` Help. Show_NotebookTab`tab2` reverte a alteração. A aba permanece oculta durante a sessão até que uma mensagem de exibição seja exibida.
Hide_CommandUse este ID quando o comando precisar desaparecer do menu, da barra de ferramentas e dos menus contextuais. Um exemplo de ID é ` .uno:Underline.`. Show_CommandO comando `.` inverte o comportamento. Use este ID somente quando o resultado desejado for remover o comando de todas essas superfícies.
Hide_ButtonUse -o quando quiser ocultar um único botão em vez de todas as entradas da interface do usuário para o comando. Seu ID é o ID de um botão da barra de ferramentas, não necessariamente o nome do comando UNO. A documentação da Collabora indica que esses IDs geralmente permanecem estáveis, mas não há garantia; confirme-os com a fonte para sua versão específica e formato de dispositivo.
Hide_MenubarEsta opção oculta a barra de menus por completo. Não se trata de um controle individual de cada comando e não deve ser confundida com a ocultação de uma aba da barra de tarefas.
A API postMessage destina-se a um host de integração. Se você utiliza Nextcloud, ownCloud ou outra plataforma, verifique se o conector dela expõe uma configuração compatível antes de criar código personalizado para o host. Evite injetar CSS na página do editor: essa prática é instável entre versões e apenas oculta visualmente os controles.
Verifique se a alteração se adequa ao seu caso de uso.
Abra um documento de teste usando o mesmo navegador, tipo de documento, permissões e versão do CODE que seus usuários. Confirme o modo selecionado, verifique se apenas a guia ou o comando desejado está oculto e teste a mensagem de exibição ou a ação de expansão da barra de ferramentas correspondente. Repita o processo para o Writer, Calc e Impress, caso sua integração seja compatível com os três; os comandos disponíveis e os IDs da barra de ferramentas podem não ser idênticos entre os módulos.
Se um controle oculto ainda aparecer, verifique se o host enviou a mensagem Host_PostmessageReady, se a origem WOPI PostMessageOrigine o destino do iframe estão corretos e se a mensagem usou o ID e a grafia esperados. Verifique também a versão do servidor em relação à versão básica documentada do recurso. Uma ocultação visual bem-sucedida não remove o comando do mecanismo de documentos subjacente nem estabelece uma restrição de segurança. Use permissões WOPI e políticas de backend para controle de acesso.