Acasă
» MS OFFICE
»
Cum să personalizezi interfața utilizator CODE și să ascunzi anumite bare de instrumente
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ă schimbi
Folosește această metodă
Ce afectează
Utilizați în mod implicit meniul compact sau bara de blocnotes cu file
Mod de interfață implicit pentru implementarea CODE respectivă
Faceți temporar mai mult spațiu pentru document
Restrângeți bara de blocnotesuri din interfața cu utilizatorul sau trimitețiCollapse_Notebookbar
Ascunde butoanele de tip tab; utilizatorul le poate extinde din nou
Ascundeți o filă din bara de notebook-uri, cum ar fi Ajutor
TrimiteHide_NotebookTab
O filă într-o sesiune de editor încorporată în WOPI
Ascundeți o comandă în interfața editorului
TrimiteHide_Command
Intrările din meniul, bara de instrumente și meniul contextual ale acelei comenzi
Ascundeți doar un anumit buton din bara de instrumente
Trimiteți Hide_Buttoncu ID-ul butonului său
Un 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.
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.
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ă:
Vizualizare ilustrativă cu file, cu fila Ajutor ascunsă și celelalte file din bara de notebook-uri încă vizibile.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.