fast-element-plus 2.0.26 → 2.0.28

package/CHANGELOG.md

@@ -4,6 +4,39 @@ All notable changes to this project are documented in this file.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and releases should follow [Semantic Versioning](https://semver.org/).
 
+## [2.0.28] - 2026-11-13
+
+### Added
+
+- Add the optional read-only `isOrderBy` field to `PagedInput`.
+- Support `FaImage` slot `viewerPlaceholder`, selection tag and label slot scopes, image upload slots, and underlying input instance methods on `FaCarNumber`.
+- Let `FaFormItem` display a string or number directly with `value`, and forward `created` from `FaSelectOption` to `ElOption`.
+
+### Fixed
+
+- Use explicit image preview sources and honor table empty text, the column `filterIcon` slot, and the column expansion slot scope.
+- Apply `FaTable` inline styles to its outer wrapper, render the append slot only when supplied, and forward custom headers and overflow-tooltip options in `FaTableColumn`.
+- Keep `FaFormItem` label tips visible when using a custom label slot.
+- Forward cached tree nodes and support native node loading in `FaTreeSelect`.
+- Invoke native upload preview callbacks from the image upload components' custom preview controls.
+
+### Changed
+
+- Rename the `FaImage` error slot from `viewer-error` to `viewerError`.
+- Improve detail form layout with taller lines, baseline alignment, and wrapping for long content.
+- Update the minimum Element Plus version to `2.14.8`.
+- Rename the stylesheet export from `fast-element-plus/style.css` to `fast-element-plus/index.css`. Update existing imports when upgrading.
+
+## [2.0.27] - 2026-11-10
+
+### Fixed
+
+- Pass string and numeric `FaTree` `initParam` values directly to `requestApi` on initial load and refresh. Object queries still merge the current `searchValue`.
+
+### Documentation and Tooling
+
+- Allow Promise-returning callbacks in TSX and SFC object properties and clarify the rules for JSX attributes.
+
 ## [2.0.26] - 2026-10-20
 
 ### Changed
@@ -300,6 +333,8 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - Scoped Table styles and added responsive IconSelector styling.
 - Improved dialogs, drawers, tables, forms, trees, selectors, car-number input, images, and uploads for dark mode, touch input, and narrow viewports.
 
+[2.0.28]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.27...v2.0.28
+[2.0.27]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.26...v2.0.27
 [2.0.26]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.25...v2.0.26
 [2.0.25]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.24...v2.0.25
 [2.0.24]: https://gitee.com/FastDotnet/fast.element.plus/compare/v2.0.23...v2.0.24

package/README.md

@@ -22,7 +22,7 @@ This SDK is not a drop-in replacement for Element Plus; business defaults, event
 
 - ES2022 modern browsers or WebViews.
 - Vue `^3.5.11`.
-- Element Plus `^2.14.5`.
+- Element Plus `^2.14.8`.
 - Element Plus Icons `^2.3.2`.
 - Fast.Element.Plus.Icons `^2.0.0`.
 
@@ -51,13 +51,13 @@ The jsDelivr entry uses `dist/index.global.min.js`. Load Vue, Element Plus, Elem
 	<head>
 		<meta charset="UTF-8" />
 		<title>Fast Element Plus</title>
-		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/element-plus@2.14.5/dist/index.css" />
+		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/element-plus@2.14.8/dist/index.css" />
 		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.css" />
 	</head>
 	<body>
 		<div id="app"></div>
 		<script src="https://cdn.jsdelivr.net/npm/vue@3.5.11/dist/vue.global.prod.js"></script>
-		<script src="https://cdn.jsdelivr.net/npm/element-plus@2.14.5/dist/index.full.min.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/element-plus@2.14.8/dist/index.full.min.js"></script>
 		<script src="https://cdn.jsdelivr.net/npm/@element-plus/icons-vue@2.3.2/dist/index.iife.min.js"></script>
 		<script src="https://cdn.jsdelivr.net/npm/@fast-element-plus/icons-vue/dist/index.global.min.js"></script>
 		<script src="https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.global.min.js"></script>
@@ -80,7 +80,7 @@ Register the complete component library:
 import { createApp } from "vue";
 import "element-plus/dist/index.css";
 import FastElementPlus from "fast-element-plus";
-import "fast-element-plus/style.css";
+import "fast-element-plus/index.css";
 import App from "./App.vue";
 
 createApp(App).use(FastElementPlus).mount("#app");
@@ -93,7 +93,7 @@ Fast.Element.Plus uses Element Plus CSS Variables and supports its official `htm
 ```ts
 import "element-plus/dist/index.css";
 import "element-plus/theme-chalk/dark/css-vars.css";
-import "fast-element-plus/style.css";
+import "fast-element-plus/index.css";
 
 document.documentElement.classList.toggle("dark", isDark);
 ```
@@ -150,7 +150,7 @@ When using internal loading for asynchronous work, finish through the click `don
 | Constants  | `FaMimeType`, `RegExps`                                                                                                                                                                                                                                                                                                                                                                  |
 | Utilities  | `Decimal`, `install`, `version`                                                                                                                                                                                                                                                                                                                                                          |
 
-The package root is the only JavaScript API entry. `fast-element-plus/global` provides Vue global declarations, and `fast-element-plus/style.css` provides the component styles. Files under `dist/` are implementation details.
+The package root is the only JavaScript API entry. `fast-element-plus/global` provides Vue global declarations, and `fast-element-plus/index.css` provides the component styles. When upgrading from 2.0.27, replace imports of `fast-element-plus/style.css`. Files under `dist/` are implementation details.
 
 Open-ended business rows, paging extensions, selector/tree payloads, request parameters, and dynamic configuration use `any` where the SDK cannot know the application schema; exported generics can constrain known models. Untrusted runtime inputs, errors, and values that require validation remain `unknown`. `DefaultRow` is the public default FaTable row type for business tables whose fields are not declared in advance.
 

package/README.zh.md

@@ -22,7 +22,7 @@
 
 - 支持 ES2022 的现代浏览器或 WebView。
 - Vue `^3.5.11`。
-- Element Plus `^2.14.5`。
+- Element Plus `^2.14.8`。
 - Element Plus Icons `^2.3.2`。
 - Fast.Element.Plus.Icons `^2.0.0`。
 
@@ -51,13 +51,13 @@ jsDelivr 入口为 `dist/index.global.min.js`。页面先加载 Vue、Element Pl
 	<head>
 		<meta charset="UTF-8" />
 		<title>Fast Element Plus</title>
-		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/element-plus@2.14.5/dist/index.css" />
+		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/element-plus@2.14.8/dist/index.css" />
 		<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.css" />
 	</head>
 	<body>
 		<div id="app"></div>
 		<script src="https://cdn.jsdelivr.net/npm/vue@3.5.11/dist/vue.global.prod.js"></script>
-		<script src="https://cdn.jsdelivr.net/npm/element-plus@2.14.5/dist/index.full.min.js"></script>
+		<script src="https://cdn.jsdelivr.net/npm/element-plus@2.14.8/dist/index.full.min.js"></script>
 		<script src="https://cdn.jsdelivr.net/npm/@element-plus/icons-vue@2.3.2/dist/index.iife.min.js"></script>
 		<script src="https://cdn.jsdelivr.net/npm/@fast-element-plus/icons-vue/dist/index.global.min.js"></script>
 		<script src="https://cdn.jsdelivr.net/npm/fast-element-plus/dist/index.global.min.js"></script>
@@ -80,7 +80,7 @@ jsDelivr 入口为 `dist/index.global.min.js`。页面先加载 Vue、Element Pl
 import { createApp } from "vue";
 import "element-plus/dist/index.css";
 import FastElementPlus from "fast-element-plus";
-import "fast-element-plus/style.css";
+import "fast-element-plus/index.css";
 import App from "./App.vue";
 
 createApp(App).use(FastElementPlus).mount("#app");
@@ -93,7 +93,7 @@ Fast.Element.Plus 使用 Element Plus CSS Variables，并兼容其官方 `html.d
 ```ts
 import "element-plus/dist/index.css";
 import "element-plus/theme-chalk/dark/css-vars.css";
-import "fast-element-plus/style.css";
+import "fast-element-plus/index.css";
 
 document.documentElement.classList.toggle("dark", isDark);
 ```
@@ -132,7 +132,7 @@ useOverlay.show();
 | 常量 | `FaMimeType`、`RegExps`                                                                                                                                                                                                                                                                                                                                                                  |
 | 工具 | `Decimal`、`install`、`version`                                                                                                                                                                                                                                                                                                                                                          |
 
-包根入口是唯一 JavaScript API 入口；`fast-element-plus/global` 提供 Vue 全局声明，`fast-element-plus/style.css` 提供组件样式。`dist/` 下的其他文件均为实现细节。
+包根入口是唯一 JavaScript API 入口；`fast-element-plus/global` 提供 Vue 全局声明，`fast-element-plus/index.css` 提供组件样式。从 2.0.27 升级时，将原来的 `fast-element-plus/style.css` 导入替换为新路径。`dist/` 下的其他文件均为实现细节。
 
 业务行、分页扩展字段、选择器与树节点附加数据、请求参数和动态配置在 SDK 无法预知应用模型时使用 `any`，已知模型可通过公开泛型约束；未经验证的运行时输入、错误对象和必须先收窄的值继续使用 `unknown`。`DefaultRow` 是 FaTable 默认公开行类型，可直接用于未预先定义字段的业务表格。