Skip to content

CSS Referenca API

Referenca CSS API pokriva pantokenov razredni sloj komponent: komponente, utilitije, globalna pravila in deklaracije zgrajene na sistemu tokenov.

Komponente

ImeRazredPovzetek
agent-shell.instui-agent-shellPovršinski vsebnik za AI agente.
alert.instui-alertVrstični prikaz z barvno vrstico statusa in zamaskiranim statusnim simbolom iz skupnega nabora ikon.
avatar.instui-avatarUporabniški avatar, ki prikazuje začetnice ali sliko, privzeto okrogel.
badge.instui-badgeMajhen števec ali statusna pika postavljena na kot cilja.
banner.instui-bannerSporazumljivo sporočilo z ikono, ki ga je mogoče zapreti, za obvestila na ravni strani ali v kontekstu.
billboard.instui-billboardVelik blok za prazno stanje ali poziv k dejanju: hero ikona ali slika, naslov in sporočilo.
breadcrumb.instui-breadcrumbSledi drobtinic z ločili; zadnja drobtinica je trenutna stran.
breadcrumb.linkliDrobtinica (InstUI Breadcrumb.Link), <li> v starševskem <ol>; zadnja je trenutna stran.
button.instui-buttonDostopljiv kontrolnik za dejanje, stiliziran iz palete tokenov; privzeto primaren.
byline.instui-bylineMedijski objekt: hero figura ob naslovu in opisu.
calendar.instui-calendarStatistična mreža mesecev s navigacijo, glave dni v tednu in celicami za dneve.
calendar.day.dayCelica dneva (InstUI Calendar.Day); -today, -selected in -outside-month označujejo njen stanje.
card.instui-cardPovršinski vsebnik, ki sprejema poljubno vsebino.
checkbox.instui-checkboxNative potrditveno polje in njegov napis, ali stikalo preko -variant-toggle.
close-button.instui-close-buttonProsojna ikona-gumb, ki nariše lastni × simbol, v treh velikostih in varianti za barvno ozadje.
context-view.instui-context-viewDvignjen izpostavljeni oblaček z zobcem, pozicioniren na katerikoli strani; deluje kot native [popover].
drawer-layout.instui-drawer-layoutRazdeljena postavitev z zložljivim stranskim predalom in primarnim drsečim vsebinskim panelom.
drawer-layout.content.contentPrimarni vsebinski panel, ki zapolni preostali prostor ob predalu.
drawer-layout.tray.trayStranski panel ob glavni vsebini, z opcijskim prekrivanjem in površinskimi modifikatorji, podobnimi predalu.
file-drop.instui-file-dropCona za odlaganje datotek z motivom ob preletu, sprejeto in zavrnjeno stanje.
form-field.instui-form-fieldOvitek polja obrazca: napis, kontrolniki in inline, required ali readonly postavitve.
form-field-group.instui-form-field-group<fieldset> skupina z legend, stolpčno ali vrstično postavitvijo in konfigurabilnimi razmiki.
form-field-messages.instui-form-field-messagesPomoč pri polju in sporočila validacije — namig, napaka, uspeh in samo-za-bralnik-zaslona — z ikonico pri napaki in uspehu.
heading.instui-headingTipografija naslovov od -level-h1 do -level-h6.
img.instui-imgStiliziran <img> z modifierji za prikaz, obrezovanje in učinke, ki se nalagajo.
in-place-edit.instui-in-place-edit[contenteditable], ki se bere kot besedilo dokler ni v fokusu, nato prikaže vhodno obrobo.
input-group.instui-input-groupFasada okoli tekstovnega vnosa z režami za vodilne in sledilne ikone.
link.instui-linkStilizirana hiperpovezava z velikostmi, inverzno varianto za temna ozadja ter vrstičnimi ali nestiliziranimi oblikami.
list.instui-listSeznam z razmiki elementov, pogojenimi s tokeni.
list.item.instui-listElement seznama (InstUI List.Item).
mask.instui-maskPrekrivna plast v toku, ki zapolni pozicioniranega starša in centrira vsebino — npr. spinner nad kartico. Za modal raje uporabite native <dialog> (njegov ::backdrop je maska). Vsak od teh modifikatorjev je na voljo tudi globalno (golo ali zveržen na katerokoli drugo komponento) — glej mask globalno utiliteto.
menu.instui-menuSpustna površina z elementi, skupinami in ločili.
menu.group.groupOznačen naslov skupine (InstUI Menu.Group/Menu.ItemGroup).
menu.item.itemVnos v meniju (InstUI Menu.Item); dodajte -disabled, -highlighted ali -active/[aria-checked].
menu.separator.separatorDelilna črta med elementi (InstUI Menu.Separator).
metric.instui-metricOznačena statistika — velika vrednost nad napisom.
modal.instui-modalPogovorno okno (deluje na native <dialog>); deleženi kot glava/telo/noga.
modal.body.bodyVsebinski predel (InstUI Modal.Body); samostojen <img> zavzame polno širino.
modal.footer.footerVrstica dejanj (InstUI Modal.Footer).
modal.header.headerVrstica naslova (InstUI Modal.Header).
number-input.instui-number-inputFasada za numerični vnos s stolpcem za +/- spinner.
pagination.instui-paginationStran za navigacijo: številčne strani, prvi, prejšnji, naslednji in zadnji puščici ter elipsa za presledke.
pagination.page.pagePovezava ali gumb strani (InstUI Pagination.Page); trenutna stran ima [aria-current].
pill.instui-pillKompakten statusni napis; dodajte vodilno ikono z deljenim -icon-<name> obrazcem.
popover.instui-popoverDvignjena površina za native [popover], pozicionirana z CSS anchor pozicioniranjem.
progress.instui-progressDoločena vrstica napredka z obarvanim merilnikom, velikostmi in opcijsko oznako vrednosti.
progress-circle.instui-progress-circleOkrogli napreden krog, pogojen s --value in --value-max CSS spremenljivkama.
radio.instui-radioNative radio gumb in njegov napis.
radio-input-group.instui-radio-input-groupEnoizbirni radio <fieldset>, navaden ali kot povezan segmentirani preklop.
range-input.instui-range-inputStiliziran drsnik (range) z inverzno mehurčkasto prikazno vrednostjo.
rating.instui-ratingOcena z zvezdicami s polnimi in praznimi ikonami ter neobvezno numerično oznako.
side-nav-bar.instui-side-nav-barNavpična navigacijska vrstica z ikonami nad oznakami, z zmanjšanim načinom, kjer so prikazane samo ikone.
side-nav-bar.item.itemNavigacijski vnos (InstUI SideNavBar.Item); -selected označi aktivnega.
simple-select.instui-simple-selectStiliziran nativen <select> s kazalcem, ki ustreza stanjem in velikostim vnosnega polja za besedilo.
spinner.instui-spinnerAnimirano naložno kolo; dodelite mu role="status" in aria-label.
table.instui-tableStilizirana podatkovna tabela za th in td plus neobvezni naslov, z razporeditvami za lebdenje, fiksno postavitev in zlagane kartice.
table.bodytbodySkupina podatkovnih vrstic tabele (InstUI Table.Body).
table.celltdPodatkovna celica (InstUI Table.Cell).
table.col-headerthGlava stolpčne celice (InstUI Table.ColHeader); privzeto oblikovanje th je pregllašeno z table.row-header za th[scope="row"].
table.headtheadSkupina vrstic z glavo tabele (InstUI Table.Head).
table.rowtrVrstica tabele (InstUI Table.Row).
table.row-headerth[scope="row"]Celica z glavo vrstice (InstUI Table.RowHeader); oblikovana iz tokenov glave vrstice, ne iz tokenov glave stolpca.
tabs.instui-tabsNabor zavihkov: seznam zavihkov, izbirni zavihki in njihove plošče.
tabs.panel.panelVsebinski panel za zavihek (InstUI Tabs.Panel).
tabs.tab.tabPosamezni gumb zavihka (InstUI Tabs.Tab, konfiguriran preko starševskega Tabs seznam zavihkov); -selected označi aktivnega.
tag.instui-tagVrstični čip za ključne besede ali filter.
text.instui-textTipografija osnovnega besedila z možnostmi velikosti, teže, barve in sloga.
text-area.instui-text-areaStiliziran, spremenljive velikosti nativni <textarea> z enakimi stanji in velikostmi kot vnosno polje za besedilo.
text-input.instui-text-inputStiliziran nativni <input> — vključno z date, time in datetime-local, kjer brskalnik zagotovi izbirnik — z validacijskimi stanji in velikostmi.
toggle-details.instui-toggle-detailsStilizirano nativno <details> razkrivalo s vrtljivim chevronom.
toggle-group.instui-toggle-groupOmejeno razkrivalo z obrobo, zgrajeno na <details>: vrstica povzetka s chevronom in zložljiva vsebina.
tooltip.instui-tooltipOrodni namig za lebdenje in fokus v CSS-u, mogoče postaviti na katerokoli stran.
tray.instui-trayPanel pripet na rob, ki drsi v iz katere koli strani; nativen [popover] ali <dialog>.
tree-browser.instui-tree-browserDrevo razkrivanja z vdelanimi zbirkami in listnimi elementi, z vrtljivimi chevroni.
view.instui-viewPrimitiv View: nevtralna škatla z modifikatorji ključ-vrednost za ozadje, obrobo, zaobljenost, senco, prikaz, položaj, prelivanje in kazalec. Vsak od teh modifikatorjev je na voljo tudi globalno (samostojno ali zaporedno na katerem koli drugem komponentu) — glej pripomočke background/border/shadow/display/position/overflow/cursor.

Pripomočki

ImeRazredPovzetek
color.--text-dangerSemantični barvni pripomočki: .--bg-<name>, .--text-<name> (z vzdevkom .--color-<name>) in .--border-<name> za kurirano semantično paleto. Vsak od teh ima tudi priponko kot modifier, pritrjeno na komponento (na primer -bg-danger na katerem koli .instui-<component>).
cursor.--cursor-pointercursor kot sestavljiva globalna razredna oznaka — .--cursor-<value> — uporabna samostojno ali zaporedno na katerikoli komponenti (.instui-button.--cursor-pointer).
gap.--gap-mdFlex/grid pripomočki gap na merskem razmiku razmika, kratka (--gap-sm) ali dolga (--gap-small) črkovna oblika. Uporabno samostojno ali zaporedno na katerikoli komponenti (.instui-view.--gap-sm) — komponente, ki že nastavijo svoj gap iz komponentno-specifičnega tokena, ga lahko preglasijo.
icon.instui-iconSistem ikon: velikosti .instui-icon in deljeni slikarski mehanizem -icon-<name>, ki maskira simbol (v currentColor) pred katerimkoli elementom.
layout.--display-flexPripomočki za prikaz in poravnavo besedila — .--display-<value> in .--text-align-<value> — kot sestavljivi globalni razredi, uporabni samostojno ali zaporedno na katerikoli komponenti.
maskglobal.--mask-overlayGlobalna, dvojna kopija prekrivnih modifikatorjev komponente mask--mask-overlay, --mask-fullscreen, --mask-blur — uporabna samostojno ali zaporedno na katerikoli komponenti, brez ovijanja v element .instui-mask.
overflow.--overflow-x-hiddenoverflow-x/overflow-y kot sestavljivi globalni razredi — .--overflow-x-<value> / .--overflow-y-<value> — uporabni samostojno ali zaporedno na katerikoli komponenti.
position.--position-relativeposition kot sestavljiva globalna razredna oznaka — .--position-<value> — uporabna samostojno ali zaporedno na katerikoli komponenti (.instui-button.--position-relative).
responsive[class*="-hidden-"],[class*="-show-"]Razredi za prikaz/skritje glede na širino vidnega polja ali vsebnika po tematski lestvici prelomnih točk.
screen-reader-content.instui-screen-reader-contentVidez skrije vsebino, hkrati pa jo ohranja dostopno pomožni tehnologiji (standardni clip vzorec).
spacing.--p-mdPripomočki za margin in padding — .--m<side>-<step> / .--margin-<side>-<step> in .--p<side>-<step> / .--padding-<side>-<step> na lestvici razmika (strani t/b/s/e/x/y ali noben, kratko ali polno zapisano — na primer --mb-sm in --margin-bottom-small sta isto pravilo; margin sprejme tudi auto). Uporabno samo ali veriženo na katerikoli komponenti (na primer class="instui-view --mb-sm").
stacking.--stack-topmostPripomočki za globino z-index — .--stack-<level> (deepest, below, above, topmost) — uporabno samo ali veriženo na katerikoli komponenti, da se sloji zložijo predvidljivo namesto z ročno nastavljenimi številkami.
transition.instui-transition.-transition-fade-enteringRazredi stanja animacije za komponento Transition.instui-transition in razredi stanja (-transition-fade-entering, -transition-scale-exited itd.) — uporabno samo ali veriženo na katerikoli komponenti.
truncate.--truncateOkrajšanje z elipsami z omejitvijo vrstic, ki jo nadzoruje --lines — uporabno samo ali veriženo na katerikoli komponenti (.instui-button.--truncate).
visual-debug.-with-visual-debugObroba za razhroščevanje postavitve: združite .-with-visual-debug na kateremkoli elementu, da obrobite škatlo in njene neposredne otroke, tako da je struktura postavitve takoj vidna.

Pravila

ImeRazredPovzetek
base*Globalni reset, ki ga izberete: box-sizing, površina strani, osnovna barva besedila in pisava, color-scheme ter privzete nastavitve povezav.
prose:where(body)Tipografske privzetosti za surovi HTML — naslovi, odstavki, seznami, povezave in koda — se samodejno uporabijo kjerkoli je uvožen (privzeto :where(body)); posredujte options.scope za ciljanje druge vsebinske korenine (npr. .vp-doc).

Plugins

ImeRazredPovzetek
logos.logosLogotipi izdelkov Instructure kot CSS image tokeni: --instui-logo-<product>-<layout>-<mode> vsebuje SVG kot data-URI, zato se logotip upodobi npr. z background-image: var(--instui-logo-canvas-horizontal-color).
primitives.instui-bg-primitive-color-whiteIzbirni pripomočki za surovo primitivno paleto: .instui-bg-/fg-/border-primitive-color-<name> obarvajo z barvo iz primitivnih barvnih tokenov, plus pripomočki font-family/font-weight za primitivne pisavne tokene. Izločeni iz semantičnih pripomočkov, da tam ostanejo le semantične zamenjave.
visual-debug.-with-visual-debugObroba za razhroščevanje postavitve: združite .-with-visual-debug na kateremkoli elementu, da obrobite škatlo in njene neposredne otroke, tako da je struktura postavitve takoj vidna.

layout

ImeRazredPovzetek
calloutdiv[class~="instui-callout"]Vrstični informativni opozorilnik za kratek opomnik ali beležko.
herodiv[class~="instui-hero"]Celostranski glavni odsek s naslovom, podnaslovom in izbirno ozadno sliko.
page-layoutdiv[class~="instui-page-layout"]Standardna tridelnika postavitev strani z glavo, stransko vrstico in glavnim vsebinskim poljem.
rubric-notediv[class~="instui-rubric-note"]Strukturirana opomba z rubricami in indikatorji točkovanja.
testimonialdiv[class~="instui-testimonial"]Prikaz citata ali izjave s podatki o avtorju in neobvezno sliko.
two-columndiv[class~="instui-two-column"]Dvodelnica postavitev z levim in desnim vsebinskim območjem.
wrapperbody[class~="instui-display-flex"]Vrstica aplikacijskega ogrodja: stranski meni, vsebnik z glavo in izbirni panel.