[
{
"path": ".github/FUNDING.yml",
"content": "# These are supported funding model platforms\n\n# github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]\n# patreon: # Replace with a single Patreon username\n# open_collective: # Replace with a single Open Collective username\n# ko_fi: # Replace with a single Ko-fi username\n# tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel\n# community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry\n# liberapay: # Replace with a single Liberapay username\n# issuehunt: # Replace with a single IssueHunt username\n# otechie: # Replace with a single Otechie username\n# custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']\n"
},
{
"path": ".github/ISSUE_TEMPLATE/bug_report.yml",
"content": "name: 🐞 Bug report\ndescription: Report an issue with naive-ui\nlabels: [untriaged]\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for taking the time to fill out this bug report!\n - type: textarea\n id: bug-description\n attributes:\n label: Describe the bug\n description: A clear and concise description of what the bug is. If you intend to submit a PR for this issue, tell us in the description. Thanks!\n placeholder: Bug description\n validations:\n required: true\n - type: textarea\n id: steps\n attributes:\n label: Steps to reproduce\n description: Clear and concise steps to reproduce this bug.\n placeholder: |\n 1. apply magic\n 2. wait 3.1415 seconds\n 3. 🧙🏽♂️\n validations:\n required: true\n - type: input\n id: reproduction\n attributes:\n label: Link to minimal reproduction\n description: Please provide a [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example). Provide a streamlined [Playground](https://play-naive.pro-components.cn)/CodePen/CodeSandbox or GitHub repository link. Please don't fill in a link randomly.\n placeholder: Reproduction\n validations:\n required: true\n - type: textarea\n id: system-info\n attributes:\n label: System Info\n description: Output of `npx envinfo --system --npmPackages 'naive-ui,vue' --binaries --browsers`\n render: Shell\n placeholder: System, Binaries, Browsers\n validations:\n required: true\n - type: dropdown\n id: package-manager\n attributes:\n label: Used Package Manager\n description: Select the used package manager\n options:\n - npm\n - yarn\n - pnpm\n validations:\n required: true\n - type: checkboxes\n id: checkboxes\n attributes:\n label: Validations\n description: Before submitting the issue, please make sure you do the following\n options:\n - label: Read the [Contributing Guidelines](https://github.com/tusen-ai/naive-ui/blob/main/CONTRIBUTING.md).\n required: true\n - label: Read the [docs](https://www.naiveui.com/en-US/).\n required: true\n - label: Check that there isn't [already an issue](https://github.com/tusen-ai/naive-ui/issues) that reports the same bug to avoid creating a duplicate.\n required: true\n - label: Check that this is a concrete bug. For Q&A open a [GitHub Discussion](https://github.com/tusen-ai/naive-ui/discussions).\n required: true\n - label: The provided reproduction is a [minimal reproducible example](https://stackoverflow.com/help/minimal-reproducible-example) of the bug.\n required: true\n"
},
{
"path": ".github/ISSUE_TEMPLATE/bug_report.zh-CN.yml",
"content": "name: 🐞 错误报告\ndescription: 报告 naive-ui 的问题\nlabels: [untriaged]\nbody:\n - type: markdown\n attributes:\n value: |\n 感谢您抽出时间填写此错误报告！\n - type: textarea\n id: bug-description\n attributes:\n label: 描述错误\n description: 对错误的清晰而简明的描述。如果您打算为此问题提交 PR，请在描述中告诉我们。谢谢！\n placeholder: 错误描述\n validations:\n required: true\n - type: textarea\n id: steps\n attributes:\n label: 复现步骤\n description: 复现此错误的清晰而简明的步骤。\n placeholder: |\n 1. 应用魔法\n 2. 等待 3.1415 秒\n 3. 🧙🏽♂️\n validations:\n required: true\n - type: input\n id: reproduction\n attributes:\n label: 最小复现链接\n description: 请提供[最小复现](https://stackoverflow.com/help/minimal-reproducible-example)链接。提供一个简化的 [Playground](https://play.pro-components.cn)/CodePen/CodeSandbox 或 GitHub 仓库链接。请不要随机填写链接。\n placeholder: 复现链接\n validations:\n required: true\n - type: textarea\n id: system-info\n attributes:\n label: 系统信息\n description: \"`npx envinfo --system --npmPackages 'naive-ui,vue' --binaries --browsers` 命令的输出\"\n render: Shell\n placeholder: 系统信息，二进制文件，浏览器\n validations:\n required: true\n - type: dropdown\n id: package-manager\n attributes:\n label: 使用的包管理器\n description: 选择所使用的包管理器\n options:\n - npm\n - yarn\n - pnpm\n validations:\n required: true\n - type: checkboxes\n id: checkboxes\n attributes:\n label: 验证\n description: 在提交问题之前，请确保完成以下步骤\n options:\n - label: 阅读 [贡献指南](https://github.com/tusen-ai/naive-ui/blob/main/CONTRIBUTING.zh-CN.md)。\n required: true\n - label: 阅读 [文档](https://www.naiveui.com/zh-CN/)。\n required: true\n - label: 检查是否已经存在[相同问题的问题](https://github.com/tusen-ai/naive-ui/issues)，以避免创建重复的问题。\n required: true\n - label: 确保这是一个具体的 bug。有关问题和答案，请打开 [GitHub 讨论](https://github.com/tusen-ai/naive-ui/discussions)。\n required: true\n - label: 提供的复现是[最小可复现的示例](https://stackoverflow.com/help/minimal-reproducible-example)。\n required: true\n"
},
{
"path": ".github/ISSUE_TEMPLATE/config.yml",
"content": "blank_issues_enabled: false\ncontact_links:\n - name: 💬 Discord Chat\n url: https://discord.gg/Pqv7Mev5Dd\n about: Ask questions and discuss with other Naive UI users in real time.\n - name: ❓ Questions & Discussions\n url: https://github.com/tusen-ai/naive-ui/discussions\n about: Use GitHub discussions for message-board style questions and discussions.\n"
},
{
"path": ".github/ISSUE_TEMPLATE/feature_request.yml",
"content": "name: 🚀 New feature request\ndescription: Propose a new feature to be added to Naive UI\nlabels: [feature request]\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for your interest in the project and taking the time to fill out this feature request!\n\n - type: textarea\n id: feature-description\n attributes:\n label: Clear and concise description of the problem\n description: 'As a developer using Naive UI I want [goal / wish] so that [benefit]. If you intend to submit a PR for this issue, tell us in the description. Thanks!'\n validations:\n required: true\n - type: textarea\n id: suggested-solution\n attributes:\n label: Suggested solution\n description: 'In module [xy] we could provide following implementation...'\n validations:\n required: true\n - type: textarea\n id: alternative\n attributes:\n label: Alternative\n description: Clear and concise description of any alternative solutions or features you've considered.\n - type: textarea\n id: additional-context\n attributes:\n label: Additional context\n description: Any other context or screenshots about the feature request here.\n - type: checkboxes\n id: checkboxes\n attributes:\n label: Validations\n description: Before submitting the issue, please make sure you do the following\n options:\n - label: Read the [Contributing Guidelines](https://github.com/tusen-ai/naive-ui/blob/main/CONTRIBUTING.md).\n required: true\n - label: Read the [docs](https://www.naiveui.com/en-US).\n required: true\n - label: Check that there isn't already an issue that request the same feature to avoid creating a duplicate.\n required: true\n"
},
{
"path": ".github/ISSUE_TEMPLATE/feature_request.zh-CN.yml",
"content": "name: 🚀 新功能请求\ndescription: 提议将新功能添加到 Naive UI\nlabels: [feature request]\nbody:\n - type: markdown\n attributes:\n value: |\n 感谢您对该项目的关注，并抽出时间填写此功能请求！\n\n - type: textarea\n id: feature-description\n attributes:\n label: 问题的清晰而简明的描述\n description: '作为使用 Naive UI 的开发者，我希望 [目标/愿望]，以便 [好处]。如果您打算为此问题提交 PR，请在描述中告诉我们。谢谢！'\n validations:\n required: true\n - type: textarea\n id: suggested-solution\n attributes:\n label: 建议的解决方案\n description: '在模块 [xy] 中，我们可以提供以下实现...'\n validations:\n required: true\n - type: textarea\n id: alternative\n attributes:\n label: 备选方案\n description: 对您考虑过的任何备选解决方案或功能的清晰而简明的描述。\n - type: textarea\n id: additional-context\n attributes:\n label: 附加上下文\n description: 在这里提供有关功能请求的任何其他上下文或截图。\n - type: checkboxes\n id: checkboxes\n attributes:\n label: 验证\n description: 在提交问题之前，请确保完成以下步骤\n options:\n - label: 阅读 [贡献指南](https://github.com/tusen-ai/naive-ui/blob/main/CONTRIBUTING.md)。\n required: true\n - label: 阅读 [文档](https://www.naiveui.com/en-US)。\n required: true\n - label: 检查是否已经存在请求相同功能的问题，以避免创建重复的问题。\n required: true\n"
},
{
"path": ".github/dependabot.yml",
"content": "# To get started with Dependabot version updates, you'll need to specify which\n# package ecosystems to update and where the package manifests are located.\n# Please see the documentation for all configuration options:\n# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates\n\nversion: 2\nupdates:\n - package-ecosystem: npm # See documentation for possible values\n directory: \"/\" # Location of package manifests\n schedule:\n interval: \"daily\"\n"
},
{
"path": ".github/pull_request_template.md",
"content": "\n\n"
},
{
"path": ".github/workflows/node.js.yml",
"content": "# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node\n# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions\n\nname: Node.js CI\n\non:\n push:\n branches: [main, feat, docs]\n pull_request:\n branches: [main, feat, docs]\n\njobs:\n lint:\n environment: test\n\n runs-on: ubuntu-latest\n\n strategy:\n matrix:\n node-version: [22]\n # See supported Node.js release schedule at https://nodejs.org/en/about/releases/\n steps:\n - uses: actions/checkout@v3\n\n - name: Install pnpm\n run: corepack enable\n\n - name: Use Node.js ${{ matrix.node-version }}\n uses: actions/setup-node@v3\n with:\n node-version: ${{ matrix.node-version }}\n\n - run: pnpm install\n\n - name: Lint\n run: pnpm run lint\n\n test:\n environment: test\n\n runs-on: ubuntu-latest\n\n strategy:\n matrix:\n node-version: [22]\n steps:\n - uses: actions/checkout@v3\n\n - name: Install pnpm\n run: corepack enable\n\n - name: Use Node.js ${{ matrix.node-version }}\n uses: actions/setup-node@v3\n with:\n node-version: ${{ matrix.node-version }}\n\n - name: Setup timezone\n uses: szenius/set-timezone@v2.0\n with:\n timezoneLinux: Asia/Shanghai\n timezoneMacos: Asia/Shanghai\n timezoneWindows: Asia/Shanghai\n\n - run: pnpm install\n\n - name: Test\n run: pnpm run test:cov\n\n - name: Code coverage\n uses: codecov/codecov-action@v3\n with:\n token: ${{ secrets.CODECOV_TOKEN }}\n files: coverage/lcov.info\n"
},
{
"path": ".github/workflows/publish-to-pkg.pr.new.yml",
"content": "name: Publish to pkg.pr.new\non:\n push:\n branches: [main]\n pull_request:\n types: [labeled]\n\n# Cancel all previous workflows on main.\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}\n cancel-in-progress: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}\n\njobs:\n publish:\n runs-on: ubuntu-latest\n if: github.event_name == 'push' || (github.event_name == 'pull_request' && contains(github.event.label.name, 'preview'))\n steps:\n - name: Checkout code\n uses: actions/checkout@v4\n\n - run: corepack enable\n - uses: actions/setup-node@v4\n with:\n node-version: 22\n cache: \"pnpm\"\n cache-dependency-path: \"package.json\"\n\n - name: Install dependencies\n run: pnpm install\n\n - name: Build\n run: pnpm build:package\n\n - name: Publish preview\n run: pnpx pkg-pr-new publish --compact"
},
{
"path": ".gitignore",
"content": "node_modules\ndist\ndocDist\nbuild-doc/deploy-doc.sh\nbuild-doc/dist\ntest-size\ntest-bundle\ntest/unit/coverage\npackage-lock.json\nplayground/temp\nyarn.lock\n.DS_Store\n.vscode\n.idea\n.pulsar\n*.swp\n*.tgz\ncoverage\n/fonts\n/site\n/package\nlib\nes\n*.tsbuildinfo\npnpm-lock.yaml\nweb-types.json\n~*\n.pnpm-debug.log\n.history\n"
},
{
"path": ".husky/pre-commit",
"content": "pnpm exec lint-staged\n"
},
{
"path": ".npmrc",
"content": "shell-emulator=true"
},
{
"path": ".nvmrc",
"content": "22\n"
},
{
"path": ".pnpmfile.cjs",
"content": "// We will lock vue version if there's regression\nconst lockVueVersion = false\n\nconst vueVersion = '3.2.36'\n\nconst isSameVersionVuePackage = (pkgName) =>\n [\n 'vue',\n '@vue/shared',\n '@vue/compiler-sfc',\n '@vue/server-renderer',\n '@vue/reactivity',\n '@vue/reactivity-transform',\n '@vue/compiler-dom',\n '@vue/compiler-ssr',\n '@vue/compiler-core'\n ].some((name) => name === pkgName)\n\nfunction readPackage(pkg) {\n if (isSameVersionVuePackage(pkg.name)) {\n pkg.version = vueVersion\n }\n\n ;['dependencies', 'peerDependencies'].forEach((depsType) => {\n const deps = { ...pkg[depsType] }\n for (dep in pkg[depsType]) {\n if (isSameVersionVuePackage(dep)) {\n deps[dep] = vueVersion\n }\n }\n pkg[depsType] = deps\n })\n\n return pkg\n}\n\nmodule.exports = lockVueVersion\n ? {\n hooks: {\n readPackage\n }\n }\n : {}\n"
},
{
"path": ".prettierignore",
"content": "*.cssr.js\n*.cssr.ts\n"
},
{
"path": ".prettierrc",
"content": "{\n \"semi\": false,\n \"singleQuote\": true,\n \"printWidth\": 80,\n \"trailingComma\": \"none\",\n \"proseWrap\": \"never\"\n}\n"
},
{
"path": "CHANGELOG.en-US.md",
"content": "# CHANGELOG\n\n## NEXT_VERSION\n\n### Fixes\n\n- Fix `n-color-picker` passed `style` and `click` (onClick) not applied to trigger, closes [#7528](https://github.com/tusen-ai/naive-ui/issues/7528).\n\n## 2.44.1\n\n`2026-03-08`\n\n### Feats\n\n- `n-config-provider` adds per-component `size` options in `component-options` (`AutoComplete`, `Cascader`, `ColorPicker`, `DatePicker`, `InputNumber`, `InputOtp`, `Mention`, `Select`, `TimePicker`, `Transfer`, `TreeSelect`).\n\n### Fixes\n\n- `n-config-provider` fixes `size` prop doesn't work for some components.\n\n## 2.44.0\n\n`2026-03-08`\n\n### Breaking Changes\n\n- `n-color-picker` refactor DOM structure & trigger class names.\n- `n-card`'s `n-card__content` class name is renamed to `n-card-content`.\n- `n-select` will clear options created by `tag` prop by default when clear button is clicked.\n\n### Feats\n\n- `n-color-picker` adds `trigger` slot, closes [#7192](https://github.com/tusen-ai/naive-ui/issues/7192).\n- `n-select` adds `clear-created-options-on-clear` prop to control whether created options are cleared when clearing while `tag` and clearable are enabled.\n- `n-select`, `n-auto-complete`, `n-mention`, `n-popselect`, `n-cascader`, `n-pagination` add `scrollbar-props` prop.\n- `n-config-provider` adds component-level `renderEmpty` options (`Cascader`, `DataTable`, `Select`, `Transfer`, `Tree`, `TreeSelect`).\n- `n-config-provider` adds per-component `size` options in `component-options` (`Button`, `Card`, `Checkbox`, `DataTable`, `Descriptions`, `Dropdown`, `DynamicTags`, `Form`, `Input`, `Pagination`, `Popselect`, `Radio`, `Rate`, `Result`, `Skeleton`, `Space`, `Switch`, `Table`, `Tabs`, `Tag`), closes [#356](https://github.com/tusen-ai/naive-ui/issues/356).\n- `n-upload`'s `submit` method adds `retry` option.\n- `n-breadcrumb-item` adds `show-separator` prop for controlling separator visibility when used with `transition-group`, closes [#3614](https://github.com/tusen-ai/naive-ui/issues/3614).\n- `n-card` adds `content-scrollable` prop, closes [#4848](https://github.com/tusen-ai/naive-ui/issues/4848), [#6759](https://github.com/tusen-ai/naive-ui/pull/6759).\n- `n-date-picker` adds `fast-year-select` prop.\n- `n-date-picker` adds `fast-month-select` prop.\n- `n-button` adds `spin-props` prop.\n- `n-cascader` adds `spin-props` prop.\n- `n-log` adds `spin-props` prop.\n- `n-message` adds `spin-props` prop.\n- `n-switch` adds `spin-props` prop.\n- `n-tree` adds `spin-props` prop.\n- `n-spin` adds `radius` and `scale` props.\n- `n-tree-select` adds `show-line` prop.\n\n### Fixes\n\n- Fix `katex` type compatibility by upgrading to `0.16.28` and removing `@types/katex` dependency, closes [#7423](https://github.com/tusen-ai/naive-ui/issues/7423).\n- Fix `n-select`'s created option is not cleared when clearing dynamic options while `tag` and `clearable` are enabled, closes [#7405](https://github.com/tusen-ai/naive-ui/issues/7405).\n- Fix `n-modal` event listeners not removed, closes [#7341](https://github.com/tusen-ai/naive-ui/issues/7341) by [@lu-han](https://github.com/lu-han).\n- Fix `n-marquee` component Non-function value encountered for default slot warning.\n- Fix `n-data-table`'s empty slot is not shown in a `display: flex` container.\n- Fix `n-data-table` missing header scrollbar in `n-data-table` when in empty state with `max-height` or `flex-height`, closes [#7479](https://github.com/tusen-ai/naive-ui/pull/7479).\n- Fix `n-input`, `n-select`, `n-date-picker`, `n-auto-complete`, `n-cascader`, `n-color-picker`, `n-input-number`, `n-input-otp`, `n-mention`, `n-time-picker`, `n-transfer`, `n-tree-select` not reading global `size` config from `n-config-provider`.\n- Fix `n-data-table` and `n-tag` `size` prop default value preventing global config from taking effect.\n\n## 2.43.2\n\n`2025-11-16`\n\n### Fixes\n\n- Fix seemly dependency version range allows incompatible versions.\n- Fix `n-progress` style is incorrect after using the dashboard mode exceeding 100%, closes [#6627](https://github.com/tusen-ai/naive-ui/issues/6627).\n- Fix `n-modal`'s outside content can't be interacted with when `show-mask` is set to `false`.\n\n### Feats\n\n- `n-date-picker` prop `defaultTime` can also accept a function that will return a formatted string.\n- `n-steps` adds `content-placement` prop, closes [#7044](https://github.com/tusen-ai/naive-ui/issues/7044).\n\n## 2.43.1\n\n`2025-09-14`\n\n### Fixes\n\n- Fix esm format files are importing `lodash` rather than `lodash-es`.\n\n## 2.43.0\n\n`2025-09-13`\n\n### Breaking Changes\n\n- Modal's inner close button won't be focusable using keyboard and it'll no longer be focused first by default.\n\n### i18n\n\n- Add daDK locale.\n\n### Fixes\n\n- Fix `n-color-picker` black and white effect of text is not obvious, closes [#7074](https://github.com/tusen-ai/naive-ui/issues/7074).\n- Fix `n-image` zoom in & out locale text in `da-DK` `sv-SE`.\n- Fix `n-popover`'s `themeOverrides` property does not have the `Scrollbar` style configuration.\n- Fix `n-input`'s `themeOverrides` property does not have the `Scrollbar` style configuration.\n- Fix `n-anchor` can't activate link in the bottom of the page by click, closes [#7033](https://github.com/tusen-ai/naive-ui/issues/7033), closes [#6918](https://github.com/tusen-ai/naive-ui/issues/6918), [#6844](https://github.com/tusen-ai/naive-ui/issues/6844), [#6782](https://github.com/tusen-ai/naive-ui/issues/6782).\n- Fix `n-upload` component `'Non-function value encountered for default slot'` warning.\n- Fix `n-input`'s `tabindex` property setting of `input-props` does not take effect.\n- Fix `n-tab` scroll shadow pseudo-class style conflicts in multi-layer tab nesting scenarios, closes [#6854](https://github.com/tusen-ai/naive-ui/issues/6854).\n- Fix `n-menu`'s disabled style not working when parent node is set to `disabled` and child node has `type: \"group\"`, closes [#6792](https://github.com/tusen-ai/naive-ui/issues/6792).\n- Fix `n-input-group-label` not injecting `formItemInjectionKey`, causing the `size` property to fail, and close [#7066](https://github.com/tusen-ai/naive-ui/issues/7066).\n- Fix the issue of style confusion in `n-carousel` when there is only one image, close [#6476](https://github.com/tusen-ai/naive-ui/issues/6476).\n- Fix `n-marquee` component 'Non-function value encountered for default slot' warning.\n- Fix memory leak caused by `n-upload` icon.\n\n### Features\n\n- `n-data-table`'s column adds `customNextSortOrder` attribute, closes [#6850](https://github.com/tusen-ai/naive-ui/issues/6850).\n- Add `n-avatar-group`'s corresponding generic component `NGAvatarGroup`, closes [#6909](https://github.com/tusen-ai/naive-ui/issues/6909).\n- `n-avatar-group` adds `size` prop.\n- `n-popover` supports RTL.\n- `n-tooltip` supports RTL.\n- `n-upload` supports RTL.\n- `n-tree-select` supports RTL.\n- `useDialog`'s option supports `z-index`, closes [#4349](https://github.com/tusen-ai/naive-ui/issues/4349).\n- Add `n-heatmap` component.\n- - `n-image` adds showPreview methods, closes [#6695](https://github.com/tusen-ai/naive-ui/issues/6695).\n- Add `n-image-preview` component.\n- `n-image-group` can be used without `n-image`.\n- `n-input-otp` adds `focusOnChar` util method, closes [#7073](https://github.com/tusen-ai/naive-ui/issues/7073).\n- `n-form-item` adds `content-class`、`content-style` props.\n- `n-message` adds `border` theme variable, closes [#7105](https://github.com/tusen-ai/naive-ui/issues/7105).\n- `n-modal` adds `show-mask` prop.\n- `useModal` add `render` function, closes [#5857](https://github.com/tusen-ai/naive-ui/issues/5857).\n- `n-card` add `close-focusable` prop.\n- `n-dialog` add `close-focusable` prop.\n- `n-form-item` adds `invalidateLabelWidth` method，`n-form` adds `invalidateLabelWidths` method，closes [#5939](https://github.com/tusen-ai/naive-ui/issues/5939).\n\n## 2.42.0\n\n`2025-06-17`\n\n### Breaking Changes\n\n- Fix `n-date-picker`'s `time-picker-format` prop doesn't work, the prop is misspelled as `timer-picker-format` before, closes [#6820](https://github.com/tusen-ai/naive-ui/issues/6820).\n\n### Fixes\n\n- Fix `n-input-otp` event bindings not removed when elements are disabled (disabled/readonly), fix width style specificity conflict.\n- Fix `n-date-picker`'s `shortcuts`' time value will be overrided if `default-time` is set in with `type=\"datetimerange\"`, closes [#6902](https://github.com/tusen-ai/naive-ui/pull/6902), [#6901](https://github.com/tusen-ai/naive-ui/pull/6901).\n- Fix `n-radio`, `n-radio-button` can't use `n-popover` inside, closes [#6837](https://github.com/tusen-ai/naive-ui/pull/6837), [#6832](https://github.com/tusen-ai/naive-ui/pull/6832).\n- Fix scrolling performance issue caused by too many layers, closes [#6887](https://github.com/tusen-ai/naive-ui/issues/6887).\n\n### Features\n\n- `n-anchor-link` adds `title` slot, closes [#6845](https://github.com/tusen-ai/naive-ui/issues/6845).\n\n## 2.41.1\n\n`2025-06-08`\n\n### Fixes\n\n- Fix `n-tabs`'s type exception of the tab slots in TabPane.\n- Fix `n-data-table` missing css variable of sorting cells, closes [#6521](https://github.com/tusen-ai/naive-ui/issues/6521).\n\n### Features\n\n- 🌟 Adds `n-input-otp` component, closes [#1385](https://github.com/tusen-ai/naive-ui/issues/1385), [#5681](https://github.com/tusen-ai/naive-ui/issues/5681), [#6222](https://github.com/tusen-ai/naive-ui/issues/6222).\n- `n-upload` adds `custom-download`, closes [#5946](https://github.com/tusen-ai/naive-ui/issues/5946), [#6800](https://github.com/tusen-ai/naive-ui/issues/6800).\n- `n-upload` adds `uploadDownload` util method.\n- `n-tree-select` adds `indent` prop.\n\n## 2.41.0\n\n`2025-01-05`\n\n### Breaking Changes\n\n- (**Vue 3.3+ required**) Add slot type for all components.\n\n### i18n\n\n- Add kmKH locale.\n- Add ugCN locale.\n\n### Features\n\n- `n-modal` adds `draggable` prop, closes [#6525](https://github.com/tusen-ai/naive-ui/issues/6525), [#5792](https://github.com/tusen-ai/naive-ui/issues/5792), [#5711](https://github.com/tusen-ai/naive-ui/issues/5711), [#5501](https://github.com/tusen-ai/naive-ui/issues/5501) and [#2152](https://github.com/tusen-ai/naive-ui/issues/2152).\n- `useDialog` supports `draggable` option.\n- `useModal` supports `draggable` option.\n\n### Fixes\n\n- Fix `n-data-table` may have multiple expand trigger with tree data.\n- Fix `n-date-picker`'s `confirm`, `now`, `clear` slots doesn't work with `'month'`, `'monthrange'`, `'quarter'`, `'quarterrange'`, `'year'` and `'yearrange'` type.\n- Fix `n-input`'s `render-count` prop doesn't work when type is not `'textarea'`.\n\n## 2.40.4\n\n`2024-12-20`\n\n### Fixes\n\n- Fix `inset` CSS property caused compatibility issues in some browsers, closes [#6604](https://github.com/tusen-ai/naive-ui/issues/6604)，close [#6602](https://github.com/tusen-ai/naive-ui/issues/6602).\n- Fix memory leak problem when used with new version of vue. Note: After the fix you may still find memory leak in Chrome >= 129, since they introduced a bug, see https://github.com/vuejs/core/issues/12306, https://issues.chromium.org/issues/376777343.\n\n## 2.40.3\n\n`2024-12-02`\n\n- Fix marquee is not exported with correct name.\n\n## 2.40.2\n\n`2024-11-26`\n\n### Fixes\n\n- Fix `n-time-picker`'s `use-12-hours` type error warning, closes [#4308](https://github.com/tusen-ai/naive-ui/issues/4308).\n- Fix `input-number` the problem that the negative sign is replaced when the negative sign is entered.\n- Fix `n-data-table`'s header will show scrollbar in some old browsers, closes [#6557](https://github.com/tusen-ai/naive-ui/issues/6557).\n\n### Features\n\n- 🌟 Adds `n-marquee` component.\n- `n-image` adds `error` slot, closes [#5649](https://github.com/tusen-ai/naive-ui/issues/5649).\n- `n-date-picker` adds `date-format` prop.\n- `n-date-picker` adds `calendar-day-format` prop.\n- `n-date-picker` adds `calendar-header-year-format` prop.\n- `n-date-picker` adds `calendar-header-month-format` prop.\n- `n-date-picker` adds `calendar-header-month-before-year` prop.\n- `n-date-picker` adds `calendar-header-month-year-separator` prop.\n- `n-progress`'s `color` prop supports gradient config.\n- `n-select` adds `font-weight` theme variable.\n- `n-input` adds `font-weight` theme variable.\n- `n-data-table` adds `get-csv-header` and `get-csv-cell` props, closes [#6542](https://github.com/tusen-ai/naive-ui/issues/6542).\n\n## 2.40.1\n\n`2024-09-26`\n\n### Fixes\n\n- Fix `n-data-table` in virtual-x mode, when all column objects do not have the `fixed` attribute configured, it cannot be displayed normally.\n- Fix `css-render` dependency version is not high enough to affect the `style-mount-target` attribute of `n-config-provider`.\n- Fix `n-data-table`'s `rowProps` generated `class` will override the original row DOM's class.\n\n## 2.40.0\n\n`2024-09-26`\n\n### Breaking Changes\n\n- Fix `n-config-provider` doesn't inherit the class prefix from it's ascendant `n-config-provider`, closes [#5970](https://github.com/tusen-ai/naive-ui/issues/5970).\n- Fix `n-date-picker`'s `weekFormat` uses different standards for year and week formatting. Now it uses local week and local year for year and week formatting.\n- Dependency `date-fns` is upgraded to V3.\n- `n-cascader`'s `filter` prop is now case insensitive.\n\n### Fixes\n\n- Fix `n-infinite-scroll` reaching bottom check is not correct, closes [#6133](https://github.com/tusen-ai/naive-ui/issues/6133).\n- Fix `n-slider`'s rail may have styling issue in `vertical` mode when global CSS box-sizing is overrided, closes [#6114](https://github.com/tusen-ai/naive-ui/issues/6114).\n- Fix `n-tabs` has style issue when using `prefix` slot, `suffix` slot or `addable` prop with vertical placement, closes [#6059](https://github.com/tusen-ai/naive-ui/issues/6059), [#6060](https://github.com/tusen-ai/naive-ui/pull/6060).\n- Fix `n-upload` can only upload a maximum of 100 files in some old browsers when uploading directories, closes [#6027](https://github.com/tusen-ai/naive-ui/issues/6027).\n- Fix `n-date-picker`'s `input-readonly` prop not working in the panel's inner input for `'datetime'` or `'datetimerange'`.\n- Fix `n-menu` can't apply HTML attributes correctly on the component when `responsive` is set.\n- Fix `n-float-button` throws error when used with `popover` component, closes [#5933](https://github.com/tusen-ai/naive-ui/issues/5933).\n- Fix `n-badge` can't mask focus element's border, closes [#5929](https://github.com/tusen-ai/naive-ui/issues/5929).\n- Fix `n-button` font-weight CSS variable's name is not correct, closes [#5922](https://github.com/tusen-ai/naive-ui/issues/5922).\n- Fix `n-icon`'s `component` prop doesn't accept functional component.\n- Fix `n-mention`'s panel is misplaced if `placement` is set to `'top'` or padding is set in component's style, closes [#6241](https://github.com/tusen-ai/naive-ui/issues/6241).\n- Fix `n-carousel`'s transition doesn't work as expected, closes [#5993](https://github.com/tusen-ai/naive-ui/issues/5993).\n\n### Features\n\n- 🌟 `n-data-table` adds `virtual-scroll-x`, `virtual-scroll-header`, `height-for-row`, `header-height` and `min-row-height` props for supporting horizontal virtual scrolling when there are massive columns.\n- 🌟 Adds `n-highlight` component.\n- `n-scrollbar` adds `x-placement` and `y-placement` props, closes [#6089](https://github.com/tusen-ai/naive-ui/issues/6089).\n- `n-date-picker` adds `clear`, `now` and `confirm` slots, closes [#6013](https://github.com/tusen-ai/naive-ui/issues/6013).\n- `n-upload` adds `on-retry` prop, closes [#6031](https://github.com/tusen-ai/naive-ui/issues/6031).\n- `n-slider`'s `marks` prop supports render function, closes [#5967](https://github.com/tusen-ai/naive-ui/issues/5967).\n- `n-transfer`'s `source-title` and `target-title` props support render function, closes [#6004](https://github.com/tusen-ai/naive-ui/issues/6004).\n- `n-data-table` add `rowData` params for `render-expand-icon` prop, closes [#6108](https://github.com/tusen-ai/naive-ui/issues/6108).\n- `n-empty`'s `size` prop supports `'tiny'` size.\n- `n-config-provider` adds `style-mount-target` prop to control where to mount components' style.\n- `n-data-table` adds `allowExport` prop for column object.\n- `n-date-picker` adds `year-range` prop.\n- `n-tree-select` adds `header` slot, closes [#5915](https://github.com/tusen-ai/naive-ui/issues/5915).\n- `n-select` adds `menu-size` prop.\n\n## 2.39.0\n\n`2024-07-15`\n\n### Breaking Changes\n\n- Fix `n-input-number` Exception when the value is a string in precision mode, closes [#6091](https://github.com/tusen-ai/naive-ui/issues/6091).\n\n### Fixes\n\n- Fix `n-form-item` validation state is not correctly updated [#6068](https://github.com/tusen-ai/naive-ui/issues/6068).\n- Fix `n-select`'s header make inner input unavailable, closes [#6030](https://github.com/tusen-ai/naive-ui/issues/6030).\n- Fix `n-tree` may have incorrect node selection status when `show-irrelevant-nodes` is disabled, close [#6115](https://github.com/tusen-ai/naive-ui/issues/6115).\n\n### Features\n\n- `n-data-table` adds `filter-icon-popover-props` prop, closes [#6111](https://github.com/tusen-ai/naive-ui/issues/6111).\n- `n-input-number` adds `round` prop, closes [#6097](https://github.com/tusen-ai/naive-ui/issues/6097).\n- `n-color-picker` add `on-clear` props.\n- `n-upload`'s `on-preview` prop adds `detail.event` parameter. You can use `preventDefault` to prevent default anchor link open behavior. Closes [#6036](https://github.com/tusen-ai/naive-ui/issues/6036).\n- `n-data-table` adds `thColorSorting`, `thColorSortingModal`, `thColorSortingPopover`, `tdColorSorting`, `tdColorSortingModal` and `tdColorSortingPopover` theme variables, closes [#6118](https://github.com/tusen-ai/naive-ui/issues/6118), [#6120](https://github.com/tusen-ai/naive-ui/issues/6120).\n\n### i18n\n\n- Add azAZ locale.\n- Add uzUZ locale.\n\n## 2.38.2\n\n`2024-05-03`\n\n### Fixes\n\n- Fix `n-menu` Submenu's wai-aria role is not correct, closes [#5729](https://github.com/tusen-ai/naive-ui/issues/5729).\n- Fix `n-tabs` style bug with type is `segment`，closes [#5728](https://github.com/tusen-ai/naive-ui/issues/5728).\n- Fix the get\\*String() methods for UTC/locale mismatch, closes [#5702](https://github.com/tusen-ai/naive-ui/issues/5702).\n- Fix `n-dialog` / `n-modal` calling `destroy` method may throw error.\n- Fix `useModal` setting `card` preset without corresponding props in `n-card` slots, closes [#5746](https://github.com/tusen-ai/naive-ui/issues/5746).\n- Fix `Submenu` component's wai-aria role setting error of `n-menu`，closes [#5729](https://github.com/tusen-ai/naive-ui/issues/5729).\n- Fix the `common` type error in the `theme-overrides` prop when modifying components' themes.\n- Fix `n-split` may emit value less than `0`.\n\n### Features\n\n- `n-watermark` support multi-lines in content.\n- Adds `n-infinite-scroll` component.\n- `n-watermark` adds `text-align` prop.\n- `n-qr-code` adds `type` prop, Customize rendering output by setting `type`, providing two options: `canvas` and `svg`.\n- `n-card` adds `action`, `content`, `cover`, `footer` and `header-extra` props.\n- `n-card`'s `title` prop supports render function.\n- `n-upload` expose the `index` arg in `on-remove` function, closes [#5747](https://github.com/tusen-ai/naive-ui/issues/5747).\n- `n-upload` exports `UploadOnDownload`, `UploadOnRemove`, `UploadOnFinish` and `UploadOnChange` types.\n- `n-dialog` adds `action-class`, `action-style`, `content-class`, `content-style`, `title-class` and `title-style` props.\n- `n-split` adds `pane1-class`, `pane1-style`, `pane2-class` and `pane2-style` props.\n- `n-mention` adds `filter` method, closes [#5721](https://github.com/tusen-ai/naive-ui/pull/5721).\n- `n-slider` adds wai-aria support.\n- `n-date-picker` adds `time-picker-format` prop.\n- `n-form-item` adds `feedback-class` and `feedback-style` props.\n- `n-split` supports using pixel unit string as `value`.\n- `n-scrollbar` adds `content-style` and `content-class` props, closes [#4497](https://github.com/tusen-ai/naive-ui/issues/4497).\n- `n-image` adds `render-toolbar` prop.\n- `n-cascader` adds `get-column-style` prop.\n- `n-cascader` adds `get-render-prefix` prop.\n- `n-cascader` adds `get-render-suffix` prop.\n- `n-image` optimizes download icon style.\n- `n-scrollbar` adds `height`, `width`, `radius`, `railInsetHorizontal`, `railInsetVertical` and `railColor` theme variables.\n\n### i18n\n\n- Add csCZ locale.\n- Add missing itIT locale translations.\n\n## 2.38.1\n\n`2024-02-26`\n\n### Fixes\n\n- Fix `n-split`'s `min` attribute does not take effect.\n- Fix `n-result` built-in icons not re-rendered after hydration.\n- Fix `n-tabs` whose `type` is `'segment'` has capsule with wrong width and position after resize, closes [#5705](https://github.com/tusen-ai/naive-ui/issues/5705).\n- Fix `n-tabs`'s capsule wrong width and position after resize within `n-modal`, closes [#5569](https://github.com/tusen-ai/naive-ui/issues/5569).\n- Fix `n-split` doesn't work with `inline-theme-disabled` prop.\n- Fix `n-float-button` doesn't work with `inline-theme-disabled` prop.\n\n### Features\n\n- `n-date-picker` adds `default-calendar-start-time` props when `type` is `'date'`/`'datetime'` or `'week'`, closes [#4493](https://github.com/tusen-ai/naive-ui/issues/4493).\n- `n-tree-select` adds `get-children` prop.\n\n## 2.38.0\n\n`2024-02-22`\n\n### Breaking Changes\n\n- Fix `n-scrollbar`'s `scrollTo(x: number, y: number)` error where the order of method parameters does not match the document.\n\n### Fixes\n\n- Fix `n-tree`'s `override-default-node-click-behavior` prop may conflict with default switcher click or checkbox click behavior.\n- Fix `n-scrollbar`'s typo on `aria-hidden` attribute.\n- Fix `n-form-item`'s feedback may hide and show again, closes [#5583](https://github.com/tusen-ai/naive-ui/issues/5583).\n- Fix `n-popselect`'s header make inner input unavailable, closes [#5494](https://github.com/tusen-ai/naive-ui/pull/5494).\n- Fix `n-qr-code`'s style of size.\n- Fix `n-badge` affects child elements' text color.\n\n### Features\n\n- 🌟 Adds `n-modal-provider` component and `useModal` method.\n- 🌟 Adds `n-float-button` and `n-float-button-group` component.\n- 🌟 Provides ES module bundle at `/dist/index.mjs` and `/dist/index.prod.mjs`.\n- `n-auto-complete` adds `append` prop.\n- `n-select` add native `title` attribute when `filterable` and blur input.\n- `n-split` adds `size` prop and `on-update:size` prop.\n- `n-split` adds `watch-props` prop, closes [#5526](https://github.com/tusen-ai/naive-ui/issues/5526).\n- `n-drawer` adds `borderRadius` theme variable.\n- adds `n-float-button` component.\n- Provides ES module bundle.\n\n### i18n\n\n- Add `etEE` locale.\n\n## 2.37.3\n\n`2024-01-09`\n\n### Fixes\n\n- Fix `n-split` has no color if it's not used in a card.\n\n## 2.37.2\n\n`2024-01-09`\n\n### Fixes\n\n- `n-data-table`'s `downloadCsv` method will export selection & expand column.\n\n## 2.37.1\n\n`2024-01-08`\n\n### Fixes\n\n- Click clear button on components with popup may trigger reopen behaviors.\n- Fix `n-form`'s `validate` returned `Promise` may not `resolve`.\n\n### Features\n\n- `n-collapse` adds `trigger-areas` prop.\n- `n-date-picker`'s `is-date-disabled` callback prop supports get detail info of date/year/month/quarter button as parameter, closes [#4649](https://github.com/tusen-ai/naive-ui/issues/4649).\n- `n-auto-complete` adds `empty` slot.\n- `n-auto-complete` adds `show-empty` prop.\n\n## 2.37.0\n\n`2024-01-07`\n\n### Breaking Changes\n\n- `module` prop in `package.json` is changed from `es/index.js` to `es/index.mjs`.\n\n### Fixes\n\n- Fix `n-space` vnode reuse problem caused by filtering out comment nodes of slot, closes [#5136](https://github.com/tusen-ai/naive-ui/issues/5136).\n- Fix `n-data-table`'s prop `pagination`'s `default-page-size` and `default-page` not work in uncontrolled mode, closes [#5201](https://github.com/tusen-ai/naive-ui/issues/5201).\n- Fix `n-time-picker` formatting (format=\"HH: mm: ss. SSS\") preventing modification of milliseconds in the edit box, closes [#5224](https://github.com/tusen-ai/naive-ui/issues/5224).\n- Fix `n-notification` notification clips out of screen when screen width is less than 400px wide.\n- Fix `n-carousel` transition effect incorrect when using the `slide` effect in loop mode with only two elements, closes [#4323](https://github.com/tusen-ai/naive-ui/issues/4323).\n- Fix `n-carousel` trigger incorrect `current-index` value on arrow button click with single image, closes [#5130](https://github.com/tusen-ai/naive-ui/issues/5130).\n- Fix `n-upload-trigger` in directory drag mode with a lot of files, some of the files are not read.\n- Fix `n-dynamic-tags`'s abnormal behavior when using keyboard to trigger add button, closes [#5077](https://github.com/tusen-ai/naive-ui/issues/5077).\n- Fix `n-tree` leaf node line color.\n- Fix `n-collapse-item` cursor pointer to correct element, closes [#5482](https://github.com/tusen-ai/naive-ui/issues/5482).\n- Fix `n-data-table` throws error if summary config has empty column.\n- Fix `n-drawer`'s `on-mask-click` may be called multiple times.\n- Fix `n-tree`'s `data` When the data source 'data' switches several times according to a certain scene, some logic of animation processing can cause errors in rendering the displayed data, closes [#5217](https://github.com/tusen-ai/naive-ui/issues/5217).\n- Fix `n-radio` value's native input element's checked value is not updated, closes [#5184](https://github.com/tusen-ai/naive-ui/issues/5184).\n- Fix `n-data-table` height incorrect when set `min-height` in empty state，closes [#5108](https://github.com/tusen-ai/naive-ui/issues/5108).\n- Fix `n-tabs`'s bar not hidden when `value` is set manually to the value other than the children `n-tab`s, closes [#5100](https://github.com/tusen-ai/naive-ui/issues/5100).\n- Fix `n-spin` abnormal animation, closes [#3556](https://github.com/tusen-ai/naive-ui/issues/3556).\n- Fix `n-avatar`'s lazy loading and `fallback-src` prop not working when load error in lazy, closes [#5007](https://github.com/tusen-ai/naive-ui/issues/5007).\n- Fix `n-split` has no color if it's not used in a card.\n- Fix `n-card` `footer-class` prop not working.\n- Fix `n-input` click clear icon to trigger twice when using the `clearable`, closes [#5510](https://github.com/tusen-ai/naive-ui/issues/5510).\n- Fix `n-tabs` may miss over-scroll shadow if `placement` is `'left'` or `'right'`.\n- Fix `n-date-picker` with range type can input start time that is later than end time, closes [#5544](https://github.com/tusen-ai/naive-ui/issues/5544).\n\n### Features\n\n- 🌟 Adds `n-flex` component.\n- 🌟 `n-date-picker`'s `type` prop supports `'week'`.\n- 🌟 `n-data-table` adds `downloadCsv` method, closes [#4260](https://github.com/tusen-ai/naive-ui/issues/4260).\n- 🌟 `n-date-picker` adds `month-format`, `year-format` and `quarter-format` props, closes [#4891](https://github.com/tusen-ai/naive-ui/issues/4891).\n- 🌟 `n-tree` adds `override-default-node-click-behavior` prop.\n- 🌟 `n-tree-select` adds `override-default-node-click-behavior` prop.\n- `n-space` adds `reverse` prop.\n- `n-input` adds `clear` method, closes [#5423](https://github.com/tusen-ai/naive-ui/issues/5423).\n- `n-time-picker` adds `'clear'` action, closes [#5334](https://github.com/tusen-ai/naive-ui/issues/5334).\n- `n-select` supports RTL.\n- `n-data-table` supports RTL.\n- `n-dialog` supports RTL.\n- `n-date-picker` adds `on-prev-month` `on-next-month` `on-prev-year` `on-next-year` prop, closes [#5350](https://github.com/tusen-ai/naive-ui/issues/5350).\n- `n-input-number` adds `input-props` prop, closes [#5450](https://github.com/tusen-ai/naive-ui/issues/5450).\n- Update `ruRU` locale.\n- `n-drawer` adds `content-class` prop.\n- `n-drawer-content` adds `body-class` `body-content-class` `footer-class` and `header-class` props.\n- `n-tree` adds multiple `scrollTo` configurations.\n- `n-form` adds `level` property from `FormItemRule` to show abnormal values but not block submit.\n- `n-cascader` adds `ellipsis-tag-popover-props` prop.\n- `n-select` adds `ellipsis-tag-popover-props` prop.\n- `n-tree-select` adds `ellipsis-tag-popover-props` prop.\n- `n-avatar-group` adds `expand-on-hover` prop.\n- `n-tabs` adds `tab-class`, `add-tab-style` and `add-tab-class` props.\n- `n-tree` adds `override-default-node-click-behavior` prop.\n- `n-tree-select` adds `override-default-node-click-behavior` prop.\n- Adds `n-flex` component.\n- `n-pagination` adds `show-quick-jump-dropdown` prop, closes [#5251](https://github.com/tusen-ai/naive-ui/issues/5251).\n\n## 2.36.0\n\n`2023-12-18`\n\n### Fixes\n\n- Fix `n-tree` unexposed line color variable `--n-line-color`, closes [#5339](https://github.com/tusen-ai/naive-ui/issues/5339).\n- Fix `n-tree` The style of the selected node is not displayed in the case of 'disabled'.\n- Fix `n-tree` on `virtual-scroll` empty data placeholder lost problem.\n- Fix `n-watermark` won't clear it's content when `content` prop is set to empty.\n- Fix `n-tree` use `render-switcher-icon` prop to customize switcher icon will cause node selection, closes [#5380](https://github.com/tusen-ai/naive-ui/issues/5380).\n- Fix `n-input` will display the password reveal button by default when the `type` is set to `password`. Starting with Microsoft Edge browser Version 87. closes [#5384](https://github.com/tusen-ai/naive-ui/issues/5384).\n- Fix `n-radio-button` css var `buttonColor` not working.\n- Fix `n-input` not display vertical scrollbar when `type` is `textarea` and the inline theme is disabled, closes [#5418](https://github.com/tusen-ai/naive-ui/issues/5418).\n- Fix if `inline-theme-disabled` is set, custom color whose params include decimal won't work in `n-tag`, `n-avatar`, `n-badge`, `n-button`, `n-rate`.\n- Fix `n-tabs`'s border height in `vertical` mode.\n- Fix `n-tree`'s node's hover color has higher priority than selected color in `block-line` mode.\n- Fix `n-tree` click expand switch causes checkbox being checked.\n- Fix `n-progress` multiple `type=\"circle\"` cases style override issue, closes [#7172](https://github.com/tusen-ai/naive-ui/issues/7172).\n\n### Features\n\n- `n-tree` adds `treeGetClickTarget` method to get click target of node click event, closes [#5375](https://github.com/tusen-ai/naive-ui/issues/5375).\n- `n-space` adds `item-class` prop.\n- `n-layout` adds `content-class` prop.\n- `n-layout-sider` adds `collapsed-trigger-class` and `trigger-class` props.\n- `n-spin` adds `content-class` and `content-style` props.\n- `n-popover` adds `arrow-class`, `arrow-wrapper-class`, `arrow-wrapper-style`, `content-class`, `footer-class` and `header-class` props.\n- `n-notification-provider` adds `container-class` prop.\n- `n-message-provider` adds `container-class` prop.\n- `n-loading-bar-provider` adds `container-class` prop.\n- `n-thing` adds `content-class` and `description-class` props.\n- `n-card` adds `content-class`, `footer-class`, `header-class` and `header-extra-class` props.\n- `n-descriptions` adds `content-class` and `label-class` props.\n- `n-upload` adds `file-list-class` and `trigger-class` props.\n- `n-dynamic-tags` adds `input-class` and `tag-class` props.\n- `n-dynamic-input` adds `item-class` prop.\n- `n-slider` adds `on-dragstart` `on-dragend` prop, closes [#5365](https://github.com/tusen-ai/naive-ui/issues/5365).\n- `n-dialog` adds `close` slot.\n- `n-equation` export the `EquationProps` type.\n- `n-popselect` adds `header` slot.\n- `n-tree-select` adds `watch-props` prop.\n- Adds `n-split` component, closes [#3557](https://github.com/tusen-ai/naive-ui/issues/3557).\n- Adds `n-virtual-list` component.\n- Adds `n-qr-code` component, closes [#2535](https://github.com/tusen-ai/naive-ui/issues/2535).\n- `n-menu` add `responsive` prop, it will collapse overflow menu items in horizontal mode.\n- `n-menu` add `deriveResponsiveState` method.\n\n## 2.35.0\n\n`2023-10-02`\n\n### Breaking Changes\n\n- `n-input`'s `suffix` to the back of `loading`, close [#4685](https://github.com/tusen-ai/naive-ui/issues/4685).\n- Fix `n-log`'s `silent` attribute spelling problem, closes [#4875](https://github.com/tusen-ai/naive-ui/issues/4875).\n\n### Fixes\n\n- Fix `n-radio` export `radioProps` dosen't not includes `theme-overrides`.\n- Fix `n-description-item`'s `span` doesn't work when `n-descriptions`'s `label-placement` is `'top'` if there's only single line, closes [#4874](https://github.com/tusen-ai/naive-ui/issues/4874).\n- Fix `n-upload`'s `data` prop type can't include `Blob` element.\n- Fix `n-select` allows option to be created with existed label, closes [#4703](https://github.com/tusen-ai/naive-ui/issues/4703).\n- Fix `n-upload`'s `render-icon` prop's type.\n- Fix `n-auto-complete`'s `onSelect` type, closes [#4617](https://github.com/tusen-ai/naive-ui/issues/4617).\n- Fix `n-grid-item`'s suffix prop won't work with responsive config, closes [#4635](https://github.com/tusen-ai/naive-ui/issues/4635).\n- Fix `n-tabs`'s `paneWrapperStyle` prop missing height after animation.\n- Fix `n-tree` should check all items instead of uncheck all if indeterminate checkbox is clicked, closes [#4941](https://github.com/tusen-ai/naive-ui/issues/4941).\n- Fix the Popover was not displayed when the `n-internal-selection` was disabled and the mouse was moved over the '+n' tag, closes [#4789](https://github.com/tusen-ai/naive-ui/issues/4789).\n- Fix `n-input` doesn't display the vertical scroll bar when `type` is `textarea`, closes [#4570](https://github.com/tusen-ai/naive-ui/issues/4570).\n- Fix `n-alert`'s content style problem, when there is no title and use closable, closes [#4588](https://github.com/tusen-ai/naive-ui/issues/4588).\n- Fix `n-select`'s `empty` slot action then it is an interactive component, closes [#4700](https://github.com/tusen-ai/naive-ui/issues/4700).\n- Fix `n-data-table` header and body's scrolling are not sync when using the keyboard, closes [#3941](https://github.com/tusen-ai/naive-ui/issues/3941).\n- Fix `n-data-table` drag column causing text selection in Safari, closes [#4957](https://github.com/tusen-ai/naive-ui/issues/4957).\n- Fix `n-data-table` ellipsis content in table cell would wrap with expand button when using tree data, closes [#3755](https://github.com/tusen-ai/naive-ui/issues/3755).\n- Fix `useLoadingBar` can't finish loading when called `finish` method, closes [#4965](https://github.com/tusen-ai/naive-ui/issues/4965).\n- Fix `n-select` can still trigger focus and blur event in the disabled state, closes [#4454](https://github.com/tusen-ai/naive-ui/issues/4454).\n- Fix `n-steps` may have line wrap issue if step is more than 9.\n- Fix `n-grid` v-show reports errors when switching multiple times, closes [#4422](https://github.com/tusen-ai/naive-ui/issues/4422).\n- Fix `n-tree`'s `TreeOption`'s `checkboxDisabled` prop doesn't work when `check-on-click` is `true`.\n- Fix rapid clicks on `n-date-input`'s buttons triggering a text select for the rest of the website.\n- Fix `n-auto-complete`'s autocomplete menu's unexpected open when clicking the clear icon with the input not focused, closes [#4658](https://github.com/tusen-ai/naive-ui/issues/4658).\n- Fix `n-input`'s `on-keyup` prop type, closes [#5101](https://github.com/tusen-ai/naive-ui/issues/5101).\n- Fix `n-data-table`'s default sorter to place null values at the very top or bottom, closes [#5281](https://github.com/tusen-ai/naive-ui/issues/5281).\n- Fix `n-popconfirm`'s action button should not be triggered multiple times，closes [#4687](https://github.com/tusen-ai/naive-ui/issues/4687).\n\n### Features\n\n- `n-drawer` adds `max-height`, `min-height`, `max-width` and `max-width` props.\n- `n-progress` supports indicator slot when the `indicator-placement` is set to `'inside'` in the `'line'` type, closes [#4888](https://github.com/tusen-ai/naive-ui/issues/4888).\n- `n-image-preview` adds `downaload` button, closes [#4302](https://github.com/tusen-ai/naive-ui/issues/4302).\n- `n-transfer` adds `select-all-text` and `clear-text` prop, closes [#4910](https://github.com/tusen-ai/naive-ui/issues/4910).\n- `n-tree` adds `scrollbar-props` prop, closes [#4021](https://github.com/tusen-ai/naive-ui/issues/4666).\n- `n-select` adds `focusInput` `blurInput` methods.\n- `n-tree-select` adds `focusInput` `blurInput` methods.\n- `n-image-group` adds `on-preview-prev` `on-preview-next` prop.\n- `n-tree` adds `show-line` prop, closes [#3796](https://github.com/tusen-ai/naive-ui/issues/3796), [#4554](https://github.com/tusen-ai/naive-ui/pull/4554).\n- `n-tree` adds node information for `render-switcher-icon` props, closes [#4815](https://github.com/tusen-ai/naive-ui/issues/4815).\n- `n-input-number` export the `select` method.\n- `n-data-table` adds `n-data-table-tr--expanded` class to expanded rows, and `n-data-table-tr n-data-table-tr--expand` class to the additional row, closes [#4420](https://github.com/tusen-ai/naive-ui/issues/4420).\n- `n-spin` adds `delay` prop.\n- Adds `n-performant-ellipsis` component.\n- `DataTableBaseColumn` adds `ellipsisComponent` prop.\n\n### i18n\n\n- Update `zhTW` locale.\n- Add `svSE` locale.\n- Update `jaJP` locale.\n\n## 2.34.4\n\n`2023-05-21`\n\n### Fixes\n\n- Fix `n-notification`'s `description` does not wrap when there is English, closes [#4609](https://github.com/tusen-ai/naive-ui/issues/4609).\n- Fix `n-dynamic-input` can't access `value[index]` by `index` passed in `on-remove` prop.\n- Fix `n-dynamic-input` doesn't return correct `index` in `on-create` callback.\n- Fix `trTR` i18n, closes [#4231](https://github.com/tusen-ai/naive-ui/issues/4231).\n- Fix `n-input`'s show password icon is offset when use both `password` and `disabled`, closes [#4364](https://github.com/tusen-ai/naive-ui/issues/4364).\n- Fix `n-image` set `fallback-src` prop and lazy loading dosen't work, closes[#4480](https://github.com/tusen-ai/naive-ui/issues/4480).\n- Fix `n-upload` warning cause by extraneous non-props attributes were passed to vue component `TransitionGroup` but could not be automatically inherited, closes [#4447](https://github.com/tusen-ai/naive-ui/issues/4447).\n- Fix `n-menu` `show` `default` attribute spelling problem, closes [#4750](https://github.com/tusen-ai/naive-ui/issues/4750).\n- Fix `n-icon-wrapper`'s theme error, closes [#4768](https://github.com/tusen-ai/naive-ui/issues/4768).\n\n### Feats\n\n- `n-dynamic-input` adds `action` slot, closes [#3981](https://github.com/tusen-ai/naive-ui/issues/3981).\n- `n-dynamic-input` add `disabled` prop, closes [#4055](https://github.com/tusen-ai/naive-ui/issues/4055).\n- `n-data-table` adds `titleAlign` prop, closes [#3954](https://github.com/tusen-ai/naive-ui/issues/3954).\n- `n-rate` exposes `index` in the default slot, closes [#4413](https://github.com/tusen-ai/naive-ui/issues/4413).\n- `n-scrollbar` adds `size` prop, closes [#3896](https://github.com/tusen-ai/naive-ui/issues/3896).\n- `n-data-table`'s `render-expand-icon` add `expanded` param, closes [#4439](https://github.com/tusen-ai/naive-ui/issues/4439).\n- `n-tabs` adds `pane-wrapper-class` `pane-wrapper-style` prop.\n- `n-collapse` adds `titlePadding` theme variable, closes [#4728](https://github.com/tusen-ai/naive-ui/issues/4728).\n- `n-tabs` adds `placement` prop.\n\n### i18n\n\n- Update `zhTW` locale.\n- Add `faIR` locale.\n\n## 2.34.3\n\n`2022-12-24`\n\n### Fixes\n\n- Fix `n-progress`'s `indicator-text-color` prop doesn't work when `indicator-placement` is `'inside'`.\n- Fix `n-image` error while operating the previewed image, closes [#4157](https://github.com/tusen-ai/naive-ui/issues/4157).\n- Fix `n-tree` cannot access `mergedFilterRef` before initialization error, closes [#4134](https://github.com/tusen-ai/naive-ui/issues/4134).\n- Fix `n-menu` can't override submenu dropdown's `trigger` by `dropdown-props`, closes [#4147](https://github.com/tusen-ai/naive-ui/issues/4147).\n- Fix `n-ellipsis` cannot be closed when using `keep-alive`, closes [#4079](https://github.com/tusen-ai/naive-ui/issues/4079).\n- Fix `n-upload` doesn't show thumbnail for file with image type file name, closes [#4198](https://github.com/tusen-ai/naive-ui/issues/4198).\n- Fix `n-input` style bug of tiny size with autosize prop, closes [#4167](https://github.com/tusen-ai/naive-ui/issues/4167).\n- Fix `n-image` & `n-avatar` in `lazy` mode, after setting the `intersection-observer-options` `rootMargin` attribute, the preload does not take effect.\n\n### Feats\n\n- `n-tree` adds `get-children` prop, closes [#4128](https://github.com/tusen-ai/naive-ui/issues/4128).\n- `n-badge` adds `offset` prop, closes [#4149](https://github.com/tusen-ai/naive-ui/issues/4149).\n- `n-card` adds `tag` prop.\n- demos can now use ``.\n- `n-pagination` adds `select-props` prop, closes [#4199](https://github.com/tusen-ai/naive-ui/issues/4199).\n- `n-select` adds `show-on-focus` prop, closes [#4191](https://github.com/tusen-ai/naive-ui/issues/4191).\n- `n-pagination` adds `goto` prop, closes [#4133](https://github.com/tusen-ai/naive-ui/issues/4133).\n- `n-upload` won't set `file` field of file info to `null` after file is uploaded, closes [#3868](https://github.com/tusen-ai/naive-ui/issues/3868).\n- `n-form` adds `labelFontWeight` theme variable, closes [#3516](https://github.com/tusen-ai/naive-ui/issues/3516).\n- `n-radio` adds `labelFontWeight` theme variable, closes [#3516](https://github.com/tusen-ai/naive-ui/issues/3516).\n- `n-checkbox` adds `labelFontWeight` theme variable, closes [#3516](https://github.com/tusen-ai/naive-ui/issues/3516).\n- `n-tree`'s `on-load` prop allows returned promise to resolve `false` to finish loading effect, closes [#4038](https://github.com/tusen-ai/naive-ui/issues/4038).\n\n### i18n\n\n- Update koKr locale.\n\n## 2.34.2\n\n`2022-11-22`\n\n### Fixes\n\n- Fix `n-config-provider`'s katex type issue.\n- Fix `n-image` error in toolbar operation during preview, closes [#4144](https://github.com/tusen-ai/naive-ui/issues/4144).\n\n## 2.34.1\n\n`2022-11-21`\n\n### Fixes\n\n- Fix `n-select` will print useless content in console in multiple select mode.\n- Fix `n-tree` misses `getCheckedData` and `getIndeterminateData` methods, closes [#4064](https://github.com/tusen-ai/naive-ui/issues/4064).\n- Fix `n-data-table`'s column's `align` doesn't work for table header, closes [#4063](https://github.com/tusen-ai/naive-ui/issues/4063).\n\n## 2.34.0\n\n`2022-11-21`\n\n### Breaking Changes\n\n- Wrap a `div` container around the columns of `n-data-table` to optimize the layout of filter button, closes [#3853](https://github.com/tusen-ai/naive-ui/issues/3853).\n\n### Feats\n\n- 'themeOverRides' provide `labelFontWeight` for `n-form`, `n-radio`, `n-checkbox`, closes [#3516](https://github.com/tusen-ai/naive-ui/issues/3516).\n- `n-avatar-group` exports `AvatarGroupOption` type, closes [#3879](https://github.com/tusen-ai/naive-ui/issues/3879).\n- `n-transfer` adds `show-selected` prop, closes [#3711](https://github.com/tusen-ai/naive-ui/issues/3711).\n- `n-data-table` adds `loading` slot, closes [#3865](https://github.com/tusen-ai/naive-ui/issues/3865).\n- `n-mention` adds `on-update:show` prop, closes [#3882](https://github.com/tusen-ai/naive-ui/issues/3882).\n- `n-tree` adds trigger node information for `on-update:expanded-keys`, `on-update:checked-keys` and `on-update:selected-keys` props, closes [#3885](https://github.com/tusen-ai/naive-ui/issues/3885).\n- `n-tree-select` adds trigger node information for `on-update:expanded-keys` and `on-update:value` props, closes [#3885](https://github.com/tusen-ai/naive-ui/issues/3885).\n- `n-tree` adds `getCheckedData` method.\n- `n-tree` adds `getIndeterminateData` method.\n- `n-tree-select` adds `getCheckedData` method.\n- `n-tree-select` adds `getIndeterminateData` method.\n- `n-tree-select` adds `focus` method.\n- `n-tree-select` adds `blur` method.\n- `n-cascader` adds `getCheckedData` method.\n- `n-cascader` adds `getIndeterminateData` method.\n- `n-input` adds `count-graphemes` prop, closes [#3967](https://github.com/tusen-ai/naive-ui/issues/3967).\n- `n-cascader` adds `not-found` slot, closes [#3862](https://github.com/tusen-ai/naive-ui/issues/3862).\n- `n-avatar` adds `img-props` prop, closes [#3963](https://github.com/tusen-ai/naive-ui/issues/3963).\n- `n-data-table` adds `spin-props` prop, closes [#3649](https://github.com/tusen-ai/naive-ui/issues/3649).\n- `n-button` adds `render-icon` prop, closes [#4007](https://github.com/tusen-ai/naive-ui/issues/4007).\n- Add `n-equation` component.\n- `n-image` adds `previewed-img-props` prop.\n- `n-data-table` adds `scrollbar-props` prop, closes [#4021](https://github.com/tusen-ai/naive-ui/issues/4021).\n- `n-upload` adds `should-use-thumbnail-url` prop, closes [#3861](https://github.com/tusen-ai/naive-ui/issues/3861).\n- `n-upload` adds `render-icon` prop.\n- `n-tree`'s `render-switcher-icon` prop is passed with `expanded` & `selected` state.\n- `useDialog`'s option support `transformOrigin`, closes [#3901](https://github.com/tusen-ai/naive-ui/issues/3901).\n\n### Fixes\n\n- Fix `n-image` can be dragged by any button on mouse in preview mode, closes [#3950](https://github.com/tusen-ai/naive-ui/issues/3950).\n- Fix `n-form-item`'s label text is in wrong position when `label-align=\"left\"` and `require-mark-placement=\"left\"` and `label-placement=\"left\"`, closes [#3871](https://github.com/tusen-ai/naive-ui/issues/3871).\n- Fix `n-tree`'s dragging causes partial white screen in Chrome and Edge with version 106, closes [#3909](https://github.com/tusen-ai/naive-ui/issues/3909).\n- Fix `n-select` shows wrong value in select box after `value-field` is set and `max-tag-count=\"responsive\"` and remove selected option in overflow tag's popover, closes [#3869](https://github.com/tusen-ai/naive-ui/issues/3869).\n- Fix `n-ellipsis` won't overflow in `n-card`'s title, closes [#3935](https://github.com/tusen-ai/naive-ui/issues/3935).\n- Fix `n-timeline-item`'s `line-type=\"dashed\"` not working when `n-timeline`'s `horizontal` is set, closes [#4014](https://github.com/tusen-ai/naive-ui/issues/4014).\n- Fix `n-popover` doesn't wrap line if word is too long.\n- Fix `n-date-picker` can't delete all input content in some cases, closes [#3922](https://github.com/tusen-ai/naive-ui/issues/3922).\n- Fix `n-input`'s `autosize` prop doesn't work properly if there are multiple spaces, closes [#4027](https://github.com/tusen-ai/naive-ui/issues/4027).\n- Fix `n-pagination`'s `endIndex` maybe incorrect in last page, closes [#4057](https://github.com/tusen-ai/naive-ui/issues/4057).\n- Fix `n-image` doesn't prevent space pressing scroll behavior in preview mode, closes [#3919](https://github.com/tusen-ai/naive-ui/issues/3919).\n\n### i18n\n\n- Add arDZ locale.\n- Add trTR locale.\n\n## 2.33.5\n\n`2022-10-12`\n\n### Fixes\n\n- Fix `n-data-table` throws error on tree data check action, closes [#3832](https://github.com/tusen-ai/naive-ui/issues/3832).\n\n## 2.33.4\n\n`2022-10-06`\n\n### Fixes\n\n- Fix `n-timeline-item`'s `title`'s `margin-bottom` can't be set by theme variable, closes [#3722](https://github.com/tusen-ai/naive-ui/issues/3722).\n- Fix `n-timeline-item`'s `meta` part's `margin-bottom` is overrided when nested in horizontal and vertical mode.\n- Fix `n-tree-select` would remove selected first option if it's clicked when placed in `label` tag, closes [#3715](https://github.com/tusen-ai/naive-ui/issues/3715).\n- Fix `n-popover` will show after `disabled` is set to `true` then `false` if it's shown at first.\n- Fix `n-select`'s overflow popover won't hide after removing all options in it when `maxTagCount=\"responsive\"`, closes [#3801](https://github.com/tusen-ai/naive-ui/issues/3801).\n- Fix `n-upload` may only allow selecting directory in Firefox, closes [#3798](https://github.com/tusen-ai/naive-ui/issues/3798).\n- Remove `package.json`'s `exports` field due to its poor compatibility, closes [#3786](https://github.com/tusen-ai/naive-ui/issues/3786).\n- Fix `createDiscreteApi` throws error in SSR environment, closes [#3813](https://github.com/tusen-ai/naive-ui/issues/3813).\n- Fix `n-tree-select` has wrong focus behavior when `filterable` and in single select mode.\n- Fix `n-input-number` may not update input when value is set in `on-blur` callback.\n\n### Feats\n\n- `n-collapse-item`'s `header-extra` & `header` slots support `collapsed` param, closes [#3723](https://github.com/tusen-ai/naive-ui/issues/3723).\n- `n-loading-bar-provider` adds `to` prop, closes [#3724](https://github.com/tusen-ai/naive-ui/issues/3724).\n- `n-data-table`'s `on-update:checked-row-keys` will pass current row data and state, closes [#3626](https://github.com/tusen-ai/naive-ui/issues/3626).\n- `n-data-table` column adds `resizable` prop, closes [#3165](https://github.com/tusen-ai/naive-ui/issues/3165).\n- `createDiscreteApi` contains Vue app in returned value.\n- Export `LayoutContentInst` type, closes [#3743](https://github.com/tusen-ai/naive-ui/issues/3743).\n- Export `CarouselInst` type, closes [#3742](https://github.com/tusen-ai/naive-ui/issues/3742).\n- `n-collapse` adds `itemMargin` theme variable, closes [#3788](https://github.com/tusen-ai/naive-ui/issues/3788).\n- `n-select` adds `ignore-composition` prop, closes [#3789](https://github.com/tusen-ai/naive-ui/issues/3789).\n- `n-card` exports `CardSegmented` type, closes [#3775](https://github.com/tusen-ai/naive-ui/issues/3775).\n- `n-date-picker` adds `next-month` slot, closes [#3570](https://github.com/tusen-ai/naive-ui/issues/3570).\n- `n-date-picker` adds `next-year` slot, closes [#3570](https://github.com/tusen-ai/naive-ui/issues/3570).\n- `n-date-picker` adds `prev-month` slot, closes [#3570](https://github.com/tusen-ai/naive-ui/issues/3570).\n- `n-date-picker` adds `prev-year` slot, closes [#3570](https://github.com/tusen-ai/naive-ui/issues/3570).\n- `n-pagination` adds `to` prop, closes [#3773](https://github.com/tusen-ai/naive-ui/issues/3773).\n- `n-avatar` adds `render-placeholder` prop, closes [#3751](https://github.com/tusen-ai/naive-ui/issues/3751).\n- `n-avatar` adds `render-fallback` prop, closes [#3751](https://github.com/tusen-ai/naive-ui/issues/3751).\n- `n-avatar` adds `fallback` slot.\n- `n-transfer` adds `render-target-list` prop.\n- `n-select` adds `show-checkmark` prop, closes [#3749](https://github.com/tusen-ai/naive-ui/issues/3749).\n- `n-tree` adds `animated` prop, closes [#3784](https://github.com/tusen-ai/naive-ui/issues/3784).\n- `n-slider` adds `markFontSize` theme variable, closes [#3820](https://github.com/tusen-ai/naive-ui/issues/3820).\n- `n-avatar-group` adds `gap` theme variable, closes [#3819](https://github.com/tusen-ai/naive-ui/issues/3819).\n\n## 2.33.3\n\n`2022-09-13`\n\n### Feats\n\n- `n-dialog` adds `onAfterLeave` in DialogOptions Properties, closes [#3662](https://github.com/tusen-ai/naive-ui/issues/3662).\n- `n-dynamic-tags` export `DynamicTagsOption` type, closes [#3677](https://github.com/tusen-ai/naive-ui/issues/3677).\n- `n-upload` adds `responseType` prop, closes [#3666](https://github.com/tusen-ai/naive-ui/issues/3666).\n- `n-dropdown`'s `DropdownOption` adds `show` prop, closes [#3703](https://github.com/tusen-ai/naive-ui/issues/3703).\n- `n-data-table` adds `summary-placement` prop, closes [#3681](https://github.com/tusen-ai/naive-ui/issues/3681).\n- `n-tabs` will scroll to active tab, closes [#3683](https://github.com/tusen-ai/naive-ui/issues/3683).\n\n### Performance\n\n- Fix `n-menu`'s `value` will cause useless rendering of menu item, closes [#3670](https://github.com/tusen-ai/naive-ui/issues/3670).\n\n### Fixes\n\n- Fix `n-date-picker`'s style is unexpected in `inline-theme-disabled` mode, closes [#3655](https://github.com/tusen-ai/naive-ui/issues/3655).\n- Fix `n-data-table` can't set `n-dropdown`'s `theme-overrides`, closes [#3613](https://github.com/tusen-ai/naive-ui/issues/3613).\n- Fix `n-carousel` displays abnoramlly if `transform: scale` style is set, closes [#3684](https://github.com/tusen-ai/naive-ui/issues/3684).\n- Fix `n-tree`'s node is disabled after `checkboxDisabled` is set, closes [#3620](https://github.com/tusen-ai/naive-ui/issues/3620).\n- Fix `n-tree`'s switcher won't work when `:show-irrelevant-nodes=\"false\"` is set & being searched, closes [#3647](https://github.com/tusen-ai/naive-ui/issues/3647).\n- Fix `n-progress`'s graph may overflow if `type=\"circle\"` and `stroke-width` is too large, closes [#3638](https://github.com/tusen-ai/naive-ui/issues/3638).\n\n## 2.33.2\n\n`2022-09-01`\n\n### Fixes\n\n- Fix UMD bundle doesn't work, closes [#3642](https://github.com/tusen-ai/naive-ui/issues/3642).\n- Fix `n-calendar`'s displayed month doesn't follow `default-value`, closes [#3645](https://github.com/tusen-ai/naive-ui/issues/3645).\n- Fix `n-form-item`'s `require-mark-placement` prop not working when set to `left`, closes [#3628](https://github.com/tusen-ai/naive-ui/issues/3628).\n- Fix `n-upload`'s `OnBeforeUpload` return type can only be `Promise`.\n\n### Feats\n\n- `n-radio` adds `colorActive` theme variable, closes [#3610](https://github.com/tusen-ai/naive-ui/issues/3610).\n\n## 2.33.1\n\n`2022-08-29`\n\n### Fixes\n\n- Fix could not resolve \"@vicons/ionicons5\" error, closes [#3616](https://github.com/tusen-ai/naive-ui/issues/3616).\n\n## 2.33.0\n\n`2022-08-29`\n\n### Breaking Changes\n\n- `n-rate`'s `default-value` prop's default value is changed from `0` to `null`.\n\n### Fixes\n\n- Fix `n-select`'s menu missing option check mark in SSR mode, closes .\n- Fix `n-card`'s `embedded` prop not work in `n-dialog`, closes [#3592](https://github.com/tusen-ai/naive-ui/issues/3592).\n- Fix `n-radio` warning when value prop type is boolean, closes [#3540](https://github.com/tusen-ai/naive-ui/issues/3540).\n- Fix `n-tree` content width may overflow container, closes [#3561](https://github.com/tusen-ai/naive-ui/issues/3561).\n- Fix `n-form-item` label text may overflow when it's left placement, closes [#3593](https://github.com/tusen-ai/naive-ui/issues/3593).\n\n### Feats\n\n- `n-menu` adds `disabled-field` prop.\n- `n-rate` adds `clearable` prop.\n- `n-slider` adds `keyboard` prop, closes [#3528](https://github.com/tusen-ai/naive-ui/issues/3528).\n- Add `useDialogReactiveList` method, closes [#2041](https://github.com/tusen-ai/naive-ui/issues/2041).\n- `DialogReactive` supports `onAfterEnter` prop, closes [#3569](https://github.com/tusen-ai/naive-ui/issues/3569).\n- `DialogOptions` supports `class` prop, closes [#3591](https://github.com/tusen-ai/naive-ui/issues/3591).\n\n## 2.32.2\n\n`2022-08-19`\n\n### Fixes\n\n- Fix `n-menu` extra not working in submenu, closes [#3390](https://github.com/tusen-ai/naive-ui/issues/3390).\n- Fix `n-tree` can't expand node with `type='group'`, closes [#3388](https://github.com/tusen-ai/naive-ui/issues/3388).\n- Fix `n-pagination`'s' `default-page-size` prop doesn't follows `page-sizes` prop, closes [#3369](https://github.com/tusen-ai/naive-ui/issues/3369).\n- Added `exports` field in package.json [#3410](https://github.com/tusen-ai/naive-ui/pull/3410).\n- Fix `n-dropdown` option prefix & suffix's z-index, closes [#3433](https://github.com/tusen-ai/naive-ui/issues/3433).\n- Fix `n-input-number`'s peers theme can't be configured, closes [#3422](https://github.com/tusen-ai/naive-ui/issues/3422).\n- Fix `n-tag` pointer should be not allow when disabled, closes [#3494](https://github.com/tusen-ai/naive-ui/issues/3494).\n- Fix `n-transfer` throws error if value has no corresponding option, closes [#3406](https://github.com/tusen-ai/naive-ui/issues/3406).\n- Fix `n-data-table` column `onSelect`'s type, closes [#3430](https://github.com/tusen-ai/naive-ui/issues/3430).\n- Fix `n-pagination` don't trigger quick jumper on quick jumper blur, closes [#3387](https://github.com/tusen-ai/naive-ui/issues/3387).\n- Fix some components works abnormally in open mode shadow DOM, closes [#3281](https://github.com/tusen-ai/naive-ui/issues/3281).\n- Fix `n-carousel` in `loop='true'` and `effect='slide'`, When there are only two elements, the transition switching effect of the rotation is opposite, closes [#3414](https://github.com/tusen-ai/naive-ui/issues/3413).\n- Fix `n-input` can't input value after compositing is interrupted by rerender, closes [#3503](https://github.com/tusen-ai/naive-ui/issues/3503).\n- Fix `n-layout`'s `embedded` prop not working after `n-config-provider` has set `inline-theme-disabled`, closes [#3500](https://github.com/tusen-ai/naive-ui/issues/3500).\n- Fix `n-input` has duplicate placeholder if disabled, closes [#3467](https://github.com/tusen-ai/naive-ui/issues/3467).\n- Fix `n-date-picker`'s `iconColor` theme variable not working, closes [#3501](https://github.com/tusen-ai/naive-ui/issues/3501).\n- Fix `n-time-picker`'s `iconColor` theme variable not working, closes [#3501](https://github.com/tusen-ai/naive-ui/issues/3501).\n- Fix `n-select`'s `node-props` prop doesn't work.\n- Fix Nuxt report `CSSRender is not a function` error on preview, closes [#3506](https://github.com/tusen-ai/naive-ui/issues/3506).\n- Fix `n-data-table`'s rows disabled by `column.expandable` can still be expanded, closes [#3373](https://github.com/tusen-ai/naive-ui/issues/3373).\n- Fix `n-input-number` click add or minus button quickly may trigger value change loop, closes [#3329](https://github.com/tusen-ai/naive-ui/issues/3329).\n- Fix `n-switch` some theme variables can't use non-px value, closes [#2938](https://github.com/tusen-ai/naive-ui/issues/2938).\n- Fix `n-input` with `resize` & `type=\"textarea\"` set can't be resized in some cases, closes [#3479](https://github.com/tusen-ai/naive-ui/issues/3479).\n- Fix `n-countdown`'s `reset` method doesn't work in `onFinish` callback, closes [#3536](https://github.com/tusen-ai/naive-ui/issues/3536).\n\n### Feats\n\n- `n-menu`'s `MenuOption` add `show` prop to set whether the Menu option is displayed, closes [#3334](https://github.com/tusen-ai/naive-ui/issues/3334).\n- `n-alert` adds `bordered` prop, closes [#3358](https://github.com/tusen-ai/naive-ui/issues/3358).\n- `n-tag` add `trigger-click-on-close` prop, closes [#3343](https://github.com/tusen-ai/naive-ui/issues/3343).\n- `n-cascader` adds `disabled-field` prop, closes [#3338](https://github.com/tusen-ai/naive-ui/issues/3338).\n- `n-list` adds `clickable` prop.\n- `n-list` adds `hoverable` prop.\n- `n-list` adds `show-divider` prop.\n- `n-thing` adds `content-style` prop.\n- `n-thing` adds `description-style` prop.\n- `n-data-table` adds `render-expand-icon` prop.\n- `n-tree` adds `disabled-field` prop.\n- `n-tree` adds `keyboard` prop, closes [#3438](https://github.com/tusen-ai/naive-ui/issues/3438).\n- `n-tree-select` adds `disabled-field` prop.\n- `n-collapse-item` adds `disabled` prop, closes [#3408](https://github.com/tusen-ai/naive-ui/issues/3408).\n- `n-pagination` adds `simple` prop.\n- `n-cascader` adds `arrow` slot, closes [#3459](https://github.com/tusen-ai/naive-ui/issues/3459).\n- `n-transfer` adds `source-filterable` prop, closes [#3407](https://github.com/tusen-ai/naive-ui/issues/3407).\n- `n-transfer` adds `target-filterable` prop, closes [#3407](https://github.com/tusen-ai/naive-ui/issues/3407).\n- `n-transfer`'s `filter` prop adds `from` param.\n- `n-list` supports RTL.\n- `n-drawer` supports RTL.\n- `n-input` adds `render-count` prop.\n- `n-input` adds `countTextColorDisabled` theme variable, closes [#3481](https://github.com/tusen-ai/naive-ui/issues/3481).\n- `n-statistic` adds `valueFontSize` theme variable, closes [#3510](https://github.com/tusen-ai/naive-ui/issues/3510).\n- `n-data-table` adds `sticky-expanded-rows` to allow expanded content remains sticky, closes [#3485](https://github.com/tusen-ai/naive-ui/issues/3485).\n- `n-tree` adds `scrollTo` method, closes [#3480](https://github.com/tusen-ai/naive-ui/issues/3480).\n- `n-pagination` adds `display-order` prop, closes [#3466](https://github.com/tusen-ai/naive-ui/issues/3466).\n- `n-grid` adds `layout-shift-disabled` prop, closes [#3301](https://github.com/tusen-ai/naive-ui/issues/3301).\n\n## 2.32.1\n\n`2022-07-30`\n\n### Fixes\n\n- Fix `n-drawer`'s warning when using `string` in `default-height` prop, closes [#3377](https://github.com/tusen-ai/naive-ui/issues/3377).\n- Fix `n-transfer`'s `on-update:value` is not triggered when uncheck options, closes [#3393](https://github.com/tusen-ai/naive-ui/issues/3393).\n\n### Feats\n\n- `n-steps` supports RTL.\n\n## 2.32.0\n\n`2022-07-28`\n\n### Breaking Changes\n\n- `n-transfer`'s UI is totally refactored. The original transfer component is renamed as `n-legacy-transfer` and will be removed in next major version.\n\n### Fixes\n\n- Fix `n-date-picker` will cancel selecting in range mode if click at disabled confirm button, closes [#3254](https://github.com/tusen-ai/naive-ui/issues/3254).\n- Fix `n-button`'s `focusable` prop doesn't work, closes [#3292](https://github.com/tusen-ai/naive-ui/issues/3292).\n- Fix `n-upload`'s `on-error` & `on-finish` props don't allow `() => void` type, closes [#3290](https://github.com/tusen-ai/naive-ui/issues/3290).\n- Fix `n-select`'s placeholder may overflow if it's long.\n- Fix `n-input` has is no indent at the prefix if `type=\"textarea\"` and `:autosize=\"true\"`, closes [#3238](https://github.com/tusen-ai/naive-ui/issues/3238).\n- Fix `n-select` focus loss when click `action` slot in `filterable` and `multiple`, closes [#3247](https://github.com/tusen-ai/naive-ui/issues/3247).\n- Fix `n-carousel`'s `autoplay` prop be `true` `hover` can't stop the play, closes [#3304](https://github.com/tusen-ai/naive-ui/issues/3304).\n- Fix `n-tree` may throw error on node selection `expanded-keys`, closes [#3319](https://github.com/tusen-ai/naive-ui/issues/3319).\n- Fix `n-avatar` shows placeholder after load fails, closes [#3315](https://github.com/tusen-ai/naive-ui/issues/3315).\n- Fix `n-input-number` register `mouseup` event multiple times when hold on button.\n- Fix all components' exported props type's prop is `readonly`.\n- Fix `n-tree`'s `check-on-click` prop sometimes doesn't work.\n- Fix `n-progress`'s `offset-degree` prop behaves incorrectly.\n\n### Feats\n\n- `n-checkbox-group`'s `on-update:value` prop adds trigger checkbox's value to params, closes [#3277](https://github.com/tusen-ai/naive-ui/issues/3277).\n- `n-tree` supports RTL.\n- `n-input` adds `scrollTo` method, closes [#3280](https://github.com/tusen-ai/naive-ui/issues/3280).\n- `n-legacy-grid` supports RTL.\n- `n-statistic` supports RTL.\n- `n-thing` supports RTL.\n- `n-transfer` add `render-source-label` prop.\n- `n-transfer` add `render-target-label` prop.\n- `n-transfer` add `render-source-list` prop.\n- `n-scrollbar` supports RTL.\n- `useDialog` supports `onEsc` prop.\n- `n-watermark` adds `global-rotate` prop.\n- `n-notification` add `keepAliveOnHover` props to control whether the notification will be closed when mouse hover, closes [#3249](https://github.com/tusen-ai/naive-ui/issues/3249).\n\n## 2.31.0\n\n`2022-07-07`\n\n### Breaking Changes\n\n- `n-date-picker`'s `clearable` will control visibility of clear button if no `action` is set, closes [#1196](https://github.com/tusen-ai/naive-ui/issues/1196).\n- `n-button`'s `native-focus-behavior` prop default value is changed to 'not on Safari'.\n\n### Fixes\n\n- Fix `n-data-table`'s column `render` prop's `index` param sequence exception when in expandable row, closes [#3153](https://github.com/tusen-ai/naive-ui/issues/3153).\n- Fix `n-data-table` column's `colSpan` doesn't work correctly in virtual scroll mode, closes [#3052](https://github.com/tusen-ai/naive-ui/issues/3052).\n- Fix `n-data-table` doesn't show `summary` row in virtual scroll mode, closes [#3202](https://github.com/tusen-ai/naive-ui/issues/3202).\n- Fix `n-carousel` has wrong hierarchical relationship between when `effect` is `fade`, closes [#3227](https://github.com/tusen-ai/naive-ui/issues/3227).\n- Fix `n-carousel` cannot slide under IOS, closes [#3106](https://github.com/tusen-ai/naive-ui/issues/3106).\n- Fix `n-carousel` losing the size of content elements when rendering, closes [#3078](https://github.com/tusen-ai/naive-ui/issues/3078).\n- Fix `n-cascader`'s filter menu doesn't show option path, closes [#3220](https://github.com/tusen-ai/naive-ui/issues/3220).\n- Fix `n-cascader`'s `filter` prop may not get correct `path`.\n- Fix `n-date-picker` menu's quarter text isn't same having `type=\"quarterrange\"` and `type=\"quarter\"`, closes [#3217](https://github.com/tusen-ai/naive-ui/issues/3217).\n- Fix `n-notification`'s leave animation if content height overflows screen.\n- Fix `n-dropdown`'s disabled option has hover style.\n- Fix `n-dropdown`'s menu may shift when it's entering.\n- Fix `n-dropdown`'s transform origin may not be correct in Chrome.\n- Fix `n-radio-button` may not have correct cursor style, closes [#3243](https://github.com/tusen-ai/naive-ui/issues/3243).\n- Fix `n-input`'s text color is too shallow with disabled state in Safari, closes [#3241](https://github.com/tusen-ai/naive-ui/issues/3241).\n- Fix `n-input`'s separator may have line wrap.\n- Fix all components' `user-select` style prop's effect on Safari.\n- Fix `n-data-table` will prevent page scroll in virtual scroll mode.\n- Fix `n-button` doesn't have pressed effect on Firefox.\n\n### Feats\n\n- `n-avatar` adds `lazy` prop.\n- `n-avatar` adds `intersection-observer-options` prop.\n- `n-number-animation` adds `on-finish` prop.\n- `n-notification` supports RTL.\n- Export all components' props object.\n- `n-popover` adds `footer-style` prop.\n- `n-popover` adds `footer` slot, closes [#3188](https://github.com/tusen-ai/naive-ui/issues/3188).\n- `n-dropdown` adds `menu-props` prop, closes [#2885](https://github.com/tusen-ai/naive-ui/issues/2885).\n- `n-data-table` adds `multiple` prop, closes [#3056](https://github.com/tusen-ai/naive-ui/issues/3056).\n- `n-date-picker` would disable confirm button if end date is not selected, closes [#3226](https://github.com/tusen-ai/naive-ui/issues/3226).\n- `n-tree` adds `check-on-click` prop to control `checked` status, closes [#2968](https://github.com/tusen-ai/naive-ui/issues/2968).\n- `n-tree` adds `accrodion` prop, closes [#3129](https://github.com/tusen-ai/naive-ui/issues/3129).\n- `n-countdown` adds `reset` method, closes [#3228](https://github.com/tusen-ai/naive-ui/issues/3228).\n- `n-drawer` adds `resizable` prop.\n- `n-drawer` adds `default-width` prop.\n- `n-drawer` adds `default-height` prop.\n- `n-drawer` adds `on-update:width` prop.\n- `n-drawer` adds `on-update:height` prop.\n- Update ukUA locale.\n- `n-message` supports RTL.\n\n## 2.30.8\n\n`2022-06-29`\n\n### Fixes\n\n- Fix `n-select`'s menu transition style, closes [#3211](https://github.com/tusen-ai/naive-ui/issues/3211).\n\n## 2.30.7\n\n`2022-06-29`\n\n### Fixes\n\n- Fix `n-tabs`'s `bar-width` props invalid when `0` set, closes [#3171](https://github.com/tusen-ai/naive-ui/issues/3171).\n- Fix `n-drawer` has log warnings of console when use `show-mask` prop, closes [#3172](https://github.com/tusen-ai/naive-ui/issues/3172).\n- Fix `n-button` doesn't omit content if content is wrapped in ellipsis container, closes [#3178](https://github.com/tusen-ai/naive-ui/issues/3178).\n- Fix `n-select` will remove select value in multiple mode in `form` if Enter key is pressed in input element. Closes [#3169](https://github.com/tusen-ai/naive-ui/issues/3169).\n- Fix `n-select`'s filter prop not working, closes [#3175](https://github.com/tusen-ai/naive-ui/issues/3175).\n- Fix `n-modal`'s mask may overlay over content if no preset is used, closes [#3204](https://github.com/tusen-ai/naive-ui/issues/3204).\n- Fix `n-button`'s icon doesn't align correctly if it's too big or small.\n- Fix `n-select`'s created options may repeat multiple times in menu, closes [#3206](https://github.com/tusen-ai/naive-ui/issues/3206).\n\n### Feats\n\n- `n-date-picker`'s `type` prop supports `'quarterrange'` and `'yearrange'`.\n- `n-tree-select` adds `render-prefix` prop.\n- `n-tree-select` adds `render-suffix` prop.\n- `n-tree-select` adds `render-switcher-icon` prop.\n- `n-tree-select` adds `node-props` prop.\n- `n-tree-select` adds `render-label` prop, closes [#3197](https://github.com/tusen-ai/naive-ui/issues/3197).\n- `n-tree-select` adds `render-tag` prop.\n- `n-notification` adds `titleFontSize`, `metaFontSize`, `descriptionFontSize` theme variables.\n\n## 2.30.6\n\n`2022-06-22`\n\n### Fixes\n\n- Fix `n-color-picker` can't input alpha value correctly manually.\n- Fix some components don't work correctly if `__VUE_OPTIONS_API__` is set to `false`, closes [#3146](https://github.com/tusen-ai/naive-ui/issues/3146).\n- Fix `n-grid` doesn't adjust it's content to fit responsive config in SSR page, closes [#2462](https://github.com/tusen-ai/naive-ui/issues/2462).\n- Fix `n-modal` when many instances are activated at same time, `on-mask-click` will be triggered on every modal even only one mask is clicked [#3147](https://github.com/tusen-ai/naive-ui/issues/3147).\n- Fix `n-data-table`'s column `ellipsis` prop's type doesn't allow `style` prop.\n- Fix `n-data-table`'s column will lose box shadow when set to `ellipsis` & `fixed` simultaneously, closes [#3145](https://github.com/tusen-ai/naive-ui/issues/3145).\n- Fix `n-image`'s `lazy` prop doesn't work on Safari & Firefox.\n\n## 2.30.5\n\n`2022-06-20`\n\n### Fixes\n\n- Fix `n-input-group-label`'s content is abnormal in `n-drawer-content`, closes [#3115](https://github.com/tusen-ai/naive-ui/issues/3115).\n- Fix `n-back-top` has log warnings of console when use `show` prop, closes [#3122](https://github.com/tusen-ai/naive-ui/issues/3122).\n- Fix `volar.d.ts` components' type is `any`.\n- Fix `n-grid-item` may not display correctly if `v-show` is used, closes [#3123](https://github.com/tusen-ai/naive-ui/issues/3123).\n- Fix `n-select` clears input value on mouse enter when it's clearable and using IME.\n\n### Feats\n\n- 🌟 `n-image` adds `lazy` prop, closes [#3055](https://github.com/tusen-ai/naive-ui/issues/3055).\n- `n-image` adds `intersection-observer-options` prop.\n- `n-image` adds `placeholder` slot.\n- Exports `NTooltipInst` type.\n- `n-data-table` adds `render-cell` prop, closes [#3095](https://github.com/tusen-ai/naive-ui/issues/3095).\n- `n-space` adds `wrap-item` prop.\n- `n-data-table`'s `on-update:checked-row-keys` will pass row data, closes [#2215](https://github.com/tusen-ai/naive-ui/issues/2215), closes [#2265](https://github.com/tusen-ai/naive-ui/pull/2265).\n\n## 2.30.4\n\n`2022-06-15`\n\n### Fixes\n\n- Fix `n-button` is focused after click with `:focusable=\"false\"`, closes [#3071](https://github.com/tusen-ai/naive-ui/issues/3071).\n- Fix `n-data-table` fixed selection may overlap with other fixed columns if it's width is not default, closes [#3067](https://github.com/tusen-ai/naive-ui/issues/3067).\n- Fix `n-popselect` doesn't trigger `on-update:show` when it select value then menu is closed.\n- Fix `n-popselect`'s width can't be set via `style`.\n- Fix `n-date-picker`'s year & month quick jump may be disabled after `is-date-disabled` is set, closes [#3068](https://github.com/tusen-ai/naive-ui/issues/3068).\n- Fix `n-layout` won't keep scroll state in `keep-alive` component, closes [#3054](https://github.com/tusen-ai/naive-ui/issues/3054).\n- Fix `n-layout-sider` won't keep scroll state in `keep-alive` component.\n- Fix `n-tree` may trigger loading multiple times.\n- Fix `n-tree` throws error on async expanding data with `:expand-on-click=\"true\"`, closes [#3089](https://github.com/tusen-ai/naive-ui/issues/3089).\n- Fix `n-slider`'s tooltip has no enter transition when it's triggered by keyboard.\n- Fix `n-slider` mark text's line wrap isn't correct when it appears at right-most position.\n- Fix `n-upload`'s inner anchor element may show focus-visible outline style.\n- Fix `n-upload` shows slot warning when `list-type=\"image-card\"`.\n- Fix `n-upload` image's corner may overflow item when `list-type=\"image-card\"`.\n- Fix `n-dynamic-tags`'s `on-create` prop not working.\n- Fix virtual scroll stucking issue introduced by Chrome 102, closes [#3048](https://github.com/tusen-ai/naive-ui/issues/3048).\n- Fix `n-upload-dragger` is almost transparent if disabled.\n\n### Feats\n\n- 🌟 `n-pagination` adds dropdown menu for fast jump button.\n- 🌟 `n-input` adds `allow-input` prop.\n- 🌟 `n-data-table` adds `default-expand-all` prop, closes [#3073](https://github.com/tusen-ai/naive-ui/issues/3073).\n- 🌟 `n-modal` with inner popup component like `n-select` can handle esc key pressing correctly, closes [#2973](https://github.com/tusen-ai/naive-ui/issues/2973).\n- `n-tree-select` adds `arrow` slot, closes [#3084](https://github.com/tusen-ai/naive-ui/issues/3084).\n- `n-cascader` will show corresponding submenu after checkbox is clicked, closes [#3079](https://github.com/tusen-ai/naive-ui/issues/3079).\n- `n-upload` will disable dragger when maximum number of files was reached.\n- `n-select` adds `node-props` prop.\n- `n-popselect` adds `node-props` prop.\n- `n-popselect` adds `virtual-scroll` prop.\n- `n-data-table` adds `scrollTo` method, closes [#2570](https://github.com/tusen-ai/naive-ui/issues/2570).\n- `n-slider` adds `thumb` slot.\n\n## 2.30.3\n\n`2022-06-09`\n\n### Fixes\n\n- Fix `n-cascader`'s overflow count tag's popover can't scroll after `filterable` is set, closes [#3061](https://github.com/tusen-ai/naive-ui/issues/3061).\n- Fix `n-drawer`'s `show-mask` prop will warn if `'transparent'` is passed.\n- Fix `n-calendar` doesn't call `on-panel-change` when date of other months is clicked, closes [#3063](https://github.com/tusen-ai/naive-ui/issues/3063).\n\n### Feats\n\n- 🌟 UMD usage is supported.\n- `n-cascader` will expand menu to selected value, closes [#3058](https://github.com/tusen-ai/naive-ui/issues/3058).\n- `n-space` will use `gap` CSS property if possible, closes [#3053](https://github.com/tusen-ai/naive-ui/issues/3053).\n\n## 2.30.2\n\n`2022-06-07`\n\n### Fixes\n\n- Fix `n-select` recomputed options on menu close, improves performance.\n\n## 2.30.1\n\n`2022-06-07`\n\n### Feats\n\n- `n-menu` adds `arrowColorChildActiveHover`, `itemIconColorChildActiveHoverHorizontal`, `itemIconColorChildActiveHover`,`itemTextColorChildActiveHoverHorizontal`, `itemTextColorChildActiveHover`, `arrowColorChildActiveHoverInverted`, `itemIconColorChildActiveHoverHorizontalInverted`, `itemIconColorChildActiveHoverInverted`,`itemTextColorChildActiveHoverHorizontalInverted`, `itemTextColorChildActiveHoverInverted` theme variables, closes [#2929](https://github.com/tusen-ai/naive-ui/issues/2929).\n\n### Fixes\n\n- Fix `n-menu` `node-props` is not applied to element with `role=\"menuitem\"` but a inner element.\n- Fix `n-menu` `node-props` doesn't work with `type=\"group\"` option.\n\n## 2.30.0\n\n`2022-06-06`\n\n### Breaking Changes\n\n- Theme variable `closeColor`, `closeColorHover`, `closeColorPressed` are renamed to `closeIconColor`, `closeIconColorHover`,`closeIconColorPressed`. `closeColorHover`, `closeColorPressed` still exist, controlling background color of close button.\n- `n-tag`'s `colorXxx` theme variables are renamed to `colorBorderedXxx`. `colorXxx` still exists, controlling background color of borderless tag.\n\n### Fixes\n\n- Fix `createDiscreteApi` not working with `'loadingBar'`.\n- Fix `n-popover` background color shifts when closed on theme changing.\n- Fix `n-select`'s menu position doesn't sync with select box when select box's size is changed.\n- Fix `n-scrollbar` can't show horizontal scrollbar, closes [#3047](https://github.com/tusen-ai/naive-ui/issues/3047).\n- Fix `n-tree` node's pressed style is prior to selected style when `:block-line=\"true\"` and `:selectable=\"true\"`.\n- Fix `n-slider` may leak event handler on edga case.\n- Fix `n-data-table` doesn't restore scroll state when it's reactivated inside `keep-alive` component, closes [#2522](https://github.com/tusen-ai/naive-ui/issues/2522).\n- Fix `n-image` zoom level doesn't fit ultra large image.\n- Fix `n-menu`'s dropdown option text style when some of it's descendants is activated.\n- Fix `n-input`'s `input-props` prop's `class` & `style` not working.\n\n### Feats\n\n- 🌟 `n-time-picker` adds `time-zone` prop, closes [#293](https://github.com/tusen-ai/naive-ui/issues/293).\n- 🌟 `n-input-number` adds `parse` prop.\n- 🌟 `n-input-number` adds `format` prop.\n- 🌟 `n-input-number` adds `precision` prop, closes [#2068](https://github.com/tusen-ai/naive-ui/issues/2068), [#1859](https://github.com/tusen-ai/naive-ui/issues/1859).\n- 🌟 `n-image` adds a switch to display the original size of the picture, closes [#3023](https://github.com/tusen-ai/naive-ui/issues/3023).\n- 🌟 All components' close buttons use new style and are focusable.\n- All components' select menu & dropdown menu's options use new style.\n- `n-tag` adds `icon` slot.\n- `n-tag` adds `strong` prop.\n- `n-tag` adds background color in dark theme when `:bordered=\"false\"`, closes [#1699](https://github.com/tusen-ai/naive-ui/issues/1699).\n- `n-time` adds `time-zone` prop.\n- `n-breadcrumb-item` adds `clickable` prop.\n- `n-breadcrumb-item` uses new style, adds `itemLineHeight`, `itemBorderRadius`, `itemColorHover`, `itemColorPressed` theme variables.\n- `n-notification` optimizes title style when it's too long.\n- `n-drawer` optimizes title style when it's too long.\n- `n-dialog` optimizes title style when it's too long.\n- `n-card` optimizes title style when it's too long.\n\n## 2.29.1\n\n`2022-06-03`\n\n### Fixes\n\n- Fix `n-tree` throw error when use `pattern` prop filter the tree node, closes [#2960](https://github.com/tusen-ai/naive-ui/issues/2960).\n- Fix `n-watermark` not working when `cls-prefix` is set.\n- Fix `n-dropdown`'s incorrect render arrow when `:show-arrow=\"true\"`, closes [#2977](https://github.com/tusen-ai/naive-ui/issues/2977).\n- Fix `n-upload-dragger` doesn't take full width.\n- Fix `n-global-style` doesn't clear body element's padding and margin.\n- Fix `n-modal` won't clear document body's overflow style if it's unmounted when it is shown, closes [#3015](https://github.com/tusen-ai/naive-ui/issues/3015).\n- Fix keyboard operation doesn't work in some specific old browsers.\n- Fix `n-tabs` lacks tab padding when `justify-content` is `'start'`, `'end'` or `'center'`.\n- Fix `n-tabs` doesn't update bar's position after `justify-content` or `size` is updated.\n- Fix `n-switch` has no transition effect when toggle `disabled`.\n- Fix `n-modal` & `n-drawer` will be closed on esc pressed during IME input, closes [#2989](https://github.com/tusen-ai/naive-ui/issues/2989).\n- Fix `n-date-picker` can select time when is selecting date in date time range picker, closes [#3004](https://github.com/tusen-ai/naive-ui/issues/3004).\n- Fix `n-pagination` has display issue when `:page-count=\"0\"`, closes [#2970](https://github.com/tusen-ai/naive-ui/issues/2970).\n- Fix `n-date-picker`'s `shortcuts` will be overrided by `default-time` when `type=\"datetimerange\"`, closes [#3020](https://github.com/tusen-ai/naive-ui/issues/3020).\n- Fix `n-image-group` switch pictures doesn't work in SSR mode.\n- Fix `n-tabs`'s height transition sometimes not applied when `display-directive=\"show\"` and `:animated=\"true\"`, closes [#3035](https://github.com/tusen-ai/naive-ui/issues/3035).\n- Fix `n-select`'s filter font size is a bit small in single select mode.\n- Fix `n-select`'s count tag's popover is too high when overflow tag's count is small.\n- Fix `n-date-picker`'s first time scroll state of items is not aligned when `type=\"monthrange\"`.\n- Fix `n-form-item`'s asterisk in required mode can be selected.\n- Fix `n-list`'s color is incorrect inside `n-popover` in dark mode.\n\n### Feats\n\n- 🌟 `n-select` adds `label-field` prop, closes [#3018](https://github.com/tusen-ai/naive-ui/issues/3018).\n- 🌟 `n-select` adds `value-field` prop, closes [#3018](https://github.com/tusen-ai/naive-ui/issues/3018).\n- 🌟 `n-steps` adds `on-update:current` prop.\n- 🌟 `n-date-picker` adds `panel` prop.\n- 🌟 `n-data-table` adds `on-scroll` prop, closes [#3025](https://github.com/tusen-ai/naive-ui/issues/3025).\n- 🌟 `FormItemRule` adds `renderMessage` prop, closes [#2525](https://github.com/tusen-ai/naive-ui/issues/2525).\n- 🌟 Add `createDiscreteApi` to create message, notification, dialog, loading bar outside setup.\n- `n-scrollbar` adds `trigger` prop.\n- `n-input-number` adds `button-placement` prop.\n- `n-select` adds `children-field` prop, closes [#3018](https://github.com/tusen-ai/naive-ui/issues/3018).\n- `n-upload` adds `trigger-style` prop.\n- `n-dropdown` adds `node-props` prop.\n- `n-dropdown` adds `render-option` prop.\n- `n-upload` adds `is-error-state` prop, closes [#2975](https://github.com/tusen-ai/naive-ui/issues/2975).\n- `n-date-picker`'s `shortcuts` prop supports readonly tuple type.\n- `n-step` adds `disabled` prop.\n- `n-calendar` adds `header` slot, closes [#3036](https://github.com/tusen-ai/naive-ui/issues/3036).\n- `n-tree` adds `expand-on-click` prop， [#2949](https://github.com/tusen-ai/naive-ui/issues/2949).\n\n## 2.29.0\n\n`2022-05-18`\n\n### Breaking Changes\n\n- Since `n-pagination` supports `size` prop, some theme variables of `n-pagination` are changed.\n\n### Fixes\n\n- Fix `n-menu` use `render-icon` function render incorrect when returns `true`.\n- Fix `n-tabs`'s `tabFontWeightActive` theme varialbe applies to all tabs, closes [#2926](https://github.com/tusen-ai/naive-ui/issues/2926).\n- Fix `n-tree-select`'s `default-expand-all` not working.\n- Fix `n-upload`'s `accept` prop doesn't work in drag & drop mode, closes [#2919](https://github.com/tusen-ai/naive-ui/issues/2919).\n- Fix `n-calendar`'s `on-panel-change` returning wrong month value when clicking Today.\n- Fix `n-time` throws error caused by `getTimezoneOffset` in SSR mode, closes [#2545](https://github.com/tusen-ai/naive-ui/issues/2545).\n- Fix `n-transfer`'s search box's box-shadow is truncated.\n- Fix `n-time-picker`'s input box's invalid value won't be cleared after blur.\n\n### Feats\n\n- `n-notification-provider`'s `placement` prop supports `'top'` and `'bottom'`, closes [#2930](https://github.com/tusen-ai/naive-ui/issues/2930).\n- `n-pagination` add `size` prop, closes [#2888](https://github.com/tusen-ai/naive-ui/issues/2888).\n- `n-config-provider` adds `preflight-style-disabled` prop.\n- `n-pagination`'s quick jumper only allow integer input, closes [#2928](https://github.com/tusen-ai/naive-ui/issues/2928).\n- `n-pagination` will jump to the first / last page when its value is out of range, closes [#2928](https://github.com/tusen-ai/naive-ui/issues/2928).\n- `n-color-picker` adds `on-confirm` prop.\n- `n-input` adds `clear-icon` slot.\n- `n-date-picker` adds `date-icon` slot, closes [#2668](https://github.com/tusen-ai/naive-ui/issues/2668).\n- `n-date-picker` adds `separator` slot, closes [#2668](https://github.com/tusen-ai/naive-ui/issues/2668).\n\n### i18n\n\n- Add nlNL locale.\n\n## 2.28.4\n\n`2022-05-11`\n\n### Fixes\n\n- Fix `n-theme-editor`'s content can't be scrolled.\n\n## 2.28.3\n\n`2022-05-11`\n\n### Fixes\n\n- Fix `n-menu`'s `dropdown-props` prop can't override `n-dropdown`'s `size` prop, closes [#2868](https://github.com/tusen-ai/naive-ui/issues/2868).\n- Fix `n-switch` abnormal loading animation when switching state, closes [#2870](https://github.com/tusen-ai/naive-ui/issues/2870).\n- Fix `n-data-table` doesn't show content when page is more than data's page, closes [#2840](https://github.com/tusen-ai/naive-ui/issues/2840).\n- Fix `n-data-table`'s `cellProps` doesn't has correct generic type.\n- Fix `n-data-table`'s `work-break` isn't `break-word`.\n- Fix `n-list`'s css variable `n-merged-color` is not correct.\n- Fix `MessageReactive`'s `destroy` method throws error if message has disappeared.\n- Fix `n-ellpisis` can't show tooltip if content width is very close to container width, closes [#1393](https://github.com/tusen-ai/naive-ui/issues/1393), [#2899](https://github.com/tusen-ai/naive-ui/issues/2899).\n- Fix `n-tree` can't use `width: fit-content;` style, closes [#2875](https://github.com/tusen-ai/naive-ui/issues/2875).\n- Fix `n-dropdown`'s `on-update:show` prop will be triggered twice, closes [#2905](https://github.com/tusen-ai/naive-ui/issues/2905).\n- Fix `n-select` can select option by pressing enter after options are cleared.\n- Fix `n-data-table`'s `selection` and `expand` column can't set width.\n- Fix `n-checkbox` contains selectable whitespace.\n- Fix `DescriptionsProps` is misspelled as `DescriptionProps`.\n- Fix `n-icon` misses `IconProps`.\n- Fix `n-icon-wrapper` misses `IconWrapperProps`.\n- Fix `n-countdown`'s display value is 1s faster than actual left time when `precision=0`, closes [#2910](https://github.com/tusen-ai/naive-ui/issues/2910).\n\n### Feats\n\n- `n-menu` adds `node-props` prop.\n- `n-switch` adds `rubber-band` prop.\n- `n-space`'s `justify` prop supports `'space-evenly'`.\n- `n-popover` adds `content-style` prop.\n- `n-popover` adds `header-style` prop.\n- `n-popover` adds `scrollable` prop.\n- `n-select` & `n-cascader` & `n-tree-select`'s overflow count tag's popover is scrollable.\n- `n-data-table` adds `pagination-behavior-on-filter` prop.\n- `n-date-picker`'s `type` prop supports `monthrange` option.\n- `n-date-picker` adds `on-clear` prop.\n- `n-date-picker` adds `on-confirm` prop, closes [#2852](https://github.com/tusen-ai/naive-ui/issues/2852).\n- `n-data-table`'s `columns`'s element supports `minWidth` prop.\n- `n-tree` adds `checkbox-placement` prop.\n- `n-tree-select` adds `loading` prop, closes [#2857](https://github.com/tusen-ai/naive-ui/issues/2857).\n- `n-modal` adds `block-scroll` prop, closes [#2556](https://github.com/tusen-ai/naive-ui/issues/2556).\n- `n-drawer` adds `block-scroll` prop, closes [#2556](https://github.com/tusen-ai/naive-ui/issues/2556).\n- `n-drawer` adds `show-mask` prop, closes [#2556](https://github.com/tusen-ai/naive-ui/issues/2846).\n- `useDialog().xxx` supports `blockScroll` option, closes [#2556](https://github.com/tusen-ai/naive-ui/issues/2556).\n- `useDialog().xxx` supports `autoFocus` option.\n- `n-button` adds `native-focus-behavior` prop, closes [#2882](https://github.com/tusen-ai/naive-ui/issues/2882).\n- `n-time-picker` adds `on-confirm` prop.\n- `n-time-picker` adds `on-clear` prop.\n- `n-time-picker` adds `on-update:show` prop.\n- `n-time-picker` adds `show` prop.\n- `n-date-picker` adds `on-update:show` prop.\n- `n-date-picker` adds `show` prop.\n- `n-date-picker` adds `default-calendar-start-time` prop, closes [#2732](https://github.com/tusen-ai/naive-ui/issues/2732).\n- `n-date-picker` adds `default-calendar-end-time` prop, closes [#2732](https://github.com/tusen-ai/naive-ui/issues/2732).\n- `n-date-picker` adds `bind-calendar-months` prop, closes [#2751](https://github.com/tusen-ai/naive-ui/issues/2751).\n- `n-upload` adds `directory` prop.\n- `n-upload` adds `directory-dnd` prop.\n- `UploadFileInfo` adds `fullPath` and `batchId` attrs.\n- `DataTableBaseColumn` adds `tree` attr, closes [#2757](https://github.com/tusen-ai/naive-ui/issues/2757).\n\n## 2.28.2\n\n`2022-04-22`\n\n### Fixes\n\n- Fix `date-picker` `actions`'s type can't be `null`.\n- Fix `time-picker` `actions`'s type can't be `null`.\n- Fix `n-tree-select`'s meaningless warning.\n- Fix `n-tree-select`'s `allow-checking-not-loaded` prop doesn't work.\n- Fix `n-tree-select`'s menu position may not sync with trigger box if `:allow-checking-not-loaded=\"true\"`.\n- Fix `n-cascader`'s menu position may not sync with trigger box if `:allow-checking-not-loaded=\"true\"`.\n\n## 2.28.1\n\n`2022-04-20`\n\n### Fixes\n\n- Fix `notification` icon won't show after first notification is emitted in SSR mode, closes [#2793](https://github.com/tusen-ai/naive-ui/issues/2793).\n- Fix `dialog` icon won't show after first dialog is displayed in SSR mode.\n- Fix `n-drawer` & `n-modal` may overflow screen on opening if `:autofocus=\"true\"`.\n- Fix `n-tree-select`'s filter not working correctly when `children-field` is not set, closed [#2789](https://github.com/tusen-ai/naive-ui/issues/2789).\n- Fix `n-tree-select`'s matched style is not cleared after filter value is cleared.\n- Fix `n-tree-select`'s parent items in tree are selectable when `check-strategy=\"child\"` and `:cascade=\"false\"`, closes [#2780](https://github.com/tusen-ai/naive-ui/issues/2780).\n- Fix `n-select`'s `empty` slot can't let `n-input` focus inside, closes [#2812](https://github.com/tusen-ai/naive-ui/issues/2812).\n- Fix `n-select`'s menu is invisible in fullscreen mode, closes [#2722](https://github.com/tusen-ai/naive-ui/issues/2722).\n- Fix `n-color-picker`'s `value` prop can't be `null`.\n- Fix `n-table`'s border color shifts when switch bewteen different props.\n\n### Feats\n\n- `n-input-number` adds `add-icon` and `minus-icon` slots, closes [#2668](https://github.com/tusen-ai/naive-ui/issues/2668).\n- `n-dynamic-input` adds `RTL` support.\n- `n-table` adds `RTL` support.\n- `n-collapse-transition` adds `RTL` support.\n- `n-tree` adds `show-irrelevant-nodes` prop, closes [#2764](https://github.com/tusen-ai/naive-ui/issues/2764).\n- `n-tree-select` adds `allow-checking-not-loaded` prop.\n- `n-cascader` adds `allow-checking-not-loaded` prop.\n- `n-tree` adds `allow-checking-not-loaded` prop.\n- `n-button-group` adds `RTL` support.\n\n### i18n\n\n- Add ptBR locale.\n- Add koKR locale.\n\n## 2.28.0\n\n`2022-04-11`\n\n### Breaking Changes\n\n- `n-time` uses `formatDistanceStrict` rather than `formatDistance` in `date-fns`, closes [#2703](https://github.com/tusen-ai/naive-ui/issues/2703).\n\n### Fixes\n\n- Fix `n-tabs` has unexpected line animation when nested with `n-tabs`, closes [#2689](https://github.com/tusen-ai/naive-ui/issues/2689).\n- Fix `n-popconfirm` with no body content has wrong margin top, closes [#2690](https://github.com/tusen-ai/naive-ui/issues/2690).\n- Fix `n-tree-select` unexpected warning.\n- Fix `n-calendar`'s disabled cells are clickable, closes [#2686](https://github.com/tusen-ai/naive-ui/issues/2686).\n- Fix message icon won't show after first message is emitted in SSR mode, closes [#2721](https://github.com/tusen-ai/naive-ui/issues/2721).\n- Fix `n-popconfirm`'s `positive-button-props` and `negative-button-props` props lack reactivity, closes [#2753](https://github.com/tusen-ai/naive-ui/issues/2753).\n- Fix `n-step` has unexpected theme variable class.\n- Fix `n-steps` displays uncorrectly when nested in vertical & horizontal mode.\n- Fix `n-popconfirm`'s `positive-text` & `negetive-text` props don't allow `null` type.\n- Fix `n-color-picker` can't be closed if mousedown.stop is set when click outside, closes [#2709](https://github.com/tusen-ai/naive-ui/issues/2709).\n- Fix `n-tabs` switch animation is incorrect when `display-directive='show'`, closes [#2718](https://github.com/tusen-ai/naive-ui/issues/2718).\n\n### Feats\n\n- `n-radio` adds `label` prop, closes [#2707](https://github.com/tusen-ai/naive-ui/issues/2707).\n- `n-drawer` adds `on-after-enter` and `on-after-leave` props, closes [#2698](https://github.com/tusen-ai/naive-ui/issues/2698).\n- `n-data-table` adds `paginate-single-page` prop , closes [#2043](https://github.com/tusen-ai/naive-ui/issues/2043).\n- `n-pagination` add `RTL` support.\n- `n-alert` add `RTL` support.\n- `n-data-table` adds `allow-checking-not-loaded` prop, closes [#2758](https://github.com/tusen-ai/naive-ui/issues/2758).\n\n## 2.27.0\n\n`2022-03-27`\n\n### Breaking Changes\n\n- `n-menu` has some style changes.\n\n### Fixes\n\n- Fix `n-data-table`‘s row disorder when using `expand` type, closes [#2631](https://github.com/tusen-ai/naive-ui/issues/2631).\n- Fix `n-popconfirm` doesn't has `setShow` & `syncPosition` methods.\n- Fix `n-popselect` doesn't has `setShow` & `syncPosition` methods.\n- Fix `n-menu` theme's peers missing `Dropdown`.\n- Fix `n-color-picker` can't input 0 as unit's value, closes [#2680](https://github.com/tusen-ai/naive-ui/issues/2680).\n- Fix `n-tree`'s scrollbar overflows in virtual scroll mode, closes [#2673](https://github.com/tusen-ai/naive-ui/issues/2673).\n- Fix `n-layout-sider`'s `content-style` can't override `overflow: auto` prop, closes [#2671](https://github.com/tusen-ai/naive-ui/issues/2671).\n- Fix `n-date-picker` displays panel item abnormally with `month` and `quarter` type in dark mode.\n- Fix `n-dropdown` `onUpdateShow` not working.\n- Fix `n-auto-complete` `onSelect` is triggered after `onUpdate:value`.\n- Fix `n-data-table` `initiatorColumn` in `onUpdate:filters`'s type is an optional parameter.\n\n### Feats\n\n- `n-tree-select` adds `on-load` prop, closes [#2550](https://github.com/tusen-ai/naive-ui/issues/2550).\n- `n-data-table` adds `on-load` prop.\n- `n-cascader` adds `menu-props` prop, closes [#2600](https://github.com/tusen-ai/naive-ui/issues/2600).\n- `n-cascader` adds `filter-menu-props` prop, closes [#2600](https://github.com/tusen-ai/naive-ui/issues/2600).\n- `n-badge` adds `value` slot.\n- `n-form` adds `validate-messages` prop.\n- `n-data-table`'s column supports `cellProps` prop, closes [#2625](https://github.com/tusen-ai/naive-ui/issues/2625).\n- `n-step` adds class to distinguish status.\n- `n-popconfirm` adds `negative-button-props` props, closes [#2642](https://github.com/tusen-ai/naive-ui/issues/2642).\n- `n-popconfirm` adds `positive-button-props` props, closes [#2642](https://github.com/tusen-ai/naive-ui/issues/2642).\n- `n-pagination` adds `goto` slot.\n- `n-input` adds `password-visible-icon` slot.\n- `n-input` adds `password-invisible-icon` slot.\n- `n-select` adds `status` prop.\n- `n-input-number` adds `status` prop.\n- `n-auto-complete` adds `status` prop.\n- `n-cascader` adds `status` prop.\n- `n-date-picker` adds `status` prop.\n- `n-time-picker` adds `status` prop.\n- `n-mention` adds `status` prop.\n- `n-tree-select` adds `status` prop.\n- `n-menu` adds `showOption` method, closes [#2562](https://github.com/tusen-ai/naive-ui/issues/2562).\n- `n-dynamic-tags`'s `value` support object typed option.\n- `n-dynamic-tags` adds `render-tag` prop, closes [#2526](https://github.com/tusen-ai/naive-ui/issues/2526).\n- `n-dynamic-tags` adds `on-create` prop, closes [#2576](https://github.com/tusen-ai/naive-ui/issues/2576).\n- `n-date-picker` adds `time-picker-props` props, closes [#2660](https://github.com/tusen-ai/naive-ui/issues/2660).\n- `n-tabs` adds `trigger` prop, closes [#2679](https://github.com/tusen-ai/naive-ui/issues/2679).\n- `n-menu` adds `itemColorHover`, `itemColorActiveHover`, `itemTextColorActiveHover`, `itemTextColorHorizontal`, `itemTextColorHoverHorizontal`, `itemTextColorActiveHorizontal`, `itemTextColorActiveHoverHorizontal`, `itemTextColorChildActiveHorizontal`, `itemIconColorActiveHover`, `itemIconColorHorizontal`, `itemIconColorHoverHorizontal`, `itemIconColorActiveHorizontal`, `itemIconColorActiveHoverHorizontal`, `itemIconColorChildActiveHorizontal`, `arrowColorActiveHover`, `itemColorHoverInverted`, `itemColorActiveHoverInverted`, `itemTextColorActiveHoverInverted`, `itemTextColorHorizontalInverted`, `itemTextColorHoverHorizontalInverted`, `itemTextColorChildActiveHorizontalInverted`, `itemTextColorActiveHorizontalInverted`, `itemTextColorActiveHoverHorizontalInverted`, `itemIconColorActiveHoverInverted`, `itemIconColorHorizontalInverted`, `itemIconColorHoverHorizontalInverted`, `itemIconColorActiveHorizontalInverted`, `itemIconColorActiveHoverHorizontalInverted`, `itemIconColorChildActiveHorizontalInverted`, `arrowColorActiveHoverInverted` theme variables, closes [#2598](https://github.com/tusen-ai/naive-ui/issues/2598).\n- `n-carousel` adds `next-slide-style` and `prev-slide-style` props, closes [#2340](https://github.com/tusen-ai/naive-ui/issues/2340).\n- `n-dialog` adds `negative-button-props` prop.\n- `n-dialog` adds `positive-button-props` prop.\n- `n-tabs` adds `animated` prop.\n\n### i18n\n\n- Add thTH locale.\n\n## 2.26.4\n\n`2022-03-11`\n\n### Fixes\n\n- Fix `n-tree-select`s in `multiple` mode cannot delete options whose `default-value` attribute contains parent node, closes [#2605](https://github.com/tusen-ai/naive-ui/issues/2605).\n- Fix `n-tree` may throw error when node is removed, closes [#2597](https://github.com/tusen-ai/naive-ui/issues/2597).\n- Fix `useDialog` renders component with popup content with unexpected focus management behavior, closes [#2612](https://github.com/tusen-ai/naive-ui/issues/2612).\n- Fix `n-tree-select`'s node sometimes can't be clicked when `check-strategy` is `'child'`.\n- Fix `n-tree-select`'s emitted value can be not corresponding to `check-strategy` when delete option in select box with `check-strategy` is not `'all'`.\n\n### Feats\n\n- `useDialog` supports `closeOnEsc` prop.\n- `n-data-table` exports `DataTableFilterState` type.\n- `n-data-table` exports `DataTableSortState` type.\n\n## 2.26.3\n\n`2022-03-09`\n\n### Fixes\n\n- Fix `n-button`'s loading icon shifts.\n\n## 2.26.2\n\n`2022-03-09`\n\n### Fixes\n\n- Fix `n-cascader` arrow's loading animation last for too long time.\n- Fix `n-select` menu doesn't follow theme.\n- Fix `n-tabs` throws error without child, closes [#809](https://github.com/tusen-ai/naive-ui/issues/809).\n- Fix `n-menu`'s font color is not changed after theme is changed in chrome 99, closes [#2563](https://github.com/tusen-ai/naive-ui/issues/2563). This is actual a bug of chrome, however we used a workaround and fixed it.\n- Fix `n-date-picker`'s date item click trigger area is as large as cell size only in `'date'` mode.\n\n### Feats\n\n- `n-dynamic-tags` `input` slot add `deactivate` prop, closes [#2575](https://github.com/tusen-ai/naive-ui/issues/2575).\n- `n-space` add `RTL` support.\n- `n-avatar-group` add `RTL` support.\n- `n-badge` add `RTL` support.\n- `n-radio` add `RTL` support.\n- `n-auto-complete` adds `focus` method.\n- `n-auto-complete` adds `blur` method.\n\n## 2.26.1\n\n`2022-03-06`\n\n### Fixes\n\n- Fix `base-loading` use css transition rather than svg animateTrantion to prevent js blocking, close [#2506](https://github.com/tusen-ai/naive-ui/issues/2506).\n- Fix `n-time` throws error caused by `getTimezoneOffset`, closes [#2545](https://github.com/tusen-ai/naive-ui/issues/2545).\n- Fix `n-modal`'s mask doesn't have enter & leave transition.\n- Fix `n-timeline` has style conflict when vertical & horizontal `n-timeline` are nested, closes [#2549](https://github.com/tusen-ai/naive-ui/issues/2549).\n- Fix `n-tree`'s arrow & loading switch animation isn't complete.\n\n### Feats\n\n- `n-time-line-item` adds `line-type` prop, closes [#2548](https://github.com/tusen-ai/naive-ui/issues/2548).\n- `n-step` adds `icon` slot, closes [#2547](https://github.com/tusen-ai/naive-ui/issues/2547).\n- `n-input-number` adds `autofocus` prop, closes [#2551](https://github.com/tusen-ai/naive-ui/issues/2551).\n- `n-date-picker`'s date item click trigger area is as large as cell size, closes [#2552](https://github.com/tusen-ai/naive-ui/issues/2552).\n\n## 2.26.0\n\n`2022-03-02`\n\n### Breaking Changes\n\n- Fix `n-tooltip`'s gap between arrow and body. `n-tooltip` can't be translucent anymore.\n\n### Feats\n\n- `n-popover` adds `arrow-point-to-center` prop.\n- `n-config-provider` adds `inline-theme-disabled` prop.\n\n## 2.25.8\n\n`2022-03-01`\n\n### Fixes\n\n- Fix `useMessage` loses styles.\n\n## 2.25.7\n\n`2022-03-01`\n\n### Fixes\n\n- Fix `n-time-picker` still shows action bar when `:actions=\"null\"`.\n- Fix `n-input`'s content may overflow when `type=\"text\"` and `autosize` is enabled, closes [#2505](https://github.com/tusen-ai/naive-ui/issues/2505).\n- Fix `n-upload` put `file` field before other `FormData` fields, closes [#2504](https://github.com/tusen-ai/naive-ui/issues/2504).\n- Fix `n-button` rtl support.\n- Fix `n-form-item-row` can't call `n-form-item`'s methods.\n\n### Feats\n\n- `n-collapse` add `RTL` support.\n- `useMessage` adds `create` methods.\n- `useMessage` adds `showIcon` prop, closes [#2495](https://github.com/tusen-ai/naive-ui/issues/2495).\n- `useMessage` supports `'default'` `type`.\n- `n-checkbox` supports label line wrap, closes [#2419](https://github.com/tusen-ai/naive-ui/issues/2419).\n- `n-radio` supports label line wrap, closes [#2419](https://github.com/tusen-ai/naive-ui/issues/2419).\n- `n-checkbox` add `RTL` support.\n- `n-input` add `RTL` support.\n- `n-input-number` add `RTL` support.\n\n## 2.25.5\n\n`2022-02-24`\n\n### Fixes\n\n- Fix `n-col` can't be wrapped correctly when `span=6`, closes [#2497](https://github.com/tusen-ai/naive-ui/issues/2497).\n- Fix `n-tabs` doesn't display border-bottom in scroll area on large number of tabs, closes [#2500](https://github.com/tusen-ai/naive-ui/issues/2500).\n\n## 2.25.3\n\n`2022-02-23`\n\n### Fixes\n\n- Fix `n-switch` can't use keyboard operation when checked value is customized.\n- Fix `n-data-table`'s fixed column is covered by scroll content when placed inside popover.\n- Fix `n-data-table` when the `filterOptions` value is 0, the filter will not take effect, closes [#2392](https://github.com/tusen-ai/naive-ui/issues/2392).\n- Fix `n-data-table` cannot click selection checkbox if the selection column is a column's child.\n- Fix `n-table`'s `border-color` abnormal style when this added dynamically, closes [#2403](https://github.com/tusen-ai/naive-ui/issues/2403).\n- Fix `n-tree`'s `default-expand-all` prop doesn't work for dynamic data.\n- Fix `n-form` when `model.xxx` is `undefined`, validator will use `null` as validation value, closes [#2486](https://github.com/tusen-ai/naive-ui/issues/2486).\n- Fix `n-input` focus style's priority is lower than hover style, closes [#2480](https://github.com/tusen-ai/naive-ui/issues/2480).\n- Fix `n-data-table` display issue when placed inside keep-alive component with virtual scroll, closes [#2183](https://github.com/tusen-ai/naive-ui/issues/2183).\n- Fix `notification` enter & leave animation.\n\n### Feats\n\n- `n-tree-select` adds `clear-filter-after-select` prop.\n- `n-cascader` adds `clear-filter-after-select` prop.\n- `n-switch` adds `icon` slot.\n- `n-switch` adds `checked-icon` slot.\n- `n-switch` adds `unchecked-icon` slot.\n- `n-tabs` uses `n` as CSS vars prefix.\n- Add `n-watermark` component, closes [#1745](https://github.com/tusen-ai/naive-ui/issues/1745).\n- `n-scrollbar` adds `scrollBy` method, closes [#2435](https://github.com/tusen-ai/naive-ui/issues/2435).\n- `n-data-table`'s `summary`'s `value` supports `VNodeChild`, closes [#2339](https://github.com/tusen-ai/naive-ui/issues/2339).\n- `n-input-number` adds hold click to increment, closes [#1293](https://github.com/tusen-ai/naive-ui/issues/1293).\n- `n-description` adds `titleTextColor` theme variable.\n\n### i18n\n\n- Add skSK locale.\n- Fix frFR locale.\n\n## 2.25.2\n\n`2022-02-11`\n\n### Fixes\n\n- Remove useless `console.log` in `resolveSlot`.\n- Fix `n-tag` misses background color when `checkable=true`.\n- Fix `n-tree` throws `Image` error in `happydom` testing environment.\n- Fix `n-select` `max-tag-count` tag size doesn't follow select size.\n\n### Feats\n\n- `n-progress` props `type` add type `dashboard`.\n- `n-progress` adds `gap-degree` prop.\n- `n-progress` adds `gap-offset-degree` prop.\n- `n-select` adds `clear-filter-after-select` prop, closes [#2352](https://github.com/tusen-ai/naive-ui/issues/2352).\n\n### i18n\n\n- Add plPL locale, closes [#2354](https://github.com/tusen-ai/naive-ui/issues/2354).\n- Add eo locale.\n\n## 2.25.1\n\n`2022-02-06`\n\n### i18n\n\n- Add enGB locale.\n- Fix deDE locale.\n\n## 2.25.0\n\n`2022-02-04`\n\n### Breaking Changes\n\n- Refactor `n-carousel`'s style when `show-arrow` is true.\n\n### Fixes\n\n- Fix `n-color-picker`'s hue & alpha slider handle are influenced by rail's box-shadow.\n- Fix `n-form-item` prevent feedback padding when empty.\n- Fix `n-button` has extra margin in safari.\n- Fix `n-form`'s rules and `n-form-item`'s rule about `validator` and `asyncValidator`'s `rule` type is not `FormItemRule`, closes [#2299](https://github.com/tusen-ai/naive-ui/issues/2299).\n- Fix `n-log` doesn't break line when line is too long, closes [#2298](https://github.com/tusen-ai/naive-ui/issues/2298).\n- Fix `n-log` doesn't export `LogInst` type.\n- Fix `n-popselect` action slot & empty slot now working.\n- Fix `n-data-table` can't use percent as column width.\n- Fix `n-select` trigger shows blank for a while when `filterable=true` and menu is closing.\n- Fix `n-select`'s being created option is not cleared after menu is closed.\n- Fix `n-select` can't input content when `show=false` and `filterable=true`, closes [#1723](https://github.com/tusen-ai/naive-ui/issues/1723).\n- Fix `n-dropdown` has extra margin when `trigger=\"manual\"`.\n- Fix `web-types.json`'s `n-h1` ~ `n-h6` name.\n- Fix `n-select` deletes option on backspace pressed while compisiting.\n- Fix `n-select` uses disabled option as pending option after menu is opened.\n\n### Feats\n\n- `n-tabs` props `justify-content` add types `start` `center` `end`.\n- `n-auto-complete` adds `placement` prop.\n- `n-cascader` adds `placement` prop.\n- `n-color-picker` adds `placement` prop.\n- `n-date-picker` adds `placement` prop.\n- `n-mention` adds `placement` prop.\n- `n-select` adds `placement` prop.\n- `n-slider` adds `placement` prop.\n- `n-time-picker` adds `placement` prop.\n- `n-tree-select` adds `placement` prop.\n- `n-card` adds `header-extra-style` prop.\n- `n-popover` adds `keep-alive-on-hover` prop, closes [#2326](https://github.com/tusen-ai/naive-ui/issues/2326).\n- `n-input` adds `status` prop.\n- Add `n-icon-wrapper` component.\n- `n-popover` exports `PopoverPlacement` type.\n- `n-drawer` exports `DrawerPlacement` type.\n- `n-dynamic-tags` adds `input-props` prop.\n- `n-notification-provider` adds `container-style` prop.\n- `n-notification-provider` exports `NotificationPlacement` type.\n- `n-notification-provider` exports `NotificationType` type.\n- `n-tabs` add `bar-width` prop.\n- `n-dynamic-input` adds `create-button-props` props.\n- `n-dynamic-input` adds `create-button-default` slot.\n- `n-dynamic-input` adds `create-button-icon` slot.\n- `n-dynamic-input` adds `show-sort-button` prop, closes [#2121](https://github.com/tusen-ai/naive-ui/issues/2121).\n- `n-select` can be used as tag input.\n- `n-select` exports `SelectRenderLabel` type.\n- `n-select` exports `SelectRenderOption` type.\n- `n-select` exports `SelectRenderTag` type.\n- `n-tree` adds `node-props` prop.\n\n## 2.24.7\n\n`2022-01-28`\n\n### Fixes\n\n- `n-popselect` doesn't work with `width=\"trigger\"`.\n\n### i18n\n\n- Update jaJP locale.\n- Update deDE locale.\n\n## 2.24.6\n\n`2022-01-26`\n\n### Feats\n\n- `n-icon` add `component` prop.\n\n### Fixes\n\n- Fix `n-dynamic-input` can add item when max is 0, closes [#2271](https://github.com/tusen-ai/naive-ui/issues/2271).\n- Fix `n-dialog` useless `console.log`.\n\n## 2.24.5\n\n`2022-01-25`\n\n### Fixes\n\n- `n-input` placeholder has no line-wrap in `textarea` type.\n- `n-date-picker` lacks space between panel year & month.\n\n### Feats\n\n- `n-color-picker` adds `disabled` prop.\n- `n-date-picker` adds trigger area for year & month quick jump.\n\n## 2.24.4\n\n`2022-01-24`\n\n### Fixes\n\n- Update vueuc version.\n\n## 2.24.3\n\n`2022-01-24`\n\n### Fixes\n\n- Fix `n-layout-sider` has no border transition.\n\n## 2.24.2\n\n`2022-01-24`\n\n### Fixes\n\n- Fix `n-layout-sider` still occupies 1px after collapsed.\n- Fix `n-code` doesn't break word when `word-wrap=true`.\n- Fix `n-tab-pane`'s tab label area inherits `attrs`, closes [#2221](https://github.com/tusen-ai/naive-ui/issues/2221).\n- Fix `n-image` preview popup background can still be scrolled, closes [#2241](https://github.com/tusen-ai/naive-ui/issues/2241).\n- Fix `n-input` shows placeholder when browser auto completes it, closes [#2234](https://github.com/tusen-ai/naive-ui/issues/2234).\n- Fix `n-input` placeholder word break issue with `type=\"textarea\"`.\n- Fix `n-avatar-group` extra count not correct after `max` is set, closes [#2244](https://github.com/tusen-ai/naive-ui/issues/2244).\n- Fix `n-calendar` doesn't trigger `on-panel-change` on today button clicked.\n- Fix `n-drawer` can't be closed by esc key when `mask-closable=false`, closes [#2233](https://github.com/tusen-ai/naive-ui/issues/2233).\n\n### Feats\n\n- `n-page-header` adds `back` slot, closes [#2176](https://github.com/tusen-ai/naive-ui/issues/2176).\n- `n-select` adds `reset-menu-on-options-change` prop, closes [#2168](https://github.com/tusen-ai/naive-ui/issues/2168).\n- `n-select` adds `arrow` slot, closes [#2201](https://github.com/tusen-ai/naive-ui/issues/2201).\n- `n-carousel` effect supports `'card'`.\n- `n-input` doesn't use native scrollbar when `type=\"textarea\"`, closes [#2242](https://github.com/tusen-ai/naive-ui/issues/2242), [#1172](https://github.com/tusen-ai/naive-ui/issues/1172).\n- `n-number-animation` add `locale` prop, closes [#2181](https://github.com/tusen-ai/naive-ui/issues/2181).\n- `n-number-animation`'s locale follows config provider.\n- Expose `lightTheme`.\n- `n-time-picker` adds `icon` slot, closes [#2228](https://github.com/tusen-ai/naive-ui/issues/2228).\n- `n-tab-pane` adds `tab-props` prop, closes [#2221](https://github.com/tusen-ai/naive-ui/issues/2221).\n- Add `CustomThemeCommonVars` to customize `useThemeVars`.\n- `n-slider` adds `show-tooltip` prop, closes [#2212](https://github.com/tusen-ai/naive-ui/issues/2212).\n- `n-select` adds `on-update:show` prop.\n- `n-select` adds `focus` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-select` adds `blur` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-date-picker` adds `focus` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-date-picker` adds `blur` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-time-picker` adds `focus` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-time-picker` adds `blur` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-checkbox` adds `focus` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-checkbox` adds `blur` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-cascader` adds `focus` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-cascader` adds `blur` method, closes [#2202](https://github.com/tusen-ai/naive-ui/issues/2202).\n- `n-upload` adds `input-props` prop, closes [#2204](https://github.com/tusen-ai/naive-ui/issues/2204).\n- `n-data-table` col adds `render-sorter-icon` prop, closes [#1785](https://github.com/tusen-ai/naive-ui/issues/1785).\n- `n-data-table` col adds `render-sorter` prop, closes [#1785](https://github.com/tusen-ai/naive-ui/issues/1785).\n- `n-date-picker` easy navigation to specific month and year for `date` and `datetime` and `daterange` and `datetimerange` type.\n- `n-modal` adds `close-on-esc` prop.\n- `n-modal` adds `auto-focus` prop.\n- `n-modal` adds `trap-focus` prop.\n- `n-modal` adds `on-esc` prop.\n- `n-drawer` adds `close-on-esc` prop.\n- `n-drawer` adds `auto-focus` prop.\n- `n-drawer` adds `trap-focus` prop.\n- `n-drawer` adds `on-esc` prop.\n- `n-upload` adds `clear` method, closes [#2247](https://github.com/tusen-ai/naive-ui/issues/2247).\n- Add volar types.\n\n### i18n\n\n- Add esAR locale.\n- Add itIT locale.\n\n## 2.24.1\n\n`2022-01-12`\n\n### Fixes\n\n- Fix install error.\n\n## 2.24.0\n\n`2022-01-12`\n\n### Breaking Changes\n\n- Fix `type PageHeaderProps` name. It was mispelled as `PageHeaderPorps` before.\n- `n-image`'s `iconColor` theme variable is renamed as `toolbarIconColor`.\n\n### Fixes\n\n- Fix `n-carousel` when Carousel is a single picture dot still existence, closes [#1777](https://github.com/tusen-ai/naive-ui/issues/1777).\n- Fix `n-upload` `on-finish` prop's `event` parameter type should be `ProgressEvent`.\n- Fix `n-upload` doesn't allow 2xx status code except 200.\n- Fix `n-form` when `validate` use `validateCallback`, cannot call Promise method.\n- Fix `n-input-number` input integer end with 0 cannot update, closes [#2115](https://github.com/tusen-ai/naive-ui/issues/2115).\n- Fix `n-back-top` allow document to be passed to `listen-to` prop.\n- Fix `n-data-table`'s content can be clicked when loading, closes [#2134](https://github.com/tusen-ai/naive-ui/issues/2134).\n- Fix `n-checkbox` doesn't show indeterminate icon in safari.\n- Fix `n-progress`'s inner text of `line` type not aligned in center, closes[#2138](https://github.com/tusen-ai/naive-ui/issues/2138).\n- Fix `n-message`'s `MessageReactive` type lacks `type` parameter.\n- Fix `n-select` has different `padding` with `n-input`, closes [#2149](https://github.com/tusen-ai/naive-ui/issues/2149).\n- Fix `n-tooltip` log errors in console when used in `n-select`'s `render-option`, closes [#1436](https://github.com/tusen-ai/naive-ui/issues/1436).\n- Fix `n-select` log ResizeObserver errors when using `render-option` in safari, closes [#1671](https://github.com/tusen-ai/naive-ui/issues/1671).\n- Fix `n-carousel` can't respond quickly and repeatedly on touch, closes [#1892](https://github.com/tusen-ai/naive-ui/issues/1892).\n- Fix `n-carousel` style of boundary, closes [#1866](https://github.com/tusen-ai/naive-ui/issues/1866).\n- Fix `n-carousel` cannot be clicked on the touchscreen, closes [#1882](https://github.com/tusen-ai/naive-ui/issues/1882).\n- Fix `n-color-picker` default mode can only be rgb is default value is empty.\n\n### Feats\n\n- `n-code` adds `word-wrap` prop, closes [#2111](https://github.com/tusen-ai/naive-ui/issues/2111).\n- `n-modal` adds `z-index` prop, closes [#2088](https://github.com/tusen-ai/naive-ui/issues/2088).\n- `n-drawer` adds `z-index` closes.\n- `n-drawer` adds wai-aria support.\n- `useMessage`'s option support `render` prop.\n- `n-data-table` `TableColumn` supports `string` typed `width`, closes [#2102](https://github.com/tusen-ai/naive-ui/issues/2102).\n- `n-calendar` adds `on-panel-change` prop, closes [#2082](https://github.com/tusen-ai/naive-ui/issues/2082).\n- `n-upload` adds `on-error` prop.\n- `n-pagination` adds `label` slot.\n- `n-tabs` adds `syncBarPosition` method, closes [#2120](https://github.com/tusen-ai/naive-ui/issues/2120).\n- `n-form`, `n-form-item`'s `label-width` prop support `auto` option, closes [#2087](https://github.com/tusen-ai/naive-ui/issues/2087).\n- `n-result` adds `icon` slot, closes [#2130](https://github.com/tusen-ai/naive-ui/issues/2130).\n- `n-date-picker` adds `value-format` prop, closes [#2076](https://github.com/tusen-ai/naive-ui/issues/2076).\n- `n-date-picker` adds `formatted-value` prop.\n- `n-date-picker` adds `default-formatted-value` prop.\n- `n-date-picker` adds `on-update:formatted-value` prop.\n- `n-date-picker`'s `on-update:value` prop will pass formatted value out.\n- `n-image` adds `show-toolbar-tooltip` prop.\n- `n-image` adds more theme variables, closes [#1531](https://github.com/tusen-ai/naive-ui/issues/1531).\n- `n-upload` adds `image-group-props` prop.\n- `n-progress` adds `offset-degree` prop, closes [#2010](https://github.com/tusen-ai/naive-ui/issues/2010).\n- `n-form-item` adds `feedback` slot, closes [#1142](https://github.com/tusen-ai/naive-ui/issues/1142).\n- `n-form-item`'s `require-mark-placement` prop adds `'right-hanging'` option, closes [#2094](https://github.com/tusen-ai/naive-ui/issues/2094).\n- `n-cascader` adds `render-label` prop, closes [#2048](https://github.com/tusen-ai/naive-ui/issues/2048).\n- `n-auto-complete` adds `render-option` prop, closes [#1629](https://github.com/tusen-ai/naive-ui/issues/1629).\n- `n-auto-complete` adds `render-label` prop, closes [#1629](https://github.com/tusen-ai/naive-ui/issues/1629).\n- `n-tree` adds `render-switcher-icon` prop, closes [#1551](https://github.com/tusen-ai/naive-ui/issues/1551).\n- `n-message` exports `MessageType` type.\n- `n-time-picker` adds `value-format` prop.\n- `n-time-picker` adds `formatted-value` prop.\n- `n-time-picker` adds `on-update:formatted-value` prop.\n- `n-time-picker` adds `default-formatted-value` prop.\n- `n-carousel` adds `default-index` prop.\n- `n-carousel` adds `current-index` prop.\n- `n-carousel` adds `show-arrow` prop.\n- `n-carousel` adds `dot-type` prop, closes [#1931](https://github.com/tusen-ai/naive-ui/issues/1931).\n- `n-carousel` adds `dot-placement` prop, closes [#1462](https://github.com/tusen-ai/naive-ui/issues/1462).\n- `n-carousel` adds `slides-per-view` prop.\n- `n-carousel` adds `space-between` prop.\n- `n-carousel` adds `centered-slides` prop.\n- `n-carousel` adds `direction` prop, closes [#1931](https://github.com/tusen-ai/naive-ui/issues/1931).\n- `n-carousel` adds `loop` prop.\n- `n-carousel` adds `effect` prop, closes [#1159](https://github.com/tusen-ai/naive-ui/issues/1159).\n- `n-carousel` adds `transition-props` prop, closes [#1159](https://github.com/tusen-ai/naive-ui/issues/1159).\n- `n-carousel` adds `transition-style` prop, closes [#1159](https://github.com/tusen-ai/naive-ui/issues/1159).\n- `n-carousel` adds `draggable` prop.\n- `n-carousel` adds `touchable` prop.\n- `n-carousel` adds `mousewheel` prop.\n- `n-carousel` adds `keyboard` prop.\n- `n-carousel` adds `show-dots` prop.\n- `n-carousel` adds `on-update:current-index` prop.\n- `n-carousel` adds `arrow` slot.\n- `n-carousel` adds `dots` slot.\n- `n-form-item` adds `for` prop.\n- `n-color-picker` adds `label` slot.\n- `n-color-picker` adds `render-label` prop.\n- `n-form-item` adds `label-props` prop.\n\n## 2.23.2\n\n`2021-12-29`\n\n### Feats\n\n- `` can be used to controll the component style's position.\n- `n-empty` adds `show-icon` prop.\n- `n-modal` adds a11y support, closes [#1877](https://github.com/tusen-ai/naive-ui/issues/1877).\n- Add `n-avatar-group` component.\n- `n-input-number` supports `loading` state.\n- Add `n-countdown` component.\n- Add `n-number-animation` component, closes [#1465](https://github.com/tusen-ai/naive-ui/issues/1465).\n- `n-statistic` adds `tabular-nums` prop.\n- `n-pagination` will give `itemCount` a approximate value derived from `pageSize` and `pageCount` if it's not set, closes [#2044](https://github.com/tusen-ai/naive-ui/issues/2044).\n- `n-cascader` adds `on-update:show` prop, closes [#2049](https://github.com/tusen-ai/naive-ui/issues/2049).\n- `n-scrollbar` uses `n` as CSS vars prefix.\n- `n-popconfirm` uses `n` as CSS vars prefix.\n- `n-gradient-text` uses `n` as CSS vars prefix.\n- `n-form` uses `n` as CSS vars prefix.\n- `n-pagination` uses `n` as CSS vars prefix.\n- `n-loading-bar` uses `n` as CSS vars prefix.\n- `n-empty` uses `n` as CSS vars prefix.\n- `n-list` uses `n` as CSS vars prefix.\n- `n-layout` uses `n` as CSS vars prefix.\n- `n-message` uses `n` as CSS vars prefix.\n- `n-mention` uses `n` as CSS vars prefix.\n- `n-menu` uses `n` as CSS vars prefix.\n- `n-popover` uses `n` as CSS vars prefix.\n- `n-transfer` uses `n` as CSS vars prefix.\n- `n-table` uses `n` as CSS vars prefix.\n- `n-statistic` uses `n` as CSS vars prefix.\n- `n-code` uses `n` as CSS vars prefix.\n- `n-breadcrumb` uses `n` as CSS vars prefix.\n- `n-slider` uses `n` as CSS vars prefix.\n- `n-spin` uses `n` as CSS vars prefix.\n- `n-select` uses `n` as CSS vars prefix.\n- `n-result` uses `n` as CSS vars prefix.\n- `n-calendar` uses `n` as CSS vars prefix.\n- `n-card` uses `n` as CSS vars prefix.\n- `n-cascader` uses `n` as CSS vars prefix.\n- `n-color-picker` uses `n` as CSS vars prefix.\n- `n-checkbox` uses `n` as CSS vars prefix.\n- `n-data-table` uses `n` as CSS vars prefix.\n- `n-date-picker` uses `n` as CSS vars prefix.\n- `n-descriptions` uses `n` as CSS vars prefix.\n- `n-drawer` uses `n` as CSS vars prefix.\n- `n-dropdown` uses `n` as CSS vars prefix.\n- `n-rate` uses `n` as CSS vars prefix.\n- `n-radio` uses `n` as CSS vars prefix.\n- `n-progress` uses `n` as CSS vars prefix.\n- `n-skeleton` uses `n` as CSS vars prefix.\n- `n-collapse` uses `n` as CSS vars prefix.\n- `n-collapse-transition` uses `n` as CSS vars prefix.\n- `n-thing` uses `n` as CSS vars prefix.\n- `n-carousel` uses `n` as CSS vars prefix.\n- `n-page-header` uses `n` as CSS vars prefix.\n- `n-image` uses `n` as CSS vars prefix.\n- `n-input` uses `n` as CSS vars prefix.\n- `n-icon` uses `n` as CSS vars prefix.\n- `n-modal` uses `n` as CSS vars prefix.\n- `n-notification` uses `n` as CSS vars prefix.\n\n### Fixes\n\n- Fix `n-form-item-gi` 's `validate` doesn't work, closes [#1901](https://github.com/tusen-ai/naive-ui/issues/1901).\n- Fix `n-card` action's border-radius style.\n- Fix `n-code`'s content is repeatly appended if language is not set, closes [#2034](https://github.com/tusen-ai/naive-ui/issues/2034).\n- Fix `n-tabs`'s `tabTextColorActiveSegment` and `tabTextColorHoverSegment` theme variables not working, closes [#2038](https://github.com/tusen-ai/naive-ui/issues/2038).\n- Fix `n-image` may keep keyboard handler after mounted.\n- Fix `n-image` can't exit preview after esc is pressed when there's only 1 image, closes [#2042](https://github.com/tusen-ai/naive-ui/issues/2042).\n- Fix `n-drawer-content`'s content doesn't scroll by default, ref [#2003](https://github.com/tusen-ai/naive-ui/issues/2003).\n- Fix `n-popover` log warnings to console when manually set same zindex on multile instances and closes them, closes [#2050](https://github.com/tusen-ai/naive-ui/issues/2050).\n- Fix `n-transfer` has no scrollbar in virtual scroll mode.\n- Fix `n-input-number` cannot input decimals end with 0.\n\n## 2.23.1\n\n`2021-12-20`\n\n### Fixes\n\n- Fix `n-transfer` list doesn't follow container height when style.height is set, closes [#1879](https://github.com/tusen-ai/naive-ui/issues/1879).\n- Fix `n-skeleton` & `n-gradient-text` cause runtime error in some old browsers, closes [#1867](https://github.com/tusen-ai/naive-ui/issues/1867).\n- Fix `n-data-table` `ellipsis` prop in column doesn't support all `n-ellipsis`'s props, closes [#1891](https://github.com/tusen-ai/naive-ui/issues/1891).\n- Fix `n-form`'s `blankHeightXxx` theme var doesn't follow `common.heightXxx`, closes [#1880](https://github.com/tusen-ai/naive-ui/issues/1880).\n- Fix `n-date-picker`'s panel doesn't use `dateFormat` in locale, closes [#1793](https://github.com/tusen-ai/naive-ui/issues/1793).\n- Fix `n-log` text color transition in theme switching.\n\n### Feats\n\n- `n-back-top` uses `n` as CSS vars prefix.\n- `n-steps` uses `n` as CSS vars prefix.\n- `n-switch` uses `n` as CSS vars prefix.\n- `n-auto-complete` uses `n` as CSS vars prefix.\n- `n-log` uses `n` as CSS vars prefix.\n- `n-timeline` uses `n` as CSS vars prefix.\n- `n-time-picker` uses `n` as CSS vars prefix.\n- `n-avatar` uses `n` as CSS vars prefix.\n- `n-dynamic-tags` uses `n` as CSS vars prefix.\n- `n-tag` uses `n` as CSS vars prefix.\n- `n-dialog` uses `n` as CSS vars prefix.\n- `n-upload` uses `n` as CSS vars prefix.\n- `n-tree` uses `n` as CSS vars prefix.\n- `n-tree-select` uses `n` as CSS vars prefix.\n\n## 2.23.0\n\n`2021-12-17`\n\n### Breaking Changes\n\n- `n-switch` can no longer be clicked under `loading` status, closes [#1853](https://github.com/tusen-ai/naive-ui/issues/1853).\n\n### Fixes\n\n- Fix `n-data-table` 's horizontal scrollbar disappears when max-height is not set, closes [#1857](https://github.com/tusen-ai/naive-ui/issues/1857).\n- Fix `n-input-number` cannot input negative decimals value, closes [#1858](https://github.com/tusen-ai/naive-ui/issues/1858).\n- Fix `n-dialog` open new dialog again when pressing `enter` key, closes [#1559](https://github.com/tusen-ai/naive-ui/issues/1559).\n\n### Feats\n\n- `n-divider` uses `n` as CSS vars prefix.\n- `n-typography` uses `n` as CSS vars prefix.\n- `n-badge` uses `n` as CSS vars prefix.\n\n## 2.22.0\n\n`2021-12-15`\n\n### Breaking Changes\n\n- `n-button` can no longer be clicked under `loading` status, closes [#1628](https://github.com/tusen-ai/naive-ui/issues/1628).\n\n### Fixes\n\n- Fix `n-alert`'s `header` slot unable to display normally.\n- Fix `n-data-table`'s pagination `onUpdatePageSize` prop does't trigger, closes [#1774](https://github.com/tusen-ai/naive-ui/issues/1774).\n- Fix `n-data-table` can select rows when table is loading, closes [#1812](https://github.com/tusen-ai/naive-ui/issues/1812).\n- Fix `n-tag` line-height is too low that clamps the content.\n- Fix `n-select` displays with mistake in input if `filterable` is `true`, closes [#1823](https://github.com/tusen-ai/naive-ui/issues/1823).\n- Fix `n-page-header`'s content has margin-top when header is not displayed, closes [#1795](https://github.com/tusen-ai/naive-ui/issues/1795).\n- Fix `n-avatar` `color` prop not working.\n- Fix `n-avatar`'s inner icon has wrong size.\n- Fix `n-image` lacks scoped style's scope-id, closes [#1788](https://github.com/tusen-ai/naive-ui/issues/1788).\n- Fix `n-radio` click event will be triggered twice, closes [#1680](https://github.com/tusen-ai/naive-ui/issues/1680).\n- Fix `n-data-table` layout display incorrect when the table is empty and min-height set, closes [#1809](https://github.com/tusen-ai/naive-ui/issues/1809).\n- Fix `n-data-table`'s summary has hover style.\n- Fix `n-data-table` fixed group column box-shadow error and right fixed column order error, closes [#1832](https://github.com/tusen-ai/naive-ui/issues/1832).\n- Fix `n-anchor`'s hover & active style.\n- Fix `n-data-table`'s header fixed column style on data is empty.\n\n### Feats\n\n- `n-tree-select` adds `menu-props` prop.\n- `n-tree-select` adds `action` slot, closes [#1765](https://github.com/tusen-ai/naive-ui/issues/1765).\n- `n-tree-select` adds `empty` slot.\n- `n-cascader` adds `empty` slot.\n- `n-popselect` adds `action` slot.\n- `n-popselect` adds `empty` slot.\n- `n-data-table` will check all if indeterminate header checkbox is clicked, closes [#1827](https://github.com/tusen-ai/naive-ui/issues/1827).\n- `n-button` uses `n` as CSS vars prefix, closes [#1808](https://github.com/tusen-ai/naive-ui/issues/1808).\n- `n-date-picker` adds `default-time` prop.\n- `n-alert` uses `n` as CSS vars prefix.\n- `n-date-picker`'s `type` prop support `quarter` option.\n- `n-anchor` uses `n` as CSS vars prefix.\n\n### i18n\n\n- Add zhTW locale.\n\n## 2.21.5\n\n`2021-12-07`\n\n### Fixes\n\n- Fix `n-input` click clear icon does't trigger `change` event, closes [#1754](https://github.com/tusen-ai/naive-ui/issues/1754).\n- Fix `n-input-number` the cursor moves when press arrow keys to change value, closes [#1759](https://github.com/tusen-ai/naive-ui/issues/1759).\n\n### Feats\n\n- `n-date-picker`'s default format follows i18n.\n\n### i18n\n\n- Add frFR locale.\n\n## 2.21.4\n\n`2021-12-06`\n\n### Fixes\n\n- Fix `n-date-picker` has no placeholder when `type` is `year`.\n- Fix `n-element` doesn't export `NEl` alias name.\n- Fix `n-upload` still shows upload trigger when max limit is reached in `image-card` mode, closes [#1744](https://github.com/tusen-ai/naive-ui/issues/1744).\n- Fix `n-form`'s `FormValidate` type lacks `shouldRuleBeApplied` parameter, closes [#1747](https://github.com/tusen-ai/naive-ui/issues/1747).\n- Fix `n-upload` is displayed vertically in `n-form` in `image-card` mode, closes [#1746](https://github.com/tusen-ai/naive-ui/issues/1746).\n- Fix `n-upload`'s file list's top margin if trigger is hidden.\n- Fix `n-upload` shows normal file status when response has 4xx status, closes [#1741](https://github.com/tusen-ai/naive-ui/issues/1741).\n\n### Feats\n\n- `n-upload` adds `show-trigger` prop.\n- `n-data-table` will ignore `children` with length 0 in tree data mode, closes [#1703](https://github.com/tusen-ai/naive-ui/issues/1703).\n\n## 2.21.3\n\n`2021-12-03`\n\n### Fixes\n\n- Fix `n-theme-editor` throw error when click button component, closes [#1708](https://github.com/tusen-ai/naive-ui/issues/1708).\n- Fix `n-input`'s color is abnormal in Android WeChat, closes [#1705](https://github.com/tusen-ai/naive-ui/issues/1705).\n- Fix `n-input` 's `borderHover` theme variable doesn't work, closes [#1704](https://github.com/tusen-ai/naive-ui/issues/1704).\n- Fix `n-dialog`'s `content` word-break.\n- Fix `n-input-number` cannot input decimals value.\n- Fix `n-data-table`'s header & body may have wrong border radius, closes [#1712](https://github.com/tusen-ai/naive-ui/issues/1712).\n- Fix `n-button`'s `colorOpacityXxx` theme vars are not string typed.\n\n### Feats\n\n- `n-switch` adds `rail-style` prop, closes [#1718](https://github.com/tusen-ai/naive-ui/issues/1718).\n- `n-image` adds `preview-disabled` props, closes [#1647](https://github.com/tusen-ai/naive-ui/issues/1647).\n- `n-image` adds `on-load` & `on-error` prop.\n- `n-image` adds `fallback-src` prop.\n- `n-data-table` adds `on-update:expanded-row-keys` prop.\n- `n-tree` adds `watch-props` prop.\n\n## 2.21.2\n\n`2021-11-29`\n\n### Fixes\n\n- Fix `n-slider` disabled tooltip at the wrong time.\n- Fix `n-slider` incorrect fill color style, closes [#1670](https://github.com/tusen-ai/naive-ui/issues/1670).\n- Fix `n-data-table`'s pagination `onUpdatePage` prop trigger twice, closes [#1666](https://github.com/tusen-ai/naive-ui/issues/1666).\n- Fix `n-log`'s `trim` prop not being independent when used.\n- Fix `n-slider` processing of step value precision.\n- Fix `n-date-picker` throw error when `time-picker` input is empty, closes [#1678](https://github.com/tusen-ai/naive-ui/issues/1678).\n- Fix `n-popover` not working when `trigger` is `focus`.\n- Fix `n-scrollbar`'s scrollbar will vanish if clicked.\n- Fix `n-popover` has an invalid line in style.\n- Fix `n-popover` `flip=false` doesn't work.\n- Fix `n-input-number` can't accept indeterminate input value when `max` or `min` is set, closes [#1664](https://github.com/tusen-ai/naive-ui/issues/1664).\n- Fix `n-input-number`'s input value is not changed to a valid value if it's input exceeds min or max multiple times.\n\n### Feats\n\n- `n-input-number` adds `keyboard` prop.\n- Add `tableColorStriped` theme variable, closes [#1686](https://github.com/tusen-ai/naive-ui/issues/1686).\n- `n-notification-provider` adds `max` & `placement` prop.\n- `n-notification` adds `destroyAll` method, closes [#333](https://github.com/tusen-ai/naive-ui/issues/333).\n- `n-layout-sider` adds `on-after-enter` and `on-after-leave` props, closes [#1241](https://github.com/tusen-ai/naive-ui/issues/1241).\n- `n-upload` adds `custom-request` prop, closes [#1389](https://github.com/tusen-ai/naive-ui/issues/1389).\n- `n-data-table` adds `expanded-row-keys` prop.\n- `n-popover` provides better auto position adjustment, closes [#1520](https://github.com/tusen-ai/naive-ui/issues/1520), [#1643](https://github.com/tusen-ai/naive-ui/issues/1643).\n- `n-input-number` adds `update-value-on-input` prop, closes [#1662](https://github.com/tusen-ai/naive-ui/issues/1662).\n- `n-auto-complete` adds `prefix` & `suffix` slot.\n\n## 2.21.1\n\n`2021-11-23`\n\n### Fixes\n\n- Fix `n-image` drag the picture to move the position incorrectly when the zoom is large.\n- Fix `n-data-table` style glitches after some rows are expanded.\n- Fix `n-data-table` doesn't expand tree data correctly, closes [#1644](https://github.com/tusen-ai/naive-ui/issues/1644).\n\n## 2.21.0\n\n`2021-11-21`\n\n### Breaking Changes\n\n- `NButton.fontWeightText` & `NButton.fontWeightGhost` theme vars are removed. If you want to change font weight, you can use `strong` prop of `n-button` instead.\n\n### Feats\n\n- `n-tag` adds `avatar` slot.\n- `n-data-table` adds `striped` prop, closes [#1552](https://github.com/tusen-ai/naive-ui/issues/1552).\n- `n-table` adds `striped` prop, closes [#1552](https://github.com/tusen-ai/naive-ui/issues/1552).\n- `n-slider` adds `vertical` prop, closes [#1468](https://github.com/tusen-ai/naive-ui/issues/1468).\n- `n-slider` adds `reverse` prop.\n- `n-slider`'s `step` prop support `mark` option.\n- Bypass Vitejs bug on string extrapolation, ref [#636](https://github.com/tusen-ai/naive-ui/issues/636).\n- `n-button` adds `strong` prop.\n- `n-button` adds `secondary` prop.\n- `n-button` adds `tertiary` prop.\n- `n-button` adds `quaternary` prop.\n- `n-auto-complete` adds `input-props` prop, closes [#1610](https://github.com/tusen-ai/naive-ui/issues/1610).\n- `n-avatar` adds `fallback-src` prop, closes [#702](https://github.com/tusen-ai/naive-ui/issues/702).\n- `n-avatar` adds `on-error` prop.\n- `n-input` adds `select` methods, closes [#1328](https://github.com/tusen-ai/naive-ui/issues/1328).\n- Add `n-tab` component, closes [#1630](https://github.com/tusen-ai/naive-ui/issues/1630).\n- `n-switch` adds `round` prop, closes [#1469](https://github.com/tusen-ai/naive-ui/issues/1469).\n- `n-step` adds `title` slot.\n- `n-menu` support `divider` type option.\n\n### Fixes\n\n- Fix the default value of the `suffix` internal component's `loading` property.\n- Fix `n-space` is shown when it has no children, closes [#1605](https://github.com/tusen-ai/naive-ui/issues/1605).\n- Fix `n-radio` has no `onUpdateChecked` prop.\n- Fix `n-dropdown` animation flicker problem, closes [#1600](https://github.com/tusen-ai/naive-ui/issues/1600).\n- Fix `n-data-table`’s `clearSorter` method isn't exported properly.\n- Fix `n-global-style` throws error in SSR.\n- Fix `n-button` will trigger click event twice if pressed, closes [#1626](https://github.com/tusen-ai/naive-ui/issues/1626).\n\n## 2.20.3\n\n`2021-11-15`\n\n### Fixes\n\n- Fix `n-grid` suffix NGridItem does not set right span when collapsed, closes [#1530](https://github.com/tusen-ai/naive-ui/issues/1530).\n- Fix `n-button` to shrink abnormally in certain scenarios when using the `circle` prop, closes [#1557](https://github.com/tusen-ai/naive-ui/issues/1557).\n- Fix `input-props` does affect `type` prop, closes [#1553](https://github.com/tusen-ai/naive-ui/issues/1553).\n\n### Feats\n\n- `n-menu` adds a color distinction between selected and unselected arrow, closes [#1535](https://github.com/tusen-ai/naive-ui/issues/1535).\n- `n-menu` adds `watch-props` prop, closes [#1536](https://github.com/tusen-ai/naive-ui/issues/1536).\n- `n-date-picker`'s `type` prop support `year` option.\n\n### i18n\n\n- Add `createLocale` to make locale customizable, closes [#1525](https://github.com/tusen-ai/naive-ui/issues/1525).\n\n## 2.20.2\n\n`2021-11-05`\n\n### Feats\n\n- `n-modal` adds `transform-origin` prop, closes [#1498](https://github.com/tusen-ai/naive-ui/issues/1498).\n- `n-tabs` adds `pane-class` prop, closes [#1500](https://github.com/tusen-ai/naive-ui/issues/1500).\n\n### Fixes\n\n- Fix `n-alert` `contentTextColor` and `titleTextColor` type theme variable not working, closes [#1495](https://github.com/tusen-ai/naive-ui/issues/1495).\n- Fix `n-time-picker` not trigger blur event when the panel is closed by ok button, closes [#1499](https://github.com/tusen-ai/naive-ui/issues/1499).\n- Fix `n-upload` `UploadFileInfo`'s `thumbnailUrl` field not working, closes [#1495](https://github.com/tusen-ai/naive-ui/issues/1245).\n- Fix `n-button` `keyboard` prop does not work, closes [#1508](https://github.com/tusen-ai/naive-ui/issues/1508).\n- Fix `n-upload` instance misses `openOpenFileDialog` method.\n\n### i18n\n\n- Add deDE locale.\n- Add nbNO locale.\n\n## 2.20.1\n\n`2021-11-01`\n\n### Fixes\n\n- Fix `n-tabs` switch tab does not work when adding a new tab, closes [#1417](https://github.com/tusen-ai/naive-ui/issues/1417).\n- Fix `n-tree`'s `filter` prop does not work when assigned `children-field` , closes [#1477](https://github.com/tusen-ai/naive-ui/issues/1477).\n- Fix `n-cascader` can't remove options when using customized fields in multiple mode.\n- Fix `n-select`'s option created by `on-create` doesn't show correct label in trigger, closes [#1482](https://github.com/tusen-ai/naive-ui/issues/1482).\n- Fix `n-select` menu height shifts on close in `filterable` mode.\n\n### Feats\n\n- `n-select` adds `menu-props` prop, closes [#1475](https://github.com/tusen-ai/naive-ui/issues/1475).\n- `n-image`'s `toolbar` adds close icon, closes [#1412](https://github.com/tusen-ai/naive-ui/issues/1412).\n- `n-tree`'s `on-load` prop is triggered when the `expanded-keys` prop changes in `remote` mode, closes [#1339](https://github.com/tusen-ai/naive-ui/issues/1339).\n\n## 2.20.0\n\n`2021-10-28`\n\n### Breaking Changes\n\n- `n-collapsed-transition`'s `collapsed` prop is deprecated, please use `show` instead, closes [#1407](https://github.com/tusen-ai/naive-ui/issues/1407).\n\n### Fixes\n\n- Fix `n-log` `font-size` prop not working, closes [#1416](https://github.com/tusen-ai/naive-ui/issues/1416).\n- Fix `n-loading-bar` will show once even if `start` is not called when `loading-bar-style` is set.\n- Fix `n-date-picker` `separator` prop not working, closes [#1456](https://github.com/tusen-ai/naive-ui/issues/1456).\n\n### Feats\n\n- `n-data-table` optimize the logic of underlying rendering and improve component performance.\n- `n-date-picker`'s `shortcuts` prop supports functional value.\n- `n-tab-pane`'s `display-directive` props supports the `show:lazy` option, closes [#1374](https://github.com/tusen-ai/naive-ui/issues/1374).\n- `n-input` of text type supports `count` slots, closes [#1440](https://github.com/tusen-ai/naive-ui/issues/1440).\n\n### i18n\n\n- Add idID locale.\n\n## 2.19.11\n\n`2021-10-21`\n\n### Fixes\n\n- Fix `n-upload`'s file can't be removed when file count limit is reached, closes [#1401](https://github.com/tusen-ai/naive-ui/issues/1401).\n\n### Feats\n\n- `n-tabs` adds `on-before-leave` prop, closes [#1337](https://github.com/tusen-ai/naive-ui/issues/1337).\n- `n-color-picker` adds `show-preview` prop, closes [#1281](https://github.com/tusen-ai/naive-ui/issues/1281).\n- `n-tab-pane`'s `display-directive` prop support `show:lazy` option, closes [#1374](https://github.com/tusen-ai/naive-ui/issues/1374).\n\n## 2.19.9\n\n`2021-10-18`\n\n### Fixes\n\n- Fix `n-collapse`'s expanded status is lost when using `v-if` with `n-collapse-item`, closes [#1387](https://github.com/tusen-ai/naive-ui/issues/1387).\n- Fix `n-dialog`'s close button will be overlayed with content, closes [#1381](https://github.com/tusen-ai/naive-ui/issues/1381).\n- Fix `n-upload` file is set to `null` after upload failure, closes [#1316](https://github.com/tusen-ai/naive-ui/issues/1316).\n- Fix `n-cascader`'s `filter` prop not working.\n- Fix `n-cascader`'s `label-field` prop breaks filter.\n- Fix `n-cascader`'s `separator` prop isn't appiled to filter select menu.\n\n### Feats\n\n- `n-menu` adds `dropdown-props` prop, closes [#1345](https://github.com/tusen-ai/naive-ui/issues/1345).\n- `n-input` adds `count` slot, closes [#1314](https://github.com/tusen-ai/naive-ui/issues/1314).\n- `n-time-picker` adds `use-12-hours` prop, closes [#547](https://github.com/tusen-ai/naive-ui/issues/547).\n- `n-input-number` adds `focus` & `blur` methods.\n\n## 2.19.8\n\n`2021-10-14`\n\n### Fixes\n\n- Fix `n-data-table` fixed style does not work in group header table, closes [#1341](https://github.com/tusen-ai/naive-ui/issues/1341).\n- Fix `n-data-table` has duplicate right border when it has multiple level headers.\n- Fix `n-scrollbar` doesn't support `scrollTo`, closes [#1346](https://github.com/tusen-ai/naive-ui/issues/1346).\n- Fix `n-ellipsis`'s `expand-trigger` prop not show `pointer` cursor when content is short when `tooltip = false`, closes [#1299](https://github.com/tusen-ai/naive-ui/issues/1299).\n- Fix `n-upload`'s `disabled` prop's style not working, closes [#1237](https://github.com/tusen-ai/naive-ui/issues/1237).\n- `n-config-provider` adds `breakpoints` prop, closes [#1379](https://github.com/tusen-ai/naive-ui/issues/1379).\n\n### Feats\n\n- `n-auto-complete` adds `get-show` prop, closes [#1292](https://github.com/tusen-ai/naive-ui/issues/1292).\n- `n-select` adds `input-props` prop, closes [#1351](https://github.com/tusen-ai/naive-ui/issues/1351).\n- `n-color-picker` adds `swatches` prop, ref [#1281](https://github.com/tusen-ai/naive-ui/issues/1281).\n- `n-upload` adds `max` prop.\n\n### i18n\n\n- Add jaJP locale.\n\n## 2.19.7\n\n`2021-10-12`\n\n### Fixes\n\n- Fix `n-ellipsis`'s `expand-trigger` prop not show `pointer` cursor when content is short, closes [#1299](https://github.com/tusen-ai/naive-ui/issues/1299).\n- Fix `n-select`'s `fallback-option` prop's type, closes [#1327](https://github.com/tusen-ai/naive-ui/issues/1327).\n- Fix `n-modal`'s `on-after-enter` prop not working.\n\n## 2.19.6\n\n`2021-10-10`\n\n### Fixes\n\n- Fix `n-menu`'s incorrect warning on `default-expanded-keys`.\n- Fix `useThemeVars` is sometimes unusable, closes [#1309](https://github.com/tusen-ai/naive-ui/issues/1309).\n- Fix the `list-style` style of the `
\n\n## Documentation\n\n[www.naiveui.com](http://www.naiveui.com)\n\n## Community\n\n- [Discord](https://discord.gg/Pqv7Mev5Dd)\n- DingTalk Group 1 (Member limit reached) 33482509\n- DingTalk Group 2 (Member limit reached) 35886835\n- DingTalk Group 3 (Member limit reached) 32377370\n- DingTalk Group 4 (Member limit reached) 8165002788\n- DingTalk Group 5 (Member limit reached) 31205022250\n- DingTalk Group 6 (Member limit reached) 62720001971\n- DingTalk Group 7 172000005810\n\n- [Awesome Naive UI](https://github.com/naive-ui/awesome-naive)\n\n## Features\n\n### Fairly Complete\n\nThere are more than 90 components. Hope they can help you write less code.\n\nWhat's more, they are all treeshakable.\n\n### Theme Customizable\n\nWe provide an advanced type safe theme system built using TypeScript. All you need is to provide a theme overrides object in JS. Then all the stuff will be done by us.\n\nWhat's more, no less/sass/css variables, no webpack loaders are required.\n\n### Uses TypeScript\n\nAll the stuff in Naive UI is written in TypeScript. It can work with your typescript project seamlessly.\n\nWhat's more, you don't need to import any CSS to use the components.\n\n### Fast\n\nI try to make it not rather slow. All data components works with virtual list by default.\n\nWhat's more, ..., no more. Just enjoy it.\n\n## Installation\n\n### npm\n\nUse npm to install.\n\n```bash\nnpm i -D naive-ui\n```\n\n### Fonts\n\n```bash\nnpm i -D vfonts\n```\n\n### Icons\n\nNaive UI recommends using [xicons](https://www.xicons.org) as icon library.\n\n### Design Resources\n\n[Naive UI (Sketch)](https://naive-ui.oss-accelerate.aliyuncs.com/NaiveUI-Design-Library-en-US.sketch).\n\n## Contributing\n\nPlease see [CONTRIBUTING.md](https://github.com/tusen-ai/naive-ui/blob/main/CONTRIBUTING.md).\n\n## License\n\nNaive UI is licensed under the [MIT license](https://opensource.org/licenses/MIT).\n\nGraphics resources of `result` component is licensed under the [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/). The graphics resources come from [Twemoji](https://github.com/twitter/twemoji).\n"
},
{
"path": "README.zh-CN.md",
"content": "
\n \n\n\n\n\n\n"
},
{
"path": "demo/SiteRoot.vue",
"content": "\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n"
},
{
"path": "demo/index.dev.js",
"content": "import { createApp } from 'vue'\nimport naive, { NThemeEditor } from '../src/index'\nimport createDemoRouter from './routes/router'\nimport { routes } from './routes/routes'\nimport { installDemoComponents } from './setup'\nimport SiteRoot from './SiteRoot.vue'\n\nconst app = createApp(SiteRoot)\n\nconst router = createDemoRouter(app, routes)\n\napp.use(router)\napp.use(naive)\napp.component('NThemeEditor', NThemeEditor)\ninstallDemoComponents(app)\n\nrouter.isReady().then(() => {\n app.mount('#app')\n})\n"
},
{
"path": "demo/index.prod.js",
"content": "import naive, { NThemeEditor } from 'naive-ui'\nimport { createApp } from 'vue'\nimport createDemoRouter from './routes/router'\nimport { routes } from './routes/routes'\nimport { installDemoComponents } from './setup'\nimport SiteRoot from './SiteRoot.vue'\n\nconst app = createApp(SiteRoot)\n\nconst router = createDemoRouter(app, routes)\n\napp.use(router)\napp.use(naive)\napp.component('NThemeEditor', NThemeEditor)\ninstallDemoComponents(app)\n\nrouter.isReady().then(() => {\n app.mount('#app')\n})\n"
},
{
"path": "demo/pages/Layout.vue",
"content": "\n\n\n \n \n \n \n \n \n \n \n \n\n"
},
{
"path": "demo/pages/docs/changelog/enUS/index.vue",
"content": "\n\n\n \n\n"
},
{
"path": "demo/pages/docs/changelog/zhCN/index.vue",
"content": "\n\n\n \n\n"
},
{
"path": "demo/pages/docs/common-issues/enUS/index.md",
"content": "# Common Issues\n\n## 1. The difference between @update:xxx and on-update:xxx\n\n### Case 1\n\nIf you are not using `v-model:xxx` with `on-update:xxx` on the same component, there is no difference between `@update:xxx` and `on-update:xxx` when used in templates.\n\nIn Naive UI, all API documents use the `on-update:xxx` format, because `@` is just a shorthand provided by Vue.\n\nIf you prefer camelCase, you can use `onUpdate:xxx`.\n\nIf you are using JSX, you can use `onUpdateXxx` (all `onUpdate:xxx` have an equivalent implementation of `onUpdateXxx`).\n\n### Case 2\n\nIf you are using `v-model:xxx`, you should use `@update:xxx` on the same component.\n\n✅ example ``.\n\n❌ example ``.\n\nThat is because `v-model:value=\"xxx\"` will be transformed to `:onUpdate:value=\"xxx\"`. If you are using `@update:value=\"yyy\"` together, it will be `:onUpdate:value=\"[xxx, yyy]\"`, and then Naive UI would take care of if.\n\nHowever if you are using `on-update:value=\"yyy\"`, Vue would generate code like `:onUpdate:value=\"xxx\" :on-update-value=\"yyy\"` and the second one would override the first one in Vue runtime. The `v-model:value` would be broken.\n\nIf you have any problems, feel free to create a PR or issue on GitHub.\n\n## 2. How to use in Single File Component(SFC)?\n\nplease see [Usage in SFC](usage-sfc)\n"
},
{
"path": "demo/pages/docs/common-issues/zhCN/index.md",
"content": "# 常见问题\n\n## 1. @update:xxx 和 on-update:xxx 的区别\n\n### 情况 1\n\n如果你没有在同一个组件上同时使用 `v-model:xxx` 和 `on-update:xxx`，`@update:xxx` 和 `on-update:xxx` 在模版中使用时没有任何区别。\n\n在 Naive UI 中，全部的 API 文档使用 `on-update:xxx` 格式，因为 `@` 只是 Vue 提供的一种简写。\n\n如果你偏爱 camelCase，可以使用 `onUpdate:xxx`。\n\n如果你在使用 JSX，可以使用 `onUpdateXxx`（所有的 `onUpdate:xxx` 都有一个 `onUpdateXxx` 的对等实现）。\n\n### 情况 2\n\n如果你在一个组件上使用了 `v-model:xxx`，你应该使用 `@update:xxx`。\n\n✅ 例子 ``。\n\n❌ 例子 ``。\n\n这是因为 `v-model:value=\"xxx\"` 会被转化为 `:onUpdate:value=\"xxx\"`。如果你同时使用了 `@update:value=\"yyy\"`，他们会被转化为 `:onUpdate:value=\"[xxx, yyy]\"`，然后 Naive UI 会来处理这种情况。\n\n然而如果你使用了 `on-update:value=\"yyy\"`，Vue 会生成类似于 `:onUpdate:value=\"xxx\" :on-update:value=\"yyy\"` 的代码，然后第二个属性会在运行时覆盖掉第一个，`v-model:value` 会崩掉。\n\n如果你发现任何问题，欢迎在 GitHub 上提交 issue 和 PR。\n\n## 2. 如何在单文件组件（SFC - Single File Component）中使用？\n\n详见 [在 SFC 中使用](usage-sfc)\n"
},
{
"path": "demo/pages/docs/community/enUS/index.md",
"content": "\n\n# Third-Party Libraries\n\nNaive UI is a high-quality Vue component library of unified design specifications. We prefer to provide only UI components with a unified specification and visual presentation. So we recommend the following great resources from the community that complement Naive UI.\n\nIf you want to contribute excellent resources, you can create a pull request of this page in naive-ui's github repo.\n\n| Resources | Descriptions |\n| --- | --- |\n| [Naive UI Admin](https://github.com/jekip/naive-ui-admin) | A free open source out-of-box UI solution for enterprise applications. |\n| [Admin Work](https://github.com/qingqingxuan/admin-work) | A free open source, powerful, easy to use, beautiful back-office management system solution. |\n| [Soybean Admin](https://github.com/honghuangdc/soybean-admin) | A beautiful vue admin template, based on Vue3 + Vite + Naive UI + TypeScript. |\n| [Rengar Admin](https://github.com/RengarJS/rengar-admin) | A mid-backend management system template based on Vue 3.5 + Vite 7 + TypeScript + Naive UI + Pinia + UnoCSS, which is concise without excessive encapsulation and has simple and easy-to-understand code. |\n| [GoView](https://github.com/dromara/go-view) | A free open source and powerful yet accessible data visualization tool. |\n| [Vue Naive Admin](https://github.com/zclzone/vue-naive-admin) | A lightweight backend management template base on Vue3 + Vite4 + Pinia + Unocss + Naive UI. |\n| [Vue Bag Admin](https://vite.itnavs.com/admin/) | 🎉vue-bag-admin，Using Vite4, Vue3, TypeScript, JavaScript construction, support a variety of writing and call, a complete framework system, responsive background management system |\n| [Celeris Web](https://github.com/kirklin/celeris-web) | Celeris Web, based on Vue 3 and Vite, is a free and open-source front-end framework with Naive UI components and TypeScript support, featuring a Monorepo structure. It also integrates with OpenAI, providing natural language processing capabilities for modern web development. |\n| [Nova admin](https://github.com/chansee97/nova-admin) | a clean and concise back-end management template based on Vue3, Vite5, Typescript, and Naive UI. It implements complete functionality in a simple way, while also considering code standards, readability, and avoiding excessive encapsulation to facilitate secondary development. |\n| [chatgpt-web](https://github.com/Chanzhaoyu/chatgpt-web) | ChatGPT demo web page built with Express and Vue3 |\n| [pro-naive-ui](https://github.com/Zheng-Changfu/pro-naive-ui) | Based on Naive UI secondary encapsulation, more functions are extended on the original components |\n| [vue3-dynamic-form](https://github.com/yayaluoya/vue3-dynamic-form) | A dynamic form designer based on Vue3, Naive UI, to implement a lot of basic controls, can be very convenient to customize the control. |\n| [astral-3d-editor](https://github.com/mlt131220/Astral3DEditor) | 3D scene building tool based on Vue3 + Naive UI + ThreeJS + Vite5 + Typescript, supporting CAD & BIM analysis, including weather system, particle system, plug-in center... |\n| [it-tools](https://github.com/CorentinTh/it-tools) | Developed based on Vue3 and the Naive UI component library, it brings together a variety of practical online tools |\n| [Lithe Admin](https://github.com/tenianon/lithe-admin) | A lightweight and elegant backend management template, built using Vue3 + Naive UI + Vite + TypeScript + Pinia, featuring a Tailwind CSS Color color scheme and a frosted texture design. |\n"
},
{
"path": "demo/pages/docs/community/zhCN/index.md",
"content": "\n\n# 社区精选资源\n\nNaive UI 是统一设计规范的高质量 Vue 组件库，我们倾向于只提供符合统一规范且带有视觉展现的 UI 组件。所以我们推荐以下社区已有的优秀资源，与 Naive UI 形成互补。\n\n想贡献优秀资源，可直接在项目中 PR 此页面。\n\n| 资源 | 描述 |\n| --- | --- |\n| [Naive UI Admin](https://github.com/jekip/naive-ui-admin) | 免费开源的中后台模板 |\n| [Admin Work](https://github.com/qingqingxuan/admin-work) | 一款免费开源、功能强大、方便易用、漂亮的中后台管理系统模板 |\n| [Soybean Admin](https://github.com/honghuangdc/soybean-admin) | 一个基于 Vue3 + Vite + Naive UI + TypeScript 的漂亮清爽的中后台模版 |\n| [Rengar Admin](https://github.com/RengarJS/rengar-admin) | 基于 Vue 3.5 + Vite 7 + TypeScript + Naive UI + Pinia + UnoCSS 的中后台管理系统模板，简洁不过度封装，代码简单易懂 |\n| [GoView](https://gitee.com/dromara/go-view) | 开源、精美、便捷的「数据可视化」低代码开发平台 |\n| [Vue Naive Admin](https://github.com/zclzone/vue-naive-admin) | 基于 Vue3 + Vite4 + Pinia + Unocss + Naive UI 的轻量级后台管理模板 |\n| [Vue Bag Admin](https://vite.itnavs.com/admin/) | 🎉vue-bag-admin，采用Vite4、Vue3、TypeScript、JavaScript构建，支持多种写法和调用，完整的框架体系，响应式中后台管理系统 |\n| [Celeris Web](https://github.com/kirklin/celeris-web) | 一个基于 Vue 3 和 Vite 的免费开源前端框架，具有 Naive UI 组件和 TypeScript 支持，采用 Monorepo 结构。它还集成了 OpenAI，为现代 Web 开发提供自然语言处理能力。 |\n| [Nova admin](https://github.com/chansee97/nova-admin) | 一个基于Vue3、Vite5、Typescript、Naive UI, 简洁干净后台管理模板，用简单的方式实现完整功能，并尽可能的考虑代码规范，易读易理解无过度封装，方便二次开发。 |\n| [chatgpt-web](https://github.com/Chanzhaoyu/chatgpt-web) | 使用 Express 和 Vue3 搭建的 ChatGPT 演示网页 |\n| [pro-naive-ui](https://github.com/Zheng-Changfu/pro-naive-ui) | 基于 Naive UI 二次封装, 基于原有组件扩展了更多功能 |\n| [vue3-dynamic-form](https://github.com/yayaluoya/vue3-dynamic-form) | 一个基于 Vue3、Naive UI 的动态表单设计器，实现了很多基础控件，能非常方便的自定义控件。 |\n| [astral-3d-editor](https://github.com/mlt131220/Astral3DEditor) | 基于 Vue3 + Naive UI + ThreeJS + Vite5 + Typescript 的三维场景构建工具，支持 CAD & BIM 解析，内含天气系统、粒子系统、插件中心... |\n| [it-tools](https://github.com/CorentinTh/it-tools) | 基于 Vue3 和 Naive UI 组件库开发，汇集了多种实用的在线工具 |\n| [Lithe Admin](https://github.com/tenianon/lithe-admin) | 一个轻盈而优雅的后台管理模板，基于 Vue3 + Naive UI + Vite + TypeScript + Pinia 构建，采用 Tailwind CSS Color 配色方案和磨砂纹理质感的设计 |\n| [DVHA Pro](https://github.com/duxweb/dvha) | 一款基于 Vue 3 的无头（Headless）中后台前端开发框架，搭配了 Naive UI 封装了开箱即用的异步能力，同时增加了异步渲染基座模式，无需编译即可集成到任何后端使用。 |\n"
},
{
"path": "demo/pages/docs/controlled-uncontrolled/enUS/index.md",
"content": "\n\n# Controlled manner & uncontrolled manner\n\nA component's manner can be controlled or uncontrolled. Uncontrolled manner means you only listen to its change but not control its value. Controlled manner means you control the component's value.\n\n## Uncontrolled manner\n\nIn this situation, you don't set ``'s `value` but only listen to its change. Component's value will be controlled by itself.\n\n```html\n\n```\n\n## Controlled manner\n\nIn the situation, you listen to component's value & change at the same time. If you don't update `value`, component's value won't be changed. Its value is controlled by you.\n\n```html\n\n```\n\n### `v-model`\n\nA component with `v-model` works in controlled manner, since `v-model` is the same as `:model-value` and `@update:model-value`.\n\n## Uncontrolled manner in naive-ui\n\nDifferent library has different behavior on how to distinguish controlled or uncontrolled manner. In naive-ui, if `value` is `undefined` or not passed, it will be uncontrolled. That is to say, if you set a component's value to `undefined` won't clear it but transform it from controlled manner to uncontrolled manner. If you need to clear it, at most time you can use `null`.\n\n### Not only `value`\n\nAny props pair like `xxx` & `@update:xxx` can work both in controlled manner or uncontrolled manner.\n"
},
{
"path": "demo/pages/docs/controlled-uncontrolled/zhCN/index.md",
"content": "\n\n# 受控模式与非受控模式\n\n一个组件的行为可以分为受控模式和非受控模式两种。非受控模式指的是只监听组件的变化，而不去控制组件的 value，受控模式指的是控制组件的值。\n\n## 非受控模式\n\n在这种情况下，你不能控制 `` 的 `value`，而只能监听它的变化，组件值的变化由组件自身控制。\n\n```html\n\n```\n\n## 受控模式\n\n在这种情况下，你既监听了组件的变化，然后也控制了组件的值。如果你不更新 `value`，那么组件的值不会改变，组件值的变化由你控制。\n\n```html\n\n```\n\n### `v-model`\n\n`v-model` 控制的组件在受控模式下，因为 `v-model` 等同于 `:model-value` 和 `@update:model-value` 的组合。\n\n## naive-ui 中的受控模式\n\n不同的组件库区分受控与非受控模式的区别是不同的。在 naive-ui 中，只要 `value` 是 `undefined` 或者根本没有传，那么组件的值会是非受控的。也就是说你将一个组件的值设为 `undefined` 并不能清空它，只会改变它的控制模式。一般情况下清空可以使用 `null`。\n\n### 不止 `value`\n\n任何 `xxx` 与 `@update:xxx` 的属性对都可以有受控和非受控模式。\n"
},
{
"path": "demo/pages/docs/customize-theme/enUS/index.md",
"content": "\n\n# Customizing theme\n\nNaive-ui provides `n-config-provider` to customize the theme.\n\nBy default all of the components are light themed, without any configuration.\n\nTo learn more about `n-config-provider`, see [Config Provider](../components/config-provider).\n\n## Use dark theme\n\nSet `n-config-provider`'s `theme` prop to `darkTheme` imported from naive-ui to set dark theme inside `n-config-provider`.\n\nIf `theme` is `undefined` it won't affect the theme of components inside.\n\n```html\n\n \n \n \n\n\n\n```\nYou may need to include `` if you want to apply the dark theme globally, not just to the components.\n\nTo learn more, see [n-global-style](../docs/customize-theme#Sync-style-of-the-body-element).\n\n## Get theme vars\n\nWhether it's the default light theme (`lightTheme`), the modified dark theme (`darkTheme`), or the custom theme we adjusted, you can get theme variables within the scope of the theme using [useThemeVars](./theme#use-theme-vars).\n\n## Customizing theme vars (design tokens)\n\nNo CSS (Scss, Less) needed.\n\nThe configured global theme variables will overwrite the theme variables that take effect on descendant components.\n\nSet `n-config-provider`'s `theme-overrides` to customize theme vars. Naive-ui exports type `GlobalThemeOverrides` to help you define `theme-overrides`.\n\nFor available vars please follow the type hint of `GlobalThemeOverrides`.\n\nIf you want to view more theme variables, you can view them in the edit button at the bottom right corner of the Naive UI homepage.\n\nYou can modify the corresponding theme variable, you can get the themeOverrides object after export.\n\n```html\n\n\n\n \n \n \n\n```\n\n## Customizing theme vars in TypeScript\n\nIf you are using ts to write code, this one is more suitable for you.\n\n```html\n\n\n\n \n \n \n\n```\n\n## Customizing component theme vars\n\nThe use of component theme variables is the same as the use of global theme variables, and the component theme variables will override the global theme variables.\n\n```html\n\n\n\n \n theme\n\n```\n\n## Customizing theme vars under different themes\n\nIf you want to use different theme variables on light and dark theme at the same time, you can take a look at this.\n\n```html\n\n\n\n \n \n \n\n```\n\n## Use the peers vars\n\nIn many cases, another component will be reused inside a component, so the theme variable of peers appears.\n\nThe theme variables related to peers have not been exposed yet. Use `GlobalThemeOverrides` to view the peers variables of the corresponding component.\n\nThe specific available peers will be updated later.\n\n```html\n\n\n\n \n \n \n\n```\n\n## Sync style of the body element\n\nFor the following reasons, you may need to set some styles on `document.body`.\n\n1. Naive-ui will mount some global style that is unresponsive (to theme, not media query). For example `font-family`. The style works fine by default, however they won't change when theme is changed.\n2. `n-config-provider` can't sync global style (for example, body's background color) outside it.\n\nYou can use `n-global-style` to sync common global style to the body element. In the following example, `n-global-style` will sync the theme provided by `n-config-provider` to `document.body`.\n\n```html\n\n \n \n \n \n\n```\n\n## Theme editor\n\nNaive-ui provides a theme editor to help you edit theme and export the corresponding configuration. It can be placed inside `n-config-provider`.\n\nThe theme editor is not included in global installation (`app.use(naive)`). You need to import it explicitly to use it.\n\n```html\n\n \n \n \n\n\n\n```\n"
},
{
"path": "demo/pages/docs/customize-theme/zhCN/index.md",
"content": "\n\n# 调整主题\n\nNaive UI 通过使用 `n-config-provider` 调整主题。\n\n默认情况下所有组件均为亮色主题，无需任何配置。\n\n了解更多关于 `n-config-provider` 的信息，参见 [全局化配置](../components/config-provider)。\n\n## 使用暗色主题\n\n将 `n-config-provider` 的 `theme` 设为从 naive-ui 导入的 `darkTheme` 来设定暗色主题。\n\n若 `theme` 为 `undefined` 则不会影响内部组件的主题。\n\n```html\n\n \n \n \n\n\n\n```\n\n如果你需要给 body 元素也应用 dark theme，而不仅仅是组件，你可能需要使用 ``。更多细节请参考 [n-global-style](../docs/customize-theme#Sync-style-of-the-body-element)。\n\n## 获取主题变量\n\n无论是默认的亮色主题(`lightTheme`)，还是修改后的暗色主题(`darkTheme`)，亦或我们通过调整得到的自定义主题，在该主题生效范围内的组件中都可以通过 [useThemeVars](./theme#use-theme-vars) 来获取主题变量。\n\n## 调整主题变量\n\n你不需要写任何 CSS（Scss、Less...）。\n\n配置的全局主题变量会对后代组件生效的主题变量覆盖。\n\n通过设定 `n-config-provider` 的 `theme-overrides` 来调整主题变量。naive-ui 导出了 `GlobalThemeOverrides` 类型帮助你定义主题。\n\n具体可使用变量请参考 `GlobalThemeOverrides` 类型提示。\n\n如果想要查看更多的主题变量，可在 Naive UI 主页的右下角的 edit 按钮查看。\n\n可以修改对应的主题变量，导出后可以拿到 themeOverrides 对象。\n\n```html\n\n\n\n \n \n \n\n```\n\n## TS 下使用主题变量\n\n如果你正在使用 ts 写代码，这块比较适合你。\n\n```html\n\n\n\n \n \n \n\n```\n\n## 调整组件主题变量\n\n组件主题变量使用方法同全局主题变量使用方法，并且组件主题变量会覆盖全局主题变量。\n\n```html\n\n\n\n \n theme\n\n```\n\n## 不同主题下调整主题变量\n\n如果你想要在亮色和暗色上同时使用不同的主题变量，可以来看看这个。\n\n```html\n\n\n\n \n \n \n\n```\n\n## 使用 peers 主题变量\n\n很多时候组件内部都会复用另一个组件，因此出现了 peers 的主题变量。\n\npeers 相关的主题变量还没有暴露，使用 `GlobalThemeOverrides` 可以查看对应组件的 peers 变量。\n\n具体哪些可使用的 peers 后续会更新。\n\n```html\n\n\n\n \n \n \n\n```\n\n## 同步 body 元素的样式\n\n出于以下原因，你可能需要将某些样式设定在 `document.body` 上。\n\n1. naive-ui 会设定一些非响应式的全局样式（例如字体），它们在默认状况下工作良好，但是不能响应主题的变化。\n2. `n-config-provider` 无法将全局样式同步到它以外的地方（例如 body 背景色）。\n\n通过使用 `n-global-style` 可以将常见的全局样式同步到 body 上。在下面的例子中，`n-global-style` 会将 `n-config-provider` 提供的主题同步到 `document.body` 上。\n\n```html\n\n \n \n \n \n\n```\n\n## 主题编辑器\n\nnaive-ui 提供主题编辑器帮助你方便的编辑主题并导出对应配置。它可以被嵌套于 `n-config-provider` 中。\n\n主题编辑器不包含在全局安装中（`app.use(naive)`）。你需要显式引入来使用它。\n\n```html\n\n \n \n \n\n\n\n```\n"
},
{
"path": "demo/pages/docs/experimental-features/enUS/index.md",
"content": "\n\n# Experimental Features\n\n\n The following features are unstable. Use them if you really need and perpare to follow the API changes.\n\n\n## Use TuSimple Theme\n\n```html\n\n\n\n \n \n \n\n```\n"
},
{
"path": "demo/pages/docs/experimental-features/zhCN/index.md",
"content": "\n\n# 试验性特性\n\n\n 下列的所有功能都是不稳定的。只在真的需要的时候再使用他们，API 有可能在未来被改变。\n\n\n## 使用图森主题\n\n```html\n\n\n\n \n \n \n\n```\n"
},
{
"path": "demo/pages/docs/fonts/enUS/index.md",
"content": "# Configuring Fonts\n\nNaive UI works with [vfonts](https://github.com/07akioni/vfonts). You can use fonts from `vfonts` easily which includes general fonts and monospace fonts.\n\nJust import fonts from in your app's entry file. Then it will work.\n\n```js\n// entry js file of your app\n// ...\n\n// General Font\nimport 'vfonts/Lato.css'\n// Monospace Font\nimport 'vfonts/FiraCode.css'\n// then it works\n\n// ...\n```\n\nNote: Different fonts from vfonts have different font weights. If you want to use `Lato` or `OpenSans` you need to configure the global font weight of naive-ui.\n\n```html\n\n\n \n\n```\n\n## Change Global Fonts by Customizing Theme\n\nIf you don't use `vfont` and want change global fonts by customzing theme, you need to use `n-global-style` to achieve that. Components' font won't be responsive to `theme-overrides` without `n-global-style`.\n\nNote: Make `vfont` work without `n-global-style` is a compromised design (I think this is a correct behavior). In the next major version, global reset style won't contain font related style. They'll be all put inside `n-global-style` component.\n"
},
{
"path": "demo/pages/docs/fonts/zhCN/index.md",
"content": "# 配置字体\n\nNaive UI 可以和 [vfonts](https://github.com/07akioni/vfonts) 配合，你可以简单的引入 `vfonts` 中的字体，包含常规字体和等宽字体。\n\n只需要在你 App 的入口文件导入字体，即可调整 Naive UI 的字体。\n\n```js\n// 你 App 的入口 js 文件\n// ...\n\n// 通用字体\nimport 'vfonts/Lato.css'\n// 等宽字体\nimport 'vfonts/FiraCode.css'\n\nconst app = createApp()\napp.use(naive)\n\n// ...\n```\n\n注意：不同 vfonts 字体提供的字重不同，在使用 `Lato`、`OpenSans` 的时候你需要全局调整 naive-ui 的字重配置。\n\n```html\n\n\n \n\n```\n\n## 通过定制主题修改全局字体\n\n如果你不打算使用 `vfonts` 并且想要通过主题调整修改其为别的字体，你需要使用 `n-global-style` 来做到这一点。在不使用 `n-global-style` 的情况下组件不会响应 `theme-overrides` 中的字体变更。\n\n题外话：不使用 `n-global-style` 就能让 `vfonts` 直接生效是一个设计上的妥协，在下个大的版本默认的全局 reset 样式将不再带有字体相关的样式，而是全部置于 `n-global-style` 组件中。\n"
},
{
"path": "demo/pages/docs/i18n/enUS/index.md",
"content": "\n\n# Internationalization\n\nNaive-ui provides `n-config-provider` to customize the internationalization. By default, all components are in English.\n\nTo learn more about `n-config-provider`, see [Config Provider](../components/config-provider).\n\n## Configure\n\nSet `n-config-provider`'s `locale` prop to `enUS` imported from naive-ui to set Chinese theme inside `n-config-provider`.\n\nSet `n-config-provider`'s `date-locale` prop to `dateEnUS` imported from naive-ui to set Chinese theme's date inside `n-config-provider`.\n\n```html\n\n \n \n \n\n\n\n```\n\n## Supported languages\n\nPRs are welcomed for locales that are not supported yet!\n\nThe following list is sorted by 'Config' column.\n\n| Language | Config | Date config | Version |\n| -------------------------- | ------ | ----------- | ------- |\n| Arabic (العربية) | arDZ | dateArDZ | 2.34.0 |\n| Azerbaijani (Azərbaycanca) | azAZ | dateAzAZ | 2.39.0 |\n| Czech (Czechia) | csCZ | dateCsCz | 2.38.2 |\n| Danish (Denmark) | daDK | dateDaDK | 2.43.0 |\n| German (Germany) | deDE | dateDeDE | |\n| English (British) | enGB | dateEnGB | 2.25.1 |\n| English | enUS | dateEnUS | |\n| Esperanto | eo | dateEo | 2.25.2 |\n| Spanish (Argentina) | esAR | dateEsAR | 2.24.2 |\n| Estonian | etEE | dateEtEE | 2.38.0 |\n| Persian | faIR | dateFaIR | 2.34.4 |\n| French | frFR | dateFrFR | |\n| Bahasa Indonesia | idID | dateIdID | |\n| Italiano | itIT | dateItIT | 2.24.2 |\n| Japanese | jaJP | dateJaJP | |\n| Khmer (Cambodia) | kmKH | dateKmKH | 2.41.0 |\n| Korean (South Korea) | koKR | dateKoKR | 2.28.1 |\n| Norwegian Bokmål (Norway) | nbNO | dateNbNO | |\n| Dutch (Netherlands) | nlNL | dateNlNL | 2.29.0 |\n| Polish (Poland) | plPL | datePlPL | 2.25.2 |\n| Portuguese (Brazil) | ptBR | datePtBR | 2.28.1 |\n| Russian | ruRU | dateRuRU | |\n| Slovak | skSK | dateSkSK | 2.25.3 |\n| Swedish | svSE | dateSvSE | 2.35.0 |\n| Thai (Thailand) | thTH | dateThTH | 2.27.0 |\n| Turkish | trTR | dateTrTR | 2.34.0 |\n| Uyghur (China) | ugCN | dateUgCN | |\n| Ukrainian | ukUA | dateUkUA | |\n| Uzbek (Uzbekistan) | uzUZ | dateUzUZ | 2.39.0 |\n| Vietnamese (Vietnam) | viVN | dateViVN | 2.30.7 |\n| Chinese (Simplified) | zhCN | dateZhCN | |\n| Chinese (Traditional) | zhTW | dateZhTW | |\n\n## Customize the existing locale\n\nYou can use `createLocale` to customize the existing locale.\n\n```html\n\n \n \n \n\n\n\n```\n"
},
{
"path": "demo/pages/docs/i18n/zhCN/index.md",
"content": "\n\n# 国际化\n\nNaive-ui 通过使用 `n-config-provider` 调整语言，默认情况下所有组件均为英语。\n\n了解更多关于 `n-config-provider` 的信息，参见 [全局化配置](../components/config-provider)。\n\n## 配置\n\n将 `n-config-provider` 的 `locale` 设为从 naive-ui 导入的 `zhCN` 来设定全局中文。\n\n将 `n-config-provider` 的 `date-locale` 设为从 naive-ui 导入的 `dateZhCN` 来设定全局日期中文。\n\n```html\n\n \n \n \n\n\n\n```\n\n## 支持语言\n\n欢迎提交 PR 来支持尚未支持的语言。\n\n以下列表依据“配置”列排序。\n\n| 语言 | 配置 | 日期配置 | 版本 |\n| ------------------ | ---- | -------- | ------ |\n| 阿拉伯语 | arDZ | dateArDZ | 2.34.0 |\n| 阿塞拜疆语 | azAZ | dateAzAZ | 2.39.0 |\n| 捷克语（捷克） | csCZ | dateCsCz | 2.38.2 |\n| 丹麦 | daDK | dateDaDK | 2.43.0 |\n| 德语 | deDE | dateDeDE | |\n| 英国英语 | enGB | dateEnGB | 2.25.1 |\n| 英语 | enUS | dateEnUS | |\n| 世界语 | eo | dateEo | 2.25.2 |\n| 西班牙语（阿根廷） | esAR | dateEsAR | 2.24.2 |\n| 爱沙尼亚语 | etEE | dateEtEE | 2.38.0 |\n| 波斯语 | faIR | dateFaIR | 2.34.4 |\n| 法语 | frFR | dateFrFR | |\n| 印度尼西亚语 | idID | dateIdID | |\n| 意大利语 | itIT | dateItIT | 2.24.2 |\n| 日语 | jaJP | dateJaJP | |\n| 高棉语（柬埔寨） | kmKH | dateKmKH | 2.41.0 |\n| 韩语 | koKR | dateKoKR | 2.28.1 |\n| 书面挪威语 | nbNO | dateNbNO | |\n| 荷兰语（荷兰） | nlNL | dateNlNL | 2.29.0 |\n| 波兰语（波兰） | plPL | datePlPL | 2.25.2 |\n| 葡萄牙语 (巴西) | ptBR | datePtBR | 2.28.1 |\n| 俄罗斯语 | ruRU | dateRuRU | |\n| 斯洛伐克语 | skSK | dateSkSK | 2.25.3 |\n| 瑞典語 | svSE | dateSvSE | 2.35.0 |\n| 泰语（泰国） | thTH | dateThTH | 2.27.0 |\n| 土耳其语 | trTR | dateTrTR | 2.34.0 |\n| 维吾尔语 | ugCN | dateUgCN | 2.41.0 |\n| 乌克兰语 | ukUA | dateUkUA | |\n| 乌兹别克语 | uzUZ | dateUzUZ | 2.39.0 |\n| 越南语（越南） | viVN | dateViVN | 2.30.7 |\n| 简体中文 | zhCN | dateZhCN | |\n| 繁体中文 | zhTW | dateZhTW | |\n\n## 在现有国际化基础上调整\n\n你可以使用 `createLocale` 在现有国际化基础上调整。\n\n```html\n\n \n \n \n\n\n\n```\n"
},
{
"path": "demo/pages/docs/import-on-demand/enUS/index.md",
"content": "# Import on Demand (Tree Shaking)\n\nNaive UI supports tree shaking for components, locales and themes.\n\nBy default the component theme is light, locale is enUS, and no extra imports are needed.\n\nFor more info about theming, see [Customizing Theme](customize-theme).\n\n## Import Directly\n\n```html\n\n\n\n \n \n \n \n \n \n\n\n\n```\n\n## Auto Import\n\nYou can use the `unplugin-auto-import` plugin to automatically import APIs.\n\nIf you develop using SFC, you can use the `unplugin-vue-components` plugin to automatically import components on demand.The plugin will automatically parse the components used in the template and import the components.\n\n```ts\nimport vue from '@vitejs/plugin-vue'\nimport AutoImport from 'unplugin-auto-import/vite'\nimport { NaiveUiResolver } from 'unplugin-vue-components/resolvers'\nimport Components from 'unplugin-vue-components/vite'\n// vite.config.ts\nimport { defineConfig } from 'vite'\n\n// https://vitejs.dev/config/\nexport default defineConfig({\n plugins: [\n vue(),\n AutoImport({\n imports: [\n 'vue',\n {\n 'naive-ui': [\n 'useDialog',\n 'useMessage',\n 'useNotification',\n 'useLoadingBar'\n ]\n }\n ]\n }),\n Components({\n resolvers: [NaiveUiResolver()]\n })\n ]\n})\n```\n\n## Install on Demand Globally\n\n```js\nimport {\n // create naive ui\n create,\n // component\n NButton\n} from 'naive-ui'\nimport { createApp } from 'vue'\n\nconst naive = create({\n components: [NButton]\n})\n\nconst app = createApp()\napp.use(naive)\n```\n\nAfter the installation, you can use the components you installed in SFC like this.\n\n```html\n\n naive-ui\n\n```\n"
},
{
"path": "demo/pages/docs/import-on-demand/zhCN/index.md",
"content": "# 按需引入（Tree Shaking）\n\nNaive UI 支持 tree shaking，组件、语言、主题均可 tree-shaking。\n\n默认情况组件主题为亮色，语言为英文，无需额外导入。\n\n了解更多关于主题设定的信息，参见[调整主题](customize-theme)。\n\n## 手动引入\n\n```html\n\n\n\n \n \n \n \n \n \n\n\n\n```\n\n## 自动引入\n\n可以使用 `unplugin-auto-import` 插件来自动导入 API。\n\n如果使用模板方式进行开发，可以使用 `unplugin-vue-components` 插件来按需自动加载组件，插件会自动解析模板中的使用到的组件，并导入组件。\n\n```ts\nimport vue from '@vitejs/plugin-vue'\nimport AutoImport from 'unplugin-auto-import/vite'\nimport { NaiveUiResolver } from 'unplugin-vue-components/resolvers'\nimport Components from 'unplugin-vue-components/vite'\n// vite.config.ts\nimport { defineConfig } from 'vite'\n\n// https://vitejs.dev/config/\nexport default defineConfig({\n plugins: [\n vue(),\n AutoImport({\n imports: [\n 'vue',\n {\n 'naive-ui': [\n 'useDialog',\n 'useMessage',\n 'useNotification',\n 'useLoadingBar'\n ]\n }\n ]\n }),\n Components({\n resolvers: [NaiveUiResolver()]\n })\n ]\n})\n```\n\n## 按需全局安装组件（手动）\n\n```js\nimport {\n // create naive ui\n create,\n // component\n NButton\n} from 'naive-ui'\nimport { createApp } from 'vue'\n\nconst naive = create({\n components: [NButton]\n})\n\nconst app = createApp()\napp.use(naive)\n```\n\n安装后，你可以这样在 SFC 中使用你安装的组件。\n\n```html\n\n naive-ui\n\n```\n"
},
{
"path": "demo/pages/docs/installation/enUS/index.md",
"content": "\n\n# Installation\n\n> Please note that naive-ui only supports Vue3. If you are using Vue2, you may look at other libraries.\n\n## npm\n\nUse npm to install.\n\n```bash\nnpm i -D naive-ui\n```\n\n## UMD\n\nPlease refer to [Using UMD](umd).\n\n## Fonts\n\n```bash\nnpm i -D vfonts\n```\n\n## Icons\n\nnaive-ui recommends using [xicons](https://www.xicons.org) as icon library.\n\n## Design Resources\n\n\n \n \n \n \n \n Naive UI (Sketch)\n \n \n \n \n \n \n \n\n\n```component\nArrowDownload16Regular: import ArrowDownload16Regular from '@vicons/fluent/ArrowDownload16Regular'\n```\n"
},
{
"path": "demo/pages/docs/installation/zhCN/index.md",
"content": "\n\n# 安装\n\n> 注意，naive-ui 仅支持 Vue3。如果你在使用 Vue2，可以去看看别的库。\n\n## npm\n\n使用 npm 安装。\n\n```bash\nnpm i -D naive-ui\n```\n\n## UMD\n\n参考 [使用 UMD](umd)。\n\n## 字体\n\n```bash\nnpm i -D vfonts\n```\n\n## 图标\n\nnaive-ui 建议使用 [xicons](https://www.xicons.org) 作为图标库。\n\n## 设计资源\n\n\n \n \n \n \n \n Naive UI (Sketch)\n \n \n \n \n \n \n \n\n\n```component\nArrowDownload16Regular: import ArrowDownload16Regular from '@vicons/fluent/ArrowDownload16Regular'\n```\n"
},
{
"path": "demo/pages/docs/introduction/enUS/index.md",
"content": "\n\n# Naive UI\n\nNaive UI is a Vue 3 component library.\n\nTo know how to install it, see [Installation](installation).\n\nIt is fairly complete, themeable, written in typescript, not too slow.\n\n## Fairly Complete\n\nThere are more than 90 components. Hope they can help you write less code.\n\nWhat's more, they are all treeshakable.\n\n## Theme Customizable\n\nWe provide an advanced type safe theme system that is built with typescript. All you need is to provide a theme overrides object in JS. Then all the stuffs will be done by us.\n\nWhat's more, no less/sass/css variables, no webpack loaders are required. And you can try the theme editor on the bottom right of the page.\n\n## Uses TypeScript\n\nAll the stuff in Naive UI is written in TypeScript. It can work with your typescript project seamlessly.\n\nWhat's more, you don't need to import any CSS to use the components.\n\n## Fast\n\nI try to make it not rather slow. At least select, tree, transfer, table and cascader work with virtual list.\n\nWhat's more, ..., no more. Just enjoy it.\n\n## Community\n\n- [Discord](https://discord.gg/Pqv7Mev5Dd)\n- 钉钉一群 33482509 (已满)\n- 钉钉二群 35886835 (已满)\n- 钉钉三群 32377370 (已满)\n- 钉钉四群 8165002788 (已满)\n- 钉钉五群 31205022250 (已满)\n- 钉钉六群 62720001971 (已满)\n- 钉钉七群 172000005810\n\n## Contributing\n\nPlease see [CONTRIBUTING.md](https://github.com/tusen-ai/naive-ui/blob/main/CONTRIBUTING.md).\n\n## License\n\nNaive UI is licensed under the [MIT license](https://opensource.org/licenses/MIT).\n"
},
{
"path": "demo/pages/docs/introduction/zhCN/index.md",
"content": "\n\n# Naive UI\n\nNaive UI 是一个 Vue3 的组件库。\n\n要了解如何安装，参见[安装](installation)。\n\n它比较完整，主题可调，用 TypeScript 写的，快。\n\n## 比较完整\n\n有超过 90 个组件，希望能帮你少写点代码。\n\n顺便一提，它们全都可以 treeshaking。\n\n## 主题可调\n\n我们提供了一个使用 TypeScript 构建的先进的类型安全主题系统。你只需要提供一个样式覆盖的对象，剩下的都交给我们。\n\n顺便一提，不用 less、sass、css 变量，也不用 webpack 的 loaders。以及你可以试试右下角的主题编辑器。\n\n## 使用 TypeScript\n\nNaive UI 全量使用 TypeScript 编写，和你的 TypeScript 项目无缝衔接。\n\n顺便一提，你不需要导入任何 CSS 就能让组件正常工作。\n\n## 快\n\n我尽力让它不要太慢。至少 select、tree、transfer、table、cascader 都可以用虚拟列表。\n\n顺便一提，...，没有顺便了。祝你使用愉快。\n\n## 社区\n\n- [Discord](https://discord.gg/Pqv7Mev5Dd)\n- 钉钉一群 33482509 (已满)\n- 钉钉二群 35886835 (已满)\n- 钉钉三群 32377370 (已满)\n- 钉钉四群 8165002788 (已满)\n- 钉钉五群 31205022250 (已满)\n- 钉钉六群 62720001971 (已满)\n- 钉钉七群 172000005810\n\n## 贡献\n\n请参考 [CONTRIBUTING.md](https://github.com/tusen-ai/naive-ui/blob/main/CONTRIBUTING.md)。\n\n## 许可\n\nNaive UI 使用 [MIT license](https://opensource.org/licenses/MIT) 许可证书。\n"
},
{
"path": "demo/pages/docs/jsx/enUS/index.md",
"content": "\n\n# JSX & TSX\n\n## Enable JSX & TSX\n\nFor how to enable JSX & TSX, please look at your toolchain's docs.\n\n## Use Component\n\nWe recommend importing components directly when using JSX.\n\n```js\nimport { NButton } from 'naive-ui'\nimport { defineComponent } from 'vue'\n\nexport default defineComponent({\n render() {\n return {{ default: () => 'Star Kirby' }}\n }\n})\n```\n\n## Props look like @update:\\*\n\nIn naive-ui, all props look like `on-update:*` has a corresponding `onUpdate*` prop (since in JSX `on-update:*` and `onUpdate:*` are not valid prop names).\n\nIf you find it doesn't exist, I must have forgotten to make it. Please create an issue or PR.\n\nFor example, `` in template can be written in ``.\n"
},
{
"path": "demo/pages/docs/jsx/zhCN/index.md",
"content": "\n\n# JSX & TSX\n\n## 启用 JSX & TSX\n\n关于启用 JSX 和 TSX，请参考你使用的工具链的相关文档。\n\n## 使用组件\n\n在 JSX 中，推荐以直接引入的形式使用组件。\n\n```js\nimport { NButton } from 'naive-ui'\nimport { defineComponent } from 'vue'\n\nexport default defineComponent({\n render() {\n return {{ default: () => 'Star Kirby' }}\n }\n})\n```\n\n## 形如 @update:\\* 的 prop\n\nnaive-ui 中，所有形如 `on-update:*` 的 prop 都有一个对应的 `onUpdate*` 属性可供使用（由于 JSX 自身的规定，`on-update:*` 和 `onUpdate:*` 不是合法的 prop 名称）。\n\n如果你发现没有，那一定是我忘了写了，请提交一个 Issue 或者 PR。\n\n例如，在模板中 `` 在 JSX 中可以写为 ``。\n"
},
{
"path": "demo/pages/docs/nuxtjs/enUS/index.md",
"content": "# Nuxt.js\n\n## Caveat\n\nThis document pertains to SSR (Server-Side Rendering). Please familiarize yourself with the [SSR Caveats](ssr#Caveat) before proceeding.\n\n## Nuxt.js Demo\n\nYou can refer to [example](https://github.com/07akioni/naive-ui-nuxt-demo).\n\n## Using Nuxt Module\n\nThis is the same approach which previous demo uses.\n\nInstall the [module](https://github.com/07akioni/nuxtjs-naive-ui) to your Nuxt application with one command:\n\n```bash\n# npm\nnpx nuxi module add nuxtjs-naive-ui\n\n# pnpm\npnpm dlx nuxi module add nuxtjs-naive-ui\n```\n\n## Using Auto Import in Nuxt\n\nYou can also use the `unplugin-auto-import` plugin to automatically import APIs and the `unplugin-vue-components` plugin to automatically import components on demand. In this case, the `nuxt.config.ts` file will have a few additional configuration lines compared to the example above.\n\n```ts\nimport AutoImport from 'unplugin-auto-import/vite'\nimport { NaiveUiResolver } from 'unplugin-vue-components/resolvers'\nimport Components from 'unplugin-vue-components/vite'\n\n// https://nuxt.com/docs/api/configuration/nuxt-config\nexport default defineNuxtConfig({\n modules: ['nuxtjs-naive-ui'],\n vite: {\n plugins: [\n AutoImport({\n imports: [\n {\n 'naive-ui': [\n 'useDialog',\n 'useMessage',\n 'useNotification',\n 'useLoadingBar'\n ]\n }\n ]\n }),\n Components({\n resolvers: [NaiveUiResolver()]\n })\n ]\n }\n})\n```\n"
},
{
"path": "demo/pages/docs/nuxtjs/zhCN/index.md",
"content": "# Nuxt.js\n\n## 注意\n\n本文档涉及到 SSR，请先了解[SSR 的注意事项](ssr#注意)。\n\n## Nuxt.js 示例\n\n参考[例子](https://github.com/07akioni/naive-ui-nuxt-demo)。\n\n## 使用 Nuxt Module\n\n这和上一个示例使用的是同样的方式。\n\n在你的 Nuxt 应用中使用下列命令安装此[模块](https://github.com/07akioni/nuxtjs-naive-ui)：\n\n```bash\n# npm\nnpx nuxi module add nuxtjs-naive-ui\n\n# pnpm\npnpm dlx nuxi module add nuxtjs-naive-ui\n```\n\n## 在 Nuxt 中使用自动引入\n\n同样可以使用 `unplugin-auto-import` 插件来自动导入 API，使用 `unplugin-vue-components` 插件来按需自动加载组件。在这种情况下，`nuxt.config.ts` 会比上面的例子多几行配置。\n\n```ts\nimport AutoImport from 'unplugin-auto-import/vite'\nimport { NaiveUiResolver } from 'unplugin-vue-components/resolvers'\nimport Components from 'unplugin-vue-components/vite'\n\n// https://nuxt.com/docs/api/configuration/nuxt-config\nexport default defineNuxtConfig({\n modules: ['nuxtjs-naive-ui'],\n vite: {\n plugins: [\n AutoImport({\n imports: [\n {\n 'naive-ui': [\n 'useDialog',\n 'useMessage',\n 'useNotification',\n 'useLoadingBar'\n ]\n }\n ]\n }),\n Components({\n resolvers: [NaiveUiResolver()]\n })\n ]\n }\n})\n```\n"
},
{
"path": "demo/pages/docs/ssr/enUS/index.md",
"content": "# Server-Sider Rendering\n\nSince naive-ui is using CSS in JS, in SSR mode it needs some extra configuration.\n\n## Caveat\n\nWhen using SSR under any framework, it is essential to ensure that the project meets the following conditions:\n\n1. During the build process, any direct or indirect references to the `@css-render/*` and `css-render` packages must have a version of `>=0.15.14`.\n2. During the build process, each direct or indirect reference to any `@css-render/*` and `css-render` package should ultimately point to a single target (a package should not have multiple versions or multiple copies of the same version).\n\nYou can search for `css-render` in the lock file to check for duplicate packages.\n\nFailure to meet these conditions may result in SSR build failures.\n\nIf you encounter issues due to this, you can resolve the problem by directing all related packages to the same version using the `resolution` field in the `package.json` file.\n\n## Nuxt.js\n\nSee [Nuxt.js](nuxtjs).\n\n## Vitepress\n\nSee [Vitepress](vitepress).\n\n## Vite SSG/SSE\n\nSee [Vite SSG/SSE](vite-ssge).\n\n## Vite Example\n\nIf you are using Vite, please see [example](https://github.com/07akioni/naive-ui-vite-ssr).\n\n## Webpack Example\n\nIf you are using Webpack, please see [example](https://github.com/tusen-ai/naive-ui/tree/main/playground/ssr).\n\n## Inline Style Optimization\n\nBy default, naive-ui bind inline theme style on components, it may increase SSR rendered HTML size. You may use `inline-theme-disabled` prop on `n-config-provider` to disable it. For pros & cons see `n-config-provider`'s doc.\n\n## Known Issues\n\nThe following components has some bugs in SSR scene, please avoid using them if possible. We will fix them gradually.\n\n- `n-scrollbar`, `n-data-table` (It works after vue >= 3.2.36)\n- `n-anchor`\n- `n-avatar-group`\n- `n-watermark`\n- `n-affix`\n- `n-transfer`\n"
},
{
"path": "demo/pages/docs/ssr/zhCN/index.md",
"content": "# 服务端渲染 Server-Sider Rendering\n\n由于 naive-ui 在使用 CSS in JS，在 SSR 的情况下需要一些额外的配置。\n\n## 注意\n\n无论在任何框架下使用 SSR，需要确保项目满足以下条件：\n\n1. 构建时，任何被直接和间接引用的 `@css-render/*` 和 `css-render` 包版本都 `>=0.15.14`\n2. 构建时，任何被直接和间接引用的每个 `@css-render/*` 和 `css-render` 包最终只都指向一个目标（一个包不会有多个版本，也不会有同一个版本的多个副本）\n\n你可以在 lock file 中搜索 `css-render` 去检查是否有重复的包。\n\n如果上述条件没有满足，可能会导致 SSR 构建失败。\n\n如果因为这个原因遇到问题，你可以通过 `package.json` 中的 `resolution` 字段来让所有相关包指向同一个版本来解决问题。\n\n## Nuxt.js\n\n参考 [Nuxt.js](nuxtjs)。\n\n## Vitepress\n\n参考 [Vitepress](vitepress)。\n\n## Vite SSG/SSE\n\n参考 [Vite SSG/SSE](vite-ssge)。\n\n## Vite 示例\n\n如果你是用的是 Vite，请参考[例子](https://github.com/07akioni/naive-ui-vite-ssr)。\n\n## Webpack 示例\n\n如果你使用的是 Webpack，请参考[例子](https://github.com/tusen-ai/naive-ui/tree/main/playground/ssr)。\n\n## 内联样式优化\n\n默认情况下，naive-ui 会在组件上绑定 inline 主题样式，这可能会影响 SSR 的尺寸。你可以使用 `n-config-provider` 的 `inline-theme-disabled` 属性来优化，详细的优劣请参考 `n-config-provider` 的文档。\n\n## 已知问题\n\n下列组件在 SSR 场景中存在一些 Bug，使用时请尽量规避，我们会逐步修复。\n\n- `n-scrollbar`, `n-data-table`（vue 版本 >= 3.2.36 后没有问题)\n- `n-anchor`\n- `n-avatar-group`\n- `n-watermark`\n- `n-affix`\n- `n-transfer`\n"
},
{
"path": "demo/pages/docs/style-conflict/enUS/index.md",
"content": "# Potential Style Conflict\n\n## Style Element Position\n\nSometimes you want to control where the style element should be inserted.\n\nFor example. If you have a tailwind reset style, you don't want it to be inserted after naive-ui's style. Since it may override button's style, etc.\n\nYou can create a `` element inside `head` element, then naive-ui's style will be inserted right before it.\n\nAlso, naive-ui uses [vueuc](https://github.com/07akioni/vueuc). If you need, its style can be controlled by `` (generally it's not needed).\n\n```html\n\n \n \n \n \n \n \n\n```\n\n## About Tailwind's Preflight Style Override\n\nYou may find adding a meta tag to your static html files doesn't work (naive's style would still be overriden), since your toolchain may always insert tailwind's style at the end of the head tag. In this situation, you need to insert the meta tag dynamically right before the app is mounted.\n\n```ts\nconst meta = document.createElement('meta')\nmeta.name = 'naive-ui-style'\ndocument.head.appendChild(meta)\n\nvueApp.mount('#app')\n```\n\n## Disable Preflight Style (CSS Reset)\n\nTo make naive-ui work for most users out of box, mounting any component of naive would create global preflight style. However it may not be expected. If you want to disable it, using `n-config-provider` like this.\n\n```html\n\n \n\n```\n"
},
{
"path": "demo/pages/docs/style-conflict/zhCN/index.md",
"content": "# 潜在的样式冲突\n\n## 样式元素的位置\n\n有时你可能希望控制样式元素插入的位置。\n\n例如，如果你使用了 tailwind 的 reset 样式，你不希望它被插入 naive-ui 样式的后面，因为这可能会覆盖按钮等组件的样式。\n\n你可以在 `head` 元素中加入一个 `` 元素，naive-ui 会把所有的样式刚好插入这个元素的前面。\n\n同时，naive-ui 依赖 [vueuc](https://github.com/07akioni/vueuc)。如果你需要（通常应该不会），它的样式位置可以通过 `` 控制。\n\n```html\n\n \n \n \n \n \n \n\n```\n\n## 关于 tailwind 的 preflight 样式\n\n你可能会发现在静态 HTML 文件中加入 meta 标签没用（naive 的样式仍然可能被覆盖），因为你的工具链可能永远会把 tailwind 的样式插入 head 的尾部。这种情况下，你需要在 app 挂载之前动态的插入 meta 标签。\n\n```ts\nconst meta = document.createElement('meta')\nmeta.name = 'naive-ui-style'\ndocument.head.appendChild(meta)\n\nvueApp.mount('#app')\n```\n\n## 禁用 preflight 样式\n\n为了让多数用户直接无配置的使用 naive-ui，挂载任何一个组件都会创建全局的 CSS 样式。但是这样可能不是期望的行为，你可以使用 `n-config-provider` 来禁用这个行为。\n\n```html\n\n \n\n```\n"
},
{
"path": "demo/pages/docs/supported-platforms/enUS/index.md",
"content": "\n\n# Supported Platforms\n\n## Browsers\n\nIE is not supported.\n\nModern browsers such as `Edge`, `Firefox`, `Chrome`, `Safari` are tested on the latest 2 versions.\n\nNo strict tests are being implemented on other versions due to the constraint of development resources, but naive-ui is expected to work on those browsers whose version is not too old (eg. in 2 years). If you find any problems please feel free to create an issue.\n\n## Vue\n\nOnly Vue 3 (>3.0.5) is supported.\n\n## TypeScript\n\nRequires version > 4.1.\n"
},
{
"path": "demo/pages/docs/supported-platforms/zhCN/index.md",
"content": "\n\n# 支持的平台\n\n## 浏览器\n\n不支持 IE 浏览器。\n\n`Edge`、`Firefox`、`Chrome`、`Safari` 等现代浏览器的最新的 2 个版本确保会被支持。\n\n对于这些浏览器的其他版本中，由于开发资源的限制并没有做过严格的测试。但是我们预期 naive-ui 应该在这些浏览器不算太老的版本上能正常的运行（比如 2 年之内的版本）。如果你发现了任何问题欢迎来提 issue。\n\n## Vue\n\n只支持 Vue 3（>3.0.5）。\n\n## TypeScript\n\n需要版本 > 4.1。\n"
},
{
"path": "demo/pages/docs/theme/enUS/element.demo.vue",
"content": "\n# Use Naive Element\n\nNaive UI has `n-element` component. See [Element](../components/element).\n\n\n\n\n\n \n \n \n Dark\n \n \n Light\n \n \n \n \n \n I am a Span.\n \n \n \n \n\n"
},
{
"path": "demo/pages/docs/theme/enUS/index.demo-entry.md",
"content": "# Create Themed Component\n\nYou may not want to use only the provided components and want to write themed components.\n\nNaive UI provides some tools for developers to create themed components easier.\n\n## Demos\n\n```demo\nprovide-theme.vue\nelement.vue\nuse-theme-vars.vue\n```\n"
},
{
"path": "demo/pages/docs/theme/enUS/provide-theme.demo.vue",
"content": "\n# Provide Theme\n\nUse `n-config-provider` to set the theme of all its descendant components.\n\n\n\n\n\n \n \n \n \n Dark\n \n \n Light\n \n \n \n \n\n"
},
{
"path": "demo/pages/docs/theme/enUS/use-theme-vars.demo.vue",
"content": "\n# useThemeVars\n\nNaive UI provides `useThemeVars`. It contains common theme variables.\n\n\n\n\n\n
\n\n"
},
{
"path": "demo/pages/docs/umd/enUS/index.md",
"content": "# Using UMD\n\n\n There is a self-closing bug in UMD version of naive. Please close tags explicitly like <n-input></n-input>.\n\n\nAfter version `2.30.3`, you can use UMD version of naive.\n\nIf you want to use a minified version of naive, use `https://unpkg.com/naive-ui@version/dist/index.prod.js` as `src`. `version` is the version of naive-ui you want to use. If you don't specify a version, latest version would be used.\n\nIt's preferable to link to a specific version of the package, as always relying on the latest version may lead to breaking changes.\n\nHere's a basic [demo](https://jsbin.com/saxubitaki/1/edit?html,output):\n\n```html\n\n\n \n \n \n \n \n \n \n
![](\"https://naiveui.oss-cn-hongkong.aliyuncs.com/naivelogo.svg\")
\n![\"npm\"](\"https://img.shields.io/npm/v/naive-ui.svg\")
\n ![](\"./assets/images/naivelogo.svg\")
\n Naive UI\n ![](\"https://naive-ui.oss-accelerate.aliyuncs.com/naive-design.png\")
\n \n \n