# 快速上手

# 全量引入

import Vue from 'vue'
import LhUIVue2 from '@lh-ui/vue2'
import '@lh-ui/vue2/theme.css'

Vue.use(LhUIVue2)

# 按需引入(推薦,利於 tree-shaking)

import Vue from 'vue'
import { LhButton, LhInput } from '@lh-ui/vue2'
import '@lh-ui/vue2/theme.css'
// 每元件樣式單獨引入(無副作用負擔,見各元件文件頂部說明)
import '@lh-ui/vue2/style/button'
import '@lh-ui/vue2/style/input'

Vue.use(LhButton)
Vue.use(LhInput)

# 全域設定(可選)

用 LhConfigProvider 包裹應用根,統一設定尺寸、語言與主題變數:

<template>
  <LhConfigProvider size="medium" locale="zh-CN" :theme-vars="{ 'primary-color': '#2B4C7C' }">
    <router-view />
  </LhConfigProvider>
</template>

# v-model 與 .sync

Vue2 語意與本庫約定:

  • 表單控制項雙向綁定:<LhInput v-model="text" />(內部 model: { prop: 'modelValue', event: 'input' })
  • 對話框顯隱:<LhDialog :visible.sync="show" />(.sync 即 update:xxx 事件約定,Dialog 亦支援 v-model)

# 命令式 API

import { t, setLocale } from '@lh-ui/vue2'
setLocale('en-US')
t('input.placeholder') // 'Please input'

警告

Vue 2.7 環境注意事項與完整紅線(動態屬性回應式、無 Teleport 的彈層方案等)見倉庫 AGENTS.md。

Copyright © 2024-2026 风默文学 | 宁ICP备2024006574号 | 公安备案徽标苏公网安备32040002010537