# @wordpress/views A lightweight package for managing DataViews view state with persistence using WordPress preferences. The `@wordpress/views` package provides: - **Persistence**: Automatically saves and restores DataViews state using `@wordpress/preferences` - **View Modification Detection**: Tracks when views differ from their default state - **Reset Functionality**: Simple reset to default view capability - **Clean Integration**: Drop-in replacement for manual view state management ## Installation Install the module ```bash npm install @wordpress/views --save ``` ## API Reference ### loadView Async function for loading view state in route loaders. Resolves the same layers `useView` does, so a route loader and the hook that takes over from it agree on the view. _Parameters_ - _config_ `ViewConfig`: Configuration object for loading the view. - _config.kind_ `ViewConfig`: Entity kind (e.g., 'postType', 'taxonomy', 'root'). - _config.name_ `ViewConfig`: Specific entity name. - _config.slug_ `ViewConfig`: View identifier. - _config.defaultView_ `ViewConfig`: Default view configuration. - _config.defaultLayouts_ `ViewConfig`: Default layout configurations keyed by layout type. - _config.activeViewOverrides_ `ViewConfig`: View overrides applied on top but never persisted. - _config.queryParams_ `ViewConfig`: Object with `page` and/or `search` from URL. _Returns_ - Promise resolving to the loaded view object. ### useView Hook for managing DataViews view state with local persistence. Only the properties the user actually modified are persisted: every other property keeps resolving out of the layers below, so a change to the default view, to the layout defaults or to the active view overrides keeps showing through. _Parameters_ - _config_ `ViewConfig`: Configuration object for loading the view. _Returns_ - `UseViewReturn`: Object with current view, modification state, and update functions. ### useViewConfig A hook that retrieves the view configuration for a given entity from the core data store. _Parameters_ - _params_ `Object`: - _params.kind_ `string`: The kind of the entity. - _params.name_ `string`: The name of the entity. - _params.fields_ `[?(string|string[])]`: Subset of top-level config properties to request, as an array or a comma-separated string (mapped to the REST API `_fields` parameter). When omitted, the full config is requested. _Returns_ - `Object`: An object containing the `default_view`, `default_layouts`, `view_list`, and `form` configuration for the entity.