# Custom Hooks: usePostMeta

A custom React hook that wraps `useEntityProp` for working with postmeta. It
returns an array that contains a copy of postmeta as well as a helper
function that sets a meta value for a given key. This hook is intended to
reduce boilerplate code in components that need to read and write postmeta.
By default, it operates on postmeta for the current post, but you can
optionally pass a post type and post ID in order to get and set post meta
for an arbitrary post.

## Usage

### Editing the Current Post's Meta

```jsx
const MyComponent = () => {
  const [{
    my_meta_key: myMetaKey = 'myDefaultValue',
  }, setMeta] = usePostMeta();

  return (
    <TextControl
      label={__('My Meta Key', 'zephr')}
      onChange={(next) => setMeta('my_meta_key', next)}
      value={myMetaKey}
    />
  );
};
```

### Editing Another Post's Meta

```jsx
const MyComponent = ({
  postId,
  postType,
}) => {
  const [{
    my_meta_key: myMetaKey = 'myDefaultValue',
  }, setMeta] = usePostMeta(postType, postId);

  return (
    <TextControl
      label={__('My Meta Key', 'zephr')}
      onChange={(next) => setMeta('my_meta_key', next)}
      value={myMetaKey}
    />
  );
};
```