什么是 tabletop?
Tabletop 是一个针对 Google Sheets 的 Node.js 包,允许你使用 Google Sheets 来存储和编辑数据,并通过 API 访问这些数据。使用 tabletop,你可以利用 sheets 的编辑功能和数据分析工具来轻松管理和更新数据,而不需要修改代码。
安装 tabletop
首先,你需要安装 Node.js 和 npm。然后,在命令行中执行:
npm install tabletop
初始化 tabletop
在使用 tabletop 前,你需要使用 Google Sheets API 管理界面来获取你的 sheets 的 API key。在你拥有它后,你可以使用如下代码初始化:
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------- - - ---- --------------- ------------ ---- -- ---- -- ---------------------- ------------ -- - -- ------ -- ------------ -- - -- ---- ---
其中,simpleSheet 为可选参数,默认为 true,代表 Sheet 里的数据是一个简单表格,没有任何合并单元格和数据验证。如果你只是需要简单表格的数据,可以不传这个参数。
获取数据
使用 tabletop 最常见的场景是读取 sheets 中的数据。使用如下代码:
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------- - - ---- --------------- -- ---------------------- ------------ -- - ----- --------- - ----------------- ----------------------- -- ------------ -- - -- ---- ---
这里,tabletop 会将 sheet 数据作为一个数组返回给你。默认情况下,tabletop 将返回第一个 sheet 中的数据,但如果你传递 spreadsheetName 选项,可选择在多个 Sheet 页面间选择一个,如下:
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------- - - ---- --------------- ---------------- -------- -- ---------------------- ------------ -- - ----- --------- - ----------------- ----------------------- -- ------------ -- - -- ---- ---
整理数据
当 tabletop 数据被读取到后,可能需要变换一下它的格式,以适应你的应用。tabletop 提供一些方便的工具来处理你的数据。
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------- - - ---- --------------- -- ---------------------- ------------ -- - ----- --------- - ----------------- ----- ------------- - ----------------------------- --------------------------- -- ------------ -- - -- ---- ---
这里,simplify 函数可以将默认输出转换为一个更易于操作的对象数组。默认情况下,simplify 会将表头行作为对象的键,每一行数据作为对象的值。如果确定自己的表头行有唯一值,则可以使用以下方式:
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------- - - ---- --------------- -- ---------------------- ------------ -- - ----- --------- - ----------------- ----- ---------------------- - --------- ----- ------------- - ---------------------------- -------- ------------------------- --------------------------- -- ------------ -- - -- ---- ---
结论
现在你已经了解了 npm 包 tabletop 的使用教程。你可以利用 tabletop 的强大功能进行数据管理和分析,轻松完成自己的前端项目开发。希望这篇文章对你有所帮助!
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5eedcc58b5cbfe1ea0612763