TIP
Quasar的v1版本现在具有稳定的API。
从较旧的v1升级到最新的v1
使用UMD
只需将引用Quasar的所有CSS和JS标签中的版本字符串替换为较新的版本。
使用Quasar CLI
# 在Quasar v1项目中
# 运行这些命令
# 检查可升级的软件包
$ quasar upgrade
# 做实际的升级
$ quasar upgrade --install
代码编辑器终端的注意事项
如果您使用的是代码编辑器终端而不是真实的终端,运行quasar upgrade并收到错误消息:Command not found或*@quasar/cli* version appears to be undefined,您将需要到代码编辑器终端的设置,然后取消选中选项(或等效选项)从项目根目录将’node_modules/.bin’添加到%PATH%,然后重新启动代码编辑器。
使用Vue CLI
$ yarn upgrade quasar@1
您可能还想确保您也拥有最新的@quasar/extras软件包:
$ yarn add @quasar/extras@latest
从0.x升级到v1
在开始将旧版Quasar升级到Quasar v1的旅程之前,您应该了解以下几点: 1)在Discord服务器或论坛上提问之前,请先阅读文档。 2)准备一个CodePen,以便工作人员可以为您提供帮助。 3)深入研究Quasar源代码(它将帮助您了解框架并教您使用Vue进行编程的最佳实践)。 4)除非绝对必要,否则不要将框架组件用作mixin(如果需要,请封装它们)。 5)除非绝对必要,否则不要使用CSS选择器来定位内部组件。 6)由于速度快和使用效率高,我们建议尽可能使用yarn。但是,当使用全局变量时,我们仍然建议使用npm,特别是如果您使用nvm(节点版本管理器)。 7)使用git进行仓库管理并进行定期提交,就像在流程上做笔记一样,如果遇到问题,可以恢复到以前的状态。 8)将Quasar启动文件用于任何预安装的应用程序例程。 9)使用其他库时请务必谨慎-Quasar无法确保它们将完全兼容 10)最后,成为[支持者/赞助人](https://donate.quasar.dev)并能访问特殊Discord支持的聊天室以获得优先支持。
升级简介
虽然升级旧版Quasar项目似乎是一个合理的选择,但它可能并不总是以最佳解决方案的形式出现。请注意,有些替代方法可能会更快,更有效。例如,有时最好创建一个新项目并移植旧项目。以这种方式,如果您缓慢且有条理地进行操作,则可以看到问题并迅速解决。这与就地升级项目相反,后者可以同时破坏所有内容。如果您要进行升级,我们将汇总以下所需的步骤。但是,您仍然需要更新通过修订的任何Quasar组件才能升级到v1。
无论哪种情况,当您在此过程中构建项目时,都可能会遇到没有提供有效信息的生成错误,并且您也不知道是什么原因导致的。 如果您遇到这种情况,建议您运行quasar build而不是quasar dev,因为生产版本有时会(从Webpack中)提供与dev版本不同的信息。
如果您陷入困境,请访问论坛并访问Discord服务器寻求帮助。 不仅来自员工,还来自社区。
无论走哪条路,祝您好运!
Info
应当指出,我们已尽最大努力确保升级文档中的所有内容都是正确的。 但是,由于这是手动过程,因此可能会出现错误。 如果发现任何问题,请不要害怕进行PR,并提出需要更正的更改。
初始步骤
开始升级项目的最佳方法是执行以下步骤:
- 首先,使用
quasar info确认您的当前信息: 
Global packages
  quasar-cli                    0.17.23
Important local packages
  quasar-cli                    0.17.23 (Quasar Framework CLI)
  quasar-framework              0.17.19 (Build responsive SPA, SSR, PWA, Hybrid Mobile Apps and Electron apps, all simultaneously using the same codebase)
  quasar-extras                 2.0.9   (Quasar Framework fonts, icons and animations)
这显示了旧版Quasar的版本(我们将在步骤结束时再次进行此操作以验证是否升级)
- 移除本地
quasar-cli软件包 
$ yarn remove quasar-cli
删除文件夹
.quasar、node_modules和package-lock.json或yarn.lock文件安装:
quasar和@quasar/extras作为依赖项
$ yarn add quasar @quasar/extras
- 安装:
@quasar/app作为开发依赖项 
$ yarn add --dev @quasar/app
- 重新安装所有npm软件包
 
$ yarn
- Babel升级
 
首先删除旧的.babelrc并创建新的babel.config.js
然后将您的babel.config.js更新为
module.exports = {
  presets: [
    '@quasar/babel-preset-app'
  ]
}
**将文件夹
src/plugins重命名为src/boot在
quasar.conf.js中:重命名关键部分plugins到boot:
module.exports = function (ctx) {
  return {
    // app plugins (/src/plugins)
    plugins: [
    ],
应该看起来像这样:
module.exports = function (ctx) {
  return {
    // app boot (/src/boot)
    boot: [
    ],
不要混淆Quasar插件。 _不要_更改此内容:
// Quasar plugins
framework: {
  plugins: [ // 不要编辑这里
    'Notify'
  ]
}
在
quasar.conf.js中:重命名fontawesome为fontawesome-v6、mdi为mdi-v6、ionicons为ionicons-v4(在extras部分中), 如果您使用它们。 即使您不使用它们,重命名它们仍然是好习惯,以防将来您使用它们。在
quasar.conf.js>framework>iconSet中,对其值进行与上述相同的重命名替换(fontawesome到fontawesome-v6、mdi到mdi-v6和ionicons到ionicons-v4)在quasar.conf.js中:重命名
framework>i18n为lang在“ quasar.conf.js”中:删除所有对
ctx.theme的引用在文件夹
~/src/css中创建文件quasar.variables.styl(如果尚不存在)。 向其中添加以下内容(或将内容从~/src/css/themes/common.variables.styl中移出):
// Quasar Stylus Variables
// --------------------------------------------------
// To customize the look and feel of this app, you can override
// the Stylus variables found in Quasar's source Stylus files.
// Check documentation for full list of Quasar variables
// It's highly recommended to change the default colors
// to match your app's branding.
// Tip: Use the "Theme Builder" on Quasar's documentation website.
$primary   = #1976d2
$secondary = #26A69A
$accent    = #9C27B0
$positive  = #21BA45
$negative  = #C10015
$info      = #31CCEC
$warning   = #F2C037
在
~/src/css文件夹中,删除themes文件夹。删除旧版Quasar的全局
quasar-cli,并安装新的@quasar/cli。 (您仍然可以使用它运行旧版0.17项目)
删除全局Quasar CLI
$ yarn global remove quasar-cli
# or (depending on what you've installed it with)
$ npm remove -g quasar-cli
安装全局Quasar CLI
$ yarn global add @quasar/cli
# or
$ npm install -g @quasar/cli
TIP
如果您正在使用Yarn,请确保Yarn的全局安装位置在你的PATH上:
# in ~/.bashrc or equivalent
export PATH="$(yarn global bin):$PATH"
- 最后但并非最不重要的一点是,使用
quasar info进行健全性检查: 
Global packages
  @quasar/cli - 1.0.5
Important local packages
  quasar - 1.9.0 -- High performance, Material Design 2, full front end stack with Vue.js -- build SPA, SSR, PWA, Hybrid Mobile Apps and Electron apps, all simultaneously using the same codebase
  @quasar/app - 1.5.4 -- Quasar Framework App CLI
  @quasar/extras - 1.5.1 -- Quasar Framework fonts, icons and animations
请注意与步骤1不同的版本。
现在剩下的就是修复页面和组件的正确性。 以下信息可用作参考。
构建主题
iOS主题不再可用,但是您将看到,也不再需要它:
- 文档中有一些示例,说明如何使不同组件的外观和感觉像iOS
 - 您可以挂接到
$q.platform.is.ios来帮助您不同地设置组件属性 - 新组件非常易于定制(比旧版Quasar容易得多)
 
Quasar CLI
- 要创建新项目,请使用
yarn create quasar或npm init quasar而不是quasar create或quasar init --theme,-t选项不再可用作构建选项。- 添加了
quasar describe,用于Quasar组件等的命令行帮助。 quasar inspect是查看生成的Webpack配置的新选项。quasar ext是Quasar应用扩展管理的新选项。quasar new plugin ...现在是quasar new boot ...
构建输出
dist文件夹现在去除了-mat和-ios后缀,因为现在只有一个主题。 结果,dist/spa-mat, dist/electron-ios, dist/pwa-mat等现在变为dist/spa, dist/electron, dist/pwa。
动画
- v1版本中,JS和CSS动画已删除。 但是,当v1完全发布时,它们将作为单独的Quasar软件包提供。 在此之前,如果需要它们,可以通过将它们直接从v0.17存储库中拉出并将它们添加到您的项目的方式,将它们手动添加到您的quasar项目中。
 - motion.styl
 - animate.js
 
杂项
this.$q.i18n改为this.$q.langimport('quasar-framework/i18n/' + lang)改为import('quasar/lang/' + lang)其中lang为en-us等.- 语言包
en-uk已更改为en-gb this.$q.icons改为this.$q.iconSet- 在以前的版本中,您将使用以下内容访问导入的语言包isoName:
 
 import('quasar/lang/' + locale).then(lang => {
   // 使用此命令访问isoName - lang.default.lang
 })
现在这需要更改为
 import('quasar/lang/' + locale).then(lang => {
   // 使用此命令访问isoName - lang.default.isoName
 })
调色板
颜色faded, dark, light已删除。 如果需要这些,请将其重新添加到新的Stylus文件中。
// Variables
$light = #bdbdbd
$dark = #424242
$faded = #777
// CSS3 Root Variables
:root
  --q-color-light $light
  --q-color-light-d darken($light, 10%)
  --q-color-faded $faded
  --q-color-dark $dark
// CSS Classes
.text-faded
  color $faded !important
  color var(--q-color-faded) !important
.bg-faded
  background $faded !important
  background var(--q-color-faded) !important
.text-light
  color $light !important
  color var(--q-color-light) !important
.bg-light
  background $light !important
  background var(--q-color-light) !important
.text-dark
  color $dark !important
  color var(--q-color-dark) !important
.bg-dark
  background $dark !important
  background var(--q-color-dark) !important
.text-faded
  color $faded !important
  color var(--q-color-faded) !important
.bg-faded
  background $faded !important
  background var(--q-color-faded) !important
CSS
颜色
tertiary颜色被重命名为accent. 这适用于品牌颜色和颜色列表。
| 旧版 | v1 | 
|---|---|
$tertiary | $accent | 
.bg-tertiary | .bg-accent | 
.text-tertiary | .text-accent | 
风格&特性
标题
| 旧版 | v1 | |
|---|---|---|
| h1 | .q-display-4 | .text-h1 | 
| h2 | .q-display-3 | .text-h2 | 
| h3 | .q-display-2 | .text-h3 | 
| h4 | .q-display-1 | .text-h4 | 
| h5 | .q-headline | .text-h5 | 
| h6 | .q-title | .text-h6 | 
.q-subheading | .text-subtitle1 或 .text-subtitle2 | |
.q-body-1 | .text-body1 | |
.q-body-2 | .text-body2 | |
.q-caption | .text-caption | |
.text-overline | 
文字类型
| 旧版 | v1 | 
|---|---|
.quote | 
CSS辅助类
| 旧版 | v1 | 
|---|---|
.capitalize | .text-capitalize | 
.lowercase | .text-lowercase | 
.uppercase | .text-uppercase | 
CSS可见性
| 旧版 | v1 | 
|---|---|
.highlight-and-fade | |
.mat-only | |
.ios-only | |
.mat-hide | |
.ios-hide | 
鼠标相关
| 旧版 | v1 | 
|---|---|
.cursor-inherit | |
.cursor-none | |
.cursor-not-allowed | 
边界相关
| 旧版 | v1 | 
|---|---|
.round-borders | .rounded-borders | 
.no-border | |
.no-border-radius | |
.no-box-shadow | 
布局和网格
网格行
| 旧版 | v1 | 
|---|---|
.order-first | |
.order-none | |
.order-last | |
.offset-<size>-<columns> | 
size 是xs, sm, md, lg or xl之一。columns 是1到12
网格列
| 旧版 | v1 | 
|---|---|
.col-auto | |
.col-xs-auto | |
.col-sm-auto | |
.col-md-auto | |
.col-lg-auto | |
.col-xl-auto | |
.col-shrink | 
网格Gutter
| 旧版 | v1 | 
|---|---|
.gutter-xs | .q-gutter-xs | 
.gutter-sm | .q-gutter-sm | 
.gutter-md | .q-gutter-md | 
.gutter-lg | .q-gutter-lg | 
.gutter-xl | .q-gutter-xl | 
.q-gutter-none | |
.q-col-gutter-xs | |
.q-col-gutter-sm | |
.q-col-gutter-md | |
.q-col-gutter-lg | |
.q-col-gutter-xl | 
指令
- 返回顶部已被弃用,以支持页面滚动条.
 
| 旧版 | v1 | 
|---|---|
v-close-overlay | v-close-popup | 
v-back-to-top | 
如果您正在使用新的QMenu组件,则可以使用auto-close属性。
插件
操作表
- 重命名为底页
 
本地/会话存储
结构看起来相同,但是一些功能已重命名。
| 旧版 | v1 | 
|---|---|
LocalStorage.get.item(key) | LocalStorage.getItem(key) | 
SessionStorage.get.item(key) | SessionStorage.getItem(key) | 
this.$q.localStorage.get.item(key) | this.$q.localStorage.getItem(key) | 
this.$q.sessionStorage.get.item(key) | this.$q.sessionStorage.getItem(key) | 
组件
- 以下组件按字母顺序排列,以便于访问。
 
QActionSheet
- 被弃用,而倾向于BottomSheet(来自代码),或使用带有
position="bottom"的QDialog(来自模板)。 
QAlert
- 替换为QBanner
 - 现在,属性
type和color由background CSS类管理。 
QBanner属性
| 旧版 | v1 | 
|---|---|
actions | |
avatar | |
color | |
detail | |
icon | |
message | |
text-color | |
type | |
dense | |
inline-actions | |
rounded | 
QBanner插槽
| 旧版 | v1 | 
|---|---|
default | |
avatar | |
action | 
QAutocomplete
- 已删除,内置于QSelect中,它功能更强大,并提供了更多选项来满足您的自动完成需求; 确保您习惯了QSelect的所有功能
 
QBreadcrumbs
QBreadcrumbs属性
| 旧版 | v1 | 
|---|---|
color | |
gutter | |
separator-color | 
QBreadcrumbsEl
QBreadcrumbsEl属性
| 旧版 | v1 | 
|---|---|
color | |
event | 
QBtn
align类型从string更改为anytabindex类型从number更改为number|string
QBtn属性
| 旧版 | v1 | 
|---|---|
no-ripple | |
repeat-timeout | |
wait-for-ripple | |
ripple | |
stack | |
stretch | |
unelevated | 
QBtnDropdown
align类型从string更改为anytabindex类型从number更改为number|string
QBtnDropdown属性
| 旧版 | v1 | 
|---|---|
dark-percentage | |
no-ripple | |
percentage | |
popover-anchor | |
popover-self | |
repeat-timeout | |
wait-for-ripple | |
auto-close | |
cover | |
menu-anchor | |
menu-self | |
persistent | |
ripple | |
stack | |
stretch | |
unelevated | 
QBtnDropdown事件
| 旧版 | v1 | 
|---|---|
@before-hide(evt) | |
@before-show(evt) | |
@hide(evt) | |
@show(evt) | 
QBtnDropdown方法
| 旧版 | v1 | 
|---|---|
hide(evt) | |
show(evt) | |
toggle(evt) | 
QBtnGroup
QBtnGroup属性
| 旧版 | v1 | 
|---|---|
glossy | |
stretch | |
unelevated | 
QBtnToggle
QBtnToggle属性
| 旧版 | v1 | 
|---|---|
no-ripple | |
wait-for-ripple | |
ripple | |
stack | |
stretch | |
unelevated | 
QCard
QCard属性
| 旧版 | v1 | 
|---|---|
color | |
inline | |
text-color | |
bordered | 
QCard插槽
| 旧版 | v1 | 
|---|---|
overlay | 
QCardTitle
- 已删除,请使用QCard的QCardSection
 
QCardMain
- 已删除,请使用QCard的QCardSection
 
QCardMedia
- 已删除,请使用QCard的QCardSection或直接放置
<img>或QParallax。 
QCardSeparator
- 已删除,使用QSeparator
 
QCarousel
thumbnails类型从array更改为boolean
QCarousel属性
| 旧版 | v1 | 
|---|---|
animation | |
color | |
easing | |
handle-arrow-keys | |
no-swipe | |
quick-nav | |
quick-nav-icon | |
quick-nav-position | |
swipe-easing | |
thumbnails-horizontal | |
thumbnails-icon | |
animated | |
control-color | |
navigation | |
navigation-icon | |
next-icon | |
padding | |
prev-icon | |
swipeable | |
transition-next | |
transition-prev | 
QCarousel事件
| 旧版 | v1 | 
|---|---|
@input(index) | @input(value) | 
@slide | |
@slide-trigger | |
@before-transition | |
transition | 
QCarousel方法
| 旧版 | v1 | 
|---|---|
goToSlide(slideNum) | goTo(panelName) | 
QCarousel插槽
| 旧版 | v1 | 
|---|---|
control-button | |
control-full | |
control-nav | |
control-progress | |
quick-nav | 
QCarouselControl
offset类型从array of 2 numbers更改为array
QCarouselSlide
QCarouselSlide属性
| 旧版 | v1 | 
|---|---|
disable | |
name | 
QChatMessage
size类型从array更改为stringtext类型从array更改为string
QCheckbox
val类型从object更改为any
QCheckbox属性
| 旧版 | v1 | 
|---|---|
checked-icon | |
indeterminate-icon | |
no-focus | |
readonly | |
unchecked-icon | |
dense | |
tabindex | 
QCheckbox方法
| 旧版 | v1 | 
|---|---|
toggle() | 
QChip
QChip属性
| 旧版 | v1 | 
|---|---|
avatar | |
closable | |
detail | |
floating | |
pointing | |
small | |
tag | |
clickable | |
disable | |
label | |
outline | |
removable | |
ripple | |
selected | |
tabindex | 
QChip事件
| 旧版 | v1 | 
|---|---|
@hide() | |
@update:selected(state) | |
@remove(state) | 
QChipsInput
- 已删除, 内置于QSelect
 
QCollapsible
QExpansionItem属性
| 旧版 | v1 | 
|---|---|
active-class | |
append | |
caption | |
content-inset-level | |
dark | |
default-opened | |
dense | |
dense-toggle | |
disable | |
duration | |
exact | |
exact-active-class | |
expand-icon | |
expand-icon-class | |
expand-icon-toggle | |
expand-separator | |
group | |
header-class | |
header-inset-level | |
header-style | |
icon | |
label | |
popup | |
switch-toggle-side | |
to | |
replace | 
QExpansionItem事件
| 旧版 | v1 | 
|---|---|
@before-hide(evt) | |
@before-show(evt) | |
@hide(evt) | |
@input(value) | |
@show(evt) | 
QExpansionItem方法
| 旧版 | v1 | 
|---|---|
show(evt) | |
toggle(evt) | |
hide(evt) | 
QExpansionItem插槽
| 旧版 | v1 | 
|---|---|
header | 
QColorPicker
- 被QColor替换
 default-value类型从string|object更改为string
QColor属性
| 旧版 | v1 | 
|---|---|
after | |
align | |
before | |
cancel-label | |
clear-value | |
clearable | |
color | |
display-value | |
error | |
float-label | |
hide-underline | |
inverted | |
inverted-light | |
modal | |
no-parent-value | |
ok-label | |
placeholder | |
popover | |
prefix | |
stack-label | |
suffix | |
warning | 
QColor事件
| 旧版 | v1 | 
|---|---|
@clear(clearVal) | 
QColor方法
| 旧版 | v1 | 
|---|---|
clear() | |
hide() | |
show() | |
toggle() | 
QContextMenu
- 已删除,将QMenu与
context-menu属性一起使用 
QDatePicker
- 被QDate替换
 
QDate属性
| 旧版 | v1 | 
|---|---|
color | |
dark | |
disable | |
disable-year-month | |
event-color | |
events | |
first-day-of-week | |
landscape | |
minimal | |
options | |
readonly | |
text-color | |
today-btn | 
QDatetime
QDatetimePicker
QDialog
QDialog属性
| 旧版 | v1 | 
|---|---|
cancel | |
color | |
ok | |
message | |
options | |
prevent-close | persistent | 
prompt | |
stack-buttons | |
title | |
content-class | |
content-style | |
full-height | |
full-width | |
maximized | |
seamless | |
no-refocus | |
no-focus | |
auto-close | |
transition-hide | |
transition-show | 
QDialog事件
| 旧版 | v1 | 
|---|---|
@ok() | |
@cancel() | |
@hide() | |
@show() | |
@before-hide | |
@before-show | |
@shake | 
QDialog方法
| 旧版 | v1 | 
|---|---|
hide(evt) | |
show(evt) | |
toggle(evt) | 
QDialog插槽
| 旧版 | v1 | 
|---|---|
body | |
buttons | |
message | |
title | 
QFab (浮动操作按钮)
QFab事件
| 旧版 | v1 | 
|---|---|
@hide() | |
@show() | |
@before-hide(evt) | |
@before-show(evt) | 
QFab插槽
| 旧版 | v1 | 
|---|---|
tooltip | 
QFabAction
QField
如果使用它包裹Input,只需将所有属性从QField移到QInput。 如果您使用error和error-label,请在QInput上启用bottom-slots,并将error-label更改为error-message。
QIcon
QIcon属性
| 旧版 | v1 | 
|---|---|
left | |
right | 
QInfiniteScroll
替换:handler为@load.
QInfiniteScroll属性
| 旧版 | v1 | 
|---|---|
handler | |
inline | |
disable | 
QInfiniteScroll事件
| 旧版 | v1 | 
|---|---|
@load(index, done) | 
QInfiniteScroll方法
| 旧版 | v1 | 
|---|---|
loadMore() | trigger | 
updateScrollTarget | 
QInfiniteScroll插槽
| 旧版 | v1 | 
|---|---|
message | loading | 
QInnerLoading
size类型从string|number更改为string
QInnerLoading属性
| 旧版 | v1 | 
|---|---|
visible | |
showing | |
transition-hide | |
transition-show | 
QInput
stack-label类型从string更改为booleanautofocus类型从boolean|string更改为boolean
QInput属性
| 旧版 | v1 | 
|---|---|
after | |
align | |
before | |
clear-value | |
decimals | |
float-label | |
hide-underline | |
initial-show-password | |
inverted | |
inverted-light | |
lower-case | |
max-height | |
no-parent-field | |
no-pass-toggle | |
numeric-keyboard-toggle | |
step | |
upper-case | |
warning | |
autogrow | |
bg-color | |
borderless | |
bottom-slots | |
counter | |
debounce | |
dense | |
error-message | |
fill-mask | |
filled | |
hide-hint | |
hint | |
input-class | |
input-style | |
items-aligned | |
label | |
lazy-rules | |
mask | |
maxlength | |
outlined | |
rounded | |
rules | |
square | |
standout | |
unmasked-value | 
QInput方法
| 旧版 | v1 | 
|---|---|
clear() | |
select() | |
togglePass() | |
resetValidation() | |
validate(value) | 
QInput插槽
| 旧版 | v1 | 
|---|---|
prepend | |
append | |
before | |
after | |
error | |
hint | |
counter | 
QItem
QItem属性
| 旧版 | v1 | 
|---|---|
event | |
highlight | |
inset-separator | |
link | |
multiline | |
separator | |
sparse | |
clickable | |
disabled | |
focused | |
inset-level | |
manual-focus | |
tabindex | 
QItem事件
| 旧版 | v1 | 
|---|---|
@click(evt) | |
@keyup(evt) | 
QItemMain
- 已删除, 使用QItemLabel
 
QItemSeparator
- 被QSeparator替换
 
QSeparator属性
| 旧版 | v1 | 
|---|---|
color | |
dark | |
inset | |
spaced | |
vertical | 
QItemSide
- 已删除, 使用QItemSection
 
QItemTile
- 已删除, 使用QItemSection
 - 带
label属性的QItemTile, 使用带header属性的QItemLabel - 带
sublabel属性的QItemTile, 使用带caption属性QItemLabel 
QJumbotron
- 已删除, 使用QCard
 
QKnob
QKnob属性
| 旧版 | v1 | 
|---|---|
decimals | |
line-width | |
angle | |
center-color | |
font-size | |
show-value | |
tabindex | |
thickness | 
QLayout
QLayout属性
| 旧版 | v1 | 
|---|---|
@resize() | @resize(size) | 
@scroll() | @scroll(details) | 
@scroll-height() | @scroll-height(height) | 
QLayoutDrawer
- 重命名为QDrawer
 
QDrawer属性
| 旧版 | v1 | 
|---|---|
no-hide-on-route-change | |
bordered | |
elevated | 
QDrawer方法
| 旧版 | v1 | 
|---|---|
on-layout | |
hide | |
show | |
toggle | 
QLayoutHeader和QLayoutFooter
QFooter属性
| 旧版 | v1 | 
|---|---|
bordered | |
elevated | |
reveal | 
QHeader属性
| 旧版 | v1 | 
|---|---|
bordered | |
elevated | |
reveal | |
reveal-offset | 
QList
QList属性
| 旧版 | v1 | 
|---|---|
highlight | |
inset-separator | |
link | |
no-border | |
sparse | |
striped | |
striped-odd | 
QListHeader
- 已删除, 使用带
header属性的QItemLabel 
QModal
- 已删除, 使用QDialog
 
QModalLayout
QOptionGroup
QOptionGroup属性
| 旧版 | v1 | 
|---|---|
no-parent-group | |
readonly | |
dense | 
QPagination
QPagination方法
| 旧版 | v1 | 
|---|---|
set(pageNumber) | |
setOffset(offset) | 
QParallax
QParallax事件
| 旧版 | v1 | 
|---|---|
@scroll(percentage) | 
QParallax插槽
| 旧版 | v1 | 
|---|---|
loading | |
content | 
QPopover
- 被QMenu替换
 anchor类型从object更改为stringself类型从object更改为stringoffset类型从array of 2 numbers更改为array
QMenu属性
| 旧版 | v1 | 
|---|---|
anchor-click | |
disabled | |
keep-on-screen | |
auto-close | |
context-class | |
context-menu | |
context-style | |
max-width | |
no-parent-event | |
target | |
transition-hide | |
transition-show | 
QMenu事件
| 旧版 | v1 | 
|---|---|
@before-hide(evt) | |
@before-show(evt) | |
@escape-key | 
QMenu方法
| 旧版 | v1 | 
|---|---|
hide(evt) | |
show(evt) | |
toggle(evt) | |
updatePosition() | 
QPopupEdit
QPopupEdit属性
| 旧版 | v1 | 
|---|---|
keep-on-screen | |
validate | 
QPopupEdit方法
| 旧版 | v1 | 
|---|---|
cancel() | |
set() | 
QPopupEdit插槽
| 旧版 | v1 | 
|---|---|
title | 
QProgress
- 被QLinearProgress替换(或者, 使用 QCircularProgress)
 
QLinearProgress属性
| 旧版 | v1 | 
|---|---|
animate | |
height | |
keep-on-percentage | |
dark | |
query | |
reverse | |
rounded | |
track-color | 
QPullToRefresh
QPullToRefresh属性
| 旧版 | v1 | 
|---|---|
handler | use refresh event | 
distance | |
inline | |
pull-message | |
release-message | |
refresh-icon | |
refresh-message | |
icon | |
no-mouse | 
QPullToRefresh事件
| 旧版 | v1 | 
|---|---|
@refresh(done) | 
QRadio
QRadio属性
| 旧版 | v1 | 
|---|---|
checked-icon | |
no-focus | |
readonly | |
unchecked-icon | 
QRange
QRange属性
| 旧版 | v1 | 
|---|---|
decimals | |
error | |
fill-handle-always | |
square | |
warning | 
QRating
max类型从number更改为string|number
QResizeObservable
- 重命名为QResizeObserver
 
QRouteTab
name类型从string更改为string|numberalert类型从boolean更改为boolean|stringlabel类型从string更改为string|numberto类型从string|object更改为any- 再也不用在其上使用
slot="title" 
QRouteTab属性
| 旧版 | v1 | 
|---|---|
color | |
count | |
hidden | |
hide | 
QRouteTab方法
| 旧版 | v1 | 
|---|---|
select() | 
QScrollArea
delay类型从number更改为string|number
QScrollObservable
- 重命名为QScrollObserver
 
QSearch
- 已删除, 使用带
debounce属性的QInput (以及append或prepend插槽上的一些可选图标) 
QSelect
stack-label类型从string更改为booleandisplay-value类型从string更改为string|number- 当选项列表是一个对象数组(而不是简单的字符串或数字)时,升级程序可能希望打开
emit-value和map-options标志以保留以前版本的行为。 在选择时,1.0默认会发出整个对象,而不仅仅是value属性。 
QSelect属性
| 旧版 | v1 | 
|---|---|
after | |
before | |
chips | |
chips-bg-color | |
chips-color | |
clear-value | |
filter | |
filter-placeholder | |
float-label | |
hide-underline | |
inverted | |
inverted-light | |
no-parent-field | |
popup-cover | |
popup-max-height | |
radio | |
separator | |
toggle | |
warning | 
QSelect插槽
| 旧版 | v1 | 
|---|---|
prepend | |
append | |
before | |
after | |
error | |
hint | |
counter | |
selected | |
no-option | |
loading | |
selected-item | |
option | 
QSlider
QSlider属性
| 旧版 | v1 | 
|---|---|
decimals | |
error | |
fill-handle-always | |
square | |
warning | 
QSpinnerMat
- 已删除, 使用QSpinner
 
QStep
name类型从string|number更改为any
QStep属性
| 旧版 | v1 | 
|---|---|
default | |
order | |
subtitle | 
QStepper
done-icon类型从boolean更改为stringactive-icon类型从boolean更改为stringerror-icon类型从boolean更改为string
QStepper属性
| 旧版 | v1 | 
|---|---|
color | |
contractable | |
no-header-navigation | 
QStepper插槽
| 旧版 | v1 | 
|---|---|
navigation | 
QTab
name类型从string更改为string|numberalert类型从boolean更改为boolean|stringlabel类型从string更改为string|numbertabindex类型从number更改为string- 再也不用在其上使用
slot="title" 
QTab属性
| 旧版 | v1 | 
|---|---|
color | |
count | |
default | |
hidden | |
hide | 
QTab插槽
| 旧版 | v1 | 
|---|---|
title | 
QTab方法
| 旧版 | v1 | 
|---|---|
select() | 
QTable
filter - 类型String更改为String,Object
QTable属性
| 旧版 | v1 | 
|---|---|
selected-rows-label | |
pagination-label | |
bordered | |
flat | |
wrap-cells | 
QTable事件
| 旧版 | v1 | 
|---|---|
@fullscreen() | |
@request() | @request(pagination, filter, getCellValue) | 
@update:pagination(newPagination) | |
@update:selected(newSelected) | 
QTable方法
| 旧版 | v1 | 
|---|---|
clearSelection() | |
isRowSelected(key) | |
nextPage() | |
prevPage() | |
requestServerInteraction(props) | |
setPagination(pagination, forceServerRequest) | |
sort(col) | |
toggleFullscreen() | 
QTable插槽
| 旧版 | v1 | 
|---|---|
body-cell | |
header-cell | 
QTableColumns
- 已删除, 使用将列作为选项的
QSelect(参见文档中的例子) 
QTabPane
- 已删除, 使用 QTabPanels和QTabPanel (在QTab之外)
 
QTabs
从所有选项卡中删除slot="title"。 不再需要了。 如果将QTab与QTabPanes一起使用,请将其从QTab容器中取出,然后放入单独的QTabPanel容器中。 将v-model放在两个容器上,并将其指向相同的变量。 如果在某些选项卡上具有default,则将其名称作为模型的默认值。
QTabs属性
| 旧版 | v1 | 
|---|---|
animated | |
color | |
glossy | |
inverted | |
panes-container-class | |
position | |
swipeable | |
text-color | |
two-lines | |
underline-color | indicator-color | 
no-pane-border | |
breakpoint | |
active-color | |
active-bg-color | |
indicator-color | |
left-icon | |
right-icon | |
switch-indicator | |
narrow-indicator | |
inline-label | |
no-caps | |
dense | 
QTab事件
| 旧版 | v1 | 
|---|---|
select | 
QTabs方法
| 旧版 | v1 | 
|---|---|
go(offset) | |
next() | |
previous() | |
selectTab(name) | 
QTimeline
QTimeline属性
| 旧版 | v1 | 
|---|---|
no-hover | |
responsive | 
QTimelineEntry
QTimelineEntry插槽
| 旧版 | v1 | 
|---|---|
subtitle | |
title | 
QTimePicker
- 被QTime替换
 
QTime属性
| 旧版 | v1 | 
|---|---|
color | |
dark | |
disable | |
format24h | |
hour-options | |
landscape | |
minute-options | |
now-btn | |
options | |
readonly | |
second-options | |
text-color | |
with-seconds | 
QToggle
val类型从object更改为any- 删除了
checked-icon和indeterminate-icon,以使QCheckbox更符合Material标准。 如果仍然需要类似的功能,请考虑将QToggle与图标结合使用。 
QToggle属性
| 旧版 | v1 | 
|---|---|
no-focus | |
readonly | |
dense | |
tabindex | 
QToolbar
QToolbar属性
| 旧版 | v1 | 
|---|---|
color | |
glossy | |
inverted | |
shrink | |
text-color | |
inset | 
QToolbar插槽
| 旧版 | v1 | 
|---|---|
subtitle | 
QTooltip
QTooltip属性
| 旧版 | v1 | 
|---|---|
disabled | |
content-class | |
content-style | |
max-width | |
target | |
transition-hide | |
transition-show | 
QTooltip事件
| 旧版 | v1 | 
|---|---|
@before-hide(evt) | |
@before-show(evt) | |
@hide(evt) | |
@input(value) | |
@show(evt) | 
QTooltip方法
| 旧版 | v1 | 
|---|---|
updatePosition() | 
QTree
QTree属性
| 旧版 | v1 | 
|---|---|
selected-color | 
QTree事件
| 旧版 | v1 | 
|---|---|
@lazy-load(details) | |
@update:expanded(expanded) | |
@update:selected(target) | |
@update:ticked(target) | 
QTree方法
| 旧版 | v1 | 
|---|---|
setExpanded(key, state) | |
setTicked(keys, state) | 
QUploader
headers类型从object更改为function|arrayurl类型从string更改为function|stringmethod类型从string更改为function|string
QUploader属性
| 旧版 | v1 | 
|---|---|
additional-fields | form-fields | 
after | |
align | |
auto-expand | |
before | |
clear-value | |
clearable | |
error | |
expand-style | |
extensions | |
float-label | |
hide-underline | |
hide-upload-button | hide-upload-btn | 
hide-upload-progress | |
inverted | |
inverted-light | |
name | |
no-content-type | |
no-parent-field | |
placeholder | |
prefix | |
stack-label | |
suffix | |
upload-factory | |
url-factory | |
warning | |
accept | |
auto-upload | |
factory | |
batch | |
bordered | |
field-name | |
label | |
flat | |
max-file-size | |
max-total-size | |
square | |
text-color | 
QUploader事件
| 旧版 | v1 | 
|---|---|
@fail(file, xhr) | @failed({ files, xhr }) | 
@remove:abort(file) | |
@remove:cancel(file) | |
@remove:done(file) | |
@uploaded(file, xhr) | @uploaded({ files, xhr }) | 
@uploading({ files, xhr }) | 
QUploader方法
| 旧版 | v1 | 
|---|---|
add(files) | addFiles(files) | 
pick() | pickFiles() | 
removeFile(file) | |
removeQueuedFiles() | |
removeUploadedFiles() | 
QUploader插槽
| 旧版 | v1 | 
|---|---|
header | |
list | 
QWindowResizeObservable
- 已删除, 直接使用
this.$q.screen.width和this.$q.screen.height(或在其上创建观察者)