Skip to content

CSS API referencia

A CSS API-referencia a pantoken osztályalapú komponensrétegét tartalmazza: komponenseket, segédprogramokat, globális szabályokat és a tokenrendszeren alapuló deklarációkat.

Komponensek

NévOsztályÖsszegzés
agent-shell.instui-agent-shellFelületkonténer AI ágensek számára.
alert.instui-alertEgy beágyazott üzenet állapot-szín sávval és a megosztott ikon készletből származó maszkmódú állapot-jelzéssel.
avatar.instui-avatarEgy felhasználói avatar, amely a kezdőbetűket vagy egy képet mutat, alapértelmezés szerint kerek.
badge.instui-badgeEgy kis számlálás vagy állapotpont, amely egy cél sarka fölött helyezkedik el.
banner.instui-bannerEgy bezárható, ikonnal ellátott üzenetfelület oldalszintű vagy kontextusfüggő bejelentésekhez.
billboard.instui-billboardEgy nagy üres állapot vagy cselekvésre ösztönző blokk: egy hős ikon vagy kép, egy cím és egy üzenet.
breadcrumb.instui-breadcrumbEgy elválasztókkal ellátott morzsasor; az utolsó morzsa az aktuális oldal.
breadcrumb.linkliEgy morzsa (InstUI Breadcrumb.Link), egy <li> a szülő <ol> elemében; az utolsó az aktuális oldal.
button.instui-buttonEgy elérhető műveleti vezérlő, a token paletta alapján stílusosan; alapértelmezés szerint elsődleges.
byline.instui-bylineEgy média objektum: egy hős ábra egy cím és leírás mellett.
calendar.instui-calendarEgy statikus havi rács navigációval, hétköznapi fejlécekkel és napcellákkal.
calendar.day.dayEgy napcella (InstUI Calendar.Day); a(z) -today, -selected és -outside-month jelöli az állapotát.
card.instui-cardEgy felületkonténer, amely tetszőleges tartalmat fogad el.
checkbox.instui-checkboxEgy natív jelölőnégyzet és annak címkéje, vagy egy kapcsoló a -variant-toggle segítségével.
close-button.instui-close-buttonEgy átlátszó ikon gomb, amely a saját × szimbólumot rajzolja meg, három méretben plusz egy inverz változatban.
context-view.instui-context-viewEgy emelt szintű figyelemfelhívás egy karóval, pozicionálható bármelyik oldalon; natív [popover]-ként működik.
drawer-layout.instui-drawer-layoutOsztott elrendezés összecsukható oldalsó tálcával és egy elsődleges, görgethető tartalmi panellel.
drawer-layout.content.contentAz elsődleges tartalmi panel, amely kitölti a tálca melletti fennmaradó helyet.
drawer-layout.tray.trayA fő tartalom melletti oldalsó panel, opcionális overlay és tálcaszerű felületmódosítókkal.
file-drop.instui-file-dropEgy fájl leejtési zóna lebegési, elfogadott és elutasított állapotokkal.
form-field.instui-form-fieldEgy form-mező burkoló: egy címke, annak vezérlői, valamint beágyazott, kötelező vagy csak olvasható elrendezések.
form-field-group.instui-form-field-groupEgy <fieldset> csoport egy jelmagyarázattal, oszlop vagy beágyazott elrendezéssel és konfigurálható térközzel.
form-field-messages.instui-form-field-messagesMező súgó és validációs üzenetek — célzás, hiba, siker és csak képernyőolvasóhoz — szimbólummal hibakor és sikerkor.
heading.instui-headingCím tipográfia -level-h1-tól -level-h6-ig.
img.instui-imgEgy stílozott <img> megjelenítési, vágási és effekt módosítókkal, amelyek egymásra rakhatók.
in-place-edit.instui-in-place-editEgy [contenteditable], amely szövegként jelenik meg, amíg fókuszban nem van, majd bemenet chrome-t mutat.
input-group.instui-input-groupEgy homlokzat egy szövegbemenet körül vezető és záró ikon nyílásokkal.
link.instui-linkEgy stílozott hiperhivatkozás méretekkel, egy inverz változat sötét hátterekhez, valamint beágyazott vagy stílus nélküli formák.
list.instui-listEgy lista token-vezérelt elemtérközzel.
list.item.instui-listEgy listaelem (InstUI List.Item).
mask.instui-maskEgy folyamatba illeszkedő (in-flow) átfedés, amely kitölti pozicionált szülőjét és középre igazítja annak tartalmát — pl. egy spinner egy kártya felett. Modális ablak esetén érdemesebb natív <dialog> elemet használni (ennek ::backdrop eleme a maszk). E módosítók mindegyike globálisan is elérhető (önmagában vagy bármely más komponenshez láncolva) — lásd a(z) mask globális segédprogramot.
menu.instui-menuEgy legördülő felület elemek, csoportok és elválasztók közül.
menu.group.groupEgy címkézett csoportfejléc (InstUI Menu.Group/Menu.ItemGroup).
menu.item.itemEgy menübejegyzés (InstUI Menu.Item); adja hozzá a -disabled, -highlighted vagy -active/[aria-checked] értéket.
menu.separator.separatorEgy elválasztó vonal az elemek között (InstUI Menu.Separator).
metric.instui-metricEgy címkézett statisztika — egy nagy érték egy felirat felett.
modal.instui-modalEgy párbeszéd felület (natív <dialog> működik); fejléc/törzs/lábléc részek.
modal.body.bodyA tartalomterület (InstUI Modal.Body); egy különálló &lt;img&gt; teljes szélességűvé válik.
modal.footer.footerA műveletek sora (InstUI Modal.Footer).
modal.header.headerA címsor (InstUI Modal.Header).
number-input.instui-number-inputEgy számbemenet homlokzat egy +/- pörgető oszloppal.
pagination.instui-paginationOldalnavigáció: számozott oldalak, első, előző, következő és utolsó nyilak, valamint ellipszis a hézagokhoz.
pagination.page.pageEgy oldalhivatkozás vagy gomb (InstUI Pagination.Page); az aktuális oldal a(z) [aria-current] értéket hordozza.
pill.instui-pillEgy kompakt állapotcímke; adjon hozzá egy vezető szimbólumot a megosztott -icon-&lt;name&gt; formával.
popover.instui-popoverEgy emelt felület egy natív [popover] számára, CSS horgonyozással pozicionálva.
progress.instui-progressEgy meghatározott haladássáv színezett mérővel, méretekkel és egy opcionális értékcímkével.
progress-circle.instui-progress-circleA(z) --value és --value-max egyéni tulajdonságok által vezérelt körkörös folyamatjelző gyűrű.
radio.instui-radioEgy natív rádiógomb és annak címkéje.
radio-input-group.instui-radio-input-groupEgy egyetlen kiválasztású rádió &lt;fieldset&gt;, egyszerű vagy csatlakoztatott szegmentált kapcsolóként.
range-input.instui-range-inputEgy stílozott tartománycúszka inverz érték buborékkal.
rating.instui-ratingEgy csillagértékelés töltött és üres szimbólumokkal és egy opcionális numerikus címkével.
side-nav-bar.instui-side-nav-barEgy függőleges navigációs sín ikon-feletti-címke elemekből, csak ikon módtal lecsökkentve.
side-nav-bar.item.itemEgy navigációs bejegyzés (InstUI SideNavBar.Item); a(z) -selected jelöli az aktív elemet.
simple-select.instui-simple-selectEgy stílozott natív &lt;select&gt; karóval, amely a szövegbemenet állapotainak és méretének felel meg.
spinner.instui-spinnerEgy animált betöltési gyűrű; adjon neki role="status" és aria-label attribútumot.
table.instui-tableEgy stílozott adattábla th és td számára, valamint egy opcionális felirattal, lebegési, rögzített és halmazott-kártya elrendezésekkel.
table.bodytbodyA táblázat adatsor-csoportja (InstUI Table.Body).
table.celltdEgy adatcella (InstUI Table.Cell).
table.col-headerthEgy oszlopfejléc-cella (InstUI Table.ColHeader); az alapértelmezett th stílusozás, amelyet felülbírál a(z) table.row-header a(z) th[scope="row"] esetén.
table.headtheadA táblázat fejlécsor-csoportja (InstUI Table.Head).
table.rowtrEgy táblázatsor (InstUI Table.Row).
table.row-headerth[scope="row"]Egy sorfejléc-cella (InstUI Table.RowHeader); a sorfejléc tokenjei alapján formázva, nem az oszlopfejlécéi alapján.
tabs.instui-tabsEgy fülezett panel készlet: egy füllista, kiválasztható fülek és azok panelja.
tabs.panel.panelEgy fül tartalompanelje (InstUI Tabs.Panel).
tabs.tab.tabEgyetlen fülgomb (InstUI Tabs.Tab, amely a szülő Tabs füllistáján keresztül konfigurálható); a(z) -selected jelöli az aktívat.
tag.instui-tagEgy beágyazott chip kulcsszóhoz vagy szűrőhöz.
text.instui-textTörzs szöveg tipográfia mérettel, súllyal, színnel és stílus módosítókkal.
text-area.instui-text-areaEgy stílozott, átméretezhető natív &lt;textarea&gt; a szövegbemenet azonos állapotaival és méretével.
text-input.instui-text-inputEgy stílozott natív &lt;input&gt; — beleértve a date, time és datetime-local értékeket, ahol a böngésző az előválasztót biztosítja — validációs állapotokkal és méretekkel.
toggle-details.instui-toggle-detailsEgy stílozott natív &lt;details&gt; nyilvánosságra hozatal forgó chevron-nal.
toggle-group.instui-toggle-groupEgy szegélyzett nyilvánosságra hozatal &lt;details&gt; alapján: egy chevron összefoglaló sor és összecsukható tartalom.
tooltip.instui-tooltipEgy CSS lebegési és fókusz alátét buborék, pozicionálható bármelyik oldalon.
tray.instui-trayEgy szélhez rögzített panel, amely bármelyik oldalról csúszik be; natív [popover] vagy &lt;dialog&gt;.
tree-browser.instui-tree-browserEgy nyilvánosságra hozatal fa beágyazott gyűjteményekből és levél elemekből, forgó chevronokkal.
view.instui-viewA View primitív: egy semleges doboz kulcs-érték módosítókkal a háttér, szegély, lekerekítés, árnyék, megjelenítés, pozíció, túlcsordulás és kurzor beállításához. Ezen módosítók mindegyike globálisan is elérhető (önállóan vagy bármely más komponenshez láncolva) — lásd a(z) background/border/shadow/display/position/overflow/cursor segédosztályokat.

Segédosztályok

NévOsztályÖsszegzés
color.--text-dangerSzemantikus szín segédprogramok: .--bg-&lt;name&gt;, .--text-&lt;name&gt; (álneve: .--color-&lt;name&gt;), és .--border-&lt;name&gt; a válogatott szemantikus palettához. Ezek mindegyike rendelkezik komponenshez csatolt álnévmódosítóval is (például -bg-danger bármely .instui-&lt;component&gt; esetén).
cursor.--cursor-pointercursor mint kombinálható, globális osztály — .--cursor-&lt;value&gt; — önállóan vagy bármely komponenshez láncolva használható (.instui-button.--cursor-pointer).
gap.--gap-mdFlex/grid gap segédosztályok a térközskálán, rövid (--gap-sm) vagy hosszú (--gap-small) írásmóddal. Használható önmagában vagy bármely komponenshez láncolva (.instui-view.--gap-sm) — a saját gap értéküket komponensspecifikus tokenből beállító komponensek felülbírálhatók.
icon.instui-iconAz ikon rendszer: .instui-icon méretezés plusz a megosztott -icon-&lt;name&gt; festő, amely egy glifa maszkot (in currentColor) helyez bármely elem előtt.
layout.--display-flexDisplay és text-align segédosztályok — .--display-&lt;value&gt; és .--text-align-&lt;value&gt; — kombinálható, globális osztályokként, önállóan vagy bármely komponenshez láncolva használhatók.
maskglobal.--mask-overlayA(z) mask komponens overlay módosítóinak egy globális, kettős másolata — --mask-overlay, --mask-fullscreen, --mask-blur — önállóan vagy bármely komponenshez láncolva használható, anélkül, hogy .instui-mask elembe kellene csomagolni.
overflow.--overflow-x-hiddenoverflow-x/overflow-y mint kombinálható, globális osztályok — .--overflow-x-&lt;value&gt; / .--overflow-y-&lt;value&gt; — önállóan vagy bármely komponenshez láncolva használhatók.
position.--position-relativeposition mint kombinálható, globális osztály — .--position-&lt;value&gt; — önállóan vagy bármely komponenshez láncolva használható (.instui-button.--position-relative).
responsive[class*="-hidden-"],[class*="-show-"]Nézőpont- vagy konténerszélesség alapú megjelenítő/elrejtő osztályok egy témázott töréspont-skála mentén.
screen-reader-content.instui-screen-reader-contentVizuálisan elrejti a tartalmat, miközben hozzáférhetővé teszi a segítségnyújtó technológia számára (a standard clip minta).
spacing.--p-mdMargin és padding segédosztályok — .--m&lt;side&gt;-&lt;step&gt; / .--margin-&lt;side&gt;-&lt;step&gt; és .--p&lt;side&gt;-&lt;step&gt; / .--padding-&lt;side&gt;-&lt;step&gt; a térközskálán (oldalak: t/b/s/e/x/y vagy egyik sem, rövid vagy teljesen kiírt hosszú alakban — például a(z) --mb-sm és a(z) --margin-bottom-small ugyanaz a szabály; a margin a(z) auto értéket is elfogadja). Önállóan vagy bármely komponenshez láncolva használható (például class="instui-view --mb-sm").
stacking.--stack-topmostz-index mélységi segédosztályok — .--stack-&lt;level&gt; (deepest, below, above, topmost) — önállóan vagy bármely komponenshez láncolva használhatók, így a rétegek kiszámíthatóan illeszkednek egymásra a kézzel beállított értékek helyett.
transition.instui-transition.-transition-fade-enteringAnimációs állapot-osztályok a(z) Transition komponenshez — .instui-transition és állapot-osztályok (-transition-fade-entering, -transition-scale-exited stb.) —, amelyek önállóan vagy bármely komponenshez láncolva használhatók.
truncate.--truncateHárompontos szövegcsonkítás (ellipsis) a(z) --lines által vezérelt sorszám-korlátozással — önállóan vagy bármely komponenshez láncolva használható (.instui-button.--truncate).
visual-debug.-with-visual-debugElrendezés-hibakeresési körvonal: összetett .-with-visual-debug bármely elemhez a doboz és azonnali gyermekeinek körvonalához, így az elrendezés szerkezete azonnal látható.

Szabályok

NévOsztályÖsszegzés
base*Az opt-in globális visszaállítás: box-sizing, az oldal felülete, alapszöveg szín és betűtípus, color-scheme, és hivatkozás alapértelmezések.
prose:where(body)Tipográfiai alapértelmezések nyers HTML-hez — címsorok, bekezdések, listák, hivatkozások és kódok —, amelyek automatikusan érvényesülnek minden importálás helyén (alapértelmezett: :where(body)); adjon meg options.scope értéket egy másik tartalomgyökér megcélzásához (pl. .vp-doc).

Plugins

NévOsztályÖsszegzés
logos.logosInstructure termék logók CSS kép tokenekként: --instui-logo-&lt;product&gt;-&lt;layout&gt;-&lt;mode&gt; egy data-URI SVG-t tartalmaz, így egy logó festődik például background-image: var(--instui-logo-canvas-horizontal-color) -on keresztül.
primitives.instui-bg-primitive-color-whiteÖnkéntes segédprogram osztályok a nyers primitív palettához: .instui-bg-/fg-/border-primitive-color-&lt;name&gt; festék egy szín a primitív szín tokenekből, valamint font-family/font-weight segédprogramok a primitív betűtípus tokenekhez. Kihagyva a szemantikus segédprogramokból, így az felülbírálatok ott maradnak csak szemantikus.
visual-debug.-with-visual-debugElrendezés-hibakeresési körvonal: összetett .-with-visual-debug bármely elemhez a doboz és azonnali gyermekeinek körvonalához, így az elrendezés szerkezete azonnal látható.

layout

NévOsztályÖsszegzés
wrapperbody[class~="instui-display-flex"]Alkalmazáshéj sora: oldalnavigáció, konténer fejléccel és opcionális panel.