import{o as a,a as n,y as t}from"./vue-libs.b44bc779.js";const l={class:"van-doc-markdown-body"},p=t(`

Cascader \u7EA7\u8054\u9009\u62E9

\u4ECB\u7ECD

\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

\u5F15\u5165

\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

import { createApp } from 'vue';
import { Cascader } from 'vant';

const app = createApp();
app.use(Cascader);

\u4EE3\u7801\u6F14\u793A

\u57FA\u7840\u7528\u6CD5

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

<van-field
  v-model="fieldValue"
  is-link
  readonly
  label="\u5730\u533A"
  placeholder="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"
  @click="show = true"
/>
<van-popup v-model:show="show" round position="bottom">
  <van-cascader
    v-model="cascaderValue"
    title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"
    :options="options"
    @close="show = false"
    @finish="onFinish"
  />
</van-popup>

import { ref } from 'vue';

export default {
  setup() {
    const show = ref(false);
    const fieldValue = ref('');
    const cascaderValue = ref('');
    // \u9009\u9879\u5217\u8868\uFF0Cchildren \u4EE3\u8868\u5B50\u9009\u9879\uFF0C\u652F\u6301\u591A\u7EA7\u5D4C\u5957
    const options = [
      {
        text: '\u6D59\u6C5F\u7701',
        value: '330000',
        children: [{ text: '\u676D\u5DDE\u5E02', value: '330100' }],
      },
      {
        text: '\u6C5F\u82CF\u7701',
        value: '320000',
        children: [{ text: '\u5357\u4EAC\u5E02', value: '320100' }],
      },
    ];
    // \u5168\u90E8\u9009\u9879\u9009\u62E9\u5B8C\u6BD5\u540E\uFF0C\u4F1A\u89E6\u53D1 finish \u4E8B\u4EF6
    const onFinish = ({ selectedOptions }) => {
      show.value = false;
      fieldValue.value = selectedOptions.map((option) => option.text).join('/');
    };

    return {
      show,
      options,
      onFinish,
      fieldValue,
      cascaderValue,
    };
  },
};

\u81EA\u5B9A\u4E49\u989C\u8272

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

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

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

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

<van-field
  v-model="fieldValue"
  is-link
  readonly
  label="\u5730\u533A"
  placeholder="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"
  @click="show = true"
/>
<van-popup v-model:show="show" round position="bottom">
  <van-cascader
    v-model="cascaderValue"
    title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"
    :options="options"
    @close="show = false"
    @change="onChange"
    @finish="onFinish"
  />
</van-popup>

import { ref } from 'vue';

export default {
  setup() {
    const show = ref(false);
    const fieldValue = ref('');
    const cascaderValue = ref('');
    const options = ref([
      {
        text: '\u6D59\u6C5F\u7701',
        value: '330000',
        children: [],
      },
    ]);
    const onChange = ({ value }) => {
      if (value === options.value[0].value) {
        setTimeout(() => {
          options.value[0].children = [
            { text: '\u676D\u5DDE\u5E02', value: '330100' },
            { text: '\u5B81\u6CE2\u5E02', value: '330200' },
          ];
        }, 500);
      }
    };
    const onFinish = ({ selectedOptions }) => {
      show.value = false;
      fieldValue.value = selectedOptions.map((option) => option.text).join('/');
    };

    return {
      show,
      options,
      onFinish,
      fieldValue,
      cascaderValue,
    };
  },
};

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

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

<van-cascader
  v-model="code"
  title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A"
  :options="options"
  :field-names="fieldNames"
/>

import { ref } from 'vue';

export default {
  setup() {
    const code = ref('');
    const fieldNames = {
      text: 'name',
      value: 'code',
      children: 'items',
    };
    const options = [
      {
        name: '\u6D59\u6C5F\u7701',
        code: '330000',
        items: [{ name: '\u676D\u5DDE\u5E02', code: '330100' }],
      },
      {
        name: '\u6C5F\u82CF\u7701',
        code: '320000',
        items: [{ name: '\u5357\u4EAC\u5E02', code: '320100' }],
      },
    ];

    return {
      code,
      options,
      fieldNames,
    };
  },
};

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

<van-cascader v-model="code" title="\u8BF7\u9009\u62E9\u6240\u5728\u5730\u533A" :options="options">
  <template #options-top="{ tabIndex }">
    <div class="current-level">\u5F53\u524D\u4E3A\u7B2C {{ tabIndex }} \u7EA7</div>
  </template>
</van-cascader>

<style>
  .current-level {
    padding: 10px 16px 0;
  }
</style>

import { ref } from 'vue';

export default {
  setup() {
    const code = ref('');
    const options = [
      {
        name: '\u6D59\u6C5F\u7701',
        code: '330000',
        items: [{ name: '\u676D\u5DDE\u5E02', code: '330100' }],
      },
      {
        name: '\u6C5F\u82CF\u7701',
        code: '320000',
        items: [{ name: '\u5357\u4EAC\u5E02', code: '320100' }],
      },
    ];

    return {
      code,
      options,
    };
  },
};

API

Props

\u53C2\u6570\u8BF4\u660E\u7C7B\u578B\u9ED8\u8BA4\u503C
title\u9876\u90E8\u6807\u9898string-
value\u9009\u4E2D\u9879\u7684\u503Cstring | number-
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#ee0a24
swipeable v3.0.11\u662F\u5426\u5F00\u542F\u624B\u52BF\u5DE6\u53F3\u6ED1\u52A8\u5207\u6362booleanfalse
closeable\u662F\u5426\u663E\u793A\u5173\u95ED\u56FE\u6807booleantrue
show-header v3.4.2\u662F\u5426\u5C55\u793A\u6807\u9898\u680Fbooleantrue
close-icon v3.0.10\u5173\u95ED\u56FE\u6807\u540D\u79F0\u6216\u56FE\u7247\u94FE\u63A5\uFF0C\u7B49\u540C\u4E8E Icon \u7EC4\u4EF6\u7684 name \u5C5E\u6027stringcross
field-names v3.0.4\u81EA\u5B9A\u4E49 options \u7ED3\u6784\u4E2D\u7684\u5B57\u6BB5object{ text: 'text', value: 'value', children: 'children' }

CascaderOption \u6570\u636E\u7ED3\u6784

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

\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 v3.1.0\u9009\u9879\u6587\u5B57\u989C\u8272string
children\u5B50\u9009\u9879\u5217\u8868CascaderOption[]
disabled v3.1.2\u662F\u5426\u7981\u7528\u9009\u9879boolean
className v3.1.0\u4E3A\u5BF9\u5E94\u5217\u6DFB\u52A0\u989D\u5916\u7684 classstring | Array | object

Events

\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

Slots

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

\u7C7B\u578B\u5B9A\u4E49

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

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

\u4E3B\u9898\u5B9A\u5236

\u6837\u5F0F\u53D8\u91CF

\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

\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)-
`,17),e=[p],i={__name:"README.zh-CN",setup(c,{expose:s}){return s({frontmatter:{}}),(r,o)=>(a(),n("div",l,e))}};export{i as default};