/*! For license information please see 6683.b004d53d.js.LICENSE.txt */ (self.webpackChunk=self.webpackChunk||[]).push([["6683"],{7985:function(s,n,a){"use strict";a.r(n);var t=a("80681");let l=["innerHTML"];n.default={setup:()=>({html:""}),render:()=>((0,t.wg)(),(0,t.iD)("div",{class:"van-doc-markdown-body",innerHTML:'

Cascader \u7EA7\u8054\u9009\u62E9

\n

\u4ECB\u7ECD

\n

\u7EA7\u8054\u9009\u62E9\u6846\uFF0C\u7528\u4E8E\u591A\u5C42\u7EA7\u6570\u636E\u7684\u9009\u62E9\uFF0C\u5178\u578B\u573A\u666F\u4E3A\u7701\u5E02\u533A\u9009\u62E9\u3002

\n

\u5F15\u5165

\n

\u901A\u8FC7\u4EE5\u4E0B\u65B9\u5F0F\u6765\u5168\u5C40\u6CE8\u518C\u7EC4\u4EF6\uFF0C\u66F4\u591A\u6CE8\u518C\u65B9\u5F0F\u8BF7\u53C2\u8003\u7EC4\u4EF6\u6CE8\u518C\u3002

\n
import { createApp } from 'vue';\nimport { Cascader } from 'vant';\n\nconst app = createApp();\napp.use(Cascader);\n
\n

\u4EE3\u7801\u6F14\u793A

\n

\u57FA\u7840\u7528\u6CD5

\n

\u7EA7\u8054\u9009\u62E9\u7EC4\u4EF6\u53EF\u4EE5\u642D\u914D Field \u548C Popup \u7EC4\u4EF6\u4F7F\u7528\uFF0C\u793A\u4F8B\u5982\u4E0B\uFF1A

\n
<van-field\n  v-model="fieldValue"\n  is-link\n  readonly\n  label="\u5730\u533A"\n  placeholder="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"\n  @click="show = true"\n/>\n<van-popup v-model:show="show" round position="bottom">\n  <van-cascader\n    v-model="cascaderValue"\n    title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"\n    :options="options"\n    @close="show = false"\n    @finish="onFinish"\n  />\n</van-popup>\n
\n
import { ref } from 'vue';\n\nexport default {\n  setup() {\n    const show = ref(false);\n    const fieldValue = ref('');\n    const cascaderValue = ref('');\n    // \u9009\u9879\u5217\u8868\uFF0Cchildren \u4EE3\u8868\u5B50\u9009\u9879\uFF0C\u652F\u6301\u591A\u7EA7\u5D4C\u5957\n    const options = [\n      {\n        text: '\u6D59\u6C5F\u7701',\n        value: '330000',\n        children: [{ text: '\u676D\u5DDE\u5E02', value: '330100' }],\n      },\n      {\n        text: '\u6C5F\u82CF\u7701',\n        value: '320000',\n        children: [{ text: '\u5357\u4EAC\u5E02', value: '320100' }],\n      },\n    ];\n    // \u5168\u90E8\u9009\u9879\u9009\u62E9\u5B8C\u6BD5\u540E\uFF0C\u4F1A\u89E6\u53D1 finish \u4E8B\u4EF6\n    const onFinish = ({ selectedOptions }) => {\n      show.value = false;\n      fieldValue.value = selectedOptions.map((option) => option.text).join('/');\n    };\n\n    return {\n      show,\n      options,\n      onFinish,\n      fieldValue,\n      cascaderValue,\n    };\n  },\n};\n
\n

\u4E2D\u56FD\u7701\u5E02\u533A\u6570\u636E

\n

Cascader \u7EC4\u4EF6\u5E38\u7528\u4E8E\u9009\u62E9\u7701\u5E02\u533A\uFF0CVant \u63D0\u4F9B\u4E86\u4E00\u4EFD\u4E2D\u56FD\u7701\u5E02\u533A\u6570\u636E\uFF0C\u4F60\u53EF\u4EE5\u5B89\u88C5 @vant/area-data npm \u5305\u6765\u5F15\u5165\uFF1A

\n
# \u901A\u8FC7 npm\nnpm i @vant/area-data\n\n# \u901A\u8FC7 yarn\nyarn add @vant/area-data\n\n# \u901A\u8FC7 pnpm\npnpm add @vant/area-data\n\n# \u901A\u8FC7 Bun\nbun add @vant/area-data\n
\n
<van-field\n  v-model="fieldValue"\n  is-link\n  readonly\n  label="\u5730\u533A"\n  placeholder="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"\n  @click="show = true"\n/>\n<van-popup v-model:show="show" round position="bottom">\n  <van-cascader\n    v-model="cascaderValue"\n    title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"\n    :options="options"\n    @close="show = false"\n    @finish="onFinish"\n  />\n</van-popup>\n
\n
import { ref } from 'vue';\nimport { useCascaderAreaData } from '@vant/area-data';\n\nexport default {\n  setup() {\n    const show = ref(false);\n    const fieldValue = ref('');\n    const cascaderValue = ref('');\n    const options = useCascaderAreaData();\n    const onFinish = ({ selectedOptions }) => {\n      show.value = false;\n      fieldValue.value = selectedOptions.map((option) => option.text).join('/');\n    };\n    return {\n      show,\n      options,\n      onFinish,\n      fieldValue,\n      cascaderValue,\n    };\n  },\n};\n
\n
\n

Tips: \u4E2D\u56FD\u7684\u884C\u653F\u533A\u5212\u6BCF\u5E74\u90FD\u4F1A\u6709\u53D8\u52A8\uFF0C\u5982\u679C\u53D1\u73B0\u7701\u5E02\u533A\u6570\u636E\u672A\u53CA\u65F6\u66F4\u65B0\uFF0C\u6B22\u8FCE\u63D0 Pull Request \u5E2E\u52A9\u6211\u4EEC\u66F4\u65B0\u3002\u4F60\u53EF\u4EE5\u5728\u300C\u56FD\u5BB6\u7EDF\u8BA1\u5C40 - \u5168\u56FD\u533A\u5212\u4EE3\u7801\u300D \u548C\u300C\u6C11\u653F\u90E8 - \u884C\u653F\u533A\u5212\u4EE3\u7801\u300D\u4E0A\u67E5\u8BE2\u5230\u6700\u65B0\u6570\u636E\uFF0C\u8BF7\u6839\u636E\u5B98\u65B9\u6570\u636E\u8FDB\u884C\u6838\u5B9E\u3002

\n
\n

\u81EA\u5B9A\u4E49\u989C\u8272

\n

\u901A\u8FC7 active-color \u5C5E\u6027\u6765\u8BBE\u7F6E\u9009\u4E2D\u72B6\u6001\u7684\u9AD8\u4EAE\u989C\u8272\u3002

\n
<van-cascader\n  v-model="cascaderValue"\n  title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"\n  :options="options"\n  active-color="#ee0a24"\n  @close="show = false"\n  @finish="onFinish"\n/>\n
\n

\u5F02\u6B65\u52A0\u8F7D\u9009\u9879

\n

\u53EF\u4EE5\u76D1\u542C change \u4E8B\u4EF6\u5E76\u52A8\u6001\u8BBE\u7F6E options\uFF0C\u5B9E\u73B0\u5F02\u6B65\u52A0\u8F7D\u9009\u9879\u3002

\n
<van-field\n  v-model="fieldValue"\n  is-link\n  readonly\n  label="\u5730\u533A"\n  placeholder="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"\n  @click="show = true"\n/>\n<van-popup v-model:show="show" round position="bottom">\n  <van-cascader\n    v-model="cascaderValue"\n    title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"\n    :options="options"\n    @close="show = false"\n    @change="onChange"\n    @finish="onFinish"\n  />\n</van-popup>\n
\n
import { ref } from 'vue';\nimport { closeToast, showLoadingToast } from 'vant';\n\nexport default {\n  setup() {\n    const show = ref(false);\n    const fieldValue = ref('');\n    const cascaderValue = ref('');\n    const options = ref([\n      {\n        text: '\u6D59\u6C5F\u7701',\n        value: '330000',\n        children: [],\n      },\n    ]);\n    const onChange = ({ value }) => {\n      if (\n        value === options.value[0].value &&\n        options.value[0].children.length === 0\n      ) {\n        // \u6A21\u62DF\u6570\u636E\u8BF7\u6C42\n        showLoadingToast('\u52A0\u8F7D\u4E2D...');\n        setTimeout(() => {\n          options.value[0].children = [\n            { text: '\u676D\u5DDE\u5E02', value: '330100' },\n            { text: '\u5B81\u6CE2\u5E02', value: '330200' },\n          ];\n          closeToast();\n        }, 1000);\n      }\n    };\n    const onFinish = ({ selectedOptions }) => {\n      show.value = false;\n      fieldValue.value = selectedOptions.map((option) => option.text).join('/');\n    };\n\n    return {\n      show,\n      options,\n      onFinish,\n      fieldValue,\n      cascaderValue,\n    };\n  },\n};\n
\n

\u81EA\u5B9A\u4E49\u5B57\u6BB5\u540D

\n

\u901A\u8FC7 field-names \u5C5E\u6027\u53EF\u4EE5\u81EA\u5B9A\u4E49 options \u91CC\u7684\u5B57\u6BB5\u540D\u79F0\u3002

\n
<van-cascader\n  v-model="code"\n  title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"\n  :options="options"\n  :field-names="fieldNames"\n/>\n
\n
import { ref } from 'vue';\n\nexport default {\n  setup() {\n    const code = ref('');\n    const fieldNames = {\n      text: 'name',\n      value: 'code',\n      children: 'items',\n    };\n    const options = [\n      {\n        name: '\u6D59\u6C5F\u7701',\n        code: '330000',\n        items: [{ name: '\u676D\u5DDE\u5E02', code: '330100' }],\n      },\n      {\n        name: '\u6C5F\u82CF\u7701',\n        code: '320000',\n        items: [{ name: '\u5357\u4EAC\u5E02', code: '320100' }],\n      },\n    ];\n\n    return {\n      code,\n      options,\n      fieldNames,\n    };\n  },\n};\n
\n

\u81EA\u5B9A\u4E49\u9009\u9879\u4E0A\u65B9\u5185\u5BB9

\n
<van-cascader v-model="code" title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A" :options="options">\n  <template #options-top="{ tabIndex }">\n    <div class="current-level">\u5F53\u524D\u4E3A\u7B2C {{ tabIndex + 1 }} \u7EA7</div>\n  </template>\n</van-cascader>\n\n<style>\n  .current-level {\n    font-size: 14px;\n    padding: 16px 16px 0;\n    color: var(--van-gray-6);\n  }\n</style>\n
\n
import { ref } from 'vue';\n\nexport default {\n  setup() {\n    const code = ref('');\n    const options = [\n      {\n        name: '\u6D59\u6C5F\u7701',\n        code: '330000',\n        items: [{ name: '\u676D\u5DDE\u5E02', code: '330100' }],\n      },\n      {\n        name: '\u6C5F\u82CF\u7701',\n        code: '320000',\n        items: [{ name: '\u5357\u4EAC\u5E02', code: '320100' }],\n      },\n    ];\n\n    return {\n      code,\n      options,\n    };\n  },\n};\n
\n

API

\n

Props

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\u53C2\u6570\u8BF4\u660E\u7C7B\u578B\u9ED8\u8BA4\u503C
v-model\u9009\u4E2D\u9879\u7684\u503Cstring | number-
title\u9876\u90E8\u6807\u9898string-
options\u53EF\u9009\u9879\u6570\u636E\u6E90CascaderOption[][]
placeholder\u672A\u9009\u4E2D\u65F6\u7684\u63D0\u793A\u6587\u6848string\u8BF7\u9009\u62E9
active-color\u9009\u4E2D\u72B6\u6001\u7684\u9AD8\u4EAE\u989C\u8272string#1989fa
swipeable\u662F\u5426\u5F00\u542F\u624B\u52BF\u5DE6\u53F3\u6ED1\u52A8\u5207\u6362booleantrue
closeable\u662F\u5426\u663E\u793A\u5173\u95ED\u56FE\u6807booleantrue
show-header\u662F\u5426\u5C55\u793A\u6807\u9898\u680Fbooleantrue
close-icon\u5173\u95ED\u56FE\u6807\u540D\u79F0\u6216\u56FE\u7247\u94FE\u63A5\uFF0C\u7B49\u540C\u4E8E Icon \u7EC4\u4EF6\u7684 name \u5C5E\u6027stringcross
field-names\u81EA\u5B9A\u4E49 options \u7ED3\u6784\u4E2D\u7684\u5B57\u6BB5CascaderFieldNames{ text: \'text\', value: \'value\', children: \'children\' }
\n

CascaderOption \u6570\u636E\u7ED3\u6784

\n

options \u5C5E\u6027\u662F\u4E00\u4E2A\u7531\u5BF9\u8C61\u6784\u6210\u7684\u6570\u7EC4\uFF0C\u6570\u7EC4\u4E2D\u7684\u6BCF\u4E2A\u5BF9\u8C61\u914D\u7F6E\u4E00\u4E2A\u53EF\u9009\u9879\uFF0C\u5BF9\u8C61\u53EF\u4EE5\u5305\u542B\u4EE5\u4E0B\u503C\uFF1A

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\u952E\u540D\u8BF4\u660E\u7C7B\u578B
text\u9009\u9879\u6587\u5B57\uFF08\u5FC5\u586B\uFF09string
value\u9009\u9879\u5BF9\u5E94\u7684\u503C\uFF08\u5FC5\u586B\uFF09string | number
color\u9009\u9879\u6587\u5B57\u989C\u8272string
children\u5B50\u9009\u9879\u5217\u8868CascaderOption[]
disabled\u662F\u5426\u7981\u7528\u9009\u9879boolean
className\u4E3A\u5BF9\u5E94\u5217\u6DFB\u52A0\u989D\u5916\u7684 classstring | Array | object
\n

Events

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\u4E8B\u4EF6\u8BF4\u660E\u56DE\u8C03\u53C2\u6570
change\u9009\u4E2D\u9879\u53D8\u5316\u65F6\u89E6\u53D1{ value: string | number, selectedOptions: CascaderOption[], tabIndex: number }
finish\u5168\u90E8\u9009\u9879\u9009\u62E9\u5B8C\u6210\u540E\u89E6\u53D1{ value: string | number, selectedOptions: CascaderOption[], tabIndex: number }
close\u70B9\u51FB\u5173\u95ED\u56FE\u6807\u65F6\u89E6\u53D1-
click-tab\u70B9\u51FB\u6807\u7B7E\u65F6\u89E6\u53D1tabIndex: number, title: string
\n

Slots

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\u540D\u79F0\u8BF4\u660E\u53C2\u6570
title\u81EA\u5B9A\u4E49\u9876\u90E8\u6807\u9898-
option\u81EA\u5B9A\u4E49\u9009\u9879\u6587\u5B57{ option: CascaderOption, selected: boolean }
options-top\u81EA\u5B9A\u4E49\u9009\u9879\u4E0A\u65B9\u7684\u5185\u5BB9{ tabIndex: number }
options-bottom\u81EA\u5B9A\u4E49\u9009\u9879\u4E0B\u65B9\u7684\u5185\u5BB9{ tabIndex: number }
\n

\u7C7B\u578B\u5B9A\u4E49

\n

\u7EC4\u4EF6\u5BFC\u51FA\u4EE5\u4E0B\u7C7B\u578B\u5B9A\u4E49\uFF1A

\n
import type { CascaderProps, CascaderOption, CascaderFieldNames } from 'vant';\n
\n

\u4E3B\u9898\u5B9A\u5236

\n

\u6837\u5F0F\u53D8\u91CF

\n

\u7EC4\u4EF6\u63D0\u4F9B\u4E86\u4E0B\u5217 CSS \u53D8\u91CF\uFF0C\u53EF\u7528\u4E8E\u81EA\u5B9A\u4E49\u6837\u5F0F\uFF0C\u4F7F\u7528\u65B9\u6CD5\u8BF7\u53C2\u8003 ConfigProvider \u7EC4\u4EF6\u3002

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\u540D\u79F0\u9ED8\u8BA4\u503C\u63CF\u8FF0
--van-cascader-header-height48px-
--van-cascader-header-padding0 var(--van-padding-md)-
--van-cascader-title-font-sizevar(--van-font-size-lg)-
--van-cascader-title-line-height20px-
--van-cascader-close-icon-size22px-
--van-cascader-close-icon-colorvar(--van-gray-5)-
--van-cascader-selected-icon-size18px-
--van-cascader-tabs-height48px-
--van-cascader-active-colorvar(--van-danger-color)-
--van-cascader-options-height384px-
--van-cascader-option-disabled-colorvar(--van-text-color-3)-
--van-cascader-tab-colorvar(--van-text-color)-
--van-cascader-unselected-tab-colorvar(--van-text-color-2)-
\n
'},null,8,l))}}}]);