[{"data":1,"prerenderedAt":1898},["ShallowReactive",2],{"docs-navigation":3,"docs:\u002Fdocs\u002Fgetting-started\u002Ftheming":644,"dependencies:\u002Fdocs\u002Fgetting-started\u002Ftheming":1897},[4],{"title":5,"path":6,"stem":7,"children":8,"page":65},"Docs","\u002Fdocs","docs",[9,66,604,628],{"title":10,"component":11,"category":11,"description":11,"path":12,"stem":13,"children":14,"page":65},"Getting Started",null,"\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[15,20,25,30,35,40,45,50,55,60],{"title":16,"path":17,"stem":18,"component":11,"category":11,"description":19},"Quick start","\u002Fdocs\u002Fgetting-started\u002Fquick-start","docs\u002F1.getting-started\u002F01.quick-start","It's dangerous to go alone! Take this. Install the kit, add your first component and set up what your app needs once.",{"title":21,"path":22,"stem":23,"component":11,"category":11,"description":24},"Installation","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002F1.getting-started\u002F02.installation","It works on my machine. Now on yours too. Set up a project, add components and keep them up to date.",{"title":26,"path":27,"stem":28,"component":11,"category":11,"description":29},"Theming","\u002Fdocs\u002Fgetting-started\u002Ftheming","docs\u002F1.getting-started\u002F03.theming","Any colour you like, as long as it's yours. Change the brand colour, add your own tones and switch to dark mode.",{"title":31,"path":32,"stem":33,"component":11,"category":11,"description":34},"Typography","\u002Fdocs\u002Fgetting-started\u002Ftypography","docs\u002F1.getting-started\u002F04.typography","Comic Sans not included. Size text by what it does, and change a whole role in one place.",{"title":36,"path":37,"stem":38,"component":11,"category":11,"description":39},"Motion","\u002Fdocs\u002Fgetting-started\u002Fmotion","docs\u002F1.getting-started\u002F05.motion","Move fast and break nothing. Pick the easing curve and duration that fit what's moving.",{"title":41,"path":42,"stem":43,"component":11,"category":11,"description":44},"Overlays","\u002Fdocs\u002Fgetting-started\u002Foverlays","docs\u002F1.getting-started\u002F06.overlays","One does not simply click outside a menu. Set up overlays once, and see why the first outside click only closes them.",{"title":46,"path":47,"stem":48,"component":11,"category":11,"description":49},"Icons","\u002Fdocs\u002Fgetting-started\u002Ficons","docs\u002F1.getting-started\u002F07.icons","A picture is worth a thousand words. An icon, about one. Use Lucide or any other set, sized and coloured by the component it sits in.",{"title":51,"path":52,"stem":53,"component":11,"category":11,"description":54},"Sizing","\u002Fdocs\u002Fgetting-started\u002Fsizing","docs\u002F1.getting-started\u002F08.sizing","One size fits all. Well, five. Every size prop runs on one scale that you can retune in one place.",{"title":56,"path":57,"stem":58,"component":11,"category":11,"description":59},"Radius","\u002Fdocs\u002Fgetting-started\u002Fradius","docs\u002F1.getting-started\u002F09.radius","Three roles, one base, and two rules that keep nested corners concentric at any radius.",{"title":61,"path":62,"stem":63,"component":11,"category":11,"description":64},"Accessibility","\u002Fdocs\u002Fgetting-started\u002Faccessibility","docs\u002F1.getting-started\u002F10.accessibility","Fat fingers welcome. Keep small controls easy to tap without making them look any bigger.",false,{"title":67,"component":11,"category":11,"description":11,"path":68,"stem":69,"children":70,"page":65},"Components","\u002Fdocs\u002Fcomponents","docs\u002F2.components",[71,77,83,89,95,101,107,113,119,125,131,137,143,149,155,161,167,173,179,185,191,197,203,209,215,221,227,233,239,245,251,257,263,269,275,281,287,293,299,305,311,317,323,329,335,341,347,353,359,365,371,377,383,389,395,401,407,413,419,425,431,437,443,449,455,461,467,473,479,485,491,497,503,509,515,521,527,533,539,545,551,557,563,569,575,581,587,593,598],{"title":72,"path":73,"stem":74,"component":75,"category":11,"description":76},"Button","\u002Fdocs\u002Fcomponents\u002Fbutton","docs\u002F2.components\u002F01.button","button","Yes, it's a button. You click it, it does things. We're as surprised as you are.",{"title":78,"path":79,"stem":80,"component":81,"category":11,"description":82},"Button Group","\u002Fdocs\u002Fcomponents\u002Fbutton-group","docs\u002F2.components\u002F02.button-group","button-group","Buttons that decided to move in together.",{"title":84,"path":85,"stem":86,"component":87,"category":11,"description":88},"Toggle","\u002Fdocs\u002Fcomponents\u002Ftoggle","docs\u002F2.components\u002F03.toggle","toggle","A two-state button with Button's variants, colours and sizes, and its own look when on.",{"title":90,"path":91,"stem":92,"component":93,"category":11,"description":94},"Toggle Group","\u002Fdocs\u002Fcomponents\u002Ftoggle-group","docs\u002F2.components\u002F04.toggle-group","toggle-group","Like a button group, but they remember what you picked",{"title":96,"path":97,"stem":98,"component":99,"category":11,"description":100},"Toolbar","\u002Fdocs\u002Fcomponents\u002Ftoolbar","docs\u002F2.components\u002F05.toolbar","toolbar","Your app's utility belt. A row or column of buttons, toggles, links and separators. One Tab gets you in, arrow keys do the rest.",{"title":102,"path":103,"stem":104,"component":105,"category":11,"description":106},"Input","\u002Fdocs\u002Fcomponents\u002Finput","docs\u002F2.components\u002F06.input","input","You type, it holds. That's the whole deal.",{"title":108,"path":109,"stem":110,"component":111,"category":11,"description":112},"Input Floating","\u002Fdocs\u002Fcomponents\u002Finput-floating","docs\u002F2.components\u002F07.input-floating","input-floating","The label moves out of the way so you can type. Polite. A text input with a label that floats inside it, in all of Input's variants and sizes.",{"title":114,"path":115,"stem":116,"component":117,"category":11,"description":118},"Input Group","\u002Fdocs\u002Fcomponents\u002Finput-group","docs\u002F2.components\u002F08.input-group","input-group","An input that brought friends. An input or textarea framed together with icons, text and buttons, in all of Input's variants and sizes.",{"title":120,"path":121,"stem":122,"component":123,"category":11,"description":124},"Input Number","\u002Fdocs\u002Fcomponents\u002Finput-number","docs\u002F2.components\u002F09.input-number","input-number","For when typing \"5\" is just too much effort. A number field with stepper buttons inside the frame.",{"title":126,"path":127,"stem":128,"component":129,"category":11,"description":130},"Input Time","\u002Fdocs\u002Fcomponents\u002Finput-time","docs\u002F2.components\u002F10.input-time","input-time","Time is money. This one's free.",{"title":132,"path":133,"stem":134,"component":135,"category":11,"description":136},"Input Date","\u002Fdocs\u002Fcomponents\u002Finput-date","docs\u002F2.components\u002F11.input-date","input-date","For birthdays, deadlines and other dates you'd rather not think about.",{"title":138,"path":139,"stem":140,"component":141,"category":11,"description":142},"Pin Input","\u002Fdocs\u002Fcomponents\u002Fpin-input","docs\u002F2.components\u002F12.pin-input","pin-input","Check your SMS. We'll wait. One box per character, for one-time codes and PINs.",{"title":144,"path":145,"stem":146,"component":147,"category":11,"description":148},"Textarea","\u002Fdocs\u002Fcomponents\u002Ftextarea","docs\u002F2.components\u002F13.textarea","textarea","Input, but it has more to say.",{"title":150,"path":151,"stem":152,"component":153,"category":11,"description":154},"Tags Input","\u002Fdocs\u002Fcomponents\u002Ftags-input","docs\u002F2.components\u002F14.tags-input","tags-input","Words that got promoted to badges. Type a tag, press Enter, and it turns into a badge. All in one text field.",{"title":156,"path":157,"stem":158,"component":159,"category":11,"description":160},"Editable","\u002Fdocs\u002Fcomponents\u002Feditable","docs\u002F2.components\u002F15.editable","editable","Text that turns into a field when you click it, and back into text when you are done. It keeps the type of wherever you put it.",{"title":162,"path":163,"stem":164,"component":165,"category":11,"description":166},"Checkbox","\u002Fdocs\u002Fcomponents\u002Fcheckbox","docs\u002F2.components\u002F16.checkbox","checkbox","You have a choice. Three, actually. A checkbox with checked, unchecked and indeterminate states.",{"title":168,"path":169,"stem":170,"component":171,"category":11,"description":172},"Radio Group","\u002Fdocs\u002Fcomponents\u002Fradio-group","docs\u002F2.components\u002F17.radio-group","radio-group","You have no choice. Well, one. A set of radio buttons where exactly one can be selected.",{"title":174,"path":175,"stem":176,"component":177,"category":11,"description":178},"Switch","\u002Fdocs\u002Fcomponents\u002Fswitch","docs\u002F2.components\u002F18.switch","switch","Is this a checkbox?",{"title":180,"path":181,"stem":182,"component":183,"category":11,"description":184},"Slider","\u002Fdocs\u002Fcomponents\u002Fslider","docs\u002F2.components\u002F19.slider","slider","Slide to unlock. Just kidding, slide to pick.",{"title":186,"path":187,"stem":188,"component":189,"category":11,"description":190},"Rating","\u002Fdocs\u002Fcomponents\u002Frating","docs\u002F2.components\u002F20.rating","rating","Everyone's a critic. Now they have stars.",{"title":192,"path":193,"stem":194,"component":195,"category":11,"description":196},"Choice Group","\u002Fdocs\u002Fcomponents\u002Fchoice-group","docs\u002F2.components\u002F21.choice-group","choice-group","Sign my petition. It's only as complicated as you make it. Layouts for checkbox and radio groups a plain stack, cards, a bordered list or a table, in a column or a row.",{"title":198,"path":199,"stem":200,"component":201,"category":11,"description":202},"Select","\u002Fdocs\u002Fcomponents\u002Fselect","docs\u002F2.components\u002F22.select","select","Looks like an input. It's a trap! A list of options behind a trigger that looks like an Input.",{"title":204,"path":205,"stem":206,"component":207,"category":11,"description":208},"Combobox","\u002Fdocs\u002Fcomponents\u002Fcombobox","docs\u002F2.components\u002F23.combobox","combobox","Ctrl+F for your dropdown. A text input that filters a list of options as you type.",{"title":210,"path":211,"stem":212,"component":213,"category":11,"description":214},"Listbox","\u002Fdocs\u002Fcomponents\u002Flistbox","docs\u002F2.components\u002F24.listbox","listbox","No dropdown. No surprises. A list to pick one or more options from, with icons, titles and descriptions.",{"title":216,"path":217,"stem":218,"component":219,"category":11,"description":220},"Color picker","\u002Fdocs\u002Fcomponents\u002Fcolor-picker","docs\u002F2.components\u002F25.color-picker","color-picker","Fifty shades of grey. And 16.7 million others. A colour picker built from parts an area, channel sliders, a field, a preview and swatches.",{"title":222,"path":223,"stem":224,"component":225,"category":11,"description":226},"Calendar","\u002Fdocs\u002Fcomponents\u002Fcalendar","docs\u002F2.components\u002F26.calendar","calendar","Thirty days hath September, and this grid knows all of them. A month to pick a date from.",{"title":228,"path":229,"stem":230,"component":231,"category":11,"description":232},"Range Calendar","\u002Fdocs\u002Fcomponents\u002Frange-calendar","docs\u002F2.components\u002F27.range-calendar","range-calendar","From here to there, in two clicks. A calendar for the start and the end of something.",{"title":234,"path":235,"stem":236,"component":237,"category":11,"description":238},"Date Picker","\u002Fdocs\u002Fcomponents\u002Fdate-picker","docs\u002F2.components\u002F28.date-picker","date-picker","Type it if you know it, pick it if you don't. Nobody remembers what day the 14th is.",{"title":240,"path":241,"stem":242,"component":243,"category":11,"description":244},"Date Range Picker","\u002Fdocs\u002Fcomponents\u002Fdate-range-picker","docs\u002F2.components\u002F29.date-range-picker","date-range-picker","Check-in, check-out, and a calendar for the bit in between. Late checkout not included.",{"title":246,"path":247,"stem":248,"component":249,"category":11,"description":250},"Field","\u002Fdocs\u002Fcomponents\u002Ffield","docs\u002F2.components\u002F30.field","field","Your input's personal assistant. Label, description and error for one form control, wired to it automatically.",{"title":252,"path":253,"stem":254,"component":255,"category":11,"description":256},"Label","\u002Fdocs\u002Fcomponents\u002Flabel","docs\u002F2.components\u002F31.label","label","Hello, my name is Email. An accessible name for a form control.",{"title":258,"path":259,"stem":260,"component":261,"category":11,"description":262},"File Upload","\u002Fdocs\u002Fcomponents\u002Ffile-upload","docs\u002F2.components\u002F32.file-upload","file-upload","Drop it like it's hot. Or click, or paste. We'll check its size first.",{"title":264,"path":265,"stem":266,"component":267,"category":11,"description":268},"Dialog","\u002Fdocs\u002Fcomponents\u002Fdialog","docs\u002F2.components\u002F33.dialog","dialog","We need to talk. A modal window with a header, a scrolling body and a footer. Open it from a template or straight from code.",{"title":270,"path":271,"stem":272,"component":273,"category":11,"description":274},"Alert Dialog","\u002Fdocs\u002Fcomponents\u002Falert-dialog","docs\u002F2.components\u002F34.alert-dialog","alert-dialog","Updating Linux… wait, where did Linux go? This is why we ask first. A modal that interrupts with a question and waits for an answer.",{"title":276,"path":277,"stem":278,"component":279,"category":11,"description":280},"Drawer","\u002Fdocs\u002Fcomponents\u002Fdrawer","docs\u002F2.components\u002F35.drawer","drawer","Wait, it's all swipeable? Always has been. A panel that slides in from any edge and swipes away, with a handle, swipe-to-open from the edge, and a bottom that stays above the keyboard.",{"title":282,"path":283,"stem":284,"component":285,"category":11,"description":286},"Drawer Menu","\u002Fdocs\u002Fcomponents\u002Fdrawer-menu","docs\u002F2.components\u002F36.drawer-menu","drawer-menu","We need to go deeper. A menu in a drawer for touch screens, with checkbox and radio items and submenus that drill down in the same sheet.",{"title":288,"path":289,"stem":290,"component":291,"category":11,"description":292},"Popover","\u002Fdocs\u002Fcomponents\u002Fpopover","docs\u002F2.components\u002F37.popover","popover","Rich content in a floating panel anchored to a trigger.",{"title":294,"path":295,"stem":296,"component":297,"category":11,"description":298},"Hover Card","\u002Fdocs\u002Fcomponents\u002Fhover-card","docs\u002F2.components\u002F38.hover-card","hover-card","Sneak peek, no commitment. A preview card for links, shown on hover or focus.",{"title":300,"path":301,"stem":302,"component":303,"category":11,"description":304},"Tour","\u002Fdocs\u002Fcomponents\u002Ftour","docs\u002F2.components\u002F39.tour","tour","Let me show you around. A popover that walks from one element to the next, driven by useTour.",{"title":306,"path":307,"stem":308,"component":309,"category":11,"description":310},"Tooltip","\u002Fdocs\u002Fcomponents\u002Ftooltip","docs\u002F2.components\u002F40.tooltip","tooltip","It looks like you're hovering over a button. Would you like help? A short hint about a control, shown on hover, keyboard focus or a long press.",{"title":312,"path":313,"stem":314,"component":315,"category":11,"description":316},"Menu","\u002Fdocs\u002Fcomponents\u002Fmenu","docs\u002F2.components\u002F41.menu","menu","One menu to rule them all. A dropdown and a context menu in one component that attaches to whatever it sits in.",{"title":318,"path":319,"stem":320,"component":321,"category":11,"description":322},"Command","\u002Fdocs\u002Fcomponents\u002Fcommand","docs\u002F2.components\u002F42.command","command","A filterable list of commands, inline or in a dialog, built on Reka UI's Listbox.",{"title":324,"path":325,"stem":326,"component":327,"category":11,"description":328},"Toast","\u002Fdocs\u002Fcomponents\u002Ftoast","docs\u002F2.components\u002F43.toast","toast","Brief messages from a useToast() service — ids to update and remove, promises, groups, and a stacked Toaster that expands on hover.",{"title":330,"path":331,"stem":332,"component":333,"category":11,"description":334},"Tabs","\u002Fdocs\u002Fcomponents\u002Ftabs","docs\u002F2.components\u002F44.tabs","tabs","Panels switched by a row or column of tabs, with an indicator that slides to the active one.",{"title":336,"path":337,"stem":338,"component":339,"category":11,"description":340},"Navigation Menu","\u002Fdocs\u002Fcomponents\u002Fnavigation-menu","docs\u002F2.components\u002F45.navigation-menu","navigation-menu","The header your marketing team keeps asking for. Links and triggers whose panels open in one shared box that glides between them.",{"title":342,"path":343,"stem":344,"component":345,"category":11,"description":346},"Menubar","\u002Fdocs\u002Fcomponents\u002Fmenubar","docs\u002F2.components\u002F46.menubar","menubar","File, Edit, View. The bar your desktop apps have had since 1984, now in Vue.",{"title":348,"path":349,"stem":350,"component":351,"category":11,"description":352},"Breadcrumb","\u002Fdocs\u002Fcomponents\u002Fbreadcrumb","docs\u002F2.components\u002F47.breadcrumb","breadcrumb","The path to the current page, as links separated by chevrons.",{"title":354,"path":355,"stem":356,"component":357,"category":11,"description":358},"Pagination","\u002Fdocs\u002Fcomponents\u002Fpagination","docs\u002F2.components\u002F48.pagination","pagination","Page navigation with previous and next, ellipses for skipped pages, Button's variants and five sizes.",{"title":360,"path":361,"stem":362,"component":363,"category":11,"description":364},"Stepper","\u002Fdocs\u002Fcomponents\u002Fstepper","docs\u002F2.components\u002F49.stepper","stepper","Step 1: draw some circles. Step 2: draw the rest of the owl. Steps that mark progress through a multi-step flow.",{"title":366,"path":367,"stem":368,"component":369,"category":11,"description":370},"Page Indicator","\u002Fdocs\u002Fcomponents\u002Fpage-indicator","docs\u002F2.components\u002F50.page-indicator","page-indicator","Dots, a pill or line segments that mark the current page or slide, built on Reka UI.",{"title":372,"path":373,"stem":374,"component":375,"category":11,"description":376},"Swipe Views","\u002Fdocs\u002Fcomponents\u002Fswipe-views","docs\u002F2.components\u002F51.swipe-views","swipe-views","Pages that follow the finger, the way native apps page between tabs. One page sits in the frame, and a release settles on the nearest one with the speed of the swipe.",{"title":378,"path":379,"stem":380,"component":381,"category":11,"description":382},"Timeline","\u002Fdocs\u002Fcomponents\u002Ftimeline","docs\u002F2.components\u002F52.timeline","timeline","One thing after another. A record of events with an optional current one, vertical or horizontal, newest first or last.",{"title":384,"path":385,"stem":386,"component":387,"category":11,"description":388},"Table","\u002Fdocs\u002Fcomponents\u002Ftable","docs\u002F2.components\u002F53.table","table","Table parts with borders on the cells, sticky header and footer, pinned columns and five row sizes.",{"title":390,"path":391,"stem":392,"component":393,"category":11,"description":394},"Data Table","\u002Fdocs\u002Fcomponents\u002Fdata-table","docs\u002F2.components\u002F54.data-table","data-table","Excel called, it wants its features back. A table with sorting, sticky parts, pinned columns and rows, selection, trees, grouping, pagination, infinite scroll and row virtualization.",{"title":396,"path":397,"stem":398,"component":399,"category":11,"description":400},"Tree","\u002Fdocs\u002Fcomponents\u002Ftree","docs\u002F2.components\u002F55.tree","tree","Folders inside folders inside folders. A tree to browse, select or check nested items, with lazy folders and room for ten thousand nodes.",{"title":402,"path":403,"stem":404,"component":405,"category":11,"description":406},"Data Tree","\u002Fdocs\u002Fcomponents\u002Fdata-tree","docs\u002F2.components\u002F56.data-tree","data-tree","A tree drawn from data, with rows from each node's label and icon, loading, empty and error states, and virtualization by one prop.",{"title":408,"path":409,"stem":410,"component":411,"category":11,"description":412},"Item","\u002Fdocs\u002Fcomponents\u002Fitem","docs\u002F2.components\u002F57.item","item","You've built this row a hundred times. Here's the last one. A row of media, title, description and actions, in five variants and five sizes.",{"title":414,"path":415,"stem":416,"component":417,"category":11,"description":418},"Avatar","\u002Fdocs\u002Fcomponents\u002Favatar","docs\u002F2.components\u002F58.avatar","avatar","Anime PFP? We don't judge.",{"title":420,"path":421,"stem":422,"component":423,"category":11,"description":424},"Badge","\u002Fdocs\u002Fcomponents\u002Fbadge","docs\u002F2.components\u002F59.badge","badge","A small label with Button's variants and colours, five sizes, side-aware icon padding and a square form.",{"title":426,"path":427,"stem":428,"component":429,"category":11,"description":430},"Kbd","\u002Fdocs\u002Fcomponents\u002Fkbd","docs\u002F2.components\u002F60.kbd","kbd","Ctrl+C, Ctrl+V. That's the whole career. A keyboard key, and a group of keys for a shortcut.",{"title":432,"path":433,"stem":434,"component":435,"category":11,"description":436},"Marker","\u002Fdocs\u002Fcomponents\u002Fmarker","docs\u002F2.components\u002F61.marker","marker","Explored 4 files. An inline status, a bordered row or a labelled separator in a conversation.",{"title":438,"path":439,"stem":440,"component":441,"category":11,"description":442},"Image","\u002Fdocs\u002Fcomponents\u002Fimage","docs\u002F2.components\u002F62.image","image","POV: your image shows up before JavaScript does. An image in a ratio box with loading and error layers, native srcset, sizes and picture sources.",{"title":444,"path":445,"stem":446,"component":447,"category":11,"description":448},"Marquee","\u002Fdocs\u002Fcomponents\u002Fmarquee","docs\u002F2.components\u002F63.marquee","marquee","And they're off. Content that scrolls forever, horizontal or vertical, with a pause on hover and a fade at the edges.",{"title":450,"path":451,"stem":452,"component":453,"category":11,"description":454},"Chart","\u002Fdocs\u002Fcomponents\u002Fchart","docs\u002F2.components\u002F64.chart","chart","Charts on Unovis. A container that turns a config into series colours, a crosshair that reports the hovered point, a tooltip that is a real Vue component, and a legend that can hide a series.",{"title":456,"path":457,"stem":458,"component":459,"category":11,"description":460},"Card","\u002Fdocs\u002Fcomponents\u002Fcard","docs\u002F2.components\u002F65.card","card","Impressive. Very nice. Let's see Paul Allen's card. A surface that groups related content, with header, title, description, content and footer parts.",{"title":462,"path":463,"stem":464,"component":465,"category":11,"description":466},"Separator","\u002Fdocs\u002Fcomponents\u002Fseparator","docs\u002F2.components\u002F66.separator","separator","A line that separates content, horizontal or vertical, with an optional label.",{"title":468,"path":469,"stem":470,"component":471,"category":11,"description":472},"Accordion","\u002Fdocs\u002Fcomponents\u002Faccordion","docs\u002F2.components\u002F67.accordion","accordion","Customers have questions? Answer them, then fold them away. Stacked sections that open one at a time or several at once, and open themselves when find in page matches their text.",{"title":474,"path":475,"stem":476,"component":477,"category":11,"description":478},"Collapsible","\u002Fdocs\u002Fcomponents\u002Fcollapsible","docs\u002F2.components\u002F68.collapsible","collapsible","Not to be confused with the three-time TI champion. A trigger that shows and hides a block of content.",{"title":480,"path":481,"stem":482,"component":483,"category":11,"description":484},"Aspect Ratio","\u002Fdocs\u002Fcomponents\u002Faspect-ratio","docs\u002F2.components\u002F69.aspect-ratio","aspect-ratio","No more squished cats. Keeps its content at a given width-to-height ratio.",{"title":486,"path":487,"stem":488,"component":489,"category":11,"description":490},"Scroll Area","\u002Fdocs\u002Fcomponents\u002Fscroll-area","docs\u002F2.components\u002F70.scroll-area","scroll-area","Scrollbars that don't look like Windows 98. Custom bars over a native scroller, with optional virtualization.",{"title":492,"path":493,"stem":494,"component":11,"category":495,"description":496},"Infinite Scroll","\u002Fdocs\u002Fcomponents\u002Finfinite-scroll","docs\u002F2.components\u002F71.infinite-scroll","layout","Doomscrolling, now as a component. Loads more content as you scroll near an edge, in any of four directions.",{"title":498,"path":499,"stem":500,"component":501,"category":11,"description":502},"Splitter","\u002Fdocs\u002Fcomponents\u002Fsplitter","docs\u002F2.components\u002F72.splitter","splitter","Resizable panels separated by draggable handles, built on Reka UI.",{"title":504,"path":505,"stem":506,"component":507,"category":11,"description":508},"Swipe Actions","\u002Fdocs\u002Fcomponents\u002Fswipe-actions","docs\u002F2.components\u002F73.swipe-actions","swipe-actions","A list row that slides sideways to reveal actions, the way Mail does on iOS.",{"title":510,"path":511,"stem":512,"component":513,"category":11,"description":514},"Alert","\u002Fdocs\u002Fcomponents\u002Falert","docs\u002F2.components\u002F74.alert","alert","A callout with Button's variants and colours, five sizes, and actions under the text or beside it.",{"title":516,"path":517,"stem":518,"component":519,"category":11,"description":520},"Banner","\u002Fdocs\u002Fcomponents\u002Fbanner","docs\u002F2.components\u002F75.banner","banner","Heads up, everyone. A full-width notice across the top of a page, closable, in any colour role.",{"title":522,"path":523,"stem":524,"component":525,"category":11,"description":526},"Progress","\u002Fdocs\u002Fcomponents\u002Fprogress","docs\u002F2.components\u002F76.progress","progress","A progress bar with Nuxt UI's indeterminate animations, status, steps and seven sizes, and shadcn's label and value.",{"title":528,"path":529,"stem":530,"component":531,"category":11,"description":532},"Spinner","\u002Fdocs\u002Fcomponents\u002Fspinner","docs\u002F2.components\u002F77.spinner","spinner","A loading indicator driven by clip-path, inheriting its colour from currentColor.",{"title":534,"path":535,"stem":536,"component":537,"category":11,"description":538},"Skeleton","\u002Fdocs\u002Fcomponents\u002Fskeleton","docs\u002F2.components\u002F78.skeleton","skeleton","A placeholder that holds the place of content while it loads.",{"title":540,"path":541,"stem":542,"component":543,"category":11,"description":544},"Inner loading","\u002Fdocs\u002Fcomponents\u002Finner-loading","docs\u002F2.components\u002F79.inner-loading","inner-loading","A loading overlay for one region, with content that cannot be used until it is done.",{"title":546,"path":547,"stem":548,"component":549,"category":11,"description":550},"Empty","\u002Fdocs\u002Fcomponents\u002Fempty","docs\u002F2.components\u002F80.empty","empty","An empty state with media, a title, a description and actions, sized by one prop and drawn on whatever holds it.",{"title":552,"path":553,"stem":554,"component":555,"category":11,"description":556},"Error state","\u002Fdocs\u002Fcomponents\u002Ferror-state","docs\u002F2.components\u002F81.error-state","error-state","Empty's anatomy for a failure, with an error icon, a title, a description and a place for Retry, announced as an alert.",{"title":558,"path":559,"stem":560,"component":561,"category":11,"description":562},"Drag","\u002Fdocs\u002Fcomponents\u002Fdrag","docs\u002F2.components\u002F82.drag","drag","A one-axis drag gesture for mouse, pen and touch that leaves vertical scrolling to the browser on touch screens.",{"title":564,"path":565,"stem":566,"component":567,"category":11,"description":568},"Swipe Snap","\u002Fdocs\u002Fcomponents\u002Fswipe-snap","docs\u002F2.components\u002F83.swipe-snap","swipe-snap","A drag that settles on snap points measured in pixels. It is the mechanism under Swipe Views, for sheets, galleries and pagers of your own.",{"title":570,"path":571,"stem":572,"component":11,"category":573,"description":574},"Press Scale","\u002Fdocs\u002Fcomponents\u002Fpress-scale","docs\u002F2.components\u002F84.press-scale","utilities","A utility class that dips an element while it is pressed.",{"title":576,"path":577,"stem":578,"component":579,"category":11,"description":580},"Ripple","\u002Fdocs\u002Fcomponents\u002Fripple","docs\u002F2.components\u002F85.ripple","ripple","Look at that subtle drift to the centre. The tasteful softness of its edge. Oh my God, it even respects reduced motion. A directive for a press ripple that grows from where you pressed and drifts to the centre.",{"title":582,"path":583,"stem":584,"component":585,"category":11,"description":586},"Scroll","\u002Fdocs\u002Fcomponents\u002Fscroll","docs\u002F2.components\u002F86.scroll","scroll","Read and write the scroll position of an element or the window, optionally animated.",{"title":588,"path":589,"stem":590,"component":591,"category":11,"description":592},"Scroll Fade","\u002Fdocs\u002Fcomponents\u002Fscroll-fade","docs\u002F2.components\u002F87.scroll-fade","scroll-fade","There's more where that came from. Utilities that fade the edges of a scroll region while there's more to scroll that way.",{"title":594,"path":595,"stem":596,"component":11,"category":573,"description":597},"Shimmer","\u002Fdocs\u002Fcomponents\u002Fshimmer","docs\u002F2.components\u002F88.shimmer","Generating response… A highlight that sweeps across text while something is on its way.",{"title":599,"path":600,"stem":601,"component":602,"category":11,"description":603},"Text Control","\u002Fdocs\u002Fcomponents\u002Ftext-control","docs\u002F2.components\u002F89.text-control","text-control","Same frame, different fields. The variants, states and sizes Input, Select, Combobox and every other text field share, so they line up and light up the same way.",{"title":605,"component":11,"category":11,"description":11,"path":606,"stem":607,"children":608,"page":65},"Charts","\u002Fdocs\u002Fcharts","docs\u002F3.charts",[609,614,619,624],{"title":610,"path":611,"stem":612,"component":11,"category":11,"description":613},"Area","\u002Fdocs\u002Fcharts\u002Farea","docs\u002F3.charts\u002F01.area","Ten area charts. One series and stacks, three curve shapes, a legend, icons, gradient fills, axes and a range picker.",{"title":615,"path":616,"stem":617,"component":11,"category":11,"description":618},"Bar","\u002Fdocs\u002Fcharts\u002Fbar","docs\u002F3.charts\u002F02.bar","Ten bar charts. One series, groups and stacks, horizontal bars, value labels, a colour per bar, an active bar, negative values and a series switch.",{"title":620,"path":621,"stem":622,"component":11,"category":11,"description":623},"Line","\u002Fdocs\u002Fcharts\u002Fline","docs\u002F3.charts\u002F03.line","Ten line charts. One series and two, three curve shapes, dots in three styles, value and name labels and a series switch.",{"title":306,"path":625,"stem":626,"component":11,"category":11,"description":627},"\u002Fdocs\u002Fcharts\u002Ftooltip","docs\u002F3.charts\u002F07.tooltip","Nine ways to show what is under the pointer. Indicators, titles, formatters, icons and a custom row layout.",{"title":629,"component":11,"category":11,"description":11,"path":630,"stem":631,"children":632,"page":65},"Forms","\u002Fdocs\u002Fforms","docs\u002F4.forms",[633,638],{"title":634,"path":635,"stem":636,"component":11,"category":11,"description":637},"Formisch","\u002Fdocs\u002Fforms\u002Fformisch","docs\u002F4.forms\u002F1.formisch","Build forms with Formisch and Valibot on top of kappa-ui's Field components.",{"title":639,"path":640,"stem":641,"component":642,"category":11,"description":643},"VeeValidate","\u002Fdocs\u002Fforms\u002Fvee-validate","docs\u002F4.forms\u002F2.vee-validate","standard-schema","Forms that check their own homework. VeeValidate and Zod on top of kappa-ui's Field components.",{"id":645,"title":26,"body":646,"category":11,"component":11,"description":29,"extension":1892,"meta":1893,"navigation":1302,"path":27,"seo":1894,"stem":28,"__hash__":1895,"examples":1896},"docs\u002Fdocs\u002F1.getting-started\u002F03.theming.md",{"type":647,"value":648,"toc":1883},"minimark",[649,668,690,699,702,705,710,713,769,784,787,811,817,826,839,843,866,869,1012,1015,1061,1067,1114,1135,1159,1164,1171,1457,1564,1571,1580,1595,1598,1650,1669,1678,1682,1692,1714,1717,1727,1738,1751,1767,1778,1782,1791,1828,1838,1859,1863,1867,1879],[650,651,652,653,657,658,657,661,664,665,667],"p",{},"Components never hard-code a colour. They read colour tokens with the usual names, ",[654,655,656],"code",{},"--primary",", ",[654,659,660],{},"--background",[654,662,663],{},"--border"," and so on, written in OKLCH. Every fill comes with a foreground meant to sit on it. In dark mode the fills turn light and their foregrounds dark, so ",[654,666,656],{}," works as a button fill and as link text, in either theme.",[650,669,670,671,657,674,677,678,681,682,685,686,689],{},"Success, warning and info are the exception. A green, amber or sky blue dark enough to carry white text turns olive, brown and navy, so in light mode their fills stay bright under dark text. For text on the page, use ",[654,672,673],{},"--success-text",[654,675,676],{},"--warning-text"," and ",[654,679,680],{},"--info-text",": ",[654,683,684],{},"text-warning-text",", not ",[654,687,688],{},"text-warning",".",[650,691,692,693,698],{},"Components read these tokens but never set them, so any theme with these names works. The values below are Kappa UI's own, from the ",[694,695,697],"a",{"href":696},"\u002Fdocs\u002Fgetting-started\u002Finstallation#theme","theme item",". They're read live from this page, so the theme toggle changes them too.",[650,700,701],{},"Each card lists the WCAG contrast of its pairs, as rendered in the theme shown. Text needs 4.5:1 and control borders 3:1. Between 3:1 and 4.5:1 is only enough for large text.",[703,704],"token-table",{},[706,707,709],"h2",{"id":708},"brand-colour","Brand colour",[650,711,712],{},"Want your own brand colour? Change one value:",[714,715,720],"pre",{"className":716,"code":717,"language":718,"meta":719,"style":719},"language-css shiki shiki-themes github-light github-dark",":root {\n  --brand: oklch(0.6 0.2 150);\n}\n","css","",[654,721,722,735,763],{"__ignoreMap":719},[723,724,727,731],"span",{"class":725,"line":726},"line",1,[723,728,730],{"class":729},"sScJk",":root",[723,732,734],{"class":733},"sVt8B"," {\n",[723,736,738,742,744,748,751,754,757,760],{"class":725,"line":737},2,[723,739,741],{"class":740},"s4XuR","  --brand",[723,743,681],{"class":733},[723,745,747],{"class":746},"sj4cs","oklch",[723,749,750],{"class":733},"(",[723,752,753],{"class":746},"0.6",[723,755,756],{"class":746}," 0.2",[723,758,759],{"class":746}," 150",[723,761,762],{"class":733},");\n",[723,764,766],{"class":725,"line":765},3,[723,767,768],{"class":733},"}\n",[650,770,771,677,773,776,777,780,781,783],{},[654,772,656],{},[654,774,775],{},"--ring"," follow ",[654,778,779],{},"--brand",", but take only its hue and chroma. The lightness is fixed per theme, so white text on ",[654,782,656],{}," stays above 4.5:1 whatever hue you pick.",[785,786],"brand-derivation",{},[788,789,791],"callout",{"type":790},"warning",[650,792,793,801,802,804,805,807,808,810],{},[794,795,796,797,685,799,689],"strong",{},"Set ",[654,798,779],{},[654,800,656],{}," The theme derives ",[654,803,656],{}," from ",[654,806,779],{},", and in current browsers that overrides a ",[654,809,656],{}," you set by hand.",[650,812,813,814,689],{},"Rather click than type? The palette button in the header opens the theme customiser. Pick a colour and a neutral, a density, a radius and a font, then how surfaces, borders, shadows and the status colours look, and press ",[794,815,816],{},"Copy CSS",[650,818,819,820,677,822,825],{},"The derivation needs relative colour syntax: Chrome 119, Safari 18, Firefox 128 or later. Older browsers fall back to the static values in ",[654,821,730],{},[654,823,824],{},".dark",", which match the default blue. Supporting them? Update those static values too.",[650,827,828,830,831,833,834,677,836,838],{},[654,829,779],{}," only works where ",[654,832,656],{}," is declared, on ",[654,835,730],{},[654,837,824],{},". Setting it on an element further down changes nothing, unless you redeclare the derived tokens on the same selector.",[706,840,842],{"id":841},"tones","Tones",[650,844,845,846,849,850,853,854,857,858,861,862,865],{},"A ",[794,847,848],{},"tone"," is the colour a component is drawn in, picked with its ",[654,851,852],{},"color"," prop. ",[654,855,856],{},"color=\"success\""," sets ",[654,859,860],{},"data-color=\"success\""," on the root, and that turns into the variables every ",[794,863,864],{},"variant",", the component's look, reads. Three variables are inputs. The other four are derived from them, and you can override those too.",[867,868],"tone-anatomy",{},[387,870,871,887],{},[872,873,874],"thead",{},[875,876,877,881,884],"tr",{},[878,879,880],"th",{},"Variable",[878,882,883],{},"Value",[878,885,886],{},"Role",[888,889,890,907,919,944,966,980,996],"tbody",{},[875,891,892,898,900],{},[893,894,895],"td",{},[654,896,897],{},"--tone",[893,899,105],{},[893,901,902,903,906],{},"Fills: the ",[654,904,905],{},"solid"," variant, a checked box, a switch that's on, the active step.",[875,908,909,914,916],{},[893,910,911],{},[654,912,913],{},"--tone-foreground",[893,915,105],{},[893,917,918],{},"Text and icons on that fill.",[875,920,921,926,928],{},[893,922,923],{},[654,924,925],{},"--tone-text",[893,927,105],{},[893,929,930,931,657,934,657,937,940,941,689],{},"Text, lines and marks in this colour on the page: ",[654,932,933],{},"outline",[654,935,936],{},"ghost",[654,938,939],{},"link",", the toast icon, checked edges and dots, the slider and progress bars, the tab line, and the focus ring of a control in a colour other than ",[654,942,943],{},"primary",[875,945,946,951,957],{},[893,947,948],{},[654,949,950],{},"--tone-soft",[893,952,953,954,956],{},"12% of ",[654,955,897],{}," over transparent",[893,958,959,960,677,963,689],{},"The fill of ",[654,961,962],{},"soft",[654,964,965],{},"subtle",[875,967,968,973,977],{},[893,969,970],{},[654,971,972],{},"--tone-soft-foreground",[893,974,975],{},[654,976,925],{},[893,978,979],{},"Text on the soft fill.",[875,981,982,987,991],{},[893,983,984],{},[654,985,986],{},"--tone-border",[893,988,989],{},[654,990,925],{},[893,992,993,994,689],{},"The edge of ",[654,995,933],{},[875,997,998,1003,1008],{},[893,999,1000],{},[654,1001,1002],{},"--tone-border-subtle",[893,1004,1005,1006,956],{},"25% of ",[654,1007,986],{},[893,1009,993,1010,689],{},[654,1011,965],{},[650,1013,1014],{},"The built-in tones read the tokens above:",[1016,1017,1018,1027,1044],"ul",{},[1019,1020,1021,677,1023,1026],"li",{},[654,1022,943],{},[654,1024,1025],{},"destructive"," use their pair, with the fill doubling as the text colour.",[1019,1028,1029,657,1032,677,1034,1037,1038,657,1040,677,1042,689],{},[654,1030,1031],{},"success",[654,1033,790],{},[654,1035,1036],{},"info"," write their text in ",[654,1039,673],{},[654,1041,676],{},[654,1043,680],{},[1019,1045,1046,1049,1050,1053,1054,1057,1058,689],{},[654,1047,1048],{},"neutral"," fills with ",[654,1051,1052],{},"--foreground",", softens with ",[654,1055,1056],{},"--secondary"," and draws its edges in ",[654,1059,1060],{},"--input",[650,1062,1063,1064,1066],{},"Switch, Checkbox, Radio and Slider take ",[654,1065,852],{}," too, with four differences:",[1016,1068,1069,1084,1090,1099],{},[1019,1070,1071,1072,1074,1075,657,1077,677,1079,1081,1082,689],{},"What they draw straight on the page, such as a checked edge, the radio's dot and the slider's range, takes ",[654,1073,925],{},". A control needs 3:1 against the page, and the bright ",[654,1076,1031],{},[654,1078,790],{},[654,1080,1036],{}," fills fall short of it. A fill with something on it, like the checked box or the track of a switch that's on, keeps ",[654,1083,897],{},[1019,1085,1086,1087,1089],{},"The edge stays ",[654,1088,1060],{}," while unchecked, so empty controls in a form look alike whatever their colours.",[1019,1091,1092,1093,1095,1096,1098],{},"An invalid control turns ",[654,1094,1025],{},", whatever its ",[654,1097,852],{},", so an error always looks like one.",[1019,1100,1101,1102,1104,1105,1107,1108,1110,1111,1113],{},"Keyboard focus rings a ",[654,1103,943],{}," control in ",[654,1106,775],{},", as everywhere else, and any other in its ",[654,1109,925],{},", which turns ",[654,1112,1025],{}," along with the rest of an invalid control. The ring matches the control it surrounds.",[650,1115,1116,677,1119,1122,1123,1125,1126,1128,1129,1131,1132,1134],{},[654,1117,1118],{},"CheckboxGroup",[654,1120,1121],{},"RadioGroup"," pass their ",[654,1124,852],{}," to every control in them that has none of its own. Progress, the ",[654,1127,725],{}," indicator of Tabs and the active step of a Stepper take ",[654,1130,852],{}," as well. The progress bar and the tab line sit on the page, so they're drawn in ",[654,1133,925],{},"; the step's indicator is a fill.",[650,1136,1137,1138,1140,1141,1143,1144,1146,1147,1149,1150,1152,1153,1155,1156,1158],{},"Rating, Calendar and RangeCalendar take ",[654,1139,852],{}," on the same terms. A Rating's stars fill with ",[654,1142,897],{}," inside a ",[654,1145,925],{}," edge. A calendar's selected day and a range's two ends fill with ",[654,1148,897],{},", today's outline is ",[654,1151,925],{}," and the band between the ends is ",[654,1154,950],{},". All three turn ",[654,1157,1025],{}," when invalid.",[1160,1161,1163],"h3",{"id":1162},"your-own-tone","Your own tone",[650,1165,1166,1167,1170],{},"Three tokens and one rule. Declare the tokens per theme, next to the rest of your theme, then map them in the ",[654,1168,1169],{},"base"," layer:",[714,1172,1174],{"className":716,"code":1173,"language":718,"meta":719,"style":719},":root {\n  --pro: var(--color-violet-600);\n  --pro-foreground: var(--color-violet-50);\n  --pro-text: var(--color-violet-700);\n}\n.dark {\n  --pro: var(--color-violet-400);\n  --pro-foreground: var(--color-violet-950);\n  --pro-text: var(--color-violet-300);\n}\n\n@layer base {\n  [data-slot][data-color='pro'],\n  [data-slot][data-state='on'][data-active-color='pro'],\n  [data-slot][aria-pressed='true'][data-active-color='pro'] {\n    --tone: var(--pro);\n    --tone-foreground: var(--pro-foreground);\n    --tone-text: var(--pro-text);\n  }\n}\n",[654,1175,1176,1182,1199,1215,1232,1237,1244,1260,1276,1292,1297,1304,1314,1339,1367,1395,1412,1429,1446,1452],{"__ignoreMap":719},[723,1177,1178,1180],{"class":725,"line":726},[723,1179,730],{"class":729},[723,1181,734],{"class":733},[723,1183,1184,1187,1189,1192,1194,1197],{"class":725,"line":737},[723,1185,1186],{"class":740},"  --pro",[723,1188,681],{"class":733},[723,1190,1191],{"class":746},"var",[723,1193,750],{"class":733},[723,1195,1196],{"class":740},"--color-violet-600",[723,1198,762],{"class":733},[723,1200,1201,1204,1206,1208,1210,1213],{"class":725,"line":765},[723,1202,1203],{"class":740},"  --pro-foreground",[723,1205,681],{"class":733},[723,1207,1191],{"class":746},[723,1209,750],{"class":733},[723,1211,1212],{"class":740},"--color-violet-50",[723,1214,762],{"class":733},[723,1216,1218,1221,1223,1225,1227,1230],{"class":725,"line":1217},4,[723,1219,1220],{"class":740},"  --pro-text",[723,1222,681],{"class":733},[723,1224,1191],{"class":746},[723,1226,750],{"class":733},[723,1228,1229],{"class":740},"--color-violet-700",[723,1231,762],{"class":733},[723,1233,1235],{"class":725,"line":1234},5,[723,1236,768],{"class":733},[723,1238,1240,1242],{"class":725,"line":1239},6,[723,1241,824],{"class":729},[723,1243,734],{"class":733},[723,1245,1247,1249,1251,1253,1255,1258],{"class":725,"line":1246},7,[723,1248,1186],{"class":740},[723,1250,681],{"class":733},[723,1252,1191],{"class":746},[723,1254,750],{"class":733},[723,1256,1257],{"class":740},"--color-violet-400",[723,1259,762],{"class":733},[723,1261,1263,1265,1267,1269,1271,1274],{"class":725,"line":1262},8,[723,1264,1203],{"class":740},[723,1266,681],{"class":733},[723,1268,1191],{"class":746},[723,1270,750],{"class":733},[723,1272,1273],{"class":740},"--color-violet-950",[723,1275,762],{"class":733},[723,1277,1279,1281,1283,1285,1287,1290],{"class":725,"line":1278},9,[723,1280,1220],{"class":740},[723,1282,681],{"class":733},[723,1284,1191],{"class":746},[723,1286,750],{"class":733},[723,1288,1289],{"class":740},"--color-violet-300",[723,1291,762],{"class":733},[723,1293,1295],{"class":725,"line":1294},10,[723,1296,768],{"class":733},[723,1298,1300],{"class":725,"line":1299},11,[723,1301,1303],{"emptyLinePlaceholder":1302},true,"\n",[723,1305,1307,1311],{"class":725,"line":1306},12,[723,1308,1310],{"class":1309},"szBVR","@layer",[723,1312,1313],{"class":733}," base {\n",[723,1315,1317,1320,1323,1326,1329,1332,1336],{"class":725,"line":1316},13,[723,1318,1319],{"class":733},"  [",[723,1321,1322],{"class":729},"data-slot",[723,1324,1325],{"class":733},"][",[723,1327,1328],{"class":729},"data-color",[723,1330,1331],{"class":1309},"=",[723,1333,1335],{"class":1334},"sZZnC","'pro'",[723,1337,1338],{"class":733},"],\n",[723,1340,1342,1344,1346,1348,1351,1353,1356,1358,1361,1363,1365],{"class":725,"line":1341},14,[723,1343,1319],{"class":733},[723,1345,1322],{"class":729},[723,1347,1325],{"class":733},[723,1349,1350],{"class":729},"data-state",[723,1352,1331],{"class":1309},[723,1354,1355],{"class":1334},"'on'",[723,1357,1325],{"class":733},[723,1359,1360],{"class":729},"data-active-color",[723,1362,1331],{"class":1309},[723,1364,1335],{"class":1334},[723,1366,1338],{"class":733},[723,1368,1370,1372,1374,1376,1379,1381,1384,1386,1388,1390,1392],{"class":725,"line":1369},15,[723,1371,1319],{"class":733},[723,1373,1322],{"class":729},[723,1375,1325],{"class":733},[723,1377,1378],{"class":729},"aria-pressed",[723,1380,1331],{"class":1309},[723,1382,1383],{"class":1334},"'true'",[723,1385,1325],{"class":733},[723,1387,1360],{"class":729},[723,1389,1331],{"class":1309},[723,1391,1335],{"class":1334},[723,1393,1394],{"class":733},"] {\n",[723,1396,1398,1401,1403,1405,1407,1410],{"class":725,"line":1397},16,[723,1399,1400],{"class":740},"    --tone",[723,1402,681],{"class":733},[723,1404,1191],{"class":746},[723,1406,750],{"class":733},[723,1408,1409],{"class":740},"--pro",[723,1411,762],{"class":733},[723,1413,1415,1418,1420,1422,1424,1427],{"class":725,"line":1414},17,[723,1416,1417],{"class":740},"    --tone-foreground",[723,1419,681],{"class":733},[723,1421,1191],{"class":746},[723,1423,750],{"class":733},[723,1425,1426],{"class":740},"--pro-foreground",[723,1428,762],{"class":733},[723,1430,1432,1435,1437,1439,1441,1444],{"class":725,"line":1431},18,[723,1433,1434],{"class":740},"    --tone-text",[723,1436,681],{"class":733},[723,1438,1191],{"class":746},[723,1440,750],{"class":733},[723,1442,1443],{"class":740},"--pro-text",[723,1445,762],{"class":733},[723,1447,1449],{"class":725,"line":1448},19,[723,1450,1451],{"class":733},"  }\n",[723,1453,1455],{"class":725,"line":1454},20,[723,1456,768],{"class":733},[714,1458,1462],{"className":1459,"code":1460,"language":1461,"meta":719,"style":719},"language-vue shiki shiki-themes github-light github-dark","\u003CButton color=\"pro\">Upgrade\u003C\u002FButton>\n\u003CBadge color=\"pro\" variant=\"soft\">Pro\u003C\u002FBadge>\n\u003CAlert color=\"pro\" variant=\"subtle\">Your trial ends in 3 days.\u003C\u002FAlert>\n\u003CSwitch color=\"pro\" aria-label=\"Pro features\" \u002F>\n","vue",[654,1463,1464,1488,1515,1541],{"__ignoreMap":719},[723,1465,1466,1469,1472,1475,1477,1480,1483,1485],{"class":725,"line":726},[723,1467,1468],{"class":733},"\u003C",[723,1470,72],{"class":1471},"s9eBZ",[723,1473,1474],{"class":729}," color",[723,1476,1331],{"class":733},[723,1478,1479],{"class":1334},"\"pro\"",[723,1481,1482],{"class":733},">Upgrade\u003C\u002F",[723,1484,72],{"class":1471},[723,1486,1487],{"class":733},">\n",[723,1489,1490,1492,1494,1496,1498,1500,1503,1505,1508,1511,1513],{"class":725,"line":737},[723,1491,1468],{"class":733},[723,1493,420],{"class":1471},[723,1495,1474],{"class":729},[723,1497,1331],{"class":733},[723,1499,1479],{"class":1334},[723,1501,1502],{"class":729}," variant",[723,1504,1331],{"class":733},[723,1506,1507],{"class":1334},"\"soft\"",[723,1509,1510],{"class":733},">Pro\u003C\u002F",[723,1512,420],{"class":1471},[723,1514,1487],{"class":733},[723,1516,1517,1519,1521,1523,1525,1527,1529,1531,1534,1537,1539],{"class":725,"line":765},[723,1518,1468],{"class":733},[723,1520,510],{"class":1471},[723,1522,1474],{"class":729},[723,1524,1331],{"class":733},[723,1526,1479],{"class":1334},[723,1528,1502],{"class":729},[723,1530,1331],{"class":733},[723,1532,1533],{"class":1334},"\"subtle\"",[723,1535,1536],{"class":733},">Your trial ends in 3 days.\u003C\u002F",[723,1538,510],{"class":1471},[723,1540,1487],{"class":733},[723,1542,1543,1545,1547,1549,1551,1553,1556,1558,1561],{"class":725,"line":1217},[723,1544,1468],{"class":733},[723,1546,174],{"class":1471},[723,1548,1474],{"class":729},[723,1550,1331],{"class":733},[723,1552,1479],{"class":1334},[723,1554,1555],{"class":729}," aria-label",[723,1557,1331],{"class":733},[723,1559,1560],{"class":1334},"\"Pro features\"",[723,1562,1563],{"class":733}," \u002F>\n",[650,1565,1566,1567,1570],{},"The last two selectors cover ",[654,1568,1569],{},"active-color"," on Toggle and ToggleGroup, which take the tone while pressed.",[650,1572,1573,1574,1577,1578,689],{},"Keep the rule in ",[654,1575,1576],{},"@layer base",", where the built-in tones live. A rule outside any layer beats every utility, so an invalid Switch or Checkbox in your colour would keep it instead of turning ",[654,1579,1025],{},[650,1581,1582,1583,1586,1587,1590,1591,1594],{},"Keep ",[654,1584,1585],{},"[data-slot]"," in the selector too. The derived values live on ",[654,1588,1589],{},"[data-slot][data-color]",", and a less specific rule can't override them. To override one, add it to the same rule, such as ",[654,1592,1593],{},"--tone-soft: var(--color-violet-50)"," when the design has its own tint.",[650,1596,1597],{},"Got a scale from 50 to 950, from Tailwind or a design file? Map it like this:",[387,1599,1600,1612],{},[872,1601,1602],{},[875,1603,1604,1606,1609],{},[878,1605],{},[878,1607,1608],{},"Light",[878,1610,1611],{},"Dark",[888,1613,1614,1626,1638],{},[875,1615,1616,1620,1623],{},[893,1617,1618],{},[654,1619,897],{},[893,1621,1622],{},"600",[893,1624,1625],{},"400",[875,1627,1628,1632,1635],{},[893,1629,1630],{},[654,1631,913],{},[893,1633,1634],{},"white or 50",[893,1636,1637],{},"950",[875,1639,1640,1644,1647],{},[893,1641,1642],{},[654,1643,925],{},[893,1645,1646],{},"700",[893,1648,1649],{},"300",[650,1651,1652,1653,677,1655,1657,1658,657,1661,1664,1665,1668],{},"Your own elements can join in. Give one ",[654,1654,1322],{},[654,1656,1328],{},", and ",[654,1659,1660],{},"bg-tone-soft",[654,1662,1663],{},"text-tone-text"," and the other ",[654,1666,1667],{},"tone-*"," colours work on it and its children.",[650,1670,1671,1672,681,1675,689],{},"Just one component? Skip the rule and set the inputs in its ",[654,1673,1674],{},"class",[654,1676,1677],{},"class=\"[--tone:var(--color-pink-500)] [--tone-foreground:white] [--tone-text:var(--color-pink-700)]\"",[706,1679,1681],{"id":1680},"dark-mode","Dark mode",[650,1683,1684,1685,1688,1689,689],{},"Want dark mode? Add the ",[654,1686,1687],{},"dark"," class to ",[654,1690,1691],{},"\u003Chtml>",[650,1693,1694,1695,1697,1698,1700,1701,1704,1705,1707,1708,1710,1711,1713],{},"The theme puts the light values on ",[654,1696,730],{}," and the dark ones on ",[654,1699,824],{},". Components read tokens only, with no ",[654,1702,1703],{},"dark:"," utilities: the tokens change value under ",[654,1706,824],{},", and every variant follows. ",[654,1709,824],{}," works on any element, not only ",[654,1712,1691],{},", so one part of a page can go dark on its own:",[1715,1716],"dark-mode-split",{},[650,1718,1719,1720,1723,1724,1726],{},"The theme also sets ",[654,1721,1722],{},"color-scheme: dark"," under ",[654,1725,824],{},", so the browser's own controls, such as date pickers and scrollbars, turn dark with it.",[650,1728,1729,1730,1733,1734,1737],{},"The shadcn-vue CLI adds this variant to your stylesheet at ",[654,1731,1732],{},"init"," and on every ",[654,1735,1736],{},"add",", unless the stylesheet already declares a custom variant:",[714,1739,1741],{"className":716,"code":1740,"language":718,"meta":719,"style":719},"@custom-variant dark (&:is(.dark *));\n",[654,1742,1743],{"__ignoreMap":719},[723,1744,1745,1748],{"class":725,"line":726},[723,1746,1747],{"class":1309},"@custom-variant",[723,1749,1750],{"class":733}," dark (&:is(.dark *));\n",[650,1752,1753,1754,1756,1757,1759,1760,1763,1764,1766],{},"From then on your own ",[654,1755,1703],{}," utilities follow the ",[654,1758,824],{}," class too. To keep them on ",[654,1761,1762],{},"prefers-color-scheme",", remove that line. Kappa UI's colours switch with ",[654,1765,824],{}," either way.",[650,1768,1769,1770,1773,1774,1777],{},"Using Nuxt? ",[654,1771,1772],{},"@nuxtjs\u002Fcolor-mode"," with ",[654,1775,1776],{},"classSuffix: ''"," sets exactly this class. That's how this site switches.",[706,1779,1781],{"id":1780},"states-and-shape","States and shape",[650,1783,1784,1785,1787,1788,1790],{},"Hover and press show as a translucent layer of the button's own text colour, so no variant needs a hover colour of its own. A disabled button takes its colours from ",[654,1786,1052],{},", whatever its variant. Pressable parts also carry the ",[694,1789,579],{"href":577},", which uses the same pressed opacity and takes over the press.",[650,1792,1793,1794,1796,1797,1799,1800,1802,1803,1805,1806,1808,1809,1812,1813,1816,1817,1820,1821,1824,1825,689],{},"Keyboard focus is a 3px outline in ",[654,1795,775],{}," at half strength, outside the element. Switch, Checkbox, Radio and Slider in a colour other than ",[654,1798,943],{}," draw it in their ",[654,1801,925],{}," instead, and so does a focused card of a ",[654,1804,1118],{}," or ",[654,1807,1121],{}," in one. Being an outline, it leaves the element's shadow alone and stays visible in forced colours mode. Use it in your own components too: ",[654,1810,1811],{},"focus-visible:focus-ring",", or ",[654,1814,1815],{},"focus-ring-inset"," to draw it inside. To draw one element's ring in another colour, set ",[654,1818,1819],{},"--focus-ring-color"," on it, as ",[654,1822,1823],{},"AlertClose"," does with ",[654,1826,1827],{},"[--focus-ring-color:currentColor]",[650,1829,1830,1831,1834,1835,1837],{},"Corners come in three roles, controls, surfaces and items, each scaled from ",[654,1832,1833],{},"--radius"," and tunable on its own. ",[694,1836,56],{"href":57}," lists them, with a playground.",[650,1839,1840,1843,1844,1847,1848,1851,1852,1855,1856,689],{},[794,1841,1842],{},"Surfaces"," are the panels that sit on or above the page: cards, dialogs, menus, popovers and select lists. A menu opens on a card or in a dialog, never the other way round, so ",[654,1845,1846],{},"--popover"," sits a step above ",[654,1849,1850],{},"--dialog"," in the dark theme, and its shadow carries an edge, so a menu stays apart from whatever it opens on. Want a hairline around every surface? Set ",[654,1853,1854],{},"--surface-border"," to ",[654,1857,1858],{},"var(--border)",[1860,1861],"css-vars",{":rows":1862},"[{\"name\":\"--state-hover\",\"default\":\"8%\",\"description\":\"Opacity of the layer under the pointer.\"},{\"name\":\"--state-pressed\",\"default\":\"12%\",\"description\":\"Opacity of the layer, or of the ripple, while pressed.\"},{\"name\":\"--state-selected\",\"default\":\"8%\",\"description\":\"Opacity of the tint under a selected option, list item or choice card. A choice group tints in its own `color`.\"},{\"name\":\"--disabled-opacity\",\"default\":\"38%\",\"description\":\"Opacity of `--foreground` for disabled text and icons.\"},{\"name\":\"--disabled-container-opacity\",\"default\":\"12%\",\"description\":\"Opacity of `--foreground` for disabled fills and outlines.\"},{\"name\":\"--scrim\",\"default\":\"oklch(0 0 0 \u002F 40%)\",\"description\":\"The dimmed layer behind a modal dialog; 60% in the dark theme.\"},{\"name\":\"--surface-border\",\"default\":\"transparent\",\"description\":\"Border colour of cards, dialogs, menus, popovers and select lists. The default theme draws them without one; set it to `var(--border)` for a hairline. The width is always there, so nothing moves. Set it on `:root` for every surface or on one element for that one.\"},{\"name\":\"--shadow-xs … --shadow-xl\",\"default\":\"Tailwind's shadow-xs … shadow-xl\",\"description\":\"Elevation of slider thumbs and the pill tab indicator, drawn with `shadow-shadow-xs` to `shadow-shadow-xl`. In the light theme the two role shadows below build on `--shadow-lg` and `--shadow-xl`. The shadcn-vue CLI mirrors these tokens into `@theme inline`, so Tailwind's own `shadow-*` classes draw them too, and shadow colour classes such as `shadow-primary\u002F30` have no effect on them.\"},{\"name\":\"--shadow-popover\",\"default\":\"a 1px ring and --shadow-lg; in the dark theme a highlight, two rings and a four-layer drop\",\"description\":\"Edge and shadow of menus, select lists, popovers, hover cards and toasts, drawn with `shadow-shadow-popover`. Set it to `var(--shadow-lg)` for a plain shadow without the edge.\"},{\"name\":\"--shadow-dialog\",\"default\":\"a 1px ring and --shadow-xl; in the dark theme a highlight, two rings and a five-layer drop\",\"description\":\"Edge and shadow of dialogs and alert dialogs, drawn with `shadow-shadow-dialog`. Set it to `var(--shadow-xl)` for a plain shadow without the edge.\"},{\"name\":\"--radius\",\"default\":\"0.5rem\",\"description\":\"Base corner radius, part of the `theme` item and of shadcn's own theme. `--radius-xs` to `--radius-4xl` (from `theme`) and the control, surface and item roles (from `tokens`, so they work without the theme) are multiples of it, so `0` squares every corner. [Radius](\u002Fdocs\u002Fgetting-started\u002Fradius) lists them.\"}]",[706,1864,1866],{"id":1865},"next","Next",[1016,1868,1869,1874],{},[1019,1870,1871,1873],{},[694,1872,31],{"href":32},": the type roles and how to change them.",[1019,1875,1876,1878],{},[694,1877,51],{"href":52},": heights, padding and gaps.",[1880,1881,1882],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}",{"title":719,"searchDepth":765,"depth":765,"links":1884},[1885,1886,1889,1890,1891],{"id":708,"depth":737,"text":709},{"id":841,"depth":737,"text":842,"children":1887},[1888],{"id":1162,"depth":765,"text":1163},{"id":1680,"depth":737,"text":1681},{"id":1780,"depth":737,"text":1781},{"id":1865,"depth":737,"text":1866},"md",{},{"title":26,"description":29},"ZOJWqpw68R_W9Fb3h7-w6qD04HcpWUaUSTL57au2g5M",[],[],1792689687270]