Устаревшая функциональность
Здесь собрано то, что помечено устаревшим в публичном API Q.Palette. Пока пометка действует, функциональность работает как прежде — переходить на замену можно в удобном темпе, но до выхода мажорной версии, в которой её удалят.
Всё перечисленное будет удалено в версии 9.0.0. В коде эти места помечены тегом @deprecated
с той же версией удаления и ссылкой на замену, поэтому подсказка видна прямо в редакторе.
Здесь только публичное API: то, что библиотеки отдают через public-api, и общедоступная
функциональность рутового приложения. Внутренние классы и сервисы, не входящие в публичное API,
сюда не попадают.
Подключение библиотек: forRoot() → provideQ*()
Модули с forRoot() устарели: подключайте функциональность функциями на корневом уровне приложения.
Вызовы forRoot() после перехода не действуют и удаляются из продукта. Подробности —
в инструкции по переходу на Single Bundle.
| Было | Стало | Библиотека |
|---|---|---|
QAuthModule.forRoot() | provideQAuth() | qpalette-auth |
QCoreModule.forRoot() | provideQCore() | qpalette-core |
QHttpNotificationsModule.forRoot() | provideQHttpNotifications() | qpalette-core |
QUrlModule.forRoot() | provideQUrls() | qpalette-urls |
QUrlIdempotencyModule.forRoot() | provideQUrlIdempotency() | qpalette-urls-addons |
QFileViewerModule.forRoot() | provideQFileViewer() | qpalette-file-viewer |
QPaletteFormFlowModule.forRoot() | provideQFormFlow() | qpalette-form-flow |
QPermissionsModule.forRoot() | provideQPermissions() | qpalette-permissions |
QWebComponentModule.forRoot() | provideQWebComponent() | qpalette-visual |
QWidgetModule.forRoot() | provideQWidget() | qpalette-visual |
QWidgetLoaderModule.forRoot() | provideQWidgetLoader() | qpalette-visual |
Там же устарел прежний способ передачи провайдеров: createApplication(providers) и
bootstrapStandalone() заменяются на createApplication().bootstrap(component, providers).
Режим Single Bundle (provideSingleBundle(), константа Q_WEB_COMPONENT_SERVICES) уступает место
режиму Standalone.
Переименованные классы и сервисы
| Что устарело | Чем заменить | Библиотека | Когда удалим |
|---|---|---|---|
QReportsService | QJasperReportsService | qpalette-file-viewer | 9.0.0 |
QWrapper, QWrapperModule | QWebComponent, QWebComponentModule | qpalette-visual | 9.0.0 |
QRootEventsService | QEventsService | qpalette-visual | 9.0.0 |
QNotificationComponent | компонент p-toast из PrimeNG | qpalette-visual | 9.0.0 |
QPermissionsService | QPermissionsRbacService | qpalette-permissions | 9.0.0 |
AuthInterceptor | OAuth2Interceptor | qpalette-auth | 9.0.0 |
Компонент q-ui-grid | — | qpalette-ui-grid | 9.0.0 |
Переименованные методы и свойства
| Что устарело | Чем заменить | Библиотека | Когда удалим |
|---|---|---|---|
QAuthService.isAuthenticated() | checkAuthorization() | qpalette-auth | 9.0.0 |
QGlobalEventsService: event(), onEvent(), error(), warning() | QMessagesService: error(), success(), warn(), info(), getMessages() | qpalette-core | 9.0.0 |
onChangeTheme() | onThemeChange() | qpalette-visual | 9.0.0 |
Поле selectedItem в контракте виджета для q-lookup | onValueSelect | qpalette-visual | 9.0.0 |
Поле selectedAccount в контракте виджета для q-lookup | selectedValue | qpalette-visual | 9.0.0 |
openModal() в выгрузке таблицы | export() | qpalette-table-addons | 9.0.0 |
Параметр filters в шапке таблицы | qteSearchParams | qpalette-table-addons | 9.0.0 |
close(controller) | отписка средствами RxJS | qpalette-sse-client | 9.0.0 |
Настройки конфигурации
| Что устарело | Чем заменить | Библиотека | Когда удалим |
|---|---|---|---|
singlePageMode | singlePage.enable | qpalette-core | 9.0.0 |
feedback | секция plugins со слотом header | qpalette-core | 9.0.0 |
Как перейти
QReportsService → QJasperReportsService
Старый сервис принимал логин с паролем и требовал передавать ключ доступа в каждый метод, хотя ключ
подставляет перехватчик из @diasoft/qpalette-auth. Соответствие методов:
| Было | Стало |
|---|---|
getToken({ username, password }) | не нужен — ключ доступа подставляет перехватчик |
getReports(token, JSON.stringify(params)) | createReport(params) |
getFile(token, tempKey) | downloadFile(tempKey) |
Примеры вызовов — в статье Просмотр и печать файлов.