Cum să personalizezi interfața utilizator CODE și să ascunzi anumite bare de instrumente

Răspuns scurt: În CODE, modificați stilul general al barei de instrumente cu setarea Vizualizare compactă sau cu file. Pentru a ascunde o filă de blocnotes sau o comandă, ruta acceptată este API-ul PostMessage al gazdei WOPI; meniurile normale ale vizualizatorului nu elimină definitiv comenzile individuale pentru toată lumea. Administratorii pot seta modul implicit de interfață pentru un server, în timp ce gazdele care încorporează CODE pot trimite mesaje de ascundere sau afișare la nivel de sesiune.

Alegeți metoda care corespunde accesului dvs. Dacă doriți doar mai mult spațiu pentru documente, restrângeți bara de instrumente sau comutați la vizualizarea compactă. Dacă integrarea WOPI ar trebui să omită fila Ajutor sau o comandă de formatare, trimiteți mesajul PostMessage corespunzător după ce editorul este gata. Dacă obiectivul dvs. este să împiedicați o acțiune precum imprimarea, descărcarea sau editarea, utilizați și capacitatea sau permisiunea WOPI relevantă; ascunderea unui buton modifică prezentarea, nu autorizarea.

Alegeți personalizarea potrivită

Ce vrei să schimbiFolosește această metodăCe afectează
Utilizați în mod implicit meniul compact sau bara de blocnotes cu fileSetați user_interface.modeîn configurația serveruluiMod de interfață implicit pentru implementarea CODE respectivă
Faceți temporar mai mult spațiu pentru documentRestrângeți bara de blocnotesuri din interfața cu utilizatorul sau trimitețiCollapse_NotebookbarAscunde butoanele de tip tab; utilizatorul le poate extinde din nou
Ascundeți o filă din bara de notebook-uri, cum ar fi AjutorTrimiteHide_NotebookTabO filă într-o sesiune de editor încorporată în WOPI
Ascundeți o comandă în interfața editoruluiTrimiteHide_CommandIntrările din meniul, bara de instrumente și meniul contextual ale acelei comenzi
Ascundeți doar un anumit buton din bara de instrumenteTrimiteți Hide_Buttoncu ID-ul butonului săuUn buton din bara de instrumente; ID-ul poate varia în funcție de interfața cu utilizatorul și de versiune

Manualul SDK relevant identifică versiunea Hide_NotebookTabca fiind disponibilă începând cu versiunea 24.04.11.1 și Hide_Commandîncepând cu versiunea 24.04.11.2. Pachetele de lansare CODE și versiunile integratorului pot diferi, așa că verificați versiunea serverului pe care îl rulați efectiv înainte de a vă baza pe un mesaj API.

Schimbați setările implicite între vizualizarea Compact și vizualizarea cu file

Vizualizarea compactă utilizează un meniu și o bară de instrumente mai mică. Vizualizarea cu file grupează controalele în filele barei de notebook-uri. Setarea serverului este user_interface.mode, cu valorile acceptate compactși tabbed. Etichetele mai vechi, cum ar fi classicși , notebookbarsunt depreciate în favoarea acestor nume.

Un editor de documente bazat pe browser afișează un rând de meniu compact și o bară de instrumente de formatare îngustă deasupra unei pagini exemplu.
Vizualizare compactă ilustrativă: editorul folosește un rând de meniu și o bară de instrumente de formatare îngustă deasupra documentului.

Pentru o valoare implicită controlată de administrator, editați <mode>intrarea existentă din <user_interface>secțiunea 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>

Se utilizează compactîn loc de tabbedpentru meniul compact. Într-un fișier de configurare real, se modifică intrarea de mod existentă în loc să se adauge una a doua. Calea exactă de configurare și procedura de repornire depind de instalarea CODE ca pachet, container sau printr-o altă platformă. Urmați metoda de configurare a implementării respective, reporniți sau reîncărcați serviciul după cum este necesar și deschideți o nouă sesiune de documente pentru a confirma valoarea implicită.

Aceasta setează un mod implicit de interfață; nu ascunde o comandă specifică. Un utilizator sau integrator poate avea preferințe de interfață salvate care au prioritate, în funcție de configurația stării UI salvate a serverului. Dacă un browser se redeschide în mod repetat într-o vizualizare diferită, testați o sesiune nouă și verificați comportamentul preferințelor utilizatorului integratorului înainte de a modifica mai multe setări ale serverului.

Restrângeți bara de instrumente fără a elimina comenzile

Când scopul este pur și simplu de a mări spațiul documentului, restrângerea barei de notebook-uri cu file este de obicei suficientă. Collapse_NotebookbarMesajul SDK-ului ascunde butoanele barei de notebook-uri; numele filelor rămân disponibile, astfel încât utilizatorii să poată extinde din nou controalele. Același mesaj ascunde și banda de butoane în vizualizarea Compact. Aceasta este o modificare reversibilă a afișajului, nu o modalitate de a dezactiva funcțiile de editare.

Un editor de documente afișează bara de blocnotesuri cu file, cu filele Acasă, Inserare, Aspect, Revizuire, Vizualizare și Ajutor deasupra controalelor de formatare grupate.
Vizualizare ilustrativă cu file, cu filele din bara de notebook-uri și controalele de formatare grupate vizibile.

Într-o interfață acceptată, un utilizator poate, de asemenea, să restrânge sau să extindă bara de notebook-uri interacționând cu banda sa de file. Comportamentul precis la clic sau dublu clic poate varia în funcție de vizualizare și eliberare. Dacă utilizatorii trebuie să restaureze o bară restrânsă, păstrați numele filelor vizibile și testați acțiunea în aceeași versiune de COD pe care o utilizează.

Ascundeți o filă sau o comandă într-o integrare WOPI

Ascunderea per sesiune necesită o aplicație gazdă care încorporează CODE într-un iframe și poate trimite mesaje către acesta. Nu este o setare de uz general care poate fi lipită în coolwsd.xml. API-ul PostMessage utilizează mesaje cu MessageId, o marcă temporală și opțional Values. Gazda WOPI trebuie să finalizeze schimbul de disponibilitate înainte de a trimite comenzi ale editorului. Configurați WOPI PostMessageOriginpentru pagina gazdă și utilizați originea exactă a iframe-ului CODE ca țintă a mesajului browserului; nu utilizați o origine țintă cu wildcard.

După ce gazda a primit App_LoadingStatusevenimentul de pregătire corespunzător și a trimis Host_PostmessageReady, aceasta poate trimite un mesaj de ascundere. De exemplu, următoarele apeluri ascund fila Ajutor și comanda subliniere pentru sesiunea de editare deschisă:

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" });
Editorul cu file afișează Acasă, Inserare, Aspect, Revizuire și Vizualizare, cu fila Ajutor ascunsă.
Vizualizare ilustrativă cu file, cu fila Ajutor ascunsă și celelalte file din bara de notebook-uri încă vizibile.
Bara de instrumente a editorului omite controlul de subliniere, în timp ce alte controale de formatare rămân; panoul codului gazdă afișează un mesaj Hide_Command pentru .uno:Underline.
Personalizare ilustrativă a gazdei WOPI: comanda de subliniere este ascunsă, în timp ce restul barei de instrumente rămâne vizibilă.

Înlocuiți office.example.comcu originea propriului iframe CODE. Exemplul ilustrează forma mesajului; conectați-l la ciclul de viață real al iframe-ului gazdă și validați originea mesajelor primite înainte de a răspunde. Documentația CODE menționează că mesajele gazdă trimise anterior Host_PostmessageReadypot fi ignorate.

Ce mesaj ar trebui să folosești?

  • Hide_NotebookTabFolosește -l pentru o filă întreagă în vizualizarea cu file. Este idID-ul filei, de exemplu Help. Show_NotebookTabanulează modificarea. Fila rămâne ascunsă pentru sesiune până când apare un mesaj de afișare.
  • Hide_CommandFolosește -l atunci când comanda trebuie să dispară din meniu, bara de instrumente și meniurile contextuale. Un exemplu de ID este .uno:Underline. Show_Commandîl inversează. Folosește-l numai atunci când rezultatul dorit este eliminarea acelei comenzi din toate acele suprafețe.
  • Hide_ButtonFolosește -l atunci când vrei să ascunzi un singur buton, nu fiecare intrare din interfața utilizator a comenzii. ID-ul său este ID-ul unui buton din bara de instrumente, nu neapărat numele comenzii UNO. Collabora documentează faptul că aceste ID-uri rămân de obicei stabile, dar nu este garantat că vor fi așa; confirmă-le cu sursa pentru versiunea exactă și factorul de formă al dispozitivului tău.
  • Hide_MenubarAceasta ascunde bara de meniu în ansamblu. Nu este un control per comandă și nu trebuie confundat cu ascunderea unei file din bara de notebook-uri.

API-ul postMessage este destinat unei gazde de integrare. Dacă rulați Nextcloud, ownCloud sau o altă platformă, verificați dacă conectorul său expune o setare acceptată înainte de a construi cod de gazdă personalizat. Evitați injectarea CSS în pagina editorului: este fragil în diferite versiuni și ascunde controalele doar vizual.

Verificați dacă modificarea se potrivește cazului dvs. de utilizare

Deschideți un document de test utilizând același browser, același tip de document, permisiuni și versiune CODE ca și utilizatorii dvs. Confirmați modul selectat, verificați dacă doar fila sau comanda dorită este ascunsă și testați afișarea mesajului sau acțiunea de extindere a barei de instrumente corespunzătoare. Repetați pentru Writer, Calc și Impress dacă integrarea dvs. deservește toate trei; comenzile disponibile și ID-urile barei de instrumente nu sunt neapărat identice între module.

Dacă un control ascuns apare în continuare, verificați dacă gazda a trimis comanda Host_PostmessageReady, dacă WOPI-ul PostMessageOriginși originea țintei iframe sunt corecte și dacă mesajul a folosit ID-ul și ortografia așteptate. De asemenea, verificați versiunea serverului în raport cu linia de bază a caracteristicilor documentate. O ascundere vizuală reușită nu elimină comanda din motorul de documente subiacent și nu stabilește o restricție de securitate. Utilizați permisiunile WOPI și politica backend pentru controlul accesului.

Referințe oficiale

Lasă un comentariu

Importul și exportul Office Outlook 2010: Mutarea datelor cu un fișier PST

Importul și exportul Office Outlook 2010: Mutarea datelor cu un fișier PST

Aflați cum să importați un fișier PST în Outlook 2010 sau să exportați e-mailuri, contacte, calendar și activități. Urmați meniurile corecte și evitați folderele lipsă sau duplicatele.

Modificarea înălțimii și lățimii grilei în Word 2010

Modificarea înălțimii și lățimii grilei în Word 2010

Aflați cum să ajustați înălțimea și lățimea grilei în Word 2010, să modificați frecvența liniilor vizibile și să setați spațierea orizontală și verticală subiacentă a grilei de desen.

Recuperarea unei parole Outlook PST cu Nucleus Kernel

Recuperarea unei parole Outlook PST cu Nucleus Kernel

Recuperează o parolă Outlook PST uitată cu pașii actuali ai Kernel, inclusiv cum să identifici fișierul corect, să faci o copie de rezervă și să verifici limitele instrumentului.

Cum se inserează o pagină web live într-un diapozitiv PowerPoint

Cum se inserează o pagină web live într-un diapozitiv PowerPoint

Utilizați programul de completare LiveWeb pentru a plasa un site web pe un diapozitiv PowerPoint, a seta dimensiunea și comportamentul de reîmprospătare și a verifica compatibilitatea înainte de prezentare.

Adăugați sărbători naționale în calendarul Outlook

Adăugați sărbători naționale în calendarul Outlook

Adăugați sărbători specifice fiecărei țări în noul Outlook, Outlook pe web sau Outlook clasic. Aflați cum să evitați evenimentele duplicate și să verificați dacă lipsesc datele din perioada 2026-2027.

Access 2010: Exportul unui tabel de bază de date în Excel 2010

Access 2010: Exportul unui tabel de bază de date în Excel 2010

Exportați un tabel Access 2010 în Excel 2010, alegeți dacă doriți să includeți formatarea, salvați pașii de export reutilizabili și verificați problemele comune legate de transferul de date.

Șabloane Microsoft Word 2010: Găsiți-le, utilizați-le și creați-le

Șabloane Microsoft Word 2010: Găsiți-le, utilizați-le și creați-le

Găsiți șabloane Word 2010 încorporate, începeți un document dintr-un fișier .dotx descărcat și salvați un șablon personalizat reutilizabil fără a suprascrie lucrarea.

Cum să organizezi o prezentare PowerPoint 2010 cu secțiuni

Cum să organizezi o prezentare PowerPoint 2010 cu secțiuni

Utilizați secțiunile PowerPoint 2010 pentru a grupa diapozitive corelate, a redenumi și a rearanja grupuri și a naviga printr-un pachet lung de diapozitive fără a modifica conținutul diapozitivelor.

Cum să eliminați metadatele și conținutul ascunse dintr-un document Word

Cum să eliminați metadatele și conținutul ascunse dintr-un document Word

Folosește Inspectorul de documente din Word pentru a revizui detaliile autorului, comentariile, modificările urmărite, textul ascuns și alte date înainte de partajare și pentru a afla ce poate omite scanarea.

Setări de export și import pentru panglică și bara de instrumente cu acces rapid în Office 2010

Setări de export și import pentru panglică și bara de instrumente cu acces rapid în Office 2010

Mutați filele personalizate din panglică și comenzile din bara de instrumente Acces rapid în Office 2010 cu un fișier .exportedUI și protejați setările deja existente pe PC-ul de destinație.