包含以下組件
核取方塊
名稱 | 類型 | 預設值 | 描述 |
---|---|---|---|
checked | 布林值 | false | 定義核取方塊輸入是否被選取 |
colors | 物件 | 具有 Tailwind CSS 顏色類別的物件 | |
colors.bgCheckedIos | 字串 | 'bg-primary' | |
colors.bgCheckedMaterial | 字串 | 'bg-md-light-primary dark:bg-md-dark-primary' | |
colors.borderCheckedIos | 字串 | 'border-primary' | |
colors.borderCheckedMaterial | 字串 | 'border-md-light-primary dark:border-md-dark-primary' | |
colors.borderIos | 字串 | 'border-black border-opacity-30 dark:border-white dark:border-opacity-30' | |
colors.borderMaterial | 字串 | 'border-md-light-outline dark:border-md-dark-outline' | |
component | 字串 | 字串 | 組件的 HTML 元素 |
defaultChecked | 布林值 | false | 定義核取方塊輸入是否被選取,用於非受控組件的情況 |
disabled | 布林值 | false | 定義核取方塊輸入是否被禁用 |
indeterminate | 布林值 | false | 定義核取方塊輸入是否處於不確定狀態 |
name | 字串 | 核取方塊輸入名稱 | |
readonly | 布林值 | false | 定義核取方塊輸入是否為唯讀 |
touchRipple | 布林值 | 布林值 | 在 Material 主題中啟用觸摸漣漪效果 |
value | 任意值 | 核取方塊輸入值 |
名稱 | 類型 | 描述 |
---|---|---|
change | 函數(e) | 當核取方塊狀態變更時會觸發事件 |
核取方塊列表不是單獨的組件,而只是使用 List
和 ListItem
組件的特殊情況。
<k-list>
<!-- Additional "label" prop on ListItem -->
<k-list-item
label
title="Books"
>
<template #media>
<!-- Pass Checkbox to list item media -->
<k-checkbox component="div" name="my-checkbox" />
</template>
</k-list-item>
<k-list-item
label
title="Movies"
>
<template #media>
<!-- Pass Checkbox to list item media -->
<k-checkbox component="div" name="my-checkbox" />
</template>
</k-list-item>
</List>
<template><k-page><k-navbar title="Checkbox" /><k-block-title>Inline</k-block-title><k-block strong-ios outline-ios><p>Lorem{{ ' ' }}<k-checkboxname="checkbox-1":checked="checked1"@change="(e) => (checked1 = e.target.checked)"/>{{ ' ' }} ipsum dolor sit amet, consectetur adipisicing elit. Aliasbeatae illo nihil aut eius commodi sint eveniet aliquid eligendi{{ ' ' }}<k-checkboxname="checkbox-2":checked="checked2"@change="(e) => (checked2 = e.target.checked)"/>{{ ' ' }}ad delectus impedit tempore nemo, enim vel praesentium consequatur nullamollitia!</p></k-block><k-block-title>Checkbox Group</k-block-title><k-list strong-ios outline-ios><k-list-item label title="Books"><template #media><k-checkboxcomponent="div"name="demo-checkbox":checked="group.includes('Books')"@change="() => toggleGroupValue('Books')"/></template></k-list-item><k-list-item label title="Movies"><template #media><k-checkboxcomponent="div"name="demo-checkbox":checked="group.includes('Movies')"@change="() => toggleGroupValue('Movies')"/></template></k-list-item><k-list-item label title="Food"><template #media><k-checkboxcomponent="div"name="demo-checkbox":checked="group.includes('Food')"@change="() => toggleGroupValue('Food')"/></template></k-list-item><k-list-item label title="Drinks"><template #media><k-checkboxcomponent="div"name="demo-checkbox":checked="group.includes('Drinks')"@change="() => toggleGroupValue('Drinks')"/></template></k-list-item></k-list><k-block-title>Indeterminate State</k-block-title><k-list strong-ios outline-ios><k-list-item label title="Movies" name="demo-checkbox"><template #media><k-checkbox:checked="movies.length === 2":indeterminate="movies.length === 1"@change="onMoviesChange"/></template><ul class="ps-12"><k-list-item label title="Movie 1"><template #media><k-checkboxname="demo-checkbox"value="Movie 1":checked="movies.indexOf('Movie 1') >= 0"@change="onMovieChange"/></template></k-list-item><k-list-item label title="Movie 2"><template #media><k-checkboxname="demo-checkbox"value="Movie 2":checked="movies.indexOf('Movie 2') >= 0"@change="onMovieChange"/></template></k-list-item></ul></k-list-item></k-list><k-block-title>With Media Lists</k-block-title><k-list strong-ios outline-ios><k-list-itemlabeltitle="Facebook"after="17:14"subtitle="New messages from John Doe"text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."><template #media><k-checkboxcomponent="div"name="demo-media-checkbox":checked="media.includes('Item 1')"@change="() => toggleMediaValue('Item 1')"/></template></k-list-item><k-list-itemlabeltitle="John Doe (via Twitter)"after="17:11"subtitle="John Doe (@_johndoe) mentioned you on Twitter!"text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."><template #media><k-checkboxcomponent="div"name="demo-media-checkbox":checked="media.includes('Item 2')"@change="() => toggleMediaValue('Item 2')"/></template></k-list-item></k-list></k-page></template><script>import { ref } from 'vue';import {kPage,kNavbar,kNavbarBackLink,kCheckbox,kBlockTitle,kBlock,kList,kListItem,} from 'konsta/vue';export default {components: {kPage,kNavbar,kNavbarBackLink,kCheckbox,kBlockTitle,kBlock,kList,kListItem,},setup() {const checked1 = ref(false);const checked2 = ref(true);// Groupconst group = ref(['Books']);const toggleGroupValue = (value) => {if (group.value.includes(value))group.value.splice(group.value.indexOf(value), 1);else group.value.push(value);group.value = [...group.value];};// Indeterminateconst movies = ref(['Movie 1']);const onMovieChange = (e) => {const value = e.target.value;if (e.target.checked) {movies.value.push(value);} else {movies.value.splice(movies.value.indexOf(value), 1);}movies.value = [...movies.value];};const onMoviesChange = () => {if (movies.value.length === 1 || movies.value.length === 0) {movies.value = ['Movie 1', 'Movie 2'];} else if (movies.value.length === 2) {movies.value = [];}};// Mediaconst media = ref(['Item 1']);const toggleMediaValue = (value) => {if (media.value.includes(value))media.value.splice(media.value.indexOf(value), 1);else media.value.push(value);media.value = [...media.value];};return {checked1,checked2,group,toggleGroupValue,movies,onMovieChange,onMoviesChange,media,toggleMediaValue,};},};</script>