云策 WordPress 开发者社区

块编辑器开发文档

@wordpress/preferences-persistence

查看官方原文 ↗
💡 云策文档标注

概述

@wordpress/preferences-persistence 是一个用于 WordPress 偏好设置的持久化工具包，提供将数据保存到 WordPress 用户元数据（通过 REST API）的持久化层，并在数据库保存失败时使用本地存储作为后备方案。

关键要点

  • 提供 create 函数创建持久化层，支持通过 wp.data('core/preferences').setPersistenceLayer 配置使用。
  • 持久化层优先使用 REST API 保存数据到 WordPress 用户元数据，失败时自动回退到 localStorage。
  • 支持配置选项，如 preloadedData 用于预加载数据、localStorageRestoreKey 用于本地存储键、requestDebounceMS 用于 API 请求防抖。
  • 需要 ES2015+ 环境，否则需包含 @wordpress/babel-preset-default 的 polyfill。

代码示例

const persistenceLayer = create();
wp.data( 'core/preferences' ).setPersistenceLayer( persistenceLayer );

注意事项

此包是 Gutenberg 项目的一部分，采用 monorepo 结构，贡献需遵循项目主贡献指南。

📄 原文内容

Persistence utilities for wordpress/preferences.

Includes a persistence layer that saves data to WordPress user meta via the REST API. If for any reason data cannot be saved to the database, this persistence layer also uses local storage as a fallback.

Installation

Install the module

npm install @wordpress/preferences-persistence --save

This package assumes that your code will run in an ES2015+ environment. If you’re using an environment that has limited or no support for such language features and APIs, you should include the polyfill shipped in @wordpress/babel-preset-default in your code.

Usage

Call the create function to create a persistence layer.

const persistenceLayer = create();

Next, configure the preferences package to use this persistence layer:

wp.data( 'core/preferences' ).setPersistenceLayer( persistenceLayer );

Reference

create

Creates a persistence layer that stores data in WordPress user meta via the REST API.

Parameters

  • options Object:
  • options.preloadedData ?Object: Any persisted preferences data that should be preloaded. When set, the persistence layer will avoid fetching data from the REST API.
  • options.localStorageRestoreKey ?string: The key to use for restoring the localStorage backup, used when the persistence layer calls localStorage.getItem or localStorage.setItem.
  • options.requestDebounceMS ?number: Debounce requests to the API so that they only occur at minimum every requestDebounceMS milliseconds, and don’t swamp the server. Defaults to 2500ms.

Returns

  • Object: A persistence layer for WordPress user meta.

Contributing to this package

This is an individual package that’s part of the Gutenberg project. The project is organized as a monorepo. It’s made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to npm and used by WordPress as well as other software projects.

To find out more about contributing to this package or Gutenberg as a whole, please read the project’s main contributor guide.