Mídia

Você pode requisitar arquivos de mídia facilmente utilizando um MediaSelector. Os métodos desse Selector retornam objetos do tipo MediaObject.

Geralmente, você não precisa utilizar o SDK para requisitar dados sobre arquivos de mídia, já que esses já são retornados por outras entidades que utilizam os arquivos. Por exemplo, uma entradaEntradas são instâncias de um modelo, como uma postagem de um blog ou uma edição de uma revista. de um modeloModelos representam dados que se repetem, como posts de um blog ou revistas. que retorna uma "imagem destacada" já retorna todos os dados do arquivo de mídia selecionado. Assim, não é necessário requisitar esses dados novamente. O mesmo acontece em arquivos de mídia usados no editor de texto visual do Starlight, e seus dados são incluídos juntos ao conteúdo.

MediaSelector

Visualizar na API

MediaSelectors são utilizados para listar e requisitar arquivos de mídia de uma área de trabalhoÁreas de trabalho representam sites ou aplicativos no Starlight. Todo conteúdo pertence à uma área de trabalho.. Para usar um MediaSelector, basta acessar a propriedade media de um cliente do SDK:

import Starlight from '@starlightcms/js-sdk'

// A propriedade media é um MediaSelector
const media = Starlight.media

Em geral, você não precisa utilizar um MediaSelector como no exemplo acima. Você pode simplesmente encadear seus métodos para requisitar o que você precisa. Por exemplo:

import Starlight from '@starlightcms/js-sdk'

// Listar todos os arquivos de mídia da área de trabalho.
const response = await Starlight.media.list()

// Requisitar os dados de um arquivo de mídia específico.
// Note que arquivos de mídia precisam ser requisitados usando seus IDs.
const response = await Starlight.media.get('1234567890')