mirror of
https://github.com/element-plus/element-plus.git
synced 2025-02-17 11:49:41 +08:00
30 lines
34 KiB
HTML
30 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 Vue 3 based component library for designers and developers">
|
||
<link rel="stylesheet" href="/assets/style.b0283613.css">
|
||
<link rel="modulepreload" href="/assets/chunks/with-border.f3c74fa4.js">
|
||
<link rel="modulepreload" href="/assets/app.e5926f2b.js">
|
||
<link rel="modulepreload" href="/assets/en-US_component_checkbox.md.d06afd93.lean.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>
|
||
<script>(function(t,s,n,h,j,e){t.hj=t.hj||function(){(t.hj.q=t.hj.q||[]).push(arguments)},t._hjSettings={hjid:2894908,hjsv:6},j=s.getElementsByTagName("head")[0],e=s.createElement("script"),e.async=1,e.src=n+t._hjSettings.hjid+h+t._hjSettings.hjsv,j.appendChild(e)})(window,document,"https://static.hotjar.com/c/hotjar-",".js?sv=");</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-60516214><div class="container" data-v-60516214><div class="logo-container" data-v-60516214><a href="/" data-v-60516214><img class="logo" src="/images/element-plus-logo.svg" alt="Element Plus Logo" data-v-60516214></a></div><div class="content" data-v-60516214><div id="docsearch" class="algolia-search-box search" data-v-60516214></div><nav class="navbar-menu menu" data-v-60516214><!--[--><a class="link-item link is-menu-link" href="/en-US/guide/design" data-v-3d10afe9 data-v-36735cb0><!--[--><!--[-->Guide<!--]--><!--]--><!----></a><a class="link-item link is-menu-link active" href="/en-US/component/button" data-v-3d10afe9 data-v-36735cb0><!--[--><!--[-->Component<!--]--><!--]--><!----></a><a class="link-item link is-menu-link" href="/en-US/resource/index" data-v-3d10afe9 data-v-36735cb0><!--[--><!--[-->Resource<!--]--><!--]--><!----></a><!--]--></nav><!----><div class="translation-container translation" data-v-60516214 data-v-7b010d8a><!----></div><div class="social-links" data-v-60516214 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="1em" height="1em" preserveaspectratio="xMidYMid meet" viewbox="0 0 24 24" data-v-4d8591cc><path fill="currentColor" 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"></path></svg><!--]--></i></a><!--]--></div><div class="menu-hamburger hamburger" role="button" data-v-60516214><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 ref_key="_ref" class="el-button el-button--text go-back-top" type="button" style=""><!--v-if--><span class=""><!--[-->Back to top<!--]--></span></button></div><aside class="sidebar"><!--[--><div class="sponsors" data-v-147db1c1><p class="sponsors-title" data-v-147db1c1>Sponsored by</p><div class="container" data-v-147db1c1 data-v-3cc4c30a><!--[--><div class="sponsor-item" data-v-3cc4c30a><a href="https://www.jnpfsoft.com/index.html?from=elementUI" title="JNPF - JNPF 低代码开发平台，让开发变得简单！" target="_blank" data-v-3cc4c30a><img src="/images/jnpfsoft.jpg" alt="JNPF" data-v-3cc4c30a></a></div><div class="sponsor-item" data-v-3cc4c30a><a href="https://vform666.com/vform3.html?from=element_plus" title="VForm - Vue 3 可视化/低代码表单" target="_blank" data-v-3cc4c30a><img src="/images/vform-banner.jpg" alt="VForm" data-v-3cc4c30a></a></div><div class="sponsor-item" data-v-3cc4c30a><a href="https://js.design?source=element-plus" title="即时设计 - 专业在线UI设计工具" target="_blank" data-v-3cc4c30a><img src="/images/js-design-banner.jpg" alt="JSDesign" data-v-3cc4c30a></a></div><!--]--></div><div class="container" data-v-147db1c1 data-v-6a5f24f2><!--[--><div class="sponsor-item" data-v-6a5f24f2><a href="https://bit.dev/?from=element-ui" title="bit - Share Code" target="_blank" data-v-6a5f24f2><img src="/images/bit.svg" alt="bit" data-v-6a5f24f2></a></div><div class="sponsor-item" data-v-6a5f24f2><a href="https://www.renren.io/?from=element-ui" title="人人开源 - 企业级的快速开发平台" target="_blank" data-v-6a5f24f2><img src="/images/renren.png" alt="renren.io" data-v-6a5f24f2></a></div><div class="sponsor-item" data-v-6a5f24f2><a href="https://form.making.link/?from=element_plus" title="FormMaking - Vue表单设计器，赋能企业快速开发" target="_blank" data-v-6a5f24f2><img src="/images/formmaking.png" alt="FormMaking" data-v-6a5f24f2></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-01281280><p class="link-text" data-v-01281280>Button</p><!----></a><a class="link" href="/en-US/component/border" data-v-01281280><p class="link-text" data-v-01281280>Border</p><!----></a><a class="link" href="/en-US/component/color" data-v-01281280><p class="link-text" data-v-01281280>Color</p><!----></a><a class="link" href="/en-US/component/container" data-v-01281280><p class="link-text" data-v-01281280>Layout Container</p><!----></a><a class="link" href="/en-US/component/icon" data-v-01281280><p class="link-text" data-v-01281280>Icon</p><!----></a><a class="link" href="/en-US/component/layout" data-v-01281280><p class="link-text" data-v-01281280>Layout</p><!----></a><a class="link" href="/en-US/component/link" data-v-01281280><p class="link-text" data-v-01281280>Link</p><!----></a><a class="link" href="/en-US/component/scrollbar" data-v-01281280><p class="link-text" data-v-01281280>Scrollbar</p><!----></a><a class="link" href="/en-US/component/space" data-v-01281280><p class="link-text" data-v-01281280>Space</p><!----></a><a class="link" href="/en-US/component/typography" data-v-01281280><p class="link-text" data-v-01281280>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-01281280><p class="link-text" data-v-01281280>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-01281280><p class="link-text" data-v-01281280>Cascader</p><!----></a><a class="link active" href="/en-US/component/checkbox" data-v-01281280><p class="link-text" data-v-01281280>Checkbox</p><!----></a><a class="link" href="/en-US/component/color-picker" data-v-01281280><p class="link-text" data-v-01281280>Color Picker</p><!----></a><a class="link" href="/en-US/component/date-picker" data-v-01281280><p class="link-text" data-v-01281280>Date Picker</p><!----></a><a class="link" href="/en-US/component/datetime-picker" data-v-01281280><p class="link-text" data-v-01281280>DateTime Picker</p><!----></a><a class="link" href="/en-US/component/form" data-v-01281280><p class="link-text" data-v-01281280>Form</p><!----></a><a class="link" href="/en-US/component/input" data-v-01281280><p class="link-text" data-v-01281280>Input</p><!----></a><a class="link" href="/en-US/component/input-number" data-v-01281280><p class="link-text" data-v-01281280>Input Number</p><!----></a><a class="link" href="/en-US/component/radio" data-v-01281280><p class="link-text" data-v-01281280>Radio</p><!----></a><a class="link" href="/en-US/component/rate" data-v-01281280><p class="link-text" data-v-01281280>Rate</p><!----></a><a class="link" href="/en-US/component/select" data-v-01281280><p class="link-text" data-v-01281280>Select</p><!----></a><a class="link" href="/en-US/component/select-v2" data-v-01281280><p class="link-text" data-v-01281280>Virtualized Select</p><!----></a><a class="link" href="/en-US/component/slider" data-v-01281280><p class="link-text" data-v-01281280>Slider</p><!----></a><a class="link" href="/en-US/component/switch" data-v-01281280><p class="link-text" data-v-01281280>Switch</p><!----></a><a class="link" href="/en-US/component/time-picker" data-v-01281280><p class="link-text" data-v-01281280>Time Picker</p><!----></a><a class="link" href="/en-US/component/time-select" data-v-01281280><p class="link-text" data-v-01281280>Time Select</p><!----></a><a class="link" href="/en-US/component/transfer" data-v-01281280><p class="link-text" data-v-01281280>Transfer</p><!----></a><a class="link" href="/en-US/component/upload" data-v-01281280><p class="link-text" data-v-01281280>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-01281280><p class="link-text" data-v-01281280>Avatar</p><!----></a><a class="link" href="/en-US/component/badge" data-v-01281280><p class="link-text" data-v-01281280>Badge</p><!----></a><a class="link" href="/en-US/component/calendar" data-v-01281280><p class="link-text" data-v-01281280>Calendar</p><!----></a><a class="link" href="/en-US/component/card" data-v-01281280><p class="link-text" data-v-01281280>Card</p><!----></a><a class="link" href="/en-US/component/carousel" data-v-01281280><p class="link-text" data-v-01281280>Carousel</p><!----></a><a class="link" href="/en-US/component/collapse" data-v-01281280><p class="link-text" data-v-01281280>Collapse</p><!----></a><a class="link" href="/en-US/component/descriptions" data-v-01281280><p class="link-text" data-v-01281280>Descriptions</p><!----></a><a class="link" href="/en-US/component/empty" data-v-01281280><p class="link-text" data-v-01281280>Empty</p><!----></a><a class="link" href="/en-US/component/image" data-v-01281280><p class="link-text" data-v-01281280>Image</p><!----></a><a class="link" href="/en-US/component/infinite-scroll" data-v-01281280><p class="link-text" data-v-01281280>Infinite Scroll</p><!----></a><a class="link" href="/en-US/component/pagination" data-v-01281280><p class="link-text" data-v-01281280>Pagination</p><!----></a><a class="link" href="/en-US/component/progress" data-v-01281280><p class="link-text" data-v-01281280>Progress</p><!----></a><a class="link" href="/en-US/component/result" data-v-01281280><p class="link-text" data-v-01281280>Result</p><!----></a><a class="link" href="/en-US/component/skeleton" data-v-01281280><p class="link-text" data-v-01281280>Skeleton</p><!----></a><a class="link" href="/en-US/component/table" data-v-01281280><p class="link-text" data-v-01281280>Table</p><!----></a><a class="link" href="/en-US/component/tag" data-v-01281280><p class="link-text" data-v-01281280>Tag</p><!----></a><a class="link" href="/en-US/component/timeline" data-v-01281280><p class="link-text" data-v-01281280>Timeline</p><!----></a><a class="link" href="/en-US/component/tree" data-v-01281280><p class="link-text" data-v-01281280>Tree</p><!----></a><a class="link" href="/en-US/component/tree-v2" data-v-01281280><p class="link-text" data-v-01281280>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-01281280><p class="link-text" data-v-01281280>Affix</p><!----></a><a class="link" href="/en-US/component/backtop" data-v-01281280><p class="link-text" data-v-01281280>Backtop</p><!----></a><a class="link" href="/en-US/component/breadcrumb" data-v-01281280><p class="link-text" data-v-01281280>Breadcrumb</p><!----></a><a class="link" href="/en-US/component/dropdown" data-v-01281280><p class="link-text" data-v-01281280>Dropdown</p><!----></a><a class="link" href="/en-US/component/menu" data-v-01281280><p class="link-text" data-v-01281280>Menu</p><!----></a><a class="link" href="/en-US/component/page-header" data-v-01281280><p class="link-text" data-v-01281280>Page Header</p><!----></a><a class="link" href="/en-US/component/steps" data-v-01281280><p class="link-text" data-v-01281280>Steps</p><!----></a><a class="link" href="/en-US/component/tabs" data-v-01281280><p class="link-text" data-v-01281280>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-01281280><p class="link-text" data-v-01281280>Alert</p><!----></a><a class="link" href="/en-US/component/dialog" data-v-01281280><p class="link-text" data-v-01281280>Dialog</p><!----></a><a class="link" href="/en-US/component/drawer" data-v-01281280><p class="link-text" data-v-01281280>Drawer</p><!----></a><a class="link" href="/en-US/component/loading" data-v-01281280><p class="link-text" data-v-01281280>Loading</p><!----></a><a class="link" href="/en-US/component/message" data-v-01281280><p class="link-text" data-v-01281280>Message</p><!----></a><a class="link" href="/en-US/component/message-box" data-v-01281280><p class="link-text" data-v-01281280>Message Box</p><!----></a><a class="link" href="/en-US/component/notification" data-v-01281280><p class="link-text" data-v-01281280>Notification</p><!----></a><a class="link" href="/en-US/component/popconfirm" data-v-01281280><p class="link-text" data-v-01281280>Pop Confirm</p><!----></a><a class="link" href="/en-US/component/popover" data-v-01281280><p class="link-text" data-v-01281280>Popover</p><!----></a><a class="link" href="/en-US/component/tooltip" data-v-01281280><p class="link-text" data-v-01281280>Tooltip</p><!----></a><!--]--></section><section class="sidebar-group"><p class="sidebar-group__title">Others</p><!--[--><a class="link" href="/en-US/component/divider" data-v-01281280><p class="link-text" data-v-01281280>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-7d4aa2c8><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-7d4aa2c8>Edit this page on GitHub <i class="el-icon" style="font-size:16px;vertical-align:text-top;line-height:24px;" data-v-7d4aa2c8><!--[--><svg width="1em" height="1em" preserveaspectratio="xMidYMid meet" viewbox="0 0 24 24" data-v-7d4aa2c8><path fill="currentColor" 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"></path></svg><!--]--></i></a></div></div><div class="updated" data-v-d1dc05ac><p class="last-updated text-sm" data-v-d1dc05ac data-v-2a7b81a2><span class="prefix" data-v-2a7b81a2>Last Updated:</span><span class="datetime" data-v-2a7b81a2></span></p></div></footer><div class="next-and-prev-link" data-v-8ad25866><div class="container" data-v-8ad25866><div class="prev" data-v-8ad25866><a class="link" href="/en-US/component/cascader" data-v-8ad25866><i class="el-icon mr-1" style="" data-v-8ad25866><!--[--><svg viewbox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" data-v-8ad25866><path fill="currentColor" d="M609.408 149.376 277.76 489.6a32 32 0 0 0 0 44.672l331.648 340.352a29.12 29.12 0 0 0 41.728 0 30.592 30.592 0 0 0 0-42.752L339.264 511.936l311.872-319.872a30.592 30.592 0 0 0 0-42.688 29.12 29.12 0 0 0-41.728 0z"></path></svg><!--]--></i><span class="text" data-v-8ad25866>Cascader</span></a></div><div class="next" data-v-8ad25866><a class="link" href="/en-US/component/color-picker" data-v-8ad25866><span class="text" data-v-8ad25866>Color Picker</span><i class="el-icon ml-1" style="" data-v-8ad25866><!--[--><svg viewbox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" data-v-8ad25866><path fill="currentColor" d="M340.864 149.312a30.592 30.592 0 0 0 0 42.752L652.736 512 340.864 831.872a30.592 30.592 0 0 0 0 42.752 29.12 29.12 0 0 0 41.728 0L714.24 534.336a32 32 0 0 0 0-44.672L382.592 149.376a29.12 29.12 0 0 0-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><div class="join mt-8"><!--[--><a href="mailto:element-plus@outlook.com" target="_blank" class="el-tooltip__trigger"><button ref_key="_ref" class="el-button" type="button" style=""><!--v-if--><span class=""><!--[-->Become a Sponsor!<!--]--></span></button></a><!--teleport start--><!--teleport end--><!--]--></div></nav></aside></div></main><!----></div></div>
|
||
<script>__VP_HASH_MAP__ = JSON.parse("{\"en-us_component_affix.md\":\"b7d5fab0\",\"en-us_component_alert.md\":\"79b9da06\",\"en-us_component_avatar.md\":\"8f88c052\",\"en-us_component_backtop.md\":\"f64cb7d2\",\"en-us_component_badge.md\":\"8e924af8\",\"en-us_component_border.md\":\"a4943592\",\"en-us_component_breadcrumb.md\":\"8b166f31\",\"en-us_component_button.md\":\"904235cc\",\"en-us_component_calendar.md\":\"25490903\",\"en-us_component_card.md\":\"c57bbc25\",\"en-us_component_carousel.md\":\"a137a58f\",\"en-us_component_cascader.md\":\"de47ee8d\",\"en-us_component_checkbox.md\":\"d06afd93\",\"en-us_component_collapse.md\":\"132e152b\",\"en-us_component_color-picker.md\":\"cff836b3\",\"en-us_component_color.md\":\"8705a5b0\",\"en-us_component_config-provider.md\":\"ce3edf80\",\"en-us_component_container.md\":\"a9d04757\",\"en-us_component_date-picker.md\":\"10f47edf\",\"en-us_component_datetime-picker.md\":\"35a2386f\",\"en-us_component_descriptions.md\":\"0e5520a5\",\"en-us_component_dialog.md\":\"ff5dddcf\",\"en-us_component_divider.md\":\"de786d3a\",\"en-us_component_drawer.md\":\"eae3d3a2\",\"en-us_component_dropdown.md\":\"e4c2c234\",\"en-us_component_empty.md\":\"0733243a\",\"en-us_component_form.md\":\"0eb8c990\",\"en-us_component_icon.md\":\"d3dac8bc\",\"en-us_component_image.md\":\"2e60910b\",\"en-us_component_infinite-scroll.md\":\"3161e5a2\",\"en-us_component_input-number.md\":\"0b23f380\",\"en-us_component_input.md\":\"f855dd62\",\"en-us_component_layout.md\":\"12bd943e\",\"en-us_component_link.md\":\"ab80549e\",\"en-us_component_loading.md\":\"884823ab\",\"en-us_component_menu.md\":\"8ef961ca\",\"en-us_component_message-box.md\":\"e41057bf\",\"en-us_component_message.md\":\"632eea51\",\"en-us_component_notification.md\":\"e3b9c5f7\",\"en-us_component_page-header.md\":\"3c2c2b07\",\"en-us_component_pagination.md\":\"d15fd6a9\",\"en-us_component_popconfirm.md\":\"99fc2358\",\"en-us_component_popover.md\":\"98052462\",\"en-us_component_progress.md\":\"ec93e67a\",\"en-us_component_radio.md\":\"80052a9a\",\"en-us_component_rate.md\":\"3102330b\",\"en-us_component_result.md\":\"8fd8e424\",\"en-us_component_scrollbar.md\":\"0988d7fe\",\"en-us_component_select-v2.md\":\"67d8436c\",\"en-us_component_select.md\":\"f34f823d\",\"en-us_component_skeleton.md\":\"274fbf65\",\"en-us_component_slider.md\":\"21d8af0e\",\"en-us_component_space.md\":\"e4d9c9f4\",\"en-us_component_steps.md\":\"8fa1b5c2\",\"en-us_component_switch.md\":\"489913d6\",\"en-us_component_table.md\":\"54a2ba22\",\"en-us_component_tabs.md\":\"0baea47a\",\"en-us_component_tag.md\":\"57ea2122\",\"en-us_component_time-picker.md\":\"b94e9c1e\",\"en-us_component_time-select.md\":\"48ca9e04\",\"en-us_component_timeline.md\":\"ce2251e6\",\"en-us_component_tooltip-v2.md\":\"7e9ce56f\",\"en-us_component_tooltip.md\":\"0806dc66\",\"en-us_component_transfer.md\":\"5a4285f7\",\"en-us_component_tree-v2.md\":\"8cc35e51\",\"en-us_component_tree.md\":\"395f4c6d\",\"en-us_component_typography.md\":\"f591078d\",\"en-us_component_upload.md\":\"19e887a4\",\"en-us_guide_changelog.md\":\"252b099d\",\"en-us_guide_design.md\":\"f3275a5a\",\"en-us_guide_i18n.md\":\"c2096020\",\"en-us_guide_installation.md\":\"77a3ce54\",\"en-us_guide_migration.md\":\"557cb958\",\"en-us_guide_nav.md\":\"3808c0c2\",\"en-us_guide_quickstart.md\":\"c0171f0d\",\"en-us_guide_theming.md\":\"4417082f\",\"en-us_guide_transitions.md\":\"4e5c80c0\",\"en-us_index.md\":\"e63a6045\",\"en-us_resource_index.md\":\"9fb8bdf3\",\"index.md\":\"b468de43\",\"zh-cn_component_affix.md\":\"9278c8b7\",\"zh-cn_component_alert.md\":\"49a26197\",\"zh-cn_component_avatar.md\":\"387187b5\",\"zh-cn_component_backtop.md\":\"a89d807c\",\"zh-cn_component_badge.md\":\"3e5c5ea4\",\"zh-cn_component_border.md\":\"febae7d6\",\"zh-cn_component_breadcrumb.md\":\"891a99a6\",\"zh-cn_component_button.md\":\"ad091407\",\"zh-cn_component_calendar.md\":\"64654d96\",\"zh-cn_component_card.md\":\"ba9263b3\",\"zh-cn_component_carousel.md\":\"dc56ae81\",\"zh-cn_component_cascader.md\":\"90d68876\",\"zh-cn_component_checkbox.md\":\"6d41e2d6\",\"zh-cn_component_collapse.md\":\"998d8ff2\",\"zh-cn_component_color-picker.md\":\"f854c004\",\"zh-cn_component_color.md\":\"0ae03b3e\",\"zh-cn_component_config-provider.md\":\"4c7cb59a\",\"zh-cn_component_container.md\":\"77ff93c8\",\"zh-cn_component_date-picker.md\":\"334942d9\",\"zh-cn_component_datetime-picker.md\":\"df7b716c\",\"zh-cn_component_descriptions.md\":\"7edc2835\",\"zh-cn_component_dialog.md\":\"084df152\",\"zh-cn_component_divider.md\":\"846f8c8b\",\"zh-cn_component_drawer.md\":\"a8f0ed9f\",\"zh-cn_component_dropdown.md\":\"61a237a7\",\"zh-cn_component_empty.md\":\"83ba3fa6\",\"zh-cn_component_form.md\":\"d5a6606c\",\"zh-cn_component_icon.md\":\"b61f9ef8\",\"zh-cn_component_image.md\":\"c85c0509\",\"zh-cn_component_infinite-scroll.md\":\"0ef03684\",\"zh-cn_component_input-number.md\":\"db16accd\",\"zh-cn_component_input.md\":\"96544376\",\"zh-cn_component_layout.md\":\"6fb70a63\",\"zh-cn_component_link.md\":\"9f611dda\",\"zh-cn_component_loading.md\":\"eba42063\",\"zh-cn_component_menu.md\":\"5191264d\",\"zh-cn_component_message-box.md\":\"413d8594\",\"zh-cn_component_message.md\":\"1c81f85c\",\"zh-cn_component_notification.md\":\"b0a76539\",\"zh-cn_component_page-header.md\":\"d7f53782\",\"zh-cn_component_pagination.md\":\"e2ea7f35\",\"zh-cn_component_popconfirm.md\":\"c4b1fd3e\",\"zh-cn_component_popover.md\":\"fc458a46\",\"zh-cn_component_progress.md\":\"d4e5aff5\",\"zh-cn_component_radio.md\":\"26b74ad2\",\"zh-cn_component_rate.md\":\"80958aa0\",\"zh-cn_component_result.md\":\"b5b86099\",\"zh-cn_component_scrollbar.md\":\"d9e4f618\",\"zh-cn_component_select-v2.md\":\"525197b6\",\"zh-cn_component_select.md\":\"093b4a9c\",\"zh-cn_component_skeleton.md\":\"54ef35bf\",\"zh-cn_component_slider.md\":\"a8e90d0b\",\"zh-cn_component_space.md\":\"1aa53320\",\"zh-cn_component_steps.md\":\"87d56b91\",\"zh-cn_component_switch.md\":\"6f60149b\",\"zh-cn_component_table.md\":\"3ff9cde1\",\"zh-cn_component_tabs.md\":\"7ac1d379\",\"zh-cn_component_tag.md\":\"503c63c5\",\"zh-cn_component_time-picker.md\":\"ca05d69c\",\"zh-cn_component_time-select.md\":\"2ff859df\",\"zh-cn_component_timeline.md\":\"2f114770\",\"zh-cn_component_tooltip-v2.md\":\"98da72fb\",\"zh-cn_component_tooltip.md\":\"89843474\",\"zh-cn_component_transfer.md\":\"3c80a185\",\"zh-cn_component_tree-v2.md\":\"cccf9ae0\",\"zh-cn_component_tree.md\":\"3d880e21\",\"zh-cn_component_typography.md\":\"38c8dcb0\",\"zh-cn_component_upload.md\":\"f27d0416\",\"zh-cn_guide_changelog.md\":\"e48d7c07\",\"zh-cn_guide_design.md\":\"cc2bc793\",\"zh-cn_guide_i18n.md\":\"01dabf5f\",\"zh-cn_guide_installation.md\":\"76ffc2eb\",\"zh-cn_guide_migration.md\":\"fb0d832d\",\"zh-cn_guide_nav.md\":\"7b8bef43\",\"zh-cn_guide_quickstart.md\":\"6882645d\",\"zh-cn_guide_theming.md\":\"983cd735\",\"zh-cn_guide_transitions.md\":\"ffeb94e3\",\"zh-cn_index.md\":\"05f821bc\",\"zh-cn_resource_index.md\":\"9800a4a5\"}")</script>
|
||
<script type="module" async src="/assets/app.e5926f2b.js"></script>
|
||
|
||
</body>
|
||
</html> |