Skip to content

Files

Latest commit

f467e1d · Jun 18, 2024

History

History

use-media

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Jun 18, 2024
Mar 7, 2024

useMedia

The useMedia hook is a simple helper to quickly get something from the WordPress Media Library. It accepts the id of the media element as it's only parameter and returns an object containing the media object itself (media), whether it is still loading (isResolvingMedia), and whether it has finished resolving (hasResolvedMedia).

Usage

import { useMedia } from '@10up/block-components';

function BlockEdit(props) {
    const { attributes } = props;
    const { imageId } = attributes;

    const { media, hasResolvedMedia } = useMedia( imageId );

    if ( ! hasResolvedMedia ) {
        return <Spinner />
    }

    return (
        <img src={ media.source_url } alt={ media.alt_text } />
    );
}

Note: In most cases it makes more sense to use the Image Component instead since that uses the useMedia hook under the hood.