mirror of
https://github.com/element-plus/element-plus.git
synced 2025-02-17 11:49:41 +08:00
77 lines
34 KiB
HTML
77 lines
34 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en-US">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>Checkbox | Element Plus</title>
|
|
<meta name="description" content="A VitePress site">
|
|
<link rel="stylesheet" href="/assets/style.8840304c.css">
|
|
<link rel="modulepreload" href="/assets/framework.ddfda0ac.js">
|
|
<link rel="modulepreload" href="/assets/framework.506ba982.js">
|
|
<link rel="modulepreload" href="/assets/_commonjsHelpers.4e997714.js">
|
|
<link rel="modulepreload" href="/assets/index.0686aea5.js">
|
|
<link rel="modulepreload" href="/assets/plugin-vue_export-helper.21dcd24c.js">
|
|
<link rel="modulepreload" href="/assets/popup-manager.bdf58719.js">
|
|
<link rel="modulepreload" href="/assets/arrow-left.fd31dbfa.js">
|
|
<link rel="modulepreload" href="/assets/arrow-right.7209a220.js">
|
|
<link rel="modulepreload" href="/assets/index.056d216e.js">
|
|
<link rel="modulepreload" href="/assets/index.570843b3.js">
|
|
<link rel="modulepreload" href="/assets/plugin-vue_export-helper.f1ab819e.js">
|
|
<link rel="modulepreload" href="/assets/circle-plus.f0bb0027.js">
|
|
<link rel="modulepreload" href="/assets/calendar.d22d7d77.js">
|
|
<link rel="modulepreload" href="/assets/caret-bottom.05ac0d8f.js">
|
|
<link rel="modulepreload" href="/assets/chat-round.cb455b99.js">
|
|
<link rel="modulepreload" href="/assets/check.313c0b4b.js">
|
|
<link rel="modulepreload" href="/assets/icon.7ce85f22.js">
|
|
<link rel="modulepreload" href="/assets/delete.b7e01d39.js">
|
|
<link rel="modulepreload" href="/assets/document.6021cf74.js">
|
|
<link rel="modulepreload" href="/assets/zoom-in.42fb902e.js">
|
|
<link rel="modulepreload" href="/assets/edit.24a52114.js">
|
|
<link rel="modulepreload" href="/assets/info-filled.2696f3bb.js">
|
|
<link rel="modulepreload" href="/assets/user.5650fe5f.js">
|
|
<link rel="modulepreload" href="/assets/loading.64045cab.js">
|
|
<link rel="modulepreload" href="/assets/location.2b672bf2.js">
|
|
<link rel="modulepreload" href="/assets/setting.b40e9888.js">
|
|
<link rel="modulepreload" href="/assets/message.89ff9f82.js">
|
|
<link rel="modulepreload" href="/assets/minus.2dc70fa8.js">
|
|
<link rel="modulepreload" href="/assets/more-filled.18074571.js">
|
|
<link rel="modulepreload" href="/assets/picture.da85d8c7.js">
|
|
<link rel="modulepreload" href="/assets/plus.d5046c6a.js">
|
|
<link rel="modulepreload" href="/assets/search.c5a2773a.js">
|
|
<link rel="modulepreload" href="/assets/share.a661f856.js">
|
|
<link rel="modulepreload" href="/assets/star-filled.eb9945df.js">
|
|
<link rel="modulepreload" href="/assets/star.92ed7cf8.js">
|
|
<link rel="modulepreload" href="/assets/timer.5a092951.js">
|
|
<link rel="modulepreload" href="/assets/upload-filled.1d2ec357.js">
|
|
<link rel="modulepreload" href="/assets/upload.8e18ea12.js">
|
|
<link rel="modulepreload" href="/assets/user-filled.d3f6a60e.js">
|
|
<link rel="modulepreload" href="/assets/view.87f04a8a.js">
|
|
<link rel="modulepreload" href="/assets/index.df8f9a57.js">
|
|
<link rel="modulepreload" href="/assets/with-install.6f85bf09.js">
|
|
<link rel="modulepreload" href="/assets/dom.24aa0649.js">
|
|
<link rel="modulepreload" href="/assets/index.b5002239.js">
|
|
<link rel="modulepreload" href="/assets/dayjs.min.c5c5e36b.js">
|
|
<link rel="modulepreload" href="/assets/index.4ea24af8.js">
|
|
<link rel="modulepreload" href="/assets/index.88137bc5.js">
|
|
<link rel="modulepreload" href="/assets/index.6f2cd576.js">
|
|
<link rel="modulepreload" href="/assets/with-border.cf451218.js">
|
|
<link rel="modulepreload" href="/assets/en-US_component_checkbox.md.98199bb8.lean.js">
|
|
<link rel="modulepreload" href="/assets/app.eab0982e.js">
|
|
|
|
<link rel="icon" href="/images/element-plus-logo-small.svg">
|
|
<link rel="stylesheet" href="//fonts.loli.net/css?family=Inter:300,400,500,600|Open+Sans:400,600;display=swap">
|
|
<link rel="stylesheet" href="//unpkg.com/nprogress@0.2.0/nprogress.css">
|
|
<script>(()=>{window.supportedLangs=["en-US","zh-CN"]})();</script>
|
|
<script>(()=>{const o=window.supportedLangs,a="preferred_lang",s="en-US",c={en:"en-US",fr:"fr-FR",es:"es-ES"};let t=localStorage.getItem(a)||navigator.language;const n=c[t]||(o.includes(t)?t:s);if(localStorage.setItem(a,n),t=n,!location.pathname.startsWith(`/${t}`)){const e=[`/${t}`].concat(location.pathname.split("/").slice(2)).join("/");location.pathname=e.endsWith(".html")||e.endsWith("/")?e:e.concat("/")}})();</script>
|
|
<script async="true" src="https://www.googletagmanager.com/gtag/js?id=UA-175337989-1"></script>
|
|
<script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments)}gtag("js",new Date),gtag("config","UA-175337989-1");</script>
|
|
<meta name="twitter:title" content="Checkbox | Element Plus">
|
|
<meta property="og:title" content="Checkbox | Element Plus">
|
|
</head>
|
|
<body>
|
|
<div id="app"><div class="App"><!----><header class="navbar has-sidebar"><div class="navbar-wrapper" data-v-6f4bb8ce><div class="container" data-v-6f4bb8ce><div class="logo-container" data-v-6f4bb8ce><a href="/" data-v-6f4bb8ce><img class="logo" src="/images/element-plus-logo.svg" alt="Elemenet Plus Logo" data-v-6f4bb8ce></a></div><div class="content" data-v-6f4bb8ce><div id="docsearch" class="algolia-search-box search" data-v-6f4bb8ce></div><nav class="navbar-menu menu" data-v-6f4bb8ce><!--[--><!----><!----><!----><!----><!--]--></nav><!----><div class="translation-container translation" data-v-6f4bb8ce data-v-1e752d22><!----></div><div class="social-links" data-v-6f4bb8ce data-v-16ed5a92><!--[--><a href="https://github.com/element-plus/element-plus" title="GitHub" target="_blank" rel="noreferrer noopener" class="social-link" data-v-16ed5a92 data-v-4d8591cc><i class="el-icon" style="font-size:20px;" data-v-4d8591cc><!--[--><svg width="1.2em" height="1.2em" preserveaspectratio="xMidYMid meet" viewbox="0 0 24 24" data-v-4d8591cc><path d="M12 2C6.475 2 2 6.475 2 12a9.994 9.994 0 0 0 6.838 9.488c.5.087.687-.213.687-.476c0-.237-.013-1.024-.013-1.862c-2.512.463-3.162-.612-3.362-1.175c-.113-.288-.6-1.175-1.025-1.413c-.35-.187-.85-.65-.013-.662c.788-.013 1.35.725 1.538 1.025c.9 1.512 2.338 1.087 2.912.825c.088-.65.35-1.087.638-1.337c-2.225-.25-4.55-1.113-4.55-4.938c0-1.088.387-1.987 1.025-2.688c-.1-.25-.45-1.275.1-2.65c0 0 .837-.262 2.75 1.026a9.28 9.28 0 0 1 2.5-.338c.85 0 1.7.112 2.5.337c1.912-1.3 2.75-1.024 2.75-1.024c.55 1.375.2 2.4.1 2.65c.637.7 1.025 1.587 1.025 2.687c0 3.838-2.337 4.688-4.562 4.938c.362.312.675.912.675 1.85c0 1.337-.013 2.412-.013 2.75c0 .262.188.574.688.474A10.016 10.016 0 0 0 22 12c0-5.525-4.475-10-10-10z" fill="currentColor"></path></svg><!--]--></i></a><!--]--></div><div class="menu-hamburger hamburger" role="button" data-v-6f4bb8ce><span class="hamburger-1"></span><span class="hamburger-2"></span><span class="hamburger-3"></span></div></div></div></div><!----></header><div class="sub-nav"><div class="sidebar-button"><i class="el-icon" style="font-size:24px;"><!--[--><svg viewbox="0 0 24 24"><g fill="none"><path d="M4 6a1 1 0 0 1 1-1h14a1 1 0 1 1 0 2H5a1 1 0 0 1-1-1z" fill="currentColor"></path><path d="M4 18a1 1 0 0 1 1-1h14a1 1 0 1 1 0 2H5a1 1 0 0 1-1-1z" fill="currentColor"></path><path d="M11 11a1 1 0 1 0 0 2h8a1 1 0 1 0 0-2h-8z" fill="currentColor"></path></g></svg><!--]--></i></div><button class="el-button el-button--text el-button--default go-back-top" type="button" style=""><!--v-if--><span class=""><!--[-->Back to top<!--]--></span></button></div><aside class="sidebar"><!--[--><div class="sponsors" data-v-670cc81e><p class="sponsors-title" data-v-670cc81e>Sponsored by</p><div class="sponsor-item" data-v-670cc81e data-v-ab191046><a href="https://www.jnpfsoft.com/index.html?from=elementUI" title="jnpfsoft" target="_blank" data-v-ab191046><img src="/images/jnpfsoft.jpg" alt="jnpfsoft" data-v-ab191046></a></div><div class="container" data-v-670cc81e><!--[--><div class="sponsor-item" data-v-670cc81e data-v-0514baed><a href="https://bit.dev/?from=element-ui" title="bit" target="_blank" data-v-0514baed><img src="/images/bit.svg" alt="bit" data-v-0514baed></a></div><div class="sponsor-item" data-v-670cc81e data-v-0514baed><a href="https://www.renren.io/?from=element-ui" title="renren.io" target="_blank" data-v-0514baed><img src="/images/renren.png" alt="renren.io" data-v-0514baed></a></div><!--]--></div></div><!--]--><div class="sidebar-groups"><!--[--><section class="sidebar-group"><p class="sidebar-group__title">Basic</p><!--[--><a class="link" href="/en-US/component/button" data-v-7c07d156><p class="link-text" data-v-7c07d156>Button</p></a><a class="link" href="/en-US/component/border" data-v-7c07d156><p class="link-text" data-v-7c07d156>Border</p></a><a class="link" href="/en-US/component/color" data-v-7c07d156><p class="link-text" data-v-7c07d156>Color</p></a><a class="link" href="/en-US/component/container" data-v-7c07d156><p class="link-text" data-v-7c07d156>Layout Container</p></a><a class="link" href="/en-US/component/icon" data-v-7c07d156><p class="link-text" data-v-7c07d156>Icon</p></a><a class="link" href="/en-US/component/layout" data-v-7c07d156><p class="link-text" data-v-7c07d156>Layout</p></a><a class="link" href="/en-US/component/link" data-v-7c07d156><p class="link-text" data-v-7c07d156>Link</p></a><a class="link" href="/en-US/component/scrollbar" data-v-7c07d156><p class="link-text" data-v-7c07d156>Scrollbar</p></a><a class="link" href="/en-US/component/space" data-v-7c07d156><p class="link-text" data-v-7c07d156>Space</p></a><a class="link" href="/en-US/component/typography" data-v-7c07d156><p class="link-text" data-v-7c07d156>Typography</p></a><!--]--></section><section class="sidebar-group"><p class="sidebar-group__title">Configuration</p><!--[--><a class="link" href="/en-US/component/config-provider" data-v-7c07d156><p class="link-text" data-v-7c07d156>Config Provider</p></a><!--]--></section><section class="sidebar-group"><p class="sidebar-group__title">Form</p><!--[--><a class="link" href="/en-US/component/cascader" data-v-7c07d156><p class="link-text" data-v-7c07d156>Cascader</p></a><a class="link active" href="/en-US/component/checkbox" data-v-7c07d156><p class="link-text" data-v-7c07d156>Checkbox</p></a><a class="link" href="/en-US/component/color-picker" data-v-7c07d156><p class="link-text" data-v-7c07d156>Color Picker</p></a><a class="link" href="/en-US/component/date-picker" data-v-7c07d156><p class="link-text" data-v-7c07d156>Date Picker</p></a><a class="link" href="/en-US/component/datetime-picker" data-v-7c07d156><p class="link-text" data-v-7c07d156>DateTime Picker</p></a><a class="link" href="/en-US/component/form" data-v-7c07d156><p class="link-text" data-v-7c07d156>Form</p></a><a class="link" href="/en-US/component/input" data-v-7c07d156><p class="link-text" data-v-7c07d156>Input</p></a><a class="link" href="/en-US/component/input-number" data-v-7c07d156><p class="link-text" data-v-7c07d156>Input Number</p></a><a class="link" href="/en-US/component/radio" data-v-7c07d156><p class="link-text" data-v-7c07d156>Radio</p></a><a class="link" href="/en-US/component/rate" data-v-7c07d156><p class="link-text" data-v-7c07d156>Rate</p></a><a class="link" href="/en-US/component/select" data-v-7c07d156><p class="link-text" data-v-7c07d156>Select</p></a><a class="link" href="/en-US/component/select-v2" data-v-7c07d156><p class="link-text" data-v-7c07d156>Virtualized Select</p></a><a class="link" href="/en-US/component/slider" data-v-7c07d156><p class="link-text" data-v-7c07d156>Slider</p></a><a class="link" href="/en-US/component/switch" data-v-7c07d156><p class="link-text" data-v-7c07d156>Switch</p></a><a class="link" href="/en-US/component/time-picker" data-v-7c07d156><p class="link-text" data-v-7c07d156>Time Picker</p></a><a class="link" href="/en-US/component/time-select" data-v-7c07d156><p class="link-text" data-v-7c07d156>Time Select</p></a><a class="link" href="/en-US/component/transfer" data-v-7c07d156><p class="link-text" data-v-7c07d156>Transfer</p></a><a class="link" href="/en-US/component/upload" data-v-7c07d156><p class="link-text" data-v-7c07d156>Upload</p></a><!--]--></section><section class="sidebar-group"><p class="sidebar-group__title">Data</p><!--[--><a class="link" href="/en-US/component/avatar" data-v-7c07d156><p class="link-text" data-v-7c07d156>Avatar</p></a><a class="link" href="/en-US/component/badge" data-v-7c07d156><p class="link-text" data-v-7c07d156>Badge</p></a><a class="link" href="/en-US/component/calendar" data-v-7c07d156><p class="link-text" data-v-7c07d156>Calendar</p></a><a class="link" href="/en-US/component/card" data-v-7c07d156><p class="link-text" data-v-7c07d156>Card</p></a><a class="link" href="/en-US/component/carousel" data-v-7c07d156><p class="link-text" data-v-7c07d156>Carousel</p></a><a class="link" href="/en-US/component/collapse" data-v-7c07d156><p class="link-text" data-v-7c07d156>Collapse</p></a><a class="link" href="/en-US/component/descriptions" data-v-7c07d156><p class="link-text" data-v-7c07d156>Descriptions</p></a><a class="link" href="/en-US/component/empty" data-v-7c07d156><p class="link-text" data-v-7c07d156>Empty</p></a><a class="link" href="/en-US/component/image" data-v-7c07d156><p class="link-text" data-v-7c07d156>Image</p></a><a class="link" href="/en-US/component/infinite-scroll" data-v-7c07d156><p class="link-text" data-v-7c07d156>Infinite Scroll</p></a><a class="link" href="/en-US/component/pagination" data-v-7c07d156><p class="link-text" data-v-7c07d156>Pagination</p></a><a class="link" href="/en-US/component/progress" data-v-7c07d156><p class="link-text" data-v-7c07d156>Progress</p></a><a class="link" href="/en-US/component/result" data-v-7c07d156><p class="link-text" data-v-7c07d156>Result</p></a><a class="link" href="/en-US/component/skeleton" data-v-7c07d156><p class="link-text" data-v-7c07d156>Skeleton</p></a><a class="link" href="/en-US/component/table" data-v-7c07d156><p class="link-text" data-v-7c07d156>Table</p></a><a class="link" href="/en-US/component/tag" data-v-7c07d156><p class="link-text" data-v-7c07d156>Tag</p></a><a class="link" href="/en-US/component/timeline" data-v-7c07d156><p class="link-text" data-v-7c07d156>Timeline</p></a><a class="link" href="/en-US/component/tree" data-v-7c07d156><p class="link-text" data-v-7c07d156>Tree</p></a><a class="link" href="/en-US/component/tree-v2" data-v-7c07d156><p class="link-text" data-v-7c07d156>Virtualized Tree</p></a><!--]--></section><section class="sidebar-group"><p class="sidebar-group__title">Navigation</p><!--[--><a class="link" href="/en-US/component/affix" data-v-7c07d156><p class="link-text" data-v-7c07d156>Affix</p></a><a class="link" href="/en-US/component/breadcrumb" data-v-7c07d156><p class="link-text" data-v-7c07d156>Breadcrumb</p></a><a class="link" href="/en-US/component/dropdown" data-v-7c07d156><p class="link-text" data-v-7c07d156>Dropdown</p></a><a class="link" href="/en-US/component/menu" data-v-7c07d156><p class="link-text" data-v-7c07d156>Menu</p></a><a class="link" href="/en-US/component/page-header" data-v-7c07d156><p class="link-text" data-v-7c07d156>Page Header</p></a><a class="link" href="/en-US/component/steps" data-v-7c07d156><p class="link-text" data-v-7c07d156>Steps</p></a><a class="link" href="/en-US/component/tabs" data-v-7c07d156><p class="link-text" data-v-7c07d156>Tabs</p></a><!--]--></section><section class="sidebar-group"><p class="sidebar-group__title">Feedback</p><!--[--><a class="link" href="/en-US/component/alert" data-v-7c07d156><p class="link-text" data-v-7c07d156>Alert</p></a><a class="link" href="/en-US/component/dialog" data-v-7c07d156><p class="link-text" data-v-7c07d156>Dialog</p></a><a class="link" href="/en-US/component/drawer" data-v-7c07d156><p class="link-text" data-v-7c07d156>Drawer</p></a><a class="link" href="/en-US/component/loading" data-v-7c07d156><p class="link-text" data-v-7c07d156>Loading</p></a><a class="link" href="/en-US/component/message" data-v-7c07d156><p class="link-text" data-v-7c07d156>Message</p></a><a class="link" href="/en-US/component/message-box" data-v-7c07d156><p class="link-text" data-v-7c07d156>Message Box</p></a><a class="link" href="/en-US/component/notification" data-v-7c07d156><p class="link-text" data-v-7c07d156>Notification</p></a><a class="link" href="/en-US/component/popconfirm" data-v-7c07d156><p class="link-text" data-v-7c07d156>Pop Confirm</p></a><a class="link" href="/en-US/component/popover" data-v-7c07d156><p class="link-text" data-v-7c07d156>Popover</p></a><a class="link" href="/en-US/component/tooltip" data-v-7c07d156><p class="link-text" data-v-7c07d156>Tooltip</p></a><!--]--></section><section class="sidebar-group"><p class="sidebar-group__title">Others</p><!--[--><a class="link" href="/en-US/component/backtop" data-v-7c07d156><p class="link-text" data-v-7c07d156>Backtop</p></a><a class="link" href="/en-US/component/divider" data-v-7c07d156><p class="link-text" data-v-7c07d156>Divider</p></a><!--]--></section><!--]--></div><!--[--><!--]--></aside><main class="page-content has-sidebar"><div class="doc-content-wrapper"><div class="doc-content-container"><div style="position:relative;" class="doc-content"><div><h1 id="checkbox" tabindex="-1">Checkbox <a class="header-anchor" href="#checkbox" aria-hidden="true">#</a></h1><p>A group of options for multiple choices.</p><h2 id="basic-usage" tabindex="-1">Basic usage <a class="header-anchor" href="#basic-usage" aria-hidden="true">#</a></h2><p>Checkbox can be used alone to switch between two states.</p><!----><h2 id="disabled-state" tabindex="-1">Disabled State <a class="header-anchor" href="#disabled-state" aria-hidden="true">#</a></h2><p>Disabled state for checkbox.</p><!----><h2 id="checkbox-group" tabindex="-1">Checkbox group <a class="header-anchor" href="#checkbox-group" aria-hidden="true">#</a></h2><p>It is used for multiple checkboxes which are bound in one group, and indicates whether one option is selected by checking if it is checked.</p><!----><h2 id="indeterminate" tabindex="-1">Indeterminate <a class="header-anchor" href="#indeterminate" aria-hidden="true">#</a></h2><p>The <code>indeterminate</code> property can help you to achieve a 'check all' effect.</p><!----><h2 id="minimum-maximum-items-checked" tabindex="-1">Minimum / Maximum items checked <a class="header-anchor" href="#minimum-maximum-items-checked" aria-hidden="true">#</a></h2><p>The <code>min</code> and <code>max</code> properties can help you to limit the number of checked items.</p><!----><h2 id="button-style" tabindex="-1">Button style <a class="header-anchor" href="#button-style" aria-hidden="true">#</a></h2><p>Checkbox with button styles.</p><!----><h2 id="with-borders" tabindex="-1">With borders <a class="header-anchor" href="#with-borders" aria-hidden="true">#</a></h2><!----><h2 id="checkbox-attributes" tabindex="-1">Checkbox Attributes <a class="header-anchor" href="#checkbox-attributes" aria-hidden="true">#</a></h2><table><thead><tr><th>Attribute</th><th>Description</th><th>Type</th><th>Accepted Values</th><th>Default</th></tr></thead><tbody><tr><td>model-value / v-model</td><td>binding value</td><td>string / number / boolean</td><td>—</td><td>—</td></tr><tr><td>label</td><td>value of the Checkbox when used inside a <code>checkbox-group</code></td><td>string / number / boolean / object</td><td>—</td><td>—</td></tr><tr><td>true-label</td><td>value of the Checkbox if it's checked</td><td>string / number</td><td>—</td><td>—</td></tr><tr><td>false-label</td><td>value of the Checkbox if it's not checked</td><td>string / number</td><td>—</td><td>—</td></tr><tr><td>disabled</td><td>whether the Checkbox is disabled</td><td>boolean</td><td>—</td><td>false</td></tr><tr><td>border</td><td>whether to add a border around Checkbox</td><td>boolean</td><td>—</td><td>false</td></tr><tr><td>size</td><td>size of the Checkbox</td><td>string</td><td>large / default /small</td><td>—</td></tr><tr><td>name</td><td>native 'name' attribute</td><td>string</td><td>—</td><td>—</td></tr><tr><td>checked</td><td>if the Checkbox is checked</td><td>boolean</td><td>—</td><td>false</td></tr><tr><td>indeterminate</td><td>same as <code>indeterminate</code> in native checkbox</td><td>boolean</td><td>—</td><td>false</td></tr></tbody></table><h2 id="checkbox-events" tabindex="-1">Checkbox Events <a class="header-anchor" href="#checkbox-events" aria-hidden="true">#</a></h2><table><thead><tr><th>Event Name</th><th>Description</th><th>Parameters</th></tr></thead><tbody><tr><td>change</td><td>triggers when the binding value changes</td><td>the updated value</td></tr></tbody></table><h2 id="checkbox-slots" tabindex="-1">Checkbox Slots <a class="header-anchor" href="#checkbox-slots" aria-hidden="true">#</a></h2><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td>—</td><td>customize default content</td></tr></tbody></table><h2 id="checkbox-group-attributes" tabindex="-1">Checkbox-group Attributes <a class="header-anchor" href="#checkbox-group-attributes" aria-hidden="true">#</a></h2><table><thead><tr><th>Attribute</th><th>Description</th><th>Type</th><th>Accepted Values</th><th>Default</th></tr></thead><tbody><tr><td>model-value / v-model</td><td>binding value</td><td>array</td><td>—</td><td>[]</td></tr><tr><td>size</td><td>size of checkbox</td><td>string</td><td>large / default /small</td><td>—</td></tr><tr><td>disabled</td><td>whether the nesting checkboxes are disabled</td><td>boolean</td><td>—</td><td>false</td></tr><tr><td>min</td><td>minimum number of checkbox checked</td><td>number</td><td>—</td><td>—</td></tr><tr><td>max</td><td>maximum number of checkbox checked</td><td>number</td><td>—</td><td>—</td></tr><tr><td>text-color</td><td>font color when button is active</td><td>string</td><td>—</td><td>#ffffff</td></tr><tr><td>fill</td><td>border and background color when button is active</td><td>string</td><td>—</td><td>#409EFF</td></tr></tbody></table><h2 id="checkbox-group-events" tabindex="-1">Checkbox-group Events <a class="header-anchor" href="#checkbox-group-events" aria-hidden="true">#</a></h2><table><thead><tr><th>Event Name</th><th>Description</th><th>Parameters</th></tr></thead><tbody><tr><td>change</td><td>triggers when the binding value changes</td><td>the updated value</td></tr></tbody></table><h2 id="checkbox-group-slots" tabindex="-1">Checkbox-group Slots <a class="header-anchor" href="#checkbox-group-slots" aria-hidden="true">#</a></h2><table><thead><tr><th>Name</th><th>Description</th><th>Subtags</th></tr></thead><tbody><tr><td>-</td><td>customize default content</td><td>Checkbox / Checkbox-button</td></tr></tbody></table><h2 id="checkbox-button-attributes" tabindex="-1">Checkbox-button Attributes <a class="header-anchor" href="#checkbox-button-attributes" aria-hidden="true">#</a></h2><table><thead><tr><th>Attribute</th><th>Description</th><th>Type</th><th>Accepted Values</th><th>Default</th></tr></thead><tbody><tr><td>label</td><td>value of the checkbox when used inside a <code>checkbox-group</code></td><td>string / number / boolean / object</td><td>—</td><td>—</td></tr><tr><td>true-label</td><td>value of the checkbox if it's checked</td><td>string / number</td><td>—</td><td>—</td></tr><tr><td>false-label</td><td>value of the checkbox if it's not checked</td><td>string / number</td><td>—</td><td>—</td></tr><tr><td>disabled</td><td>whether the checkbox is disabled</td><td>boolean</td><td>—</td><td>false</td></tr><tr><td>name</td><td>native 'name' attribute</td><td>string</td><td>—</td><td>—</td></tr><tr><td>checked</td><td>if the checkbox is checked</td><td>boolean</td><td>—</td><td>false</td></tr></tbody></table><h2 id="checkbox-button-slots" tabindex="-1">Checkbox-button Slots <a class="header-anchor" href="#checkbox-button-slots" aria-hidden="true">#</a></h2><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td>—</td><td>customize default content</td></tr></tbody></table></div></div><footer class="page-footer" data-v-d1dc05ac><div class="edit" data-v-d1dc05ac><div class="edit-link" data-v-d1dc05ac data-v-6ef31e8a><a class="link text-sm" href="https://github.com/element-plus/element-plus/edit/dev/docs/en-US/component/checkbox.md" target="_blank" rel="noopener noreferrer" data-v-6ef31e8a>Edit this page on GitHub <i class="el-icon" style="font-size:16px;vertical-align:text-top;line-height:24px;" data-v-6ef31e8a><!--[--><svg width="1.2em" height="1.2em" preserveaspectratio="xMidYMid meet" viewbox="0 0 24 24" data-v-6ef31e8a><path d="M10 6v2H5v11h11v-5h2v6a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V7a1 1 0 0 1 1-1h6zm11-3v8h-2V6.413l-7.793 7.794l-1.414-1.414L17.585 5H13V3h8z" fill="currentColor"></path></svg><!--]--></i></a></div></div><div class="updated" data-v-d1dc05ac><p class="last-updated text-sm" data-v-d1dc05ac data-v-1caaffb8><span class="prefix" data-v-1caaffb8>Last Updated:</span><span class="datetime" data-v-1caaffb8></span></p></div></footer><div class="next-and-prev-link" data-v-74a5b853><div class="container" data-v-74a5b853><div class="prev" data-v-74a5b853><a class="link" href="/en-US/component/cascader" data-v-74a5b853><i class="el-icon" style="" data-v-74a5b853><!--[--><svg class="icon" width="200" height="200" viewbox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" data-v-74a5b853><path fill="currentColor" d="M609.408 149.376L277.76 489.6a32 32 0 000 44.672l331.648 340.352a29.12 29.12 0 0041.728 0 30.592 30.592 0 000-42.752L339.264 511.936l311.872-319.872a30.592 30.592 0 000-42.688 29.12 29.12 0 00-41.728 0z"></path></svg><!--]--></i><span class="text" data-v-74a5b853>Cascader</span></a></div><div class="next" data-v-74a5b853><a class="link" href="/en-US/component/color-picker" data-v-74a5b853><span class="text" data-v-74a5b853>Color Picker</span><i class="el-icon" style="" data-v-74a5b853><!--[--><svg class="icon" width="200" height="200" viewbox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" data-v-74a5b853><path fill="currentColor" d="M340.864 149.312a30.592 30.592 0 000 42.752L652.736 512 340.864 831.872a30.592 30.592 0 000 42.752 29.12 29.12 0 0041.728 0L714.24 534.336a32 32 0 000-44.672L382.592 149.376a29.12 29.12 0 00-41.728 0z"></path></svg><!--]--></i></a></div></div></div></div><aside ref_key="container" class="toc-wrapper"><nav class="toc-content"><h3 class="toc-content__heading">Contents</h3><ul class="toc-items"><!--[--><li class="toc-item"><a class="toc-link" href="#basic-usage">Basic usage</a><!----></li><li class="toc-item"><a class="toc-link" href="#disabled-state">Disabled State</a><!----></li><li class="toc-item"><a class="toc-link" href="#checkbox-group">Checkbox group</a><!----></li><li class="toc-item"><a class="toc-link" href="#indeterminate">Indeterminate</a><!----></li><li class="toc-item"><a class="toc-link" href="#minimum-maximum-items-checked">Minimum / Maximum items checked</a><!----></li><li class="toc-item"><a class="toc-link" href="#button-style">Button style</a><!----></li><li class="toc-item"><a class="toc-link" href="#with-borders">With borders</a><!----></li><li class="toc-item"><a class="toc-link" href="#checkbox-attributes">Checkbox Attributes</a><!----></li><li class="toc-item"><a class="toc-link" href="#checkbox-events">Checkbox Events</a><!----></li><li class="toc-item"><a class="toc-link" href="#checkbox-slots">Checkbox Slots</a><!----></li><li class="toc-item"><a class="toc-link" href="#checkbox-group-attributes">Checkbox-group Attributes</a><!----></li><li class="toc-item"><a class="toc-link" href="#checkbox-group-events">Checkbox-group Events</a><!----></li><li class="toc-item"><a class="toc-link" href="#checkbox-group-slots">Checkbox-group Slots</a><!----></li><li class="toc-item"><a class="toc-link" href="#checkbox-button-attributes">Checkbox-button Attributes</a><!----></li><li class="toc-item"><a class="toc-link" href="#checkbox-button-slots">Checkbox-button Slots</a><!----></li><!--]--></ul><div class="toc-marker"></div></nav></aside></div></main><!----></div></div>
|
|
<script>__VP_HASH_MAP__ = JSON.parse("{\"en-us_component_affix.md\":\"0f48800c\",\"en-us_component_alert.md\":\"b402e266\",\"en-us_component_avatar.md\":\"75b085d7\",\"en-us_component_backtop.md\":\"ce22e9f9\",\"en-us_component_badge.md\":\"94faff6a\",\"en-us_component_border.md\":\"84592266\",\"en-us_component_breadcrumb.md\":\"dd7b3886\",\"en-us_component_button.md\":\"2ec760d3\",\"en-us_component_calendar.md\":\"f263fac7\",\"en-us_component_card.md\":\"f16028eb\",\"en-us_component_carousel.md\":\"1141d0a6\",\"en-us_component_cascader.md\":\"3efd1701\",\"en-us_component_checkbox.md\":\"98199bb8\",\"en-us_component_collapse.md\":\"90de4ff0\",\"en-us_component_color-picker.md\":\"0e98f8c0\",\"en-us_component_color.md\":\"006ddc65\",\"en-us_component_config-provider.md\":\"95ca29e8\",\"en-us_component_container.md\":\"8d0c0c96\",\"en-us_component_date-picker.md\":\"9cbbea09\",\"en-us_component_datetime-picker.md\":\"92033484\",\"en-us_component_descriptions.md\":\"4229ae26\",\"en-us_component_dialog.md\":\"33d86856\",\"en-us_component_divider.md\":\"6e7e6ddb\",\"en-us_component_drawer.md\":\"9670c9b4\",\"en-us_component_dropdown.md\":\"deb9221d\",\"en-us_component_empty.md\":\"792bcfa1\",\"en-us_component_form.md\":\"4456cbee\",\"en-us_component_icon.md\":\"89b1f258\",\"en-us_component_image.md\":\"107ca9e7\",\"en-us_component_infinite-scroll.md\":\"377f08f3\",\"en-us_component_input-number.md\":\"1dd40c73\",\"en-us_component_input.md\":\"25fc2c33\",\"en-us_component_layout.md\":\"78a47460\",\"en-us_component_link.md\":\"4ac4fa5d\",\"en-us_component_loading.md\":\"b9b8bdc7\",\"en-us_component_menu.md\":\"4793d117\",\"en-us_component_message-box.md\":\"ab637caf\",\"en-us_component_message.md\":\"8f9dc8c3\",\"en-us_component_notification.md\":\"fe6be74e\",\"en-us_component_page-header.md\":\"9810b376\",\"en-us_component_pagination.md\":\"4b279ddf\",\"en-us_component_popconfirm.md\":\"b7e184b7\",\"en-us_component_popover.md\":\"284c2aba\",\"en-us_component_progress.md\":\"a7e4a5c7\",\"en-us_component_radio.md\":\"9ac5fe39\",\"en-us_component_rate.md\":\"bf1ba641\",\"en-us_component_result.md\":\"bf487f64\",\"en-us_component_scrollbar.md\":\"930dd71d\",\"en-us_component_select-v2.md\":\"d929522b\",\"en-us_component_select.md\":\"989e330c\",\"en-us_component_skeleton.md\":\"91f9fb7c\",\"en-us_component_slider.md\":\"297c81a4\",\"en-us_component_space.md\":\"1b625c1e\",\"en-us_component_steps.md\":\"50cbc06a\",\"en-us_component_switch.md\":\"b4fd3c26\",\"en-us_component_table.md\":\"76ba5c37\",\"en-us_component_tabs.md\":\"1a19c5f1\",\"en-us_component_tag.md\":\"2033eb2e\",\"en-us_component_time-picker.md\":\"33246fcc\",\"en-us_component_time-select.md\":\"aea4b1c0\",\"en-us_component_timeline.md\":\"62ce00a2\",\"en-us_component_tooltip.md\":\"63df5695\",\"en-us_component_transfer.md\":\"ef61c01c\",\"en-us_component_tree-v2.md\":\"6c384b58\",\"en-us_component_tree.md\":\"dd6d4dab\",\"en-us_component_typography.md\":\"2134b4ce\",\"en-us_component_upload.md\":\"11d52c59\",\"en-us_guide_changelog.md\":\"b9a921ef\",\"en-us_guide_design.md\":\"b18cd94e\",\"en-us_guide_i18n.md\":\"9e49c157\",\"en-us_guide_installation.md\":\"f7a065cd\",\"en-us_guide_migration.md\":\"347bf33f\",\"en-us_guide_nav.md\":\"58ff2828\",\"en-us_guide_quickstart.md\":\"7f8f12b0\",\"en-us_guide_theming.md\":\"36558cba\",\"en-us_guide_transitions.md\":\"82b5b7c3\",\"en-us_index.md\":\"85d2acce\",\"en-us_resource_index.md\":\"07767eb2\",\"index.md\":\"dae1a15f\",\"zh-cn_component_affix.md\":\"58da349a\",\"zh-cn_component_alert.md\":\"8f822c6e\",\"zh-cn_component_avatar.md\":\"3e012d9f\",\"zh-cn_component_backtop.md\":\"17cca067\",\"zh-cn_component_badge.md\":\"7fdd36d8\",\"zh-cn_component_border.md\":\"c186a767\",\"zh-cn_component_breadcrumb.md\":\"b023a2ef\",\"zh-cn_component_button.md\":\"95c771c2\",\"zh-cn_component_calendar.md\":\"342814d0\",\"zh-cn_component_card.md\":\"671d69d3\",\"zh-cn_component_carousel.md\":\"0a8d247d\",\"zh-cn_component_cascader.md\":\"886f6217\",\"zh-cn_component_checkbox.md\":\"3493f5f9\",\"zh-cn_component_collapse.md\":\"26e7ae1e\",\"zh-cn_component_color-picker.md\":\"9599dc23\",\"zh-cn_component_color.md\":\"c9782f71\",\"zh-cn_component_config-provider.md\":\"870f7a5a\",\"zh-cn_component_container.md\":\"d138505d\",\"zh-cn_component_date-picker.md\":\"486804d1\",\"zh-cn_component_datetime-picker.md\":\"2f6a8627\",\"zh-cn_component_descriptions.md\":\"f0dcc9c9\",\"zh-cn_component_dialog.md\":\"860ba84c\",\"zh-cn_component_divider.md\":\"4c755245\",\"zh-cn_component_drawer.md\":\"988dfe4d\",\"zh-cn_component_dropdown.md\":\"b64c3c4e\",\"zh-cn_component_empty.md\":\"b0d35b07\",\"zh-cn_component_form.md\":\"1590fdfe\",\"zh-cn_component_icon.md\":\"faaee863\",\"zh-cn_component_image.md\":\"abdb7d58\",\"zh-cn_component_infinite-scroll.md\":\"a6dc9162\",\"zh-cn_component_input-number.md\":\"4558ef47\",\"zh-cn_component_input.md\":\"8f871205\",\"zh-cn_component_layout.md\":\"7e6cf394\",\"zh-cn_component_link.md\":\"e60ca3f2\",\"zh-cn_component_loading.md\":\"e2c2e4db\",\"zh-cn_component_menu.md\":\"ea27dece\",\"zh-cn_component_message-box.md\":\"4c9eef07\",\"zh-cn_component_message.md\":\"7a1c5d9a\",\"zh-cn_component_notification.md\":\"e1890f99\",\"zh-cn_component_page-header.md\":\"20097d01\",\"zh-cn_component_pagination.md\":\"8f0f3014\",\"zh-cn_component_popconfirm.md\":\"9ec20849\",\"zh-cn_component_popover.md\":\"cea84814\",\"zh-cn_component_progress.md\":\"93112d58\",\"zh-cn_component_radio.md\":\"0dc87056\",\"zh-cn_component_rate.md\":\"b5454bf9\",\"zh-cn_component_result.md\":\"762acdc8\",\"zh-cn_component_scrollbar.md\":\"90e86380\",\"zh-cn_component_select-v2.md\":\"801d9d86\",\"zh-cn_component_select.md\":\"0072b87f\",\"zh-cn_component_skeleton.md\":\"a48c6789\",\"zh-cn_component_slider.md\":\"b517e09c\",\"zh-cn_component_space.md\":\"63fc1cdc\",\"zh-cn_component_steps.md\":\"3c83dd7a\",\"zh-cn_component_switch.md\":\"2b3edae5\",\"zh-cn_component_table.md\":\"ec0d5cd9\",\"zh-cn_component_tabs.md\":\"7bdd0364\",\"zh-cn_component_tag.md\":\"8828937c\",\"zh-cn_component_time-picker.md\":\"3473e489\",\"zh-cn_component_time-select.md\":\"be049441\",\"zh-cn_component_timeline.md\":\"b4675a65\",\"zh-cn_component_tooltip.md\":\"8978580a\",\"zh-cn_component_transfer.md\":\"a7e45fe0\",\"zh-cn_component_tree-v2.md\":\"5ea0f1f3\",\"zh-cn_component_tree.md\":\"9630fac6\",\"zh-cn_component_typography.md\":\"ea91b0b4\",\"zh-cn_component_upload.md\":\"b853716c\",\"zh-cn_guide_changelog.md\":\"7aa414cd\",\"zh-cn_guide_design.md\":\"68182fb1\",\"zh-cn_guide_i18n.md\":\"50df2185\",\"zh-cn_guide_installation.md\":\"272703d5\",\"zh-cn_guide_migration.md\":\"0650a9cd\",\"zh-cn_guide_nav.md\":\"34d5a385\",\"zh-cn_guide_quickstart.md\":\"ad7f3588\",\"zh-cn_guide_theming.md\":\"8ea40d7b\",\"zh-cn_guide_transitions.md\":\"2a4b6dfe\",\"zh-cn_index.md\":\"5cbd6b32\",\"zh-cn_resource_index.md\":\"bdb754f7\"}")</script>
|
|
<script type="module" async src="/assets/app.eab0982e.js"></script>
|
|
|
|
</body>
|
|
</html> |