Vodič za programere kroz ONLYOFFICE stil i boje API

Razvijanje ONLYOFFICE dodataka često znači unapređivanje načina na koji korisnici rade sa dokumentima, bilo dodavanjem markera, alata za čišćenje formata ili tematskih elemenata korisničkog interfejsa.

Da biste radili efikasnije, sastavili smo ključne API metode za stil i boje koje omogućavaju programerima jednostavno upravljanje izgledom i doživljajem svojih dodataka.

Ovaj blog post nudi jasna objašnjenja, praktične primere i savete za što lakše iskustvo razvoja.

Razumevanje konteksta stilizovanja

ONLYOFFICE plugin API-ji pružaju fleksibilne načine za prilagođavanje izgleda dokumenata pomoću objekata kao što su ApiRange, ApiParagraph, i ApiTextPr.

Ovi interfejsi omogućavaju programerima da menjaju atribute fonta, poravnanje paragrafa, boje i druge vizuelne osobine direktno iz skripti dodataka.

Jednostavan primer primene stilova na tekst:

const oDocument = Api.GetDocument();

const oRange = oDocument.GetRangeBySelect();

const oTextPr = oRange.GetTextPr();

oTextPr.Bold(true);

oTextPr.Italic(true);

oTextPr.SetColor(255, 0, 0); // RGB red

Ovaj isečak pokazuje kako se više stilova može kombinovati kako bi se postiglo dinamično formatiranje.

Najčešće korišćene metode za stil i boje

Prilikom razvoja ONLYOFFICE dodataka koji rade sa stilizovanjem dokumenata poput markera, alata za čišćenje formata ili tematskih elemenata interfejsa, programerima su potrebne jasne i spremne metode za rukovanje bojama, fontovima i atributima teksta.

Da bismo olakšali ovaj proces, prikupili smo najpraktičnije API-je za stil i boje, uz savete i primere za jednostavnu integraciju.

Primjer	Opisa	Metode
SetColor(r, g, b)	Postavlja boju teksta koristeći RGB vrednosti.	oTextPr.SetColor(0, 102, 204)
SetHighlight(sColor)	Primjenjuje marker ili pozadinsku boju na tekst.	oRange.SetHighlight("lightGray")
SetBackgroundColor(r, g, b)	Postavlja pozadinsku boju paragrafa.	oParagraph.SetBackColor(230, 230, 230)
SetBold(true/false)	Uključuje ili isključuje podebljan tekst.	oTextPr.SetBold(true)
SetItalic(true/false)	Uključuje ili isključuje kurziv.	oTextPr.SetItalic(true)
SetUnderline(true/false)	Dodaje ili uklanja podvlačenje.	oTextPr.SetUnderline(true)
SetFontSize(nSize)	Menja veličinu fonta u tačkama.	oTextPr.SetFontSize(14)
SetFontName(name)	Postavlja porodicu fonta.	oTextPr.SetFontName("Calibri")
ApiCell	Predstavlja ćeliju u tabeli za stilizovanje.	const cell = sheet.GetRange("A1");
SetCellColor(r, g, b)	Postavlja pozadinsku boju ćelije u tabeli.	cell.SetCellColor(255, 230, 191)

Za stilizovanje paragrafa mogu se koristiti analogne metode putem interfejsa ApiParagraph:

const oParagraph = oRange.GetParagraph(0);

oParagraph.SetBackColor(230, 230, 230); // Light gray background

oParagraph.SetAlign("center");

Ove metode čine osnovu formatiranja teksta i paragrafa u ONLYOFFICE dodacima. Ćelije u tabelama koriste slične API-je, poput ApiCell i SetCellColor, prateći istu logiku stilizovanja.

Rad sa objektima boja

ONLYOFFICE koristi RGB definicije boja za svoje metode stilizovanja. Ako vaš projekat koristi HEX kodove boja (često u dizajn sistemima ili brend temama), lako ih možete konvertovati pomoću male pomoćne funkcije:

function hexToRGB(hex) {

const bigint = parseInt(hex.replace("#", ""), 16);

const r = (bigint >> 16) & 255;

const g = (bigint >> 8) & 255;

const b = bigint & 255;

return [r, g, b];

}

// Example use:

const [r, g, b] = hexToRGB("#3498db");

oTextPr.SetColor(r, g, b);
This allows seamless integration between design resources and plugin functionality.

Saveti i trikovi za pouzdano stilizovanje

• Ponovo selektujte opseg dokumenta pre primene promena radi tačnosti nakon UI akcija.
• Koristite odvojene pozive funkcija za svaku operaciju stilizovanja umesto predugog ulančavanja metoda.
• Uvek proverite validnost objekta (npr. da li GetRangeBySelect() vraća važeći objekat).
• Podržite tamne i svetle teme dinamičkim prilagođavanjem vrednosti boja pomoću Asc.plugin.getTheme().

Ove male prilagodbe pomažu u stvaranju stabilnijeg i vizuelno konzistentnog ponašanja plugin-a.

Zaključak

API-ji za stilizovanje u ONLYOFFICE-u zadržavaju dosledan pristup u svim editorima, bilo da radite sa dokumentima, prezentacijama ili tabelama.

Korišćenjem istih koncepata (primena boja, podešavanje fonta, poravnanje paragrafa), programeri mogu prilagoditi svoj kod različitim editorima, a pritom zadržati jedinstvenu logiku stilizovanja.

Okupljanjem svih ovih informacija na jednom mestu, želimo da razvoj dodataka učinimo bržim, jednostavnijim i intuitivnijim za sve koji grade uz ONLYOFFICE.

Ako imate pitanja ili predloge, slobodno nas kontaktirajte.  Zajedno možemo nastaviti da unapređujemo ONLYOFFICE dokumentaciju.