vant-vue3

When to use this skill

• Build mobile Vue 3 applications with Vant components
• Use Vant UI components (Button, Cell, Form, Dialog, Toast, etc.)
• Create mobile-friendly interfaces
• Customize Vant theme
• Implement internationalization with Vant
• Use Vant with TypeScript
• Handle mobile gestures and interactions
• Implement mobile navigation patterns
• Use mobile form components
• Create mobile data display components

How to use this skill

1. Identify the topic from the user's request:
   • Getting started/快速开始 →

     examples/getting-started/installation.md

     or

     examples/getting-started/basic-usage.md

   • Button/按钮 →

     examples/components/button.md

   • Cell/单元格 →

     examples/components/cell.md

   • Form/表单 →

     examples/components/form.md

   • Dialog/对话框 →

     examples/components/dialog.md

   • Toast/提示 →

     examples/components/toast.md

   • Popup/弹出层 →

     examples/components/popup.md

   • Theme/主题 →

     examples/advanced/theme-customization.md

2. Load the appropriate example file from the

   examples/

   directory:
   Getting Started (快速开始) -

   examples/getting-started/

   :

   • examples/getting-started/installation.md

     - Installing Vant and basic setup

   • examples/getting-started/basic-usage.md

     - Basic component usage
   Components (组件) -

   examples/components/

   :

   • examples/components/button.md

     - Button component

   • examples/components/cell.md

     - Cell component

   • examples/components/icon.md

     - Icon component

   • examples/components/image.md

     - Image component

   • examples/components/popup.md

     - Popup component

   • examples/components/toast.md

     - Toast component

   • examples/components/dialog.md

     - Dialog component

   • examples/components/form.md

     - Form component

   • examples/components/field.md

     - Field component

   • examples/components/picker.md

     - Picker component

   • examples/components/calendar.md

     - Calendar component

   • examples/components/tabs.md

     - Tabs component

   • examples/components/tabbar.md

     - Tabbar component

   • examples/components/navbar.md

     - Navbar component

   • examples/components/list.md

     - List component

   • examples/components/grid.md

     - Grid component

   • examples/components/card.md

     - Card component

   • examples/components/badge.md

     - Badge component

   • examples/components/loading.md

     - Loading component

   • examples/components/action-sheet.md

     - ActionSheet component
   Advanced (高级) -

   examples/advanced/

   :

   • examples/advanced/theme-customization.md

     - Customizing Vant theme

   • examples/advanced/internationalization.md

     - Internationalization setup

   • examples/advanced/typescript.md

     - TypeScript support
3. Follow the specific instructions in that example file for syntax, structure, and best practices
   Important Notes:
   • All examples follow Vant Vue 3.0 API
   • Examples use Composition API syntax
   • Each example file includes key concepts, code examples, and key points
   • Always check the example file for best practices and common patterns
   • Vant is optimized for mobile devices
4. Reference API documentation in the

   api/

   directory when needed:

   • api/components.md

     - Component API reference

   • api/config-provider.md

     - ConfigProvider API

   • api/hooks.md

     - Composition Hooks API
5. Use templates from the

   templates/

   directory:

   • templates/project-setup.md

     - Project setup templates

   • templates/component-template.md

     - Component usage templates

Doc mapping (one-to-one with official documentation)

• See guide files in

  examples/guide/

  or

  examples/getting-started/

  → https://vant-ui.github.io/vant/#/zh-CN

• See component files in

  examples/components/

  → https://vant-ui.github.io/vant/#/zh-CN

Examples and Templates

examples/

• Identify the topic from the user's request
• Load the appropriate example file from the mapping above
• Follow the instructions, syntax, and best practices in that file
• Adapt the code examples to your specific use case

• Reference templates in

  templates/

  directory for common scaffolding
• Adapt templates to your specific needs and coding style

API Reference

api/

Components API (

api/components.md

)

• All component props and APIs
• Component events and slots
• Component types and interfaces

ConfigProvider API (

api/config-provider.md

)

• ConfigProvider component API
• Global configuration options
• Theme configuration

Hooks API (

api/hooks.md

)

• Composition hooks (useClickAway, useWindowSize, etc.)
• Utility hooks

1. Identify the API you need help with
2. Load the corresponding API file from the

   api/

   directory
3. Find the API signature, parameters, return type, and examples
4. Reference the linked example files for detailed usage patterns
5. All API files include links to relevant example files in the

   examples/

   directory

Best Practices

1. Import Vant CSS: Import Vant CSS in your entry file
2. Use Composition API: Prefer Composition API for Vue 3 projects
3. Tree-shaking: Import components individually for better tree-shaking
4. Mobile-first: Design for mobile devices first
5. Touch interactions: Consider touch gestures and interactions
6. Performance: Optimize for mobile performance
7. Theme customization: Use CSS variables for consistent theming
8. Internationalization: Use ConfigProvider with locale for i18n
9. TypeScript: Use TypeScript for better type safety
10. Component composition: Compose components for complex UIs

Resources

• Official Website: https://vant-ui.github.io/
• Documentation: https://vant-ui.github.io/vant/#/zh-CN
• GitHub Repository: https://github.com/youzan/vant

Keywords