跳到主要内容

数据存储

本文档提供了与 wp.data 注册的各种块使用的结构化数据存储的概述。结构化数据的描述作为 wc.wcBlocksData 导出中的常量导出（外部注册为 @woocommerce/block-data，并通过句柄 wc-blocks-data-store 引入）。对于任何使用该存储的块，建议导入结构化数据的描述，而不是直接使用引用，以确保正确提取依赖项。本文档假定读者对 `wp.data** API 有一定的了解。您可以在 WordPress 数据参考指南 中了解更多信息。

购物车存储 (wc/store/cart)​

购物车存储 (wc/store/cart) 负责处理与购物车相关的数据和操作。要使用常量访问此存储，可以使用以下代码：

const { cartStore } = window.wc.wcBlocksData;

结账存储 (wc/store/checkout)​

结账存储 (wc/store/checkout) 管理结账流程，确保用户获得无缝的体验。要使用常量访问此存储，可以使用以下代码：

const { checkoutStore } = window.wc.wcBlocksData;

集合存储 (wc/store/collections)​

集合存储 (wc/store/collections) 包含按命名空间、模型名称和查询字符串索引的数据。要使用常量访问此存储，可以使用以下代码：

const { COLLECTIONS_STORE_KEY } = window.wc.wcBlocksData;

支付存储 (wc/store/payment)​

支付存储 (wc/store/payment) 处理所有与支付相关的数据和交易。要使用常量访问此存储，可以使用以下代码：

const { paymentStore } = window.wc.wcBlocksData;

查询状态存储 (wc/store/query-state)​

查询状态存储 (wc/store/query-state) 包含按上下文和键索引的任意值。它通常用于跟踪给定上下文中查询对象的状态。要使用常量访问此存储，可以使用以下代码：

const { QUERY_STATE_STORE_KEY } = window.wc.wcBlocksData;

结构化数据存储 (wc/store/schema)​

结构化数据存储 (wc/store/schema) 主要用于访问路由，并且主要用于内部用途。要使用常量访问此存储，可以使用以下代码：

const { SCHEMA_STORE_KEY } = window.wc.wcBlocksData;

商店通知存储 (wc/store/store-notices)​

商店通知存储 (wc/store/store-notices) 专门用于处理各种商店通知和警报。要使用常量访问此存储，可以使用以下代码：

const { storeNoticesStore } = window.wc.wcBlocksData;

此 StoreDescriptor 可以传递给 useSelect 函数中的 mapSelect 函数以及 useDispatch 函数。

验证商店 (wc/store/validation)​

验证商店 (wc/store/validation) 存储与验证错误相关的数据，主要用于购物车和结账流程，以确保在存在无效数据时，结账流程不会继续。要使用常量访问此商店，可以使用以下代码：

const { validationStore } = window.wc.wcBlocksData;