🔥 認識我們的新專案 t0ggles - 您終極的專案管理工具! 🔥

核取方塊 Vue 組件

核取方塊組件

包含以下組件

  • 核取方塊

核取方塊屬性

名稱類型預設值描述
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)

當核取方塊狀態變更時會觸發事件

核取方塊列表

核取方塊列表不是單獨的組件,而只是使用 ListListItem 組件的特殊情況。

<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>

範例

Checkbox.vue
<template>
<k-page>
<k-navbar title="Checkbox" />
<k-block-title>Inline</k-block-title>
<k-block strong-ios outline-ios>
<p>
Lorem{{ ' ' }}
<k-checkbox
name="checkbox-1"
:checked="checked1"
@change="(e) => (checked1 = e.target.checked)"
/>{{ ' ' }} ipsum dolor sit amet, consectetur adipisicing elit. Alias
beatae illo nihil aut eius commodi sint eveniet aliquid eligendi
{{ ' ' }}
<k-checkbox
name="checkbox-2"
:checked="checked2"
@change="(e) => (checked2 = e.target.checked)"
/>{{ ' ' }}
ad delectus impedit tempore nemo, enim vel praesentium consequatur nulla
mollitia!
</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-checkbox
component="div"
name="demo-checkbox"
:checked="group.includes('Books')"
@change="() => toggleGroupValue('Books')"
/>
</template>
</k-list-item>
<k-list-item label title="Movies">
<template #media>
<k-checkbox
component="div"
name="demo-checkbox"
:checked="group.includes('Movies')"
@change="() => toggleGroupValue('Movies')"
/>
</template>
</k-list-item>
<k-list-item label title="Food">
<template #media>
<k-checkbox
component="div"
name="demo-checkbox"
:checked="group.includes('Food')"
@change="() => toggleGroupValue('Food')"
/>
</template>
</k-list-item>
<k-list-item label title="Drinks">
<template #media>
<k-checkbox
component="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-checkbox
name="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-checkbox
name="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-item
label
title="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-checkbox
component="div"
name="demo-media-checkbox"
:checked="media.includes('Item 1')"
@change="() => toggleMediaValue('Item 1')"
/>
</template>
</k-list-item>
<k-list-item
label
title="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-checkbox
component="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);
// Group
const 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];
};
// Indeterminate
const 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 = [];
}
};
// Media
const 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>
程式碼授權於 MIT.
2022 © Konsta UI by nolimits4web.