Prezentare generală
UtilizațiChip pentru referințe compacte la persoane, înregistrări sau fișiere. Utilizați Etichetă pentru categorii colorate și Stare pentru stările fluxului de lucru.
Utilizare
startElement și endElement acceptă avatare, pictograme sau alt conținut. endElementDivider adaugă un separator înaintea conținutului de la final. Chipul implicit este un div; sloturile sale pot conține o acțiune separată, în timp ce chipul însuși rămâne prezentational.
Chip nu inserează niciodată o etichetă. Furnizați, când este necesar, o alternativă tradusă din aplicația dvs. Omiteți elementele copil pentru conținut alcătuit în întregime din sloturi. Un chip interactiv doar cu o pictogramă are nevoie de un nume accesibil furnizat de apelant.
Aspect
size acceptă sm sau md, cu înălțimi totale de 20px și 24px. variant acceptă ghost, soft, solid, plain sau outline; ghost este valoarea implicită. Chipurile simple nu au umplere în starea de repaus sau padding la început. Jetoanele cu contur au o bordură pronunțată de 1px, un fundal mai deschis în starea de repaus și o umplere interioară inline de 8px pe fiecare parte, cu aceeași înălțime totală ca celelalte variante. Jetoanele plain și outline pe care se poate face clic folosesc fundalurile ghost la trecere și apăsare, cursorul indicator și conturul de focalizare. Utilizați shape="round" pentru o pastilă, weight="medium" pentru accentuare și color="secondary" pentru text secundar.
Butoane și linkuri
onClick păstrează elementul div implicit. Utilizați render pentru a compune un buton nativ explicit, o ancoră, un link de router sau un alt element proprietar adecvat. Atributele native, handler-ele, stilurile și referința rădăcină ajung la acel element proprietar. Un buton nativ oferă activare de la tastatură și comportament dezactivat. Chip recunoaște starea nativă dezactivată și aria-disabled pentru aspect; aria-disabled singur nu împiedică activarea.
clickable controlează aspectul la survolare și al indicatorului și, implicit, depinde de furnizarea lui onClick. Setați-l explicit pentru un link fără handler de clic. Nu imbricați butoane sau linkuri într-un chip care este el însuși interactiv.
Trunchiere și indicii informative
maxWidth limitează lățimea chipului redat în pixeli, inclusiv spațierea interioară și orice bordură de contur. Aceeași limită se aplică cipului simplu cu spațiere interioară asimetrică. Conținutul este trunchiat implicit cu puncte de suspensie; truncate={false} îl lasă neconstrâns de trunchiere. Elementele copil de tip șir furnizează propriul text pentru indiciul informativ. Setați tooltipContent pentru text personalizat sau conținut de tip nod, tooltipDelay pentru întârzierea la deschidere și isTooltipMultiline pentru a păstra întreruperile de linie. alwaysShowTooltip activează, de asemenea, indiciul informativ atunci când conținutul încape. Aceste opțiuni urmează OverflowingTextWithTooltip. Păstrați informațiile esențiale disponibile fără a vă baza pe trecerea cursorului.
Migrare
ÎnlocuițiemptyLabel cu elemente copil de rezervă furnizate de apelant și înlocuiți forceEmptyText sau isLabelHidden cu elemente copil omise. Păstrați în aplicație alternativele traduse ale produsului. Înlocuiți tooltipLabel cu tooltipContent. Mutați disabled la elementul interactiv explicit și eliminați nativeButton. Adăugați un buton nativ sau un link prin render oriunde chipul se baza anterior pe onClick pentru a-și alege elementul.
Înlocuiți suprascrierile spațierii interioare din partea inițială cu variant="plain". Mențineți clickable activat pentru linkurile și butoanele native care necesită feedback la trecerea cursorului și la apăsare.
Proprietăți
Tipurile și valorile implicite sunt generate din tipurile publice ale componentei. Sunt acceptate și atributele native, precum și gestionarele de evenimente.boolean
implicit:"false"
Shows the content tooltip even when the content is not truncated.
ReactNode
Caller-owned content. Missing or empty children add no fallback label.
boolean
implicit:"isDefined(onClick)"
Enables hover and pointer styling. Defaults to whether
onClick is supplied; does not change the default div or add keyboard behavior."primary" | "secondary"
implicit:"primary"
Primary or secondary text color.
ReactNode
Content after the label. Avoid interactive content when the chip itself is a button or link.
boolean
implicit:"false"
Adds a divider before
endElement when that slot has content.boolean
Preserves line breaks in the tooltip text.
number
Maximum rendered chip width in pixels, including its leading and trailing padding and any outline border.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Replaces the default div. Compose a native button or link explicitly; that owner supplies disabled and native interaction behavior.
"round" | "square"
implicit:"square"
Square or round corners.
"md" | "sm"
implicit:"sm"
Visual size of the chip.
ReactNode
Content before the label, such as an avatar or icon.
string
Tooltip text. Defaults to string children. Supply text explicitly for node content.
number
Delay in milliseconds before the tooltip opens.
"bottom" | "inline-end" | "inline-start" | "left" | "right" | "top"
Position of the content tooltip.
boolean
implicit:"true"
Truncates overflowing content with an ellipsis. Defaults to true.
"ghost" | "outline" | "plain" | "soft" | "solid"
implicit:"ghost"
Background and border treatment. Outline has a strong border, lighter resting fill and 8px inline padding. Plain has no resting fill or leading padding. Both use ghost hover and pressed feedback when clickable.
"medium" | "regular"
implicit:"regular"
Font weight of the content.