{"id":13607606,"url":"https://github.com/vikadata/widget-datasheet-operation","last_synced_at":"2025-04-12T14:30:46.604Z","repository":{"id":41396936,"uuid":"508624644","full_name":"vikadata/widget-datasheet-operation","owner":"vikadata","description":"维格表编辑小程序","archived":false,"fork":false,"pushed_at":"2022-07-20T15:37:26.000Z","size":8953,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-11-07T13:37:00.008Z","etag":null,"topics":["datasheet","vika-widget","vikadata"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vikadata.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-06-29T09:21:24.000Z","updated_at":"2022-09-13T08:41:48.000Z","dependencies_parsed_at":"2022-09-23T01:02:53.561Z","dependency_job_id":null,"html_url":"https://github.com/vikadata/widget-datasheet-operation","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vikadata%2Fwidget-datasheet-operation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vikadata%2Fwidget-datasheet-operation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vikadata%2Fwidget-datasheet-operation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vikadata%2Fwidget-datasheet-operation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vikadata","download_url":"https://codeload.github.com/vikadata/widget-datasheet-operation/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248581004,"owners_count":21128091,"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","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":["datasheet","vika-widget","vikadata"],"created_at":"2024-08-01T19:01:20.095Z","updated_at":"2025-04-12T14:30:45.901Z","avatar_url":"https://github.com/vikadata.png","language":"TypeScript","funding_links":[],"categories":["🎯开源维格小程序"],"sub_categories":["官方开源"],"readme":"# 维格小程序 - 维格表编辑器\n\n为了让你更容易理解小程序的 SDK 能力，我们提供了一个维格表编辑器小程序用于测试\n\n## 功能说明\n\n**修改字段属性**\n\n修改字段的属性配置，不同类型的字段有不同的属性配置。 比如我们可以修改「文本」字段的默认值（ defaultValue ）\n\n返回 `null` 则代表这个字段没有属性配置。 具体可参阅 [FieldType](https://vika.cn/developers/widget/api-reference/enums/interface_field_types.FieldType/)\n\n![edit-field-property](/static/img/edit-field-property.png)\n\n**修改字段描述**\n\n通过 `description` 比如修改首列描述为「描述详情！」\n\n![edit-description](/static/img/edit-description.png)\n\n**新增字段**\n\n此方式可以根据预先编辑好的字段配置生成新的字段\n\n比如配置以下参数，可以生成一列保留 3 位小数的「数字」列\n\n![add-field](/static/img/add-field.gif)\n\n有关新增字段属性值写入格式，请参阅 [FieldType](https://vika.cn/developers/widget/api-reference/enums/interface_field_types.FieldType)\n\n**删除字段**\n\n此方式可以用于删除除首列外的维格列\n\n在下拉列表中选择对应列，勾选「直接删除/保留关联表的对应字段」即可\n\n![delete-field](/static/img/delete-field.gif)\n\n**Field 一键操作**\n\n此方式可以按需批量新增/删除列\n\n- 如果你选择「一键新增字段」，编辑器内容将初始化为维格表除「神奇关联」「神奇引用」外的所有字段类型（21 种）\n- 如果你选择「一键删除字段」，编辑器内容将初始化为当前视图下所有字段\n\n![add-or-delete-all](/static/img/add-or-delete-all.gif)\n\n## 快速开始\n\n### 克隆工程到本地\n\n```shell\ngit clone git@github.com:vikadata/widget-datasheet-operation.git\n```\n\n### 创建自建小程序\n\n进去空间站，切换到「空间站自建」窗口，创建一个自建小程序\n\n![空间站自建](/static/img/custom-widget.png)\n\n![初始化小程序](/static/img/create-widget.png )\n\n注意：如果是第一次开发，需要先执行以下命令：\n\n```shell\nnpm install -g @vikadata/widget-cli\n```\n\n### 修改项目配置文件\n\n1. 在「初始化」界面的命令中获取小程序唯一 ID（wpk开头） 和空间站 ID（spc开头）\n\n![获取空间站id](/static/img/get-space-id.png)\n\n![获取小程序id](/static/img/get-widget-id.png)\n\n打开项目工程中的 `widget.config.json` 文件，将 packageId 和 spaceId 分别改为自己的小程序 ID 和空间站 ID\n\n![widget-config](/static/img/widget-config.png)\n\n2. 使用 `widget-cli auth` 命令去创建认证文件（`.vika.yml`），添加 API Token 和 host\n\n![set-vika-yml](/static/img/set-vika-yml.png)\n\n### 安装依赖库 \n\n```shell\ncd widget-datasheet-operation\nnpm install\n```\n\n### 进入开发模式\n\n```shell\nwidget-cli start\n```\n\n## 示例结果\n\n你可以在右侧的小程序面板上预览这个小程序，目前提供了 5 种编辑方式。你可以通过这几种编辑方式的代码调试熟悉维格表小程序的 SDK 能力\n\n如果你在使用过程中有更好的想法或者建议，欢迎给项目仓库提交 PR，共同开发完善该小程序\n\n![datasheet-operation](/static/img/datasheet-operation.png)\n\n## 特性\n\n### 已经实现的功能特性\n\n- [x] 修改所选字段的属性配置\n- [x] 修改所选字段的描述\n- [x] 新增单个字段\n- [x] 删除单个字段\n- [x] 一键「新增/删除」多个字段\n\n## 相关项目\n\n- [awesome-vikadata](https://github.com/vikadata/awesome-vikadata)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvikadata%2Fwidget-datasheet-operation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvikadata%2Fwidget-datasheet-operation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvikadata%2Fwidget-datasheet-operation/lists"}