{"id":24555768,"url":"https://github.com/byte-power/jsonpress","last_synced_at":"2025-07-29T11:09:28.235Z","repository":{"id":42394310,"uuid":"348935239","full_name":"byte-power/jsonpress","owner":"byte-power","description":"Schema based JSON editor","archived":false,"fork":false,"pushed_at":"2025-04-08T03:18:49.000Z","size":1178,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-10T07:14:32.446Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/byte-power.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-03-18T04:00:22.000Z","updated_at":"2024-11-26T01:24:45.000Z","dependencies_parsed_at":"2023-01-21T20:47:52.494Z","dependency_job_id":"bf151a4f-36a6-44dc-bc09-6c109bf5e195","html_url":"https://github.com/byte-power/jsonpress","commit_stats":{"total_commits":514,"total_committers":1,"mean_commits":514.0,"dds":0.0,"last_synced_commit":"ebebff2548cfea6be4fa0da88e327ac972944310"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/byte-power/jsonpress","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte-power%2Fjsonpress","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte-power%2Fjsonpress/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte-power%2Fjsonpress/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte-power%2Fjsonpress/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/byte-power","download_url":"https://codeload.github.com/byte-power/jsonpress/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byte-power%2Fjsonpress/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267677314,"owners_count":24126313,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-23T04:20:08.302Z","updated_at":"2025-07-29T11:09:28.209Z","avatar_url":"https://github.com/byte-power.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 使用说明\n\n## 简介\n\nJSON Press 是一款能将描述数据结构的 JSON Schema 转换为相应的 HTML 表单的前端工具库。\n\n它能快速生成以 JSON 文件作为产出物的可交互、有约束、易校验的 HTML 表单，可以对应用、游戏提供简洁快速的配置支持，避免使用原始表单组件进行大量重复的页面布局和功能开发，提高生产效率。\n\n它是 [json-editor/json-editor](https://github.com/json-editor/json-editor) 的 fork 版本，在其基础上进行了美化、修正和增强（下文用 Press 代指来注明修改之处）。\n\n## 安装\n\n推荐以 npm 方式安装\n\n`$ npm install @byte-power/json-press`\n\n## 引入\n\n以 ES6 模块形式\n\n`import {JSONEditor} from '@byte-power/json-press';`\n\n以 CommonJS 形式\n\n`let {JSONEditor} = require('@byte-power/json-press');`\n\n## 使用\n\n```javascript\nlet element = document.getElementById('editor');\nlet editor = new JSONEditor(element, options);\n```\n\n更多关于集成方面的说明，请查看 [集成指南](./docs/integration_guide.md)\n\n以下说明，面向使用 JSON Press 撰写 JSON schema 的运维和产品人员。\n\n## 原生 JSON Schema 支持\n\n编辑器支持原生的 JSON Schema 规范（v4 版），包括核心定义和校验规则。\n\n### $ref 和 definitions\n\n编辑器支持使用 `$ref` 关键字来索引外部 URL 或本地自定义类型。\n\n```javascript\nlet schema = {\n    type: 'object',\n    properties: {\n        name: {\n            title: 'Full Name',\n            $ref: '#/definitions/name'\n        },\n        location: {\n            $ref: 'http://mydomain.com/geo.json'\n        }\n    },\n    definitions: {\n        name: {\n            type: 'string',\n            minLength: 5\n        }\n    }\n};\n```\n\n本地自定义类型主要是通过定义在根节点的 `definitions` 关键字来生成。它的描述路径格式为 `#/definitions/xxx`，xxx 为定义的名字。其定义的内容除了被 `$ref` 索引，也可以被后文提到的 `anyOf`、`oneOf` 和 `allOf` 来使用。\n\n### hyper-schema\n\n编辑器支持使用 `links` 关键字来支持 schema 的扩展集合（hyper-schema），它通常用于链接外部文档或媒体资源。\n\n`links.mediaType` 属性可以让编辑器以恰当的方式显示媒体文件，而不是仅是文本方式。\n\n#### 简单文本链接\n\n```javascript\nlet schema = {\n    title: 'Blog Post Id',\n    type: 'integer',\n    links: [\n        {\n            rel: 'comments',\n            href: '/posts/{{self}}/comments/',\n            // 定义链接的样式\n            class: 'comment-link'\n        }\n    ]\n};\n```\n\n#### 创建可下载的链接\n\n```javascript\nlet schema = {\n    title: 'Document filename',\n    type: 'string',\n    links: [\n        {\n            rel: 'Download File',\n            href: '/documents/{{self}}',\n            // 表示该链接为下载链接，也可以设置为字符串形式，表示为下载文件名\n            download: true\n        }\n    ]\n};\n```\n\nPress 针对下载功能进行了增强，用于支持根据当前字段的值返回动态内容的文件下载功能。\n\n设置 `mediaType` 为 _download_ 即可启用该增强模式，同时使用 `download` 来约定下载文件的名称，使用 `getMedia` 方法来根据当前字段动态处理下载文件的内容并返回。\n\n```javascript\nlet schema = {\n    title: 'File',\n    type: 'string',\n    links: [\n        {\n            rel: 'Download File',\n            // href 设置为空\n            href: '',\n            // 开启下载增强模式\n            mediaType: 'download',\n            // 设置下载文件名（self 表示当前字段的值）\n            download: '{{self}}.json',\n            // 返回文件内容的函数，默认传入参数为当前字段的值\n            getMedia: target =\u003e {\n                if (target \u0026\u0026 this.blackList[target]) {\n                    let fileContent = JSON.stringify(this.blackList[target]);\n                    return 'data:application/file;charset=utf-8,' + encodeURI(fileContent);\n                }\n                return '';\n            }\n        }\n    ]\n};\n```\n\n#### 显示媒体预览（按 HTML5 方式）\n\n```javascript\nlet schema = {\n    title: 'Video',\n    type: 'string',\n    links: [\n        {\n            href: '/videos/{{self}}.mp4',\n            mediaType: 'video/mp4'\n        }\n    ]\n};\n```\n\n#### 显示文本弹窗\n\nPress 针对 `links` 还提供了增强功能--文本弹窗，用于展示根据当前字段值动态返回的文本内容。\n\n设置 `mediaType` 为 _info_ 即可启用该增强模式，同时使用 `getMedia` 方法来根据当前字段动态处理文本内容并返回。\n\n```javascript\nlet schema = {\n    title: 'Description',\n    type: 'string',\n    links: [\n        {\n            rel: 'Show More',\n            // href 设置为空\n            href: '',\n            // 开启文本弹窗模式\n            mediaType: 'info',\n            // 返回文本信息的函数，默认传入参数为当前字段的值\n            getMedia: target =\u003e {\n                if (target) {\n                    return this.textMap[target];\n                }\n                return '';\n            }\n        }\n    ]\n};\n```\n\n\u003e self 表示当前字段的值\n\n### 属性排序\n\n原生的 schema 规范是不支持对属性进行排序的。编辑器提供了一个关键字 `propertyOrder` 用于实现这个目的。默认值为 _1000_，假如遇到相同的值，按标准 JSON 键值进行排序。\n\n```javascript\nlet schema = {\n    type: 'object',\n    properties: {\n        prop1: {\n            type: 'string'\n        },\n        prop2: {\n            type: 'string',\n            propertyOrder: 10\n        },\n        prop3: {\n            type: 'string',\n            propertyOrder: 1001\n        },\n        prop4: {\n            type: 'string',\n            propertyOrder: 1\n        }\n    }\n};\n```\n\n最终排序结果为： prop4、prop2、prop1、prop3\n\n### 默认属性\n\n编辑器默认行为是对象所有定义在 `properties` 关键字的属性都会包括在内，可以使用 `defaultProperties` 关键字来指定若干属性来覆盖默认行为，此时除了指定属性，其他属性都不会在界面显示和包含在最终 JSON 值内。\n\n```javascript\nlet schema = {\n    type: 'object',\n    properties: {\n        name: {type: 'string'},\n        age: {type: 'integer'}\n    },\n    defaultProperties: ['name']\n};\n```\n\n### 字段提示\n\n通过 `option.infoText` 属性，可以在字段标题旁边显示一个带 hover 效果的提示图标。\n\n```javascript\nlet schema = {\n    type: 'string',\n    title: 'Name',\n    options: {\n        infoText: 'Your full name'\n    }\n};\n```\n\n\u003e infoText 说明支持用 \\n 来实现换行；这是 Press 新增特性。\n\n## 路径描述\n\n在 schema 的书写过程中，对元素的路径描述是一个常用的功能，在某些场景下发挥重要的作用，包括校验规则和依赖联动项等等。\n\n路径使用字符串形式，使用 `.` 号分隔嵌套属性，默认从根路径算起。\n\n### 绝对路径\n\n以 root 为根路径，通过 'root.XXX.XXX' 形式描述的路径为绝对路径，一般用于对象等数据格式固定的场景中。\n\n```javascript\nlet schema = {\n    foo: {\n        type: 'object',\n        properties: {\n            // 路径为 'root.foo.bar'\n            bar: {\n                type: 'string'\n            }\n        }\n    }\n};\n```\n\n### 相对路径\n\n可以使用 `id` 关键字指定参考节点，然后在其内部就可以使用相对路径来描述相邻节点的关系。这个在数组等动态变化的数据格式场景中描述路径时十分有用。\n\n```javascript\nlet schema = {\n    rewards: {\n        type: 'array',\n        items: {\n            type: 'object',\n            id: 'timeItem',\n            properties: {\n                // 路径为 'timeItem.min_time'\n                min_time: {\n                    type: 'number',\n                    relativeTo: {\n                        path: 'timeItem.max_time',\n                        limit: 'less'\n                    }\n                },\n                // 路径为 'timeItem.max_time'\n                max_time: {\n                    type: 'number',\n                    relativeTo: {\n                        path: 'timeItem.min_time',\n                        limit: 'greater'\n                    }\n                }\n            }\n        }\n    }\n};\n```\n\n## 数据类型\n\n目前 schema 支持的数据包括基础类型 `type` 和扩展格式 `format`，通过这两种关键字的结合设置和使用，从而满足更丰富更个性化的数据格式及交互需求。\n\n```javascript\nlet schema = {\n    valid_date_start: {\n        type: 'integer',\n        format: 'datetime-local'\n    },\n    valid_date_end: {\n        type: 'integer',\n        format: 'datetime-local'\n    }\n};\n```\n\n### 基础类型\n\n-   string\n-   boolean\n-   number\n-   integer\n-   array\n-   object\n-   info\n-   button\n\n### 扩展格式\n\n-   textarea (基于 string 扩展)\n-   date (基于 string 扩展)\n-   time (基于 string 扩展)\n-   datetime-local (基于 string 扩展)\n-   color (基于 string 扩展)\n-   starrating (基于 string 扩展)\n-   hidden (基于 string 扩展)\n-   uuid (基于 string 扩展)\n-   signature (基于 string 扩展)\n-   range (基于 number 扩展)\n-   rating (基于 integer 扩展)\n-   checkbox (基于 boolean 扩展)\n-   grid (基于 object 扩展)\n-   table (基于 array 扩展)\n-   tabs (基于 array 扩展)\n-   radio (基于 string/number/integer + enum 扩展，即单选)\n-   checkbox (基于 array + enum 扩展，即多选)\n-   select2 (基于 enum 扩展，单选多选都支持)\n\n### 汇总\n\n\u003ctable\u003e\n    \u003cthead\u003e\n        \u003ctr\u003e\n            \u003cth\u003etype\u003c/th\u003e\n            \u003cth\u003eformat\u003c/th\u003e\n            \u003cth\u003eenum\u003c/th\u003e\n            \u003cth\u003e备注\u003c/th\u003e\n        \u003c/tr\u003e\n    \u003c/thead\u003e\n    \u003ctbody\u003e\n        \u003ctr\u003e\n            \u003ctd rowspan=\"5\"\u003estring\u003c/td\u003e\n            \u003ctd\u003e\n                textarea\n                \u003cbr /\u003e\n                starrating\n                \u003cbr /\u003e\n                hidden\n                \u003cbr /\u003e\n                uuid\n            \u003c/td\u003e\n            \u003ctd\u003e无\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003e\n                date\n                \u003cbr /\u003e\n                time\n                \u003cbr /\u003e\n                datetime-local\n            \u003c/td\u003e\n            \u003ctd\u003e无\u003c/td\u003e\n            \u003ctd\u003e通过 flatpickr 支持\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003ecolor\u003c/td\u003e\n            \u003ctd\u003e无\u003c/td\u003e\n            \u003ctd\u003e通过 vanilla-picker 支持\u003c/td\u003e\n        \u003c/tr\u003e\n         \u003ctr\u003e\n            \u003ctd\u003esignature\u003c/td\u003e\n            \u003ctd\u003e无\u003c/td\u003e\n            \u003ctd\u003e通过 signature_pad 支持\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003eradio\u003c/td\u003e\n            \u003ctd\u003e有\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003eboolean\u003c/td\u003e\n            \u003ctd\u003echeckbox\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003enumber\u003c/td\u003e\n            \u003ctd\u003erange\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003einteger\u003c/td\u003e\n            \u003ctd\u003erating\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd rowspan=\"2\"\u003earray\u003c/td\u003e\n            \u003ctd\u003echeckbox\u003c/td\u003e\n            \u003ctd\u003e有\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003e\n                table\n                \u003cbr /\u003e\n                tabs\n            \u003c/td\u003e\n            \u003ctd\u003e无\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003eobject\u003c/td\u003e\n            \u003ctd\u003egrid\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003e任意类型均可\u003c/td\u003e\n            \u003ctd\u003eselect2\u003c/td\u003e\n            \u003ctd\u003e有\u003c/td\u003e\n            \u003ctd\u003e通过 select2 支持\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003einfo\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003ebutton\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n            \u003ctd\u003e\u003c/td\u003e\n        \u003c/tr\u003e\n    \u003c/tbody\u003e\n\u003c/table\u003e\n\n### string\n\n最基础的数据类型，通过指定 `format` 还能支持更多的交互和数据子类型。\n\n#### 基础用法\n\n```javascript\nlet schema = {\n    name: {\n        type: 'string',\n        title: 'User Name', // 输入框对应的 label，不提供的话默认使用 key 值\n        description: 'input text for user name', // 该字段的描述，显示在输入框下方\n        default: 'bob', // 该字段的默认值\n        pattern: '^(\\\\([0-9]{3}\\\\))?[0-9]{3}-[0-9]{4}$', // 正则表达式模板\n        required: true, // 该字段为必填项，此设置也可以放入父级对象 required 字段（形式为数组，值为当前字段名）\n        readOnly: true, // 该字段为只读模式\n        newOnly: true, // 该字段为新建模式，新建无值时可以编辑，保存后有值不能编辑\n        // 可以通过 options 关键字传入一些定制化的设定\n        options: {\n            exclude: true, // 设置该字段不包括在最终值内，此选项为 Press 新增特性\n            pattern_message: '只能输入数字', // 当外部使用 pattern 进行正则校验时，可以在此定义更易理解的提示，避免直接暴露正则表达式给用户\n            inputAttributes: {\n                placeholder: 'your name here...',\n                class: 'form-control'\n            }\n        }\n    }\n};\n```\n\n\u003e description 说明支持用 \\n 来实现换行；支持传入 options.warning 来开启警示颜色。这是 Press 新增特性。\n\n```javascript\ndescription: 'the first line \\n the second line',\noptions: {\n    warning：true\n}\n```\n\nstring 提供了一个关键字 `minLength` 用于限制字符串的最小长度。\n\n```javascript\nlet schema = {\n    type: 'string',\n    // 相当于限制该字符串不能为空\n    minLength: 1\n};\n```\n\nPress 针对 `pattern` 字段提供一个增强辅助字段 `patternValidate` ，用于提供一个根据条件判断并设置 pattern 是否生效的方法，默认传入参数为当前字段的值，返回布尔值，表明是否生效。\n\n```javascript\nlet schema = {\n    type: 'string',\n    pattern: '^(?!_)\\\\w+$',\n    patternValidate: target =\u003e {\n        // 当前字段值不等于 float 时，正则生效\n        return target !== 'float';\n    }\n};\n```\n\n#### textarea\n\n当 `format` 为 _textarea_ 时，渲染为文本域形式，可以支持输入大段文字。\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'textarea'\n};\n```\n\n#### colorpicker\n\n当 `format` 为 _color_ 时，渲染为颜色选择器形式，可以支持输入色值。通过 `options.colorpicker` 设置相关属性即可启用[vanilla-picker](https://github.com/Sphinxxxx/vanilla-picker) 第三方控件，并支持传入其原生配置。\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'color',\n    options: {\n        colorpicker: {\n            popup: 'bottom', // 弹出位置，支持 top、left、right，默认是 bottom\n            editorFormat: 'hex', // 颜色格式，支持 rgb、hsl，默认是 hex\n            alpha: true // 是否支持透明度\n        }\n    }\n};\n```\n\n#### datetime\n\n当需要输入日期或时间类的字符串值时，可以使用 `format` 来指定相应的格式。\n编辑器共提供了 3 种类型：\n\n-   date，渲染为日期选择框，返回值为 ‘YYYY-MM-DD’ 格式\n-   time，渲染为时间选择框，返回值为 ‘HH:MM’ 格式\n-   datetime-local，渲染为日期+时间选择框，返回值为 ‘YYYY-MM-DD HH:MM’ 格式\n\n通过 `options.flatpickr` 中设置相关属性，可以启用第三方控件 [flatpickr](https://github.com/flatpickr/flatpickr)，并支持传入其原生配置。\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'datetime-local',\n    options: {\n        flatpickr: {\n            inline: true, // 是否启用行内模式，即日期选择框直接显示，和 wrap 互斥\n            inlineHideInput: false, // 当启用 inline 模式时，是否隐藏原生的输入框\n            wrap: true, // 是否启用按钮群组模式，可以显示切换和清除按钮，和 inline 互斥\n            showToggleButton: false, // 当启用 wrap 模式时，是否显示切换按钮\n            showClearButton: false, // 当启用 wrap 模式时，是否显示清除按钮\n            defaultHour: 7, // 默认小时数\n            defaultMinute: 19, // 默认分钟数\n            hourIncrement: 2, // 每次点击按钮小时增量\n            minuteIncrement: 3, // 每次点击按钮分钟增量\n            enableSeconds: true, // 是否启用秒数\n            time_24hr: true, // 是否启用 24 小时制\n            allowInput: true // 是否允许手动输入\n        }\n    }\n};\n```\n\nPress 针对 datetime 类型额外实现了对象依赖限制功能：可以指定某项时间必须大于或小于另外一项时间，这项特性在设置起始时间的场景下比较有用。\n\n通过 `relativeTo` 属性来描述规则：\n\n-   通过 `path` 关键字可以指定当前项的对比目标的路径。它支持绝对路径和相对路径。\n-   通过 `limit` 关键字设置当前项相对于对比目标的规则。它支持两个值：'less' 表明小于目标对象，'greater' 表明大于目标对象。\n\n```javascript\nlet schema = {\n    valid_date_start: {\n        type: 'integer',\n        format: 'datetime-local',\n        relativeTo: {\n            path: 'root.valid_date_end',\n            limit: 'less'\n        }\n    },\n    valid_date_end: {\n        type: 'integer',\n        format: 'datetime-local',\n        relativeTo: {\n            path: 'root.valid_date_start',\n            limit: 'greater'\n        }\n    }\n};\n```\n\n#### uuid\n\n当 `format` 为 _uuid_ 时，渲染为一个只读的输入框，自动生成 uuid 格式字符串。\n\n\u003e 注： Press 对其进行了修改，输出统一为大写字母。\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'uuid',\n    description: 'uuid field with value'\n};\n```\n\n#### signature\n\n编辑器引入了 [signature pad](https://github.com/szimek/signature_pad) 第三方控件来支持签名输入。当 `format` 为 _signature_ 时，渲染为一个手写板，可以进行签名，最后图片保存为 base64 格式。通过 `options.canvas_height` 属性可以定义手写板的高度.\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'signature',\n    options: {\n        canvas_height: 200\n    }\n};\n```\n\n#### ip\n\n可以使用 `format` 关键字指定该字段为 ip 格式（包括 _ipv4、ipv6、hostname_ 三个有效值），这时编辑器会调用相关的格式校验，以避免用户输入非法 ip 格式。\n\n```javascript\nlet schema = {\n    ipAddress: {\n        title: 'IPv4 Address',\n        type: 'string',\n        format: 'ipv4'\n    },\n    ipv6Address: {\n        title: 'IPv6 Address',\n        type: 'string',\n        format: 'ipv6'\n    },\n    hostname: {\n        title: 'hostname',\n        type: 'string',\n        format: 'hostname'\n    }\n};\n```\n\n#### upload\n\n编辑器内置了一个上传控件，可以支持相关文件的上传。\n\n启用方法：\n\n-   首先设置 `format` 为 _url_，同时通过 `options.upload` 中设置相关属性，即可启用一个带文件预览和上传进度的上传控件。\n-   在相关属性内，使用 `upload_handler` 关键字可以指定一个上传的处理函数。该回调函数有三个参数 _path, file, callback_。\n\n    -   path：上传控件对应的路径字段。它支持绝对路径\n    -   file：上传控件选中的文件\n    -   callback：回调对象（提供了 success、failure、updateProgress 方法）\n        -   success：成功的回调方法，用于给控件对应的字段赋值\n        -   failure：失败的回调方法，用于控件显示错误提示信息\n        -   updateProgress：上传进度的回调方法，用于控件实时渲染进度提示\n\n    也可以设置该属性为函数名称，然后通过全局统一定义管理回调函数，请参考[集成指南](./docs/integration_guide.md#upload)的对应部分\n\n-   可以通过 `links` 关键字设置上传成功后的回显：默认是显示文件完整路径，可以用 `rel` 为 _view_ 来仅显示 view 字样的链接\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'url',\n    options: {\n        upload: {\n            upload_handler: function (path, file, callback) {\n                if (path === 'root.uploadfail') {\n                    callback.failure('Upload failed');\n                } else {\n                    let step = 0;\n\n                    let tickFunction = function () {\n                        step += 1;\n                        console.log('progress: ' + step);\n\n                        if (step \u003c 100) {\n                            callback.updateProgress(step);\n                            window.setTimeout(tickFunction, 50);\n                        } else if (step == 100) {\n                            callback.updateProgress();\n                            window.setTimeout(tickFunction, 500);\n                        } else {\n                            callback.success('http://www.example.com/images/' + file.name);\n                        }\n                    };\n\n                    window.setTimeout(tickFunction);\n                }\n            }\n        }\n    },\n    links: [\n        {\n            href: '{{self}}',\n            rel: 'view'\n        }\n    ]\n};\n```\n\n#### base64\n\n针对小型文件的内容录入，可以不使用 upload 控件上传并返回路径，而用 base64 的方式，直接将文件嵌入字段中。\n我们只需要设置 `media.binaryEncoding` 为 _base64_ 即可。这时字段会渲染为文件控件，但是不带上传功能，所选中的文件内容会编码为 base64 格式，并随着整体 JSON 数据一起提交。\n\n```javascript\nlet schema = {\n    type: 'string',\n    media: {\n        binaryEncoding: 'base64',\n        type: 'img/png'\n    }\n};\n```\n\n#### hidden\n\n对于不需要在界面显示和编辑的隐藏值，可以使用 hidden 类型来解决。\n\nhidden 控件实现有两种方法：\n\n-   通过 `format` 关键字设置为 _hidden_ 实现，字段输入控件不在界面显示，但是字段标题 label 还会渲染\n-   通过 `options.hidden` 属性设置为 _true_ 实现，整个字段不在界面显示，但是最终 JSON 值包含该字段值\n-   通过 `options.exclude` 属性设置为 _true_ 实现，整个字段不包含在最终 JSON 值，此选项为 Press 新增特性\n\n```javascript\nlet schema = {\n    hidden: {\n        type: 'string',\n        options: {\n            hidden: true\n        }\n    },\n    hiddenAnother: {\n        type: 'string',\n        format: 'hidden'\n    },\n    excludeValue: {\n        type: 'string',\n        options: {\n            exclude: true\n        }\n    }\n};\n```\n\n#### autocomplete\n\n编辑器引入了 [autocomplete](https://github.com/trevoreyre/autocomplete) 第三方控件用于实现输入时自动完成效果，优化交互和体验。设置 format 为 _autocomplete_，就可以启用。\n\n启用方法：\n\n-   首先设置 `format` 为 _autocomplete_，同时通过 `options.autocomplete` 设置相关属性，即可启用一个带自动完成的输入控件。\n-   在相关属性内，\n    -   使用 `search` 关键字指定一个搜索函数并异步返回结果。该回调函数有一个参数，表示当前输入值；\n    -   使用 `renderResult` 关键字指定一个函数处理上述返回结果并渲染到备选下拉框。该回调函数有两个参数，分别表示单个备选结果及其相关属性；\n    -   使用 `getResultValue` 关键字指定一个函数处理选中项并返回结果用于渲染。该回调函数有一个参数，表示当前选中值；\n    -   使用 `autoSelect` 关键字设置是否自动选择列表第一个项。\n-   也可以设置上述属性为函数名称，然后通过全局统一定义管理回调函数，请参考[集成指南](./docs/integration_guide.md#autocomplete)的对应部分\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'autocomplete',\n    options: {\n        autocomplete: {\n            search: function search(input) {\n                let url =\n                    'https://en.wikipedia.org/w/api.php?action=query\u0026list=search\u0026format=json\u0026srsearch=' +\n                    encodeURI(input);\n\n                return new Promise(function (resolve) {\n                    if (input.length \u003c 3) {\n                        return resolve([]);\n                    }\n\n                    fetch(url)\n                        .then(function (response) {\n                            return response.json();\n                        })\n                        .then(function (data) {\n                            resolve(data.query.search);\n                        });\n                });\n            },\n            renderResult: function (result, props) {\n                return `\u003cli ${props}\u003e${result.title}\u003c/li\u003e`;\n            },\n            getResultValue: function (result) {\n                return result.title;\n            },\n            autoSelect: true\n        }\n    }\n};\n```\n\n#### SCEditor\n\n[**SCEditor**](https://github.com/samclarke/SCEditor) 是一个提供基于 HTML 和 BBCode 格式的所见即所得（WYSIWYG）编辑器。它作为第三方控件被引入，启用也很简单：`format` 设置为 _xhtml_ 或 _bbcode_ ，然后设置 `options.wysiwyg` 为 true 即可。\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'xhtml',\n    options: {\n        wysiwyg: true\n    }\n};\n```\n\n#### SimpleMDE\n\n[**SimpleMDE**](https://github.com/sparksuite/simplemde-markdown-editor) 是一个提供动态预览的简单 Markdown 编辑器。它作为第三方控件被引入，`format` 设置为 _markdown_ 即可启用。\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'markdown'\n};\n```\n\n#### Ace Editor\n\n[**Ace Editor**](https://github.com/ajaxorg/ace) 是一个支持语法高亮的源代码编辑器，它作为第三方控件被引入，`format` 设置为对应值即可启用相应语法高亮和检查。\n\n支持格式如下：\n\n-   c\n-   cpp (alias for c++)\n-   csharp\n-   css\n-   less\n-   sass\n-   scss\n-   dart\n-   golang\n-   html\n-   ini\n-   java\n-   javascript\n-   json\n-   lua\n-   makefile\n-   php\n-   python\n-   ruby\n-   sql\n-   pgsql\n-   mysql\n-   xml\n-   yaml\n\n同时 还能通过 `options.ace` 传入 Ace Editor 的原生支持选项\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'sql',\n    options: {\n        ace: {\n            theme: 'ace/theme/vibrant_ink',\n            tabSize: 2,\n            wrap: true\n        }\n    }\n};\n```\n\n#### 结合 enum 属性\n\n当通过 enum 属性提供了可选枚举值后，string 类型会被渲染为下拉选择框。假如设置 `format` 为 _radio_，就可以切换为单选框形式（推荐在可选项小于 5 个时使用）。\n\n假如当前字段为非必填项的话，下拉选择框会在顶部增加一个空项，如果不想显示此项，可以将该字段加入父级对象的 `required` 属性列表内，或者直接设置 `required: true`。\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'radio',\n    enum: ['get', 'post', 'put', 'delete']\n};\n```\n\n\u003e 注：当为 radio 时，该字段默认为 required\n\n另外设置 `format` 为 _select2_，就可以启用第三方控件[select2](https://github.com/select2/select2)，可以提升选择交互体验。\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'select2',\n    enum: ['get', 'post', 'put', 'delete']\n};\n```\n\n正常情况下，通过枚举数组定义的下拉选项的显示值就是实际值。假如下拉选项的显示值和实际值不相同，而是一一映射关系，可以使用 `enumSource` 属性来完成这种特殊需求。\n\n-   通过 `source` 关键字可以指定一个对象数组作为枚举备选项，对象中可以分别描述显示值和实际值。\n-   通过 `title` 关键字定义枚举项的显示文本，支持模板语法，其中用 item 代指对象数组中的数组元素自身。\n-   通过 `value` 关键字定义枚举项的值，支持模板语法，其中用 item 代指对象数组中的数组元素自身。\n\n```javascript\nlet schema = {\n    type: 'string',\n    enumSource: [\n        {\n            source: [\n                {\n                    value: 1,\n                    title: 'One'\n                },\n                {\n                    value: 2,\n                    title: 'Two'\n                }\n            ],\n            title: '{{item.title}}',\n            value: '{{item.value}}'\n        }\n    ]\n};\n```\n\n### boolean\n\nboolean 类型默认是下拉选择框形式，内置选项 _true_ 和 _false_。假如设置 `format` 为 _checkbox_，就可以切换为复选框形式。\n\n```javascript\nlet schema = {\n    type: 'boolean',\n    format: 'checkbox',\n    title: '是否启用',\n    default: true\n};\n```\n\n另外 Press 还新增了一个开关切换形式用于布尔类型，设置 `format` 为 _toggle_ 即可。\n\n```javascript\nlet schema = {\n    type: 'boolean',\n    format: 'toggle'\n};\n```\n\n### number 和 integer\n\nnumber、integer 类型都是用于输入数字值，它们的唯一区别就是一个接受数字，一个接受整数，默认控件是输入框。\n\n另外可以通过 `maximum` 和 `minimum` 关键字限定最大最小值。\n\n其中，integer 类型可设置 `format` 为 _range_ ，切换为滑块形式；_rating_ ，切换为打星评分形式（默认 `minimum: 1`，另外可以设置属性 exclusiveMinimum/exclusiveMaximum 为布尔值，表示可取值范围不包括最小或最大值）。\n\n```javascript\nlet schema = {\n    type: 'integer',\n    default: 1,\n    multipleOf: 25, // 倍数约束\n    minimum: 1,\n    maximum: 1000\n};\n```\n\n和 datetime 类似，Press 也对 number 实现了对象依赖限制功能：可以指定某项值必须大于或小于另外一项。\n\n通过 `relativeTo` 属性来描述规则：\n\n-   通过 `path` 关键字可以指定当前项的对比目标的路径。它支持绝对路径和相对路径。\n-   通过 `limit` 关键字设置当前项相对于对比目标的规则。它支持两个值：'less' 表明小于等于目标对象，'greater' 表明大于等于目标对象。\n\n#### 结合 enum 属性\n\n当通过 `enum` 属性提供了可选枚举值后，number 类型会被渲染为下拉选择框。假如设置 `format` 为 _radio_，就可以切换为单选框形式（推荐在可选项小于 5 个时使用）。\n\n```javascript\nlet schema = {\n    type: 'integer',\n    enum: [2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012]\n};\n```\n\n#### datetime\n\ndatetime 控件也支持数值类型，同 string 下同类控件相似，只是返回值为对应的时间戳。\n\n```javascript\nlet schema = {\n    type: 'number',\n    format: 'datetime-local',\n    options: {\n        flatpickr: {\n            ...\n        }\n    }\n};\n```\n\n### array\n\narray 作为 JSON 数据的重要组成类型，相应的，数组编辑区也占据了编辑器的大量篇幅（包括界面、代码等等）。\n除了默认形式，另外还提供了 _table_ 和 _tabs_ 两种 format 形式来编辑数组。\n\n-   默认: 数组元素从上到下，垂直排列分布，适合元素数量少时。\n-   table: 用表格的形式展示数组元素，适合元素数量多且元素为对象且属性少的情况。\n-   tabs: 用左页签来切换数据元素，永远只显示一个元素，适合元素为对象且属性多的情况。\n-   tabs-top: 同上，只是改为顶页签。\n\n```javascript\nlet schema = {\n    type: 'array',\n    items: {\n        type: 'string'\n    }\n};\nlet schema2 = {\n    type: 'array',\n    format: 'table',\n    items: {\n        type: 'object',\n        properties: {\n            name: {\n                type: 'string',\n                options: {\n                    // 通过 input_width 变相实现自定义 td 的宽度\n                    input_width: '60px'\n                }\n            },\n            id: {\n                type: 'string'\n            }\n        }\n    }\n};\n```\n\n#### minItems 和 maxItems 属性\n\narray 类型提供了两个关键字用于限制数组的长度 `minItems` 和 `maxItems`\n\n```javascript\nlet schema = {\n    type: 'array',\n    format: 'table',\n    uniqueItems: true,\n    minItems: 1,\n    maxItems: 10,\n    items: {\n        type: 'string'\n    }\n};\n```\n\n#### uniqueItems 属性\n\narray 类型提供了一个 `uniqueItems` 关键字，当为 true 时，可以避免添加重复项。Press 针对该特性做了优化，可以通过设为字符串来指定数组元素的某个属性不能重复。也可以设置为数组，表明多个属性不能重复\n\n```javascript\nlet schema = {\n    type: 'array',\n    format: 'table',\n    uniqueItems: 'name',\n    items: {\n        type: 'object',\n        properties: {\n            name: {\n                type: 'string'\n            },\n            id: {\n                type: 'string'\n            }\n        }\n    }\n};\n\nlet schema2 = {\n    type: 'array',\n    format: 'table',\n    uniqueItems: ['name', 'id'],\n    items: {\n        type: 'object',\n        properties: {\n            name: {\n                type: 'string'\n            },\n            id: {\n                type: 'string'\n            }\n        }\n    }\n};\n```\n\n`uniqueItems` 关键字还支持多级嵌套，表明在包含属性定义的当前层级下，所指属性不能重复。\n\n支持两种设定形式：\n\n1. 用 `.` 号进行分隔，适用于对象组成的数组，描述的是数组名+对象属性名\n\n    ```javascript\n    let schema = {\n        rules: {\n            type: 'array',\n            // rewards 数组的 id 在 rules 范围内必须唯一\n            uniqueItems: 'rewards.id',\n            items: {\n                type: 'object',\n                properties: {\n                    rewards: {\n                        type: 'array',\n                        // id 在 rewards 数组内必须唯一\n                        uniqueItems: 'id',\n                        items: {\n                            type: 'object',\n                            properties: {\n                                id: {\n                                    type: 'integer',\n                                    minimum: 0\n                                },\n                                weight: {\n                                    type: 'integer'\n                                }\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    };\n    ```\n\n2. 用 `@` 号进行分隔，适用于基础类型组成的数组，描述的是数组名\n\n    ```javascript\n    let schema = {\n        rules: {\n            type: 'array',\n            // rewards 数组的值在 rules 范围内必须唯一\n            uniqueItems: 'rewards@',\n            items: {\n                type: 'object',\n                properties: {\n                    rewards: {\n                        type: 'array',\n                        items: {\n                            type: 'string'\n                        }\n                    }\n                }\n            }\n        }\n    };\n    ```\n\n总结：\n\n`uniqueItems: ['name', 'foo.bar', 'list@']` 分别表明数组元素的 name 属性不能重复；数组元素的 foo 属性（也为对象组成的数组），其子元素的 bar 在总数组范围内不能重复；数组元素的 list 属性（也为数组），其子元素在总数组范围内不能重复。\n\n#### readOnly 属性\n\nPress 针对 array/table 类型提供一个 readOnly 属性，可以设置元素的只读状态，用于固定内置项避免被修改的场景。\n\n通过 `items.readOnly` 来设置元素的只读状态，支持使用函数或者布尔值。\n\n1. 函数：按条件判断禁用（符合条件的元素无法修改，并且无法排序和删除），默认传入参数为当前数组元素，返回布尔值\n2. 布尔：直接全局禁用（所有元素都无法修改、排序和删除，并且不允许添加新元素）\n\n另外还支持使用 `options.ignore = 'readOnly'` 来设置特定项忽略只读模式\n\n```javascript\nlet schema = {\n    type: 'array',\n    format: 'table',\n    uniqueItems: 'name',\n    items: {\n        type: 'object',\n        readOnly: (target) =\u003e {\n            return preset.includes(target.name);\n        },\n        properties: {\n            name: {\n                type: 'string'\n            },\n            id: {\n                type: 'string'\n            }，\n            enable: {\n                type: 'boolean',\n                format: 'toggle',\n                options: {\n                    // enable 属性不受 readOnly 状态的影响\n                    ignore: 'readOnly'\n                }\n            }\n        }\n    }\n};\n```\n\n#### compareThanPrev 属性\n\nPress 针对 array 类型提供一个可以指定数组元素的某个属性必须比相邻元素的大或者小的校验功能。这个特性一般用于设定连续区间。\n\n通过 `compareThanPrev` 属性来描述规则：\n\n-   通过 `path` 关键字可以指定数组元素内的属性。\n-   通过 `limit` 关键字设置当前元素相对于前一个元素同名属性的比较规则。它支持两个值：'less' 表明小于目标对象，'greater' 表明大于目标对象。\n\n```javascript\nlet schema = {\n    rules: {\n        type: 'array',\n        compareThanPrev: {\n            path: 'range_to',\n            limit: 'greater'\n        },\n        items: {\n            type: 'object',\n            properties: {\n                range_to: {\n                    type: 'integer'\n                },\n                id: {\n                    type: 'string'\n                },\n                weight: {\n                    type: 'integer'\n                }\n            }\n        }\n    }\n};\n```\n\n上述例子中表明了数组元素 `range_to` 属性必须比前一个元素的同名属性大。\n\n#### 结合 enum 属性\n\n同样的，通过 `enum` 属性提供了可选枚举值并同时设置 `uniqueItems` 属性后，array 类型会被渲染为多选形式。假如可选项小于 8 个时会被渲染为复选框样式，否则渲染为下拉多选样式。可以通过设置 `format` 为 _select_ 或 _checkbox_，进行显式定义。\n\n```javascript\nlet schema = {\n    type: 'array',\n    format: 'checkbox',\n    uniqueItems: true,\n    items: {\n        type: 'string',\n        enum: ['A-Yes', 'A-Unknown', 'B-Yes', 'B-Unknown', 'C-Yes', 'C-Unknown']\n    }\n};\n```\n\n上文提及的 select2 也支持多选，设置 `format` 为 _select2_，就可以启用。\n\n```javascript\nlet schema = {\n    type: 'array',\n    format: 'select2',\n    uniqueItems: true,\n    items: {\n        type: 'string',\n        enum: ['A-Yes', 'A-Unknown', 'B-Yes', 'B-Unknown', 'C-Yes', 'C-Unknown']\n    }\n};\n```\n\n#### array 事件\n\n编辑器针对 array 的元素常见操作（增加、删除、移动）都提供了对应的钩子函数便于做相应的处理。\n\n```javascript\neditor.on('moveRow', editor =\u003e {\n    console.log('moveRow', editor);\n});\neditor.on('addRow', editor =\u003e {\n    console.log('addRow', editor);\n});\neditor.on('deleteRow', editor =\u003e {\n    console.log('deleteRow', editor);\n});\neditor.on('deleteAllRows', editor =\u003e {\n    console.log('deleteAllRows', editor);\n});\n```\n\n#### multiline 类型\n\nPress 针对 array 数据新增了 multiline 类型，其表现为支持多行指定类型的文本域，用于快速生成数组（支持 字符串、数字、布尔 三种类型组成数组）\n\n当 `format` 为 _multiline_ 时，可以启用这种类型，它渲染为文本域形式，通过换行支持输入多个项。\n\n另外可以通过 `options.multiType` 选项来设置数组的组成元素类型，用于校验和最终生成值。支持 number、string、boolean 三种类型\n\n\u003e 注：`type` 为 _string_ 而不是 _array_\n\n```javascript\nlet schema = {\n    type: 'string',\n    format: 'multiline',\n    options: {\n        multiType: 'number'\n    }\n};\n```\n\n另外需要注意的是，当该字段为必填项时，其默认值（或者值为空时）返回为空数组 [] 否则返回 undefined\n\n### object\n\nobject 编辑区也是编辑器的重要组成部分之一。该编辑区除了默认布局也提供了其他布局用于精简界面。它通过 `format` 关键字来设定。\n\n-   默认: 每个子属性单独占据一行。\n-   grid: 多个子属性并排在一行显示，每个子属性可以通过 _grid_columns_ 选项来设置宽度，然后 每行会尽可能占满 12 格后换行，所以该布局不能保证子属性的显示顺序和代码一致。\n-   grid-strict: 同上，但是每个子属性会严格按照 _grid_columns_ 显示，不会自动扩展。同时支持通过 _grid_break_ 选项来设置手动换行。\n-   categories: 通过顶页签形式对子属性进行分组，每个对象或数组属性对应一个页签（页签标题来自对象或数组的标题），剩余的其他属性为一个页签（标题默认为 Basic，可以通过 `basicCategoryTitle` 属性进行自定义）。\n\n```javascript\nlet schema = {\n    type: 'object',\n    properties: {\n        name: {type: 'string'}\n    }\n};\n```\n\n```javascript\nlet schema = {\n    type: 'object',\n    format: 'grid-strict',\n    properties: {\n        a: {\n            title: 'a',\n            type: 'string',\n            options: {\n                grid_columns: 4\n            }\n        },\n        b: {\n            title: 'b',\n            type: 'string',\n            options: {\n                grid_columns: 4,\n                grid_break: true\n            }\n        },\n        c: {\n            title: 'c',\n            type: 'string',\n            options: {\n                grid_columns: 6\n            }\n        },\n        d: {\n            title: 'd',\n            type: 'string',\n            options: {\n                grid_columns: 6\n            }\n        }\n    }\n};\n```\n\n```javascript\nlet schema = {\n    type: 'object',\n    format: 'categories',\n    basicCategoryTitle: 'ab',\n    properties: {\n        a: {\n            title: 'a',\n            type: 'string'\n        },\n        b: {\n            title: 'b',\n            type: 'string'\n        },\n        location: {\n            type: 'object',\n            title: 'Location',\n            properties: {\n                city: {\n                    type: 'string'\n                },\n                state: {\n                    type: 'string'\n                }\n            }\n        },\n        people: {\n            type: 'array',\n            format: 'table',\n            title: 'People',\n            uniqueItems: true,\n            items: {\n                type: 'string'\n            }\n        }\n    }\n};\n```\n\n### info\n\ninfo 类型提供了静态文本的展示方式，一般用于信息提示和说明。\n\n```javascript\nlet schema = {\n    type: 'info',\n    title: 'Tips',\n    description: 'It shows the available standard elements with all displayable options enabled'\n};\n```\n\n### button\n\nbutton 类型提供了按钮控件形式，一般用于获取当前编辑器的值及额外操作。\n\n启用方法：\n\n-   首先设置 `type` 为 _button_，同时通过 `options.button` 中设置相关属性，即可启用一个按钮控件。\n-   在相关属性内，使用 `action` 关键字指定一个函数用于按钮点击调用，该函数有一个参数，表示当前事件；使用 `validated` 关键字设置是否校验数据有效后才让按钮生效。\n-   也可以设置 `action` 属性为函数名称，然后通过全局统一定义管理回调函数，请参考[集成指南](./docs/integration_guide.md#button)的对应部分\n\n\u003e 注：当为 button 时，该字段默认为 required\n\n```javascript\nlet schema = {\n    type: 'button',\n    title: 'Click this',\n    options: {\n        button: {\n            validated: true,\n            action: function (evt) {\n                console.log('value = ', this.jsoneditor.getValue());\n            }\n        }\n    }\n};\n```\n\n## anyOf、oneOf、allOf 和 not\n\n编辑器支持使用 anyOf、oneOf 和 allOf 关键字来描述复杂的 schema 校验规则和机制。\n\n-   anyOf: 满足任意一个子 schema\n-   oneOf: 满足且仅满足一个子 schema\n-   allOf: 满足所有子 schema\n-   not: 不满足 schema\n\n```javascript\nlet schema = {\n    any: {\n        anyOf: [\n            {\n                type: 'string',\n                maxLength: 5\n            },\n            {\n                type: 'number',\n                minimum: 10\n            }\n        ]\n    },\n    all: {\n        allOf: [\n            {\n                type: 'string'\n            },\n            {\n                maxLength: 5\n            }\n        ]\n    },\n    one: {\n        // 可以为 5 或 3，不能为 15\n        oneOf: [\n            {\n                type: 'number',\n                multipleOf: 5\n            },\n            {\n                type: 'number',\n                multipleOf: 3\n            }\n        ]\n    },\n    // 不能为数字\n    not: {\n        type: 'number'\n    },\n    // 不能为枚举项任意一个值\n    not: {\n        enum: ['default', 'origin']\n    }\n};\n```\n\nany 字段可以选择任一条件进行满足，没有通过即报错；all 字段必须满足所有条件，没有选择界面；one 字段只能优先选择一个条件，无论有没有通过，继续以当前值来验证后续条件，假如最后满足的条件项不等于 1，则报错。\n\n`anyOf` 可以支持更复杂应用场景，比如一个字段支持多种格式的输入，可以使用它结合 `definitions` 属性来实现。\n\n```javascript\nlet schema = {\n    definitions: {\n        base64: {\n            type: 'object',\n            title: 'base64 decode',\n            properties: {\n                base64: {\n                    type: 'string',\n                    default: 'standard',\n                    readOnly: true\n                }\n            }\n        },\n        encrypt_var: {\n            type: 'object',\n            title: 'defined encrypt variable',\n            properties: {\n                encrypt_name: {\n                    type: 'string',\n                    enum: ['aes', 'tkip', 'psk']\n                }\n            },\n            required: ['encrypt_name']\n        },\n        encrypt: {\n            type: 'object',\n            title: 'encrypt method',\n            properties: {\n                type: {\n                    type: 'string',\n                    enum: ['aes', 'tkip', 'psk']\n                },\n                key: {\n                    type: 'string'\n                }\n            },\n            required: ['type', 'key']\n        }\n    },\n    type: 'object',\n    properties: {\n        any: {\n            anyOf: [\n                {\n                    $ref: '#/definitions/base64'\n                },\n                {\n                    $ref: '#/definitions/encrypt_var'\n                },\n                {\n                    $ref: '#/definitions/encrypt'\n                }\n            ]\n        }\n    }\n};\n```\n\n`oneOf` 项校验可以通过 `options.hideOneOfValidate` 选项来设置内部项校验不通过的话不再笼统显示提示信息，而是针对具体的某一项进行提示。\n\n```javascript\nlet schema = {\n    type: 'object',\n    oneOf: [\n        {\n            title: 'condition',\n            required: ['target', 'value'],\n            properties: {\n                target: {\n                    type: 'string',\n                    minLength: 1\n                },\n                value: {\n                    type: 'string'\n                }\n            }\n        },\n        {\n            title: 'expression',\n            required: ['expr'],\n            properties: {\n                expr: {\n                    type: 'string',\n                    minLength: 1\n                }\n            }\n        }\n    ],\n    options: {\n        hideOneOfValidate: true\n    }\n};\n```\n\n## 依赖项\n\n在编辑 JSON 时，一个字段依赖于另外一个字段的值是很常见的情况。编辑器提供了 `dependencies` 关键字来满足这方面的需求。\n\n`dependencies` 的值是 map 形式的键值对，用来描述要监控的字段和期望值。它的值支持三种形式：\n\n-   单个键值对：表明依赖项的值为期望值即生效。\n-   单个键值对，但是值为数组：表明依赖项的值为数组元素之一即生效。\n-   多个键值对：表明当多个依赖项都分别满足期望值时才生效。\n\n```javascript\nlet schema = {\n    fieldOne: {\n        type: 'string',\n        enum: ['foo', 'bar', 'cool'],\n        default: 'foo'\n    },\n    fieldTwo: {\n        type: 'string',\n        enum: ['a', 'b', 'c'],\n        default: 'a'\n    },\n    depender1: {\n        type: 'string',\n        description: 'show when fieldOne is bar',\n        options: {\n            dependencies: {\n                fieldOne: 'bar'\n            }\n        }\n    },\n    depender2: {\n        type: 'string',\n        description: 'show when fieldOne is bar or cool',\n        options: {\n            dependencies: {\n                fieldOne: ['bar', 'cool']\n            }\n        }\n    },\n    depender3: {\n        type: 'string',\n        description: 'show when fieldOne is bar or cool and fieldTwo is b',\n        options: {\n            dependencies: {\n                fieldOne: ['bar', 'cool'],\n                fieldTwo: 'b'\n            }\n        }\n    }\n};\n```\n\n另外，针对 `dependencies` 关键字，Press 提供了增强功能，支持使用 `not` 字段来设置依赖值，表明依赖项为非设定值时生效。\n\n```javascript\nlet schema = {\n    fieldOne: {\n        type: 'string',\n        enum: ['foo', 'bar', 'cool'],\n        default: 'foo'\n    },\n    depender: {\n        type: 'string',\n        description: 'show when fieldOne is not bar',\n        options: {\n            dependencies: {\n                fieldOne: {\n                    not: 'bar'\n                }\n            }\n        }\n    }\n};\n```\n\n### 自定义依赖\n\n上述规则可以满足大部分常见场景的需求，但是还不够灵活。所以编辑器还提供了一系列关键字的组合来提供更多可能。\n\n#### 使用 watch 定义监听项\n\n首先，使用 `watch` 关键字来定义需要监听的字段路径\n\n```javascript\nlet schema = {\n    first_name: {\n        type: 'string'\n    },\n    last_name: {\n        type: 'string'\n    },\n    full_name: {\n        type: 'string',\n        watch: {\n            fname: 'first_name',\n            lname: 'last_name'\n        }\n    }\n};\n```\n\n上述例子中的 `fname` 是待监听字段的化名，`first_name` 是字段的路径，支持绝对路径和相对路径。\n\n```javascript\nlet schema = {\n    type: 'array',\n    items: {\n        type: 'object',\n        id: 'arr_item',\n        properties: {\n            first_name: {\n                type: 'string'\n            },\n            last_name: {\n                type: 'string'\n            },\n            full_name: {\n                type: 'string',\n                watch: {\n                    fname: 'arr_item.first_name',\n                    lname: 'arr_item.last_name'\n                }\n            }\n        }\n    }\n};\n```\n\n上述例子中的 `arr_item` 是定义的相对节点，然后数组每个元素下的 `full_name` 都能观测到同级的 `first_name` 和 `last_name` 属性值。\n\n#### 使用 template 实现渲染\n\n其次，使用 `template` 关键字定义用于渲染变量和结果的模板字符串。Press 除了支持默认引擎外，还引入了第三方支持（nunjucks）。\n\n引入第三方模板配置支持两种方式：\n\n-   全局默认值形式\n\n`JSONEditor.defaults.options.template = \"nunjucks\"`\n\n-   实例化传参形式\n\n```javascript\nconst editor = new JSONEditor(element, {\n    //...\n    template: 'nunjucks'\n});\n```\n\n第三方模板可以自定义其实现方法：\n\n```javascript\nconst myEngine = {\n    // 渲染引擎必须包含 compile 方法，并返回一个渲染函数\n    compile(template) {\n        return view =\u003e {\n            // 实现 render 方法来渲染模板，需要结合传入的数据 view\n            let render = function () {};\n            const result = render(template, view);\n            return result;\n        };\n    }\n};\n```\n\n上个例子使用默认模板渲染如下：\n\n```javascript\nlet schema = {\n    first_name: {\n        type: 'string'\n    },\n    last_name: {\n        type: 'string'\n    },\n    full_name: {\n        type: 'string',\n        template: '{{fname}} {{lname}}',\n        watch: {\n            fname: 'first_name',\n            lname: 'last_name'\n        }\n    }\n};\n```\n\n`template` 关键字除了定义为模板字符串，也支持指定为一个回调函数，该函数有一个参数就是 `watch` 定义的监听项。\n\n也可以设置该属性为函数名称，然后通过全局统一定义管理回调函数，请参考[集成指南](./docs/integration_guide.md#template)的对应部分\n\n```javascript\nlet schema = {\n    first_name: {\n        type: 'string'\n    },\n    last_name: {\n        type: 'string'\n    },\n    full_name: {\n        type: 'string',\n        template: function (target) {\n            return target.fname + ':' + target.lname;\n        },\n        watch: {\n            fname: 'first_name',\n            lname: 'last_name'\n        }\n    }\n};\n```\n\n### enum 依赖\n\n另外一个常见的依赖场景就是下拉选择框的枚举值依赖于其他字段。这种需求也需要 `watch` 关键字并配合 `enumSource` 关键字来实现。它支持定义为字符串值或数组。\n\n#### 基础用法\n\n定义为字符串时，表明为枚举数据的来源，该值来自于 `watch` 中的监听字段的化名。\n\n```javascript\nlet schema = {\n    possible_colors: {\n        type: 'array',\n        items: {\n            type: 'string'\n        }\n    },\n    primary_color: {\n        type: 'string',\n        watch: {\n            colors: 'possible_colors'\n        },\n        enumSource: 'colors'\n    }\n};\n```\n\n#### 高级用法\n\n`enumSource` 关键字也支持定义为更加复杂的数组形式以支持筛选、多个来源、内置常量等等需求。下面为示例，它使用了 `nunjucks` 作为模板引擎以支持高级语法表达式。\n\n```javascript\nlet schema = {\n    possible_colors: {\n        type: 'array',\n        items: {\n            type: 'string'\n        }\n    },\n    primary_color: {\n        type: 'string',\n        watch: {\n            colors: 'possible_colors'\n        },\n        enumSource: [\n            // 前置常量\n            ['none'],\n            {\n                // 监听来源\n                source: 'colors',\n                // 定义枚举项的显示文本\n                title: '{{item|title}}',\n                // 定义枚举项的值\n                value: '{{item|trim}}',\n                // 可以定义数组子集，相当于 arr.slice\n                slice: [2, 5],\n                // 过滤特殊值，返回常量表示不渲染（需要引入第三方模板引擎支持）\n                // 也可以直接定义回调函数以避免引入模板引擎，见 [回调函数] 部分\n                filter: \"{% if item !== 'black' %}1{% endif %}\"\n            },\n            // 后置常量\n            ['transparent']\n        ]\n    }\n};\n```\n\n`enumSource.source` 也可以定义为静态列表，使用的语法稍有不同。\n\n```javascript\nlet schema = {\n    enumSource: [\n        {\n            source: [\n                {\n                    value: 1,\n                    title: 'One'\n                },\n                {\n                    value: 2,\n                    title: 'Two'\n                }\n            ],\n            title: '{{item.title}}',\n            value: '{{item.value}}'\n        }\n    ]\n};\n```\n\n除了监听简单的字符串数组外，也可以监听对象数组，只是解析值的时候表达式有所不同。\n\n```javascript\nlet schema = {\n    possible_colors: {\n        type: 'array',\n        items: {\n            type: 'object',\n            properties: {\n                id: {\n                    type: 'string'\n                },\n                text: {\n                    type: 'string'\n                }\n            }\n        }\n    },\n    primary_color: {\n        type: 'string',\n        watch: {\n            colors: 'possible_colors'\n        },\n        enumSource: [\n            {\n                source: 'colors',\n                title: '{{item.text}}',\n                value: '{{item.id}}'\n            }\n        ]\n    }\n};\n```\n\n所有支持使用自定义表达式的地方，都会包括两个属性 `item` 和 `i`，表示数组的元素和它们的索引（以 0 开始）。\n\n另外，针对 `enumSource` 关键字，Press 新增 `sourceFormat` 字段，支持设定一个处理方法，用于对 source 设置的数据进行处理和加工，默认传入参数为监听来源 source 的值。\n\n```javascript\nlet schema = {\n    select_input: {\n        type: 'string',\n        watch: {\n            target: 'occasionItem.action_name'\n        },\n        enumSource: [\n            {\n                source: 'target',\n                sourceFormat: target =\u003e {\n                    return this.realPigatData[target];\n                },\n                title: '{{item.name}}',\n                value: '{{item.name}}:{{item.type}}'\n            }\n        ]\n    }\n};\n```\n\n另外，针对依赖 `watch` 属性的 `enumSource` 关键字，Press 新增 `options.auto_refresh` 属性，用于设定该字段为动态刷新模式，假如 watch 依赖项已经删除选中值，则校验不通过，无法保存，避免生成无效值。\n\n```javascript\nlet schema = {\n    select_input: {\n        type: 'string',\n        watch: {\n            target: 'occasionItem.action_name'\n        },\n        enumSource: [\n            {\n                source: 'target',\n                title: '{{item.name}}',\n                value: '{{item.value}}'\n            }\n        ],\n        options: {\n            auto_refresh: true\n        }\n    }\n};\n```\n\n#### 回调函数\n\n对于 `enumSource` 的 _title、value、filter_ 等属性，也支持使用回调函数来处理渲染数据，以代替模板表达式。\n\n```javascript\nlet schema = {\n    possible_colors: {\n        type: 'array',\n        items: {\n            type: 'object',\n            properties: {\n                text: {\n                    type: 'string'\n                }\n            }\n        }\n    },\n    primary_color: {\n        type: 'string',\n        watch: {\n            colors: 'possible_colors'\n        },\n        enumSource: [\n            {\n                source: 'colors',\n                title: 'enumTitleCB',\n                value: 'enumValueCB',\n                filter: 'enumFilterCB'\n            }\n        ]\n    }\n};\n\nJSONEditor.defaults.callbacks.template = {\n    enumTitleCB: (jseditor, evt) =\u003e evt.item.text.toUpperCase(),\n    enumValueCB: (jseditor, evt) =\u003e evt.item.text.toLowerCase(),\n    enumFilterCB: (jseditor, evt) =\u003e {\n        if (evt.item.text.toLowerCase() == 'red') {\n            return '';\n        }\n        return evt.item.text;\n    }\n};\n```\n\n#### 排序\n\n候选项支持按排序，只要设置 `enumSource.sort` 属性设置为 _asc_ 或 _desc_ 即可。\n\n## anyOf 和依赖项的组合\n\n通过 anyOf 和依赖项的结合使用，可以满足某些特殊场景的联动需求，不过这种使用方式官方并未完全支持，所以 Press 在此基础上针对具体需求进行修正和增强，提供了更具想象力的使用方式。\n\n增强功能列表：\n\n-   假如 anyOf 下所有元素都有 dependencies 属性的情况下，\n    -   隐藏 anyOf 原生切换控件，通过激活 dependencies 对应项来实现切换（同时隐藏 anyOf 标题）\n    -   实现激活 dependencies 对应项时，同时重置 anyOf 当前激活项的值\n    -   初始化时修改内部参数，避免联动的输入控件不能正确渲染为对应的项和值\n    -   统一初始化 anyOf 的项，避免切换时无初始项无法渲染\n    -   仅按 anyOf 当前激活项的规则进行校验，而非按 anyOf 所有规则校验\n\n通过上述的改造，Press 组件支持以下应用场景：\n\n1. 元素的 schema 内规则和联动项的取值有关联\n\n    如下：当 algorithm = mutative 时，reference 为必填项\n\n    ```javascript\n    let schema = {\n        algorithm: {\n            type: 'string',\n            enum: ['constant', 'mutative', 'global']\n        },\n        reference: {\n            title: 'reference',\n            anyOf: [\n                {\n                    type: 'string',\n                    options: {\n                        dependencies: {\n                            algorithm: ['constant', 'global']\n                        }\n                    }\n                },\n                {\n                    type: 'string',\n                    minLength: 1,\n                    options: {\n                        dependencies: {\n                            algorithm: 'mutative'\n                        }\n                    }\n                }\n            ]\n        }\n    };\n    ```\n\n2. 元素的 schema 内控件类型和联动项的取值有关联\n\n    \u003e 注：当有多个依赖项时，不支持都是数组的情况！\n\n    如下：当 kind = custom 时，name 为文本输入框；当 kind = preset 时，name 为下拉选择框\n\n    ```javascript\n    let schema = {\n        kind: {\n            type: 'string',\n            enum: ['preset', 'custom']\n        },\n        name: {\n            anyOf: [\n                {\n                    type: 'string',\n                    minLength: 1,\n                    options: {\n                        dependencies: {\n                            kind: 'custom'\n                        }\n                    }\n                },\n                {\n                    type: 'string',\n                    enum: ['a', 'b'],\n                    options: {\n                        dependencies: {\n                            kind: 'preset'\n                        }\n                    }\n                }\n            ]\n        }\n    };\n    ```\n\n## 动态标题\n\nschema 的 `title` 关键字用于在编辑界面向用户展示友好易于理解的标题。有时候，实现标题依赖其他字段而动态改变，对用户很有用。\n\n对于常见的数组元素，默认其标题是 `item 1` 等等以此类推，即使定义了 `title = child` 的情况下，也仅仅是 `child 1` 等等。而使用了动态标题后，就可以向用户展示该元素下的一些复合信息，方便用户理解。\n\n编辑器提供了 `headerTemplate` 关键字来实现，它提供了三个属性用于模板表达式：`self` 表示数组元素自身、`i0` 表示以 0 起始索引、 `i1` 表示以 1 起始索引。\n\n```javascript\nlet schema = {\n    type: 'array',\n    title: 'Children',\n    items: {\n        type: 'object',\n        title: 'Child',\n        headerTemplate: '{{ i1 }} - {{ self.name }} (age {{ self.age }})',\n        properties: {\n            name: {type: 'string'},\n            age: {type: 'integer'}\n        }\n    }\n};\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyte-power%2Fjsonpress","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbyte-power%2Fjsonpress","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyte-power%2Fjsonpress/lists"}