Cascader 级联选择器

当一个数据集合有清晰的层级结构时,可通过级联选择器逐级查看并选择。

基础用法

有两种触发子菜单的方式

Cascader 级联选择器 - 图1

只需为 Cascader 的options属性指定选项数组即可渲染出一个级联选择器。通过expand-trigger可以定义展开子级菜单的触发方式。本例还展示了change事件,它的参数为 Cascader 的绑定值:一个由各级菜单的值所组成的数组。

  1. <div class="block">
  2. <span class="demonstration">默认 click 触发子菜单</span>
  3. <el-cascader
  4. :options="options"
  5. v-model="selectedOptions"
  6. @change="handleChange">
  7. </el-cascader>
  8. </div>
  9. <div class="block">
  10. <span class="demonstration">hover 触发子菜单</span>
  11. <el-cascader
  12. expand-trigger="hover"
  13. :options="options"
  14. v-model="selectedOptions2"
  15. @change="handleChange">
  16. </el-cascader>
  17. </div>
  18. <script>
  19. export default {
  20. data() {
  21. return {
  22. options: [{
  23. value: 'zhinan',
  24. label: '指南',
  25. children: [{
  26. value: 'shejiyuanze',
  27. label: '设计原则',
  28. children: [{
  29. value: 'yizhi',
  30. label: '一致'
  31. }, {
  32. value: 'fankui',
  33. label: '反馈'
  34. }, {
  35. value: 'xiaolv',
  36. label: '效率'
  37. }, {
  38. value: 'kekong',
  39. label: '可控'
  40. }]
  41. }, {
  42. value: 'daohang',
  43. label: '导航',
  44. children: [{
  45. value: 'cexiangdaohang',
  46. label: '侧向导航'
  47. }, {
  48. value: 'dingbudaohang',
  49. label: '顶部导航'
  50. }]
  51. }]
  52. }, {
  53. value: 'zujian',
  54. label: '组件',
  55. children: [{
  56. value: 'basic',
  57. label: 'Basic',
  58. children: [{
  59. value: 'layout',
  60. label: 'Layout 布局'
  61. }, {
  62. value: 'color',
  63. label: 'Color 色彩'
  64. }, {
  65. value: 'typography',
  66. label: 'Typography 字体'
  67. }, {
  68. value: 'icon',
  69. label: 'Icon 图标'
  70. }, {
  71. value: 'button',
  72. label: 'Button 按钮'
  73. }]
  74. }, {
  75. value: 'form',
  76. label: 'Form',
  77. children: [{
  78. value: 'radio',
  79. label: 'Radio 单选框'
  80. }, {
  81. value: 'checkbox',
  82. label: 'Checkbox 多选框'
  83. }, {
  84. value: 'input',
  85. label: 'Input 输入框'
  86. }, {
  87. value: 'input-number',
  88. label: 'InputNumber 计数器'
  89. }, {
  90. value: 'select',
  91. label: 'Select 选择器'
  92. }, {
  93. value: 'cascader',
  94. label: 'Cascader 级联选择器'
  95. }, {
  96. value: 'switch',
  97. label: 'Switch 开关'
  98. }, {
  99. value: 'slider',
  100. label: 'Slider 滑块'
  101. }, {
  102. value: 'time-picker',
  103. label: 'TimePicker 时间选择器'
  104. }, {
  105. value: 'date-picker',
  106. label: 'DatePicker 日期选择器'
  107. }, {
  108. value: 'datetime-picker',
  109. label: 'DateTimePicker 日期时间选择器'
  110. }, {
  111. value: 'upload',
  112. label: 'Upload 上传'
  113. }, {
  114. value: 'rate',
  115. label: 'Rate 评分'
  116. }, {
  117. value: 'form',
  118. label: 'Form 表单'
  119. }]
  120. }, {
  121. value: 'data',
  122. label: 'Data',
  123. children: [{
  124. value: 'table',
  125. label: 'Table 表格'
  126. }, {
  127. value: 'tag',
  128. label: 'Tag 标签'
  129. }, {
  130. value: 'progress',
  131. label: 'Progress 进度条'
  132. }, {
  133. value: 'tree',
  134. label: 'Tree 树形控件'
  135. }, {
  136. value: 'pagination',
  137. label: 'Pagination 分页'
  138. }, {
  139. value: 'badge',
  140. label: 'Badge 标记'
  141. }]
  142. }, {
  143. value: 'notice',
  144. label: 'Notice',
  145. children: [{
  146. value: 'alert',
  147. label: 'Alert 警告'
  148. }, {
  149. value: 'loading',
  150. label: 'Loading 加载'
  151. }, {
  152. value: 'message',
  153. label: 'Message 消息提示'
  154. }, {
  155. value: 'message-box',
  156. label: 'MessageBox 弹框'
  157. }, {
  158. value: 'notification',
  159. label: 'Notification 通知'
  160. }]
  161. }, {
  162. value: 'navigation',
  163. label: 'Navigation',
  164. children: [{
  165. value: 'menu',
  166. label: 'NavMenu 导航菜单'
  167. }, {
  168. value: 'tabs',
  169. label: 'Tabs 标签页'
  170. }, {
  171. value: 'breadcrumb',
  172. label: 'Breadcrumb 面包屑'
  173. }, {
  174. value: 'dropdown',
  175. label: 'Dropdown 下拉菜单'
  176. }, {
  177. value: 'steps',
  178. label: 'Steps 步骤条'
  179. }]
  180. }, {
  181. value: 'others',
  182. label: 'Others',
  183. children: [{
  184. value: 'dialog',
  185. label: 'Dialog 对话框'
  186. }, {
  187. value: 'tooltip',
  188. label: 'Tooltip 文字提示'
  189. }, {
  190. value: 'popover',
  191. label: 'Popover 弹出框'
  192. }, {
  193. value: 'card',
  194. label: 'Card 卡片'
  195. }, {
  196. value: 'carousel',
  197. label: 'Carousel 走马灯'
  198. }, {
  199. value: 'collapse',
  200. label: 'Collapse 折叠面板'
  201. }]
  202. }]
  203. }, {
  204. value: 'ziyuan',
  205. label: '资源',
  206. children: [{
  207. value: 'axure',
  208. label: 'Axure Components'
  209. }, {
  210. value: 'sketch',
  211. label: 'Sketch Templates'
  212. }, {
  213. value: 'jiaohu',
  214. label: '组件交互文档'
  215. }]
  216. }],
  217. selectedOptions: [],
  218. selectedOptions2: []
  219. };
  220. },
  221. methods: {
  222. handleChange(value) {
  223. console.log(value);
  224. }
  225. }
  226. };
  227. </script>

禁用选项

通过在数据源中设置 disabled 字段来声明该选项是禁用的

Cascader 级联选择器 - 图2

本例中,options指定的数组中的第一个元素含有disabled: true键值对,因此是禁用的。在默认情况下,Cascader 会检查数据中每一项的disabled字段是否为true,如果你的数据中表示禁用含义的字段名不为disabled,可以通过props属性来指定(详见下方 API 表格)。当然,valuelabelchildren这三个字段名也可以通过同样的方式指定。

  1. <el-cascader
  2. :options="optionsWithDisabled"
  3. ></el-cascader>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. optionsWithDisabled: [{
  9. value: 'zhinan',
  10. label: '指南',
  11. disabled: true,
  12. children: [{
  13. value: 'shejiyuanze',
  14. label: '设计原则',
  15. children: [{
  16. value: 'yizhi',
  17. label: '一致'
  18. }, {
  19. value: 'fankui',
  20. label: '反馈'
  21. }, {
  22. value: 'xiaolv',
  23. label: '效率'
  24. }, {
  25. value: 'kekong',
  26. label: '可控'
  27. }]
  28. }, {
  29. value: 'daohang',
  30. label: '导航',
  31. children: [{
  32. value: 'cexiangdaohang',
  33. label: '侧向导航'
  34. }, {
  35. value: 'dingbudaohang',
  36. label: '顶部导航'
  37. }]
  38. }]
  39. }, {
  40. value: 'zujian',
  41. label: '组件',
  42. children: [{
  43. value: 'basic',
  44. label: 'Basic',
  45. children: [{
  46. value: 'layout',
  47. label: 'Layout 布局'
  48. }, {
  49. value: 'color',
  50. label: 'Color 色彩'
  51. }, {
  52. value: 'typography',
  53. label: 'Typography 字体'
  54. }, {
  55. value: 'icon',
  56. label: 'Icon 图标'
  57. }, {
  58. value: 'button',
  59. label: 'Button 按钮'
  60. }]
  61. }, {
  62. value: 'form',
  63. label: 'Form',
  64. children: [{
  65. value: 'radio',
  66. label: 'Radio 单选框'
  67. }, {
  68. value: 'checkbox',
  69. label: 'Checkbox 多选框'
  70. }, {
  71. value: 'input',
  72. label: 'Input 输入框'
  73. }, {
  74. value: 'input-number',
  75. label: 'InputNumber 计数器'
  76. }, {
  77. value: 'select',
  78. label: 'Select 选择器'
  79. }, {
  80. value: 'cascader',
  81. label: 'Cascader 级联选择器'
  82. }, {
  83. value: 'switch',
  84. label: 'Switch 开关'
  85. }, {
  86. value: 'slider',
  87. label: 'Slider 滑块'
  88. }, {
  89. value: 'time-picker',
  90. label: 'TimePicker 时间选择器'
  91. }, {
  92. value: 'date-picker',
  93. label: 'DatePicker 日期选择器'
  94. }, {
  95. value: 'datetime-picker',
  96. label: 'DateTimePicker 日期时间选择器'
  97. }, {
  98. value: 'upload',
  99. label: 'Upload 上传'
  100. }, {
  101. value: 'rate',
  102. label: 'Rate 评分'
  103. }, {
  104. value: 'form',
  105. label: 'Form 表单'
  106. }]
  107. }, {
  108. value: 'data',
  109. label: 'Data',
  110. children: [{
  111. value: 'table',
  112. label: 'Table 表格'
  113. }, {
  114. value: 'tag',
  115. label: 'Tag 标签'
  116. }, {
  117. value: 'progress',
  118. label: 'Progress 进度条'
  119. }, {
  120. value: 'tree',
  121. label: 'Tree 树形控件'
  122. }, {
  123. value: 'pagination',
  124. label: 'Pagination 分页'
  125. }, {
  126. value: 'badge',
  127. label: 'Badge 标记'
  128. }]
  129. }, {
  130. value: 'notice',
  131. label: 'Notice',
  132. children: [{
  133. value: 'alert',
  134. label: 'Alert 警告'
  135. }, {
  136. value: 'loading',
  137. label: 'Loading 加载'
  138. }, {
  139. value: 'message',
  140. label: 'Message 消息提示'
  141. }, {
  142. value: 'message-box',
  143. label: 'MessageBox 弹框'
  144. }, {
  145. value: 'notification',
  146. label: 'Notification 通知'
  147. }]
  148. }, {
  149. value: 'navigation',
  150. label: 'Navigation',
  151. children: [{
  152. value: 'menu',
  153. label: 'NavMenu 导航菜单'
  154. }, {
  155. value: 'tabs',
  156. label: 'Tabs 标签页'
  157. }, {
  158. value: 'breadcrumb',
  159. label: 'Breadcrumb 面包屑'
  160. }, {
  161. value: 'dropdown',
  162. label: 'Dropdown 下拉菜单'
  163. }, {
  164. value: 'steps',
  165. label: 'Steps 步骤条'
  166. }]
  167. }, {
  168. value: 'others',
  169. label: 'Others',
  170. children: [{
  171. value: 'dialog',
  172. label: 'Dialog 对话框'
  173. }, {
  174. value: 'tooltip',
  175. label: 'Tooltip 文字提示'
  176. }, {
  177. value: 'popover',
  178. label: 'Popover 弹出框'
  179. }, {
  180. value: 'card',
  181. label: 'Card 卡片'
  182. }, {
  183. value: 'carousel',
  184. label: 'Carousel 走马灯'
  185. }, {
  186. value: 'collapse',
  187. label: 'Collapse 折叠面板'
  188. }]
  189. }]
  190. }, {
  191. value: 'ziyuan',
  192. label: '资源',
  193. children: [{
  194. value: 'axure',
  195. label: 'Axure Components'
  196. }, {
  197. value: 'sketch',
  198. label: 'Sketch Templates'
  199. }, {
  200. value: 'jiaohu',
  201. label: '组件交互文档'
  202. }]
  203. }]
  204. };
  205. }
  206. };
  207. </script>

仅显示最后一级

可以仅在输入框中显示选中项最后一级的标签,而不是选中项所在的完整路径。

Cascader 级联选择器 - 图3

属性show-all-levels定义了是否显示完整的路径,将其赋值为false则仅显示最后一级

  1. <el-cascader
  2. :options="options"
  3. :show-all-levels="false"
  4. ></el-cascader>
  5. <script>
  6. export default {
  7. data() {
  8. return {
  9. options: [{
  10. value: 'zhinan',
  11. label: '指南',
  12. children: [{
  13. value: 'shejiyuanze',
  14. label: '设计原则',
  15. children: [{
  16. value: 'yizhi',
  17. label: '一致'
  18. }, {
  19. value: 'fankui',
  20. label: '反馈'
  21. }, {
  22. value: 'xiaolv',
  23. label: '效率'
  24. }, {
  25. value: 'kekong',
  26. label: '可控'
  27. }]
  28. }, {
  29. value: 'daohang',
  30. label: '导航',
  31. children: [{
  32. value: 'cexiangdaohang',
  33. label: '侧向导航'
  34. }, {
  35. value: 'dingbudaohang',
  36. label: '顶部导航'
  37. }]
  38. }]
  39. }, {
  40. value: 'zujian',
  41. label: '组件',
  42. children: [{
  43. value: 'basic',
  44. label: 'Basic',
  45. children: [{
  46. value: 'layout',
  47. label: 'Layout 布局'
  48. }, {
  49. value: 'color',
  50. label: 'Color 色彩'
  51. }, {
  52. value: 'typography',
  53. label: 'Typography 字体'
  54. }, {
  55. value: 'icon',
  56. label: 'Icon 图标'
  57. }, {
  58. value: 'button',
  59. label: 'Button 按钮'
  60. }]
  61. }, {
  62. value: 'form',
  63. label: 'Form',
  64. children: [{
  65. value: 'radio',
  66. label: 'Radio 单选框'
  67. }, {
  68. value: 'checkbox',
  69. label: 'Checkbox 多选框'
  70. }, {
  71. value: 'input',
  72. label: 'Input 输入框'
  73. }, {
  74. value: 'input-number',
  75. label: 'InputNumber 计数器'
  76. }, {
  77. value: 'select',
  78. label: 'Select 选择器'
  79. }, {
  80. value: 'cascader',
  81. label: 'Cascader 级联选择器'
  82. }, {
  83. value: 'switch',
  84. label: 'Switch 开关'
  85. }, {
  86. value: 'slider',
  87. label: 'Slider 滑块'
  88. }, {
  89. value: 'time-picker',
  90. label: 'TimePicker 时间选择器'
  91. }, {
  92. value: 'date-picker',
  93. label: 'DatePicker 日期选择器'
  94. }, {
  95. value: 'datetime-picker',
  96. label: 'DateTimePicker 日期时间选择器'
  97. }, {
  98. value: 'upload',
  99. label: 'Upload 上传'
  100. }, {
  101. value: 'rate',
  102. label: 'Rate 评分'
  103. }, {
  104. value: 'form',
  105. label: 'Form 表单'
  106. }]
  107. }, {
  108. value: 'data',
  109. label: 'Data',
  110. children: [{
  111. value: 'table',
  112. label: 'Table 表格'
  113. }, {
  114. value: 'tag',
  115. label: 'Tag 标签'
  116. }, {
  117. value: 'progress',
  118. label: 'Progress 进度条'
  119. }, {
  120. value: 'tree',
  121. label: 'Tree 树形控件'
  122. }, {
  123. value: 'pagination',
  124. label: 'Pagination 分页'
  125. }, {
  126. value: 'badge',
  127. label: 'Badge 标记'
  128. }]
  129. }, {
  130. value: 'notice',
  131. label: 'Notice',
  132. children: [{
  133. value: 'alert',
  134. label: 'Alert 警告'
  135. }, {
  136. value: 'loading',
  137. label: 'Loading 加载'
  138. }, {
  139. value: 'message',
  140. label: 'Message 消息提示'
  141. }, {
  142. value: 'message-box',
  143. label: 'MessageBox 弹框'
  144. }, {
  145. value: 'notification',
  146. label: 'Notification 通知'
  147. }]
  148. }, {
  149. value: 'navigation',
  150. label: 'Navigation',
  151. children: [{
  152. value: 'menu',
  153. label: 'NavMenu 导航菜单'
  154. }, {
  155. value: 'tabs',
  156. label: 'Tabs 标签页'
  157. }, {
  158. value: 'breadcrumb',
  159. label: 'Breadcrumb 面包屑'
  160. }, {
  161. value: 'dropdown',
  162. label: 'Dropdown 下拉菜单'
  163. }, {
  164. value: 'steps',
  165. label: 'Steps 步骤条'
  166. }]
  167. }, {
  168. value: 'others',
  169. label: 'Others',
  170. children: [{
  171. value: 'dialog',
  172. label: 'Dialog 对话框'
  173. }, {
  174. value: 'tooltip',
  175. label: 'Tooltip 文字提示'
  176. }, {
  177. value: 'popover',
  178. label: 'Popover 弹出框'
  179. }, {
  180. value: 'card',
  181. label: 'Card 卡片'
  182. }, {
  183. value: 'carousel',
  184. label: 'Carousel 走马灯'
  185. }, {
  186. value: 'collapse',
  187. label: 'Collapse 折叠面板'
  188. }]
  189. }]
  190. }, {
  191. value: 'ziyuan',
  192. label: '资源',
  193. children: [{
  194. value: 'axure',
  195. label: 'Axure Components'
  196. }, {
  197. value: 'sketch',
  198. label: 'Sketch Templates'
  199. }, {
  200. value: 'jiaohu',
  201. label: '组件交互文档'
  202. }]
  203. }]
  204. };
  205. }
  206. };
  207. </script>

默认值

Cascader 级联选择器 - 图4

默认值通过数组的方式指定。

  1. <el-cascader
  2. :options="options"
  3. v-model="selectedOptions"
  4. ></el-cascader>
  5. <script>
  6. export default {
  7. data() {
  8. return {
  9. options: [{
  10. value: 'zhinan',
  11. label: '指南',
  12. children: [{
  13. value: 'shejiyuanze',
  14. label: '设计原则',
  15. children: [{
  16. value: 'yizhi',
  17. label: '一致'
  18. }, {
  19. value: 'fankui',
  20. label: '反馈'
  21. }, {
  22. value: 'xiaolv',
  23. label: '效率'
  24. }, {
  25. value: 'kekong',
  26. label: '可控'
  27. }]
  28. }, {
  29. value: 'daohang',
  30. label: '导航',
  31. children: [{
  32. value: 'cexiangdaohang',
  33. label: '侧向导航'
  34. }, {
  35. value: 'dingbudaohang',
  36. label: '顶部导航'
  37. }]
  38. }]
  39. }, {
  40. value: 'zujian',
  41. label: '组件',
  42. children: [{
  43. value: 'basic',
  44. label: 'Basic',
  45. children: [{
  46. value: 'layout',
  47. label: 'Layout 布局'
  48. }, {
  49. value: 'color',
  50. label: 'Color 色彩'
  51. }, {
  52. value: 'typography',
  53. label: 'Typography 字体'
  54. }, {
  55. value: 'icon',
  56. label: 'Icon 图标'
  57. }, {
  58. value: 'button',
  59. label: 'Button 按钮'
  60. }]
  61. }, {
  62. value: 'form',
  63. label: 'Form',
  64. children: [{
  65. value: 'radio',
  66. label: 'Radio 单选框'
  67. }, {
  68. value: 'checkbox',
  69. label: 'Checkbox 多选框'
  70. }, {
  71. value: 'input',
  72. label: 'Input 输入框'
  73. }, {
  74. value: 'input-number',
  75. label: 'InputNumber 计数器'
  76. }, {
  77. value: 'select',
  78. label: 'Select 选择器'
  79. }, {
  80. value: 'cascader',
  81. label: 'Cascader 级联选择器'
  82. }, {
  83. value: 'switch',
  84. label: 'Switch 开关'
  85. }, {
  86. value: 'slider',
  87. label: 'Slider 滑块'
  88. }, {
  89. value: 'time-picker',
  90. label: 'TimePicker 时间选择器'
  91. }, {
  92. value: 'date-picker',
  93. label: 'DatePicker 日期选择器'
  94. }, {
  95. value: 'datetime-picker',
  96. label: 'DateTimePicker 日期时间选择器'
  97. }, {
  98. value: 'upload',
  99. label: 'Upload 上传'
  100. }, {
  101. value: 'rate',
  102. label: 'Rate 评分'
  103. }, {
  104. value: 'form',
  105. label: 'Form 表单'
  106. }]
  107. }, {
  108. value: 'data',
  109. label: 'Data',
  110. children: [{
  111. value: 'table',
  112. label: 'Table 表格'
  113. }, {
  114. value: 'tag',
  115. label: 'Tag 标签'
  116. }, {
  117. value: 'progress',
  118. label: 'Progress 进度条'
  119. }, {
  120. value: 'tree',
  121. label: 'Tree 树形控件'
  122. }, {
  123. value: 'pagination',
  124. label: 'Pagination 分页'
  125. }, {
  126. value: 'badge',
  127. label: 'Badge 标记'
  128. }]
  129. }, {
  130. value: 'notice',
  131. label: 'Notice',
  132. children: [{
  133. value: 'alert',
  134. label: 'Alert 警告'
  135. }, {
  136. value: 'loading',
  137. label: 'Loading 加载'
  138. }, {
  139. value: 'message',
  140. label: 'Message 消息提示'
  141. }, {
  142. value: 'message-box',
  143. label: 'MessageBox 弹框'
  144. }, {
  145. value: 'notification',
  146. label: 'Notification 通知'
  147. }]
  148. }, {
  149. value: 'navigation',
  150. label: 'Navigation',
  151. children: [{
  152. value: 'menu',
  153. label: 'NavMenu 导航菜单'
  154. }, {
  155. value: 'tabs',
  156. label: 'Tabs 标签页'
  157. }, {
  158. value: 'breadcrumb',
  159. label: 'Breadcrumb 面包屑'
  160. }, {
  161. value: 'dropdown',
  162. label: 'Dropdown 下拉菜单'
  163. }, {
  164. value: 'steps',
  165. label: 'Steps 步骤条'
  166. }]
  167. }, {
  168. value: 'others',
  169. label: 'Others',
  170. children: [{
  171. value: 'dialog',
  172. label: 'Dialog 对话框'
  173. }, {
  174. value: 'tooltip',
  175. label: 'Tooltip 文字提示'
  176. }, {
  177. value: 'popover',
  178. label: 'Popover 弹出框'
  179. }, {
  180. value: 'card',
  181. label: 'Card 卡片'
  182. }, {
  183. value: 'carousel',
  184. label: 'Carousel 走马灯'
  185. }, {
  186. value: 'collapse',
  187. label: 'Collapse 折叠面板'
  188. }]
  189. }]
  190. }, {
  191. value: 'ziyuan',
  192. label: '资源',
  193. children: [{
  194. value: 'axure',
  195. label: 'Axure Components'
  196. }, {
  197. value: 'sketch',
  198. label: 'Sketch Templates'
  199. }, {
  200. value: 'jiaohu',
  201. label: '组件交互文档'
  202. }]
  203. }],
  204. selectedOptions: ['zujian', 'data', 'tag']
  205. };
  206. }
  207. };
  208. </script>

选择即改变

点击或移入选项即表示选中该项,可用于选择任意一级菜单的选项。

Cascader 级联选择器 - 图5

若需要允许用户选择任意一级选项,则可将change-on-select赋值为true

  1. <el-cascader
  2. :options="options"
  3. change-on-select
  4. ></el-cascader>
  5. <script>
  6. export default {
  7. data() {
  8. return {
  9. options: [{
  10. value: 'zhinan',
  11. label: '指南',
  12. children: [{
  13. value: 'shejiyuanze',
  14. label: '设计原则',
  15. children: [{
  16. value: 'yizhi',
  17. label: '一致'
  18. }, {
  19. value: 'fankui',
  20. label: '反馈'
  21. }, {
  22. value: 'xiaolv',
  23. label: '效率'
  24. }, {
  25. value: 'kekong',
  26. label: '可控'
  27. }]
  28. }, {
  29. value: 'daohang',
  30. label: '导航',
  31. children: [{
  32. value: 'cexiangdaohang',
  33. label: '侧向导航'
  34. }, {
  35. value: 'dingbudaohang',
  36. label: '顶部导航'
  37. }]
  38. }]
  39. }, {
  40. value: 'zujian',
  41. label: '组件',
  42. children: [{
  43. value: 'basic',
  44. label: 'Basic',
  45. children: [{
  46. value: 'layout',
  47. label: 'Layout 布局'
  48. }, {
  49. value: 'color',
  50. label: 'Color 色彩'
  51. }, {
  52. value: 'typography',
  53. label: 'Typography 字体'
  54. }, {
  55. value: 'icon',
  56. label: 'Icon 图标'
  57. }, {
  58. value: 'button',
  59. label: 'Button 按钮'
  60. }]
  61. }, {
  62. value: 'form',
  63. label: 'Form',
  64. children: [{
  65. value: 'radio',
  66. label: 'Radio 单选框'
  67. }, {
  68. value: 'checkbox',
  69. label: 'Checkbox 多选框'
  70. }, {
  71. value: 'input',
  72. label: 'Input 输入框'
  73. }, {
  74. value: 'input-number',
  75. label: 'InputNumber 计数器'
  76. }, {
  77. value: 'select',
  78. label: 'Select 选择器'
  79. }, {
  80. value: 'cascader',
  81. label: 'Cascader 级联选择器'
  82. }, {
  83. value: 'switch',
  84. label: 'Switch 开关'
  85. }, {
  86. value: 'slider',
  87. label: 'Slider 滑块'
  88. }, {
  89. value: 'time-picker',
  90. label: 'TimePicker 时间选择器'
  91. }, {
  92. value: 'date-picker',
  93. label: 'DatePicker 日期选择器'
  94. }, {
  95. value: 'datetime-picker',
  96. label: 'DateTimePicker 日期时间选择器'
  97. }, {
  98. value: 'upload',
  99. label: 'Upload 上传'
  100. }, {
  101. value: 'rate',
  102. label: 'Rate 评分'
  103. }, {
  104. value: 'form',
  105. label: 'Form 表单'
  106. }]
  107. }, {
  108. value: 'data',
  109. label: 'Data',
  110. children: [{
  111. value: 'table',
  112. label: 'Table 表格'
  113. }, {
  114. value: 'tag',
  115. label: 'Tag 标签'
  116. }, {
  117. value: 'progress',
  118. label: 'Progress 进度条'
  119. }, {
  120. value: 'tree',
  121. label: 'Tree 树形控件'
  122. }, {
  123. value: 'pagination',
  124. label: 'Pagination 分页'
  125. }, {
  126. value: 'badge',
  127. label: 'Badge 标记'
  128. }]
  129. }, {
  130. value: 'notice',
  131. label: 'Notice',
  132. children: [{
  133. value: 'alert',
  134. label: 'Alert 警告'
  135. }, {
  136. value: 'loading',
  137. label: 'Loading 加载'
  138. }, {
  139. value: 'message',
  140. label: 'Message 消息提示'
  141. }, {
  142. value: 'message-box',
  143. label: 'MessageBox 弹框'
  144. }, {
  145. value: 'notification',
  146. label: 'Notification 通知'
  147. }]
  148. }, {
  149. value: 'navigation',
  150. label: 'Navigation',
  151. children: [{
  152. value: 'menu',
  153. label: 'NavMenu 导航菜单'
  154. }, {
  155. value: 'tabs',
  156. label: 'Tabs 标签页'
  157. }, {
  158. value: 'breadcrumb',
  159. label: 'Breadcrumb 面包屑'
  160. }, {
  161. value: 'dropdown',
  162. label: 'Dropdown 下拉菜单'
  163. }, {
  164. value: 'steps',
  165. label: 'Steps 步骤条'
  166. }]
  167. }, {
  168. value: 'others',
  169. label: 'Others',
  170. children: [{
  171. value: 'dialog',
  172. label: 'Dialog 对话框'
  173. }, {
  174. value: 'tooltip',
  175. label: 'Tooltip 文字提示'
  176. }, {
  177. value: 'popover',
  178. label: 'Popover 弹出框'
  179. }, {
  180. value: 'card',
  181. label: 'Card 卡片'
  182. }, {
  183. value: 'carousel',
  184. label: 'Carousel 走马灯'
  185. }, {
  186. value: 'collapse',
  187. label: 'Collapse 折叠面板'
  188. }]
  189. }]
  190. }, {
  191. value: 'ziyuan',
  192. label: '资源',
  193. children: [{
  194. value: 'axure',
  195. label: 'Axure Components'
  196. }, {
  197. value: 'sketch',
  198. label: 'Sketch Templates'
  199. }, {
  200. value: 'jiaohu',
  201. label: '组件交互文档'
  202. }]
  203. }]
  204. };
  205. }
  206. };
  207. </script>

动态加载次级选项

当选中某一级时,动态加载该级下的选项。

Cascader 级联选择器 - 图6

本例的选项数据源在初始化时不包含城市数据。利用active-item-change事件,可以在用户点击某个省份时拉取该省份下的城市数据。此外,本例还展示了props属性的用法。

  1. <el-cascader
  2. :options="options"
  3. @active-item-change="handleItemChange"
  4. :props="props"
  5. ></el-cascader>
  6. <script>
  7. export default {
  8. data() {
  9. return {
  10. options: [{
  11. label: '江苏',
  12. cities: []
  13. }, {
  14. label: '浙江',
  15. cities: []
  16. }],
  17. props: {
  18. value: 'label',
  19. children: 'cities'
  20. }
  21. };
  22. },
  23. methods: {
  24. handleItemChange(val) {
  25. console.log('active item:', val);
  26. setTimeout(_ => {
  27. if (val.indexOf('江苏') > -1 && !this.options2[0].cities.length) {
  28. this.options2[0].cities = [{
  29. label: '南京'
  30. }];
  31. } else if (val.indexOf('浙江') > -1 && !this.options2[1].cities.length) {
  32. this.options2[1].cities = [{
  33. label: '杭州'
  34. }];
  35. }
  36. }, 300);
  37. }
  38. }
  39. };
  40. </script>

可搜索

可以快捷地搜索选项并选择。

Cascader 级联选择器 - 图7

filterable赋值为true即可打开搜索功能。

  1. <div class="block">
  2. <span class="demonstration">只可选择最后一级菜单的选项</span>
  3. <el-cascader
  4. placeholder="试试搜索:指南"
  5. :options="options"
  6. filterable
  7. ></el-cascader>
  8. </div>
  9. <div class="block">
  10. <span class="demonstration">可选择任意一级菜单的选项</span>
  11. <el-cascader
  12. placeholder="试试搜索:指南"
  13. :options="options"
  14. filterable
  15. change-on-select
  16. ></el-cascader>
  17. </div>
  18. <script>
  19. export default {
  20. data() {
  21. return {
  22. options: [{
  23. value: 'zhinan',
  24. label: '指南',
  25. children: [{
  26. value: 'shejiyuanze',
  27. label: '设计原则',
  28. children: [{
  29. value: 'yizhi',
  30. label: '一致'
  31. }, {
  32. value: 'fankui',
  33. label: '反馈'
  34. }, {
  35. value: 'xiaolv',
  36. label: '效率'
  37. }, {
  38. value: 'kekong',
  39. label: '可控'
  40. }]
  41. }, {
  42. value: 'daohang',
  43. label: '导航',
  44. children: [{
  45. value: 'cexiangdaohang',
  46. label: '侧向导航'
  47. }, {
  48. value: 'dingbudaohang',
  49. label: '顶部导航'
  50. }]
  51. }]
  52. }, {
  53. value: 'zujian',
  54. label: '组件',
  55. children: [{
  56. value: 'basic',
  57. label: 'Basic',
  58. children: [{
  59. value: 'layout',
  60. label: 'Layout 布局'
  61. }, {
  62. value: 'color',
  63. label: 'Color 色彩'
  64. }, {
  65. value: 'typography',
  66. label: 'Typography 字体'
  67. }, {
  68. value: 'icon',
  69. label: 'Icon 图标'
  70. }, {
  71. value: 'button',
  72. label: 'Button 按钮'
  73. }]
  74. }, {
  75. value: 'form',
  76. label: 'Form',
  77. children: [{
  78. value: 'radio',
  79. label: 'Radio 单选框'
  80. }, {
  81. value: 'checkbox',
  82. label: 'Checkbox 多选框'
  83. }, {
  84. value: 'input',
  85. label: 'Input 输入框'
  86. }, {
  87. value: 'input-number',
  88. label: 'InputNumber 计数器'
  89. }, {
  90. value: 'select',
  91. label: 'Select 选择器'
  92. }, {
  93. value: 'cascader',
  94. label: 'Cascader 级联选择器'
  95. }, {
  96. value: 'switch',
  97. label: 'Switch 开关'
  98. }, {
  99. value: 'slider',
  100. label: 'Slider 滑块'
  101. }, {
  102. value: 'time-picker',
  103. label: 'TimePicker 时间选择器'
  104. }, {
  105. value: 'date-picker',
  106. label: 'DatePicker 日期选择器'
  107. }, {
  108. value: 'datetime-picker',
  109. label: 'DateTimePicker 日期时间选择器'
  110. }, {
  111. value: 'upload',
  112. label: 'Upload 上传'
  113. }, {
  114. value: 'rate',
  115. label: 'Rate 评分'
  116. }, {
  117. value: 'form',
  118. label: 'Form 表单'
  119. }]
  120. }, {
  121. value: 'data',
  122. label: 'Data',
  123. children: [{
  124. value: 'table',
  125. label: 'Table 表格'
  126. }, {
  127. value: 'tag',
  128. label: 'Tag 标签'
  129. }, {
  130. value: 'progress',
  131. label: 'Progress 进度条'
  132. }, {
  133. value: 'tree',
  134. label: 'Tree 树形控件'
  135. }, {
  136. value: 'pagination',
  137. label: 'Pagination 分页'
  138. }, {
  139. value: 'badge',
  140. label: 'Badge 标记'
  141. }]
  142. }, {
  143. value: 'notice',
  144. label: 'Notice',
  145. children: [{
  146. value: 'alert',
  147. label: 'Alert 警告'
  148. }, {
  149. value: 'loading',
  150. label: 'Loading 加载'
  151. }, {
  152. value: 'message',
  153. label: 'Message 消息提示'
  154. }, {
  155. value: 'message-box',
  156. label: 'MessageBox 弹框'
  157. }, {
  158. value: 'notification',
  159. label: 'Notification 通知'
  160. }]
  161. }, {
  162. value: 'navigation',
  163. label: 'Navigation',
  164. children: [{
  165. value: 'menu',
  166. label: 'NavMenu 导航菜单'
  167. }, {
  168. value: 'tabs',
  169. label: 'Tabs 标签页'
  170. }, {
  171. value: 'breadcrumb',
  172. label: 'Breadcrumb 面包屑'
  173. }, {
  174. value: 'dropdown',
  175. label: 'Dropdown 下拉菜单'
  176. }, {
  177. value: 'steps',
  178. label: 'Steps 步骤条'
  179. }]
  180. }, {
  181. value: 'others',
  182. label: 'Others',
  183. children: [{
  184. value: 'dialog',
  185. label: 'Dialog 对话框'
  186. }, {
  187. value: 'tooltip',
  188. label: 'Tooltip 文字提示'
  189. }, {
  190. value: 'popover',
  191. label: 'Popover 弹出框'
  192. }, {
  193. value: 'card',
  194. label: 'Card 卡片'
  195. }, {
  196. value: 'carousel',
  197. label: 'Carousel 走马灯'
  198. }, {
  199. value: 'collapse',
  200. label: 'Collapse 折叠面板'
  201. }]
  202. }]
  203. }, {
  204. value: 'ziyuan',
  205. label: '资源',
  206. children: [{
  207. value: 'axure',
  208. label: 'Axure Components'
  209. }, {
  210. value: 'sketch',
  211. label: 'Sketch Templates'
  212. }, {
  213. value: 'jiaohu',
  214. label: '组件交互文档'
  215. }]
  216. }]
  217. };
  218. }
  219. };
  220. </script>

Attributes

参数说明类型可选值默认值
value / v-model选中项绑定值array
options可选项数据源,键名可通过 props 属性配置array
props配置选项,具体见下表object
separator选项分隔符string斜杠'/'
popper-class自定义浮层类名string
placeholder输入框占位文本string请选择
disabled是否禁用booleanfalse
clearable是否支持清空选项booleanfalse
expand-trigger次级菜单的展开方式stringclick / hoverclick
show-all-levels输入框中是否显示选中值的完整路径booleantrue
filterable是否可搜索选项boolean
debounce搜索关键词输入的去抖延迟,毫秒number300
change-on-select是否允许选择任意一级的选项booleanfalse
size尺寸stringmedium / small / mini
before-filter筛选之前的钩子,参数为输入的值,若返回 false 或者返回 Promise 且被 reject,则停止筛选function(value)

props

参数说明类型可选值默认值
value指定选项的值为选项对象的某个属性值string
label指定选项标签为选项对象的某个属性值string
children指定选项的子选项为选项对象的某个属性值string
disabled指定选项的禁用为选项对象的某个属性值string

Events

事件名称说明回调参数
change当绑定值变化时触发的事件当前值
active-item-change当父级选项变化时触发的事件,仅在 change-on-selectfalse 时可用各父级选项组成的数组
blur在 Cascader 失去焦点时触发(event: Event)
focus在 Cascader 获得焦点时触发(event: Event)
visible-change下拉框出现/隐藏时触发出现则为 true,隐藏则为 false