@jxyszb/jxy-form-designer 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## Unreleased
+
+## 0.3.1 - 2026-10-19
+
+- 普通上传、拖拽上传和图片上传的新建默认大小限制改为 20MB，已有配置保持不变。
+- 字段增加伪必填开关，只显示标签星号；与真实必填互斥，不参与校验。
+
+## 0.3.0 - 2026-10-16
+
+- Schema 升级为 1.4.0，兼容迁移 1.0.0 至 1.3.0。
+- 普通上传增加按需模板下载，支持独立模板数据源、实时参数和宿主下载适配。
+- provider 增加可选 downloadTemplate，预览通过 mock 展示下载信息。
+- 数据源和字段选择支持搜索；字段选项同时展示中文标题与 prop。
+- 模板引用纳入类型校验、删除清理、导入 ID 重映射和 Undo/Redo。
+
 ## 0.2.0
 
 - 保存草稿和发布按钮支持独立名称与显示配置。

package/README.md

@@ -6,7 +6,7 @@ A schema-driven form designer and runtime for Vue 3, Pinia, and Element Plus.
 
 - Drag-and-drop form design with fields, titles, and grid layouts.
 - Runtime rendering from JSON Schema.
-- Static, dictionary, and API data sources.
+- Static, dictionary, API, and on-demand template-download data sources.
 - Validation, field reactions, import/export, and preview.
 - Host adapters for request clients, file upload, rich-text editors, and custom fields.
 
@@ -46,6 +46,9 @@ Dynamic data sources, uploads, and rich-text fields can use host adapters:
 ```js
 app.use(createJxyFormPlugin({
   request: requestClient,
+  // JXY framework example: keep the method receiver so its internal this remains valid.
+  downloadFile: (url, params, fileName) =>
+    app.config.globalProperties.$custom.downFile(params, fileName, url),
   components: {
     fileUpload: FileUpload,
     editor: RichTextEditor
@@ -103,7 +106,18 @@ Schema utilities are also available from `@jxyszb/jxy-form-designer/schema`. The
 
 ## Documentation
 
+Normal upload fields (`file`) support a template download button:
+
+1. Add a `templateDownload` data source with a relative `url`, `params`, and optional `fileName`.
+2. Enable template download in the field properties and select that source.
+3. Provide `downloadFile` through the plugin, or `downloadTemplate(url, params, fileName)` through a custom provider.
+
+The button appears after the upload component and only requests on click. Required parameters use current form values. A configured file name overrides the backend name; leave it empty to use the host downloader's response-header handling. Global form disabled/view mode hides the button; individual field disabled states do not. Existing synchronous JXY download utilities are supported without download loading or duplicate-click protection.
+
+An explicit Runtime provider overrides the plugin provider entirely. Preview providers must implement `downloadTemplate`; the included mock displays request details and never downloads a real file. Upgrade Runtime before publishing Schema `jxy-form-schema@1.4.0`.
+
 - [Field suffix extension](<docs/JXY 表单字段右侧扩展位使用说明.md>)
+- [Designer configuration and template downloads](<docs/JXY Form Designer 开发者说明.md>)
 - [Designer developer guide](docs/designer-save-publish-events.md)
 
 ## License