ModelCategoryInstance <D>

An Instance that provide methods to request information from a ModelCategory and its Entries.

You can access a ModelCategoryInstance using ModelInstance.category or using the dynamic syntax on a DynamicModelInstance. Usage examples will use the dynamic syntax.

To list all categories from a model, use a ModelCategorySelector.

Index

Methods

• entries
• get

Methods

entries

• entries(params?: ModelCategoryEntryListParams & QueryableFields<D>, options?: RequestInit): Promise<StarlightListResponse<Entry<D>>>

• Returns a StarlightListResponse with the list of entries of this ModelCategory.

  @example

  Requesting all items from a category called “gaming” in a model of slug “posts”.

  import Starlight from '@starlightcms/js-sdk'
  
  const response = await Starlight.posts.gaming.items()

  @example

  Paginating and searching on the last example.

  import Starlight from '@starlightcms/js-sdk'
  
  const response = await Starlight.posts.gaming.items({
    page: 5,
    query: 'kirby'
  })

  ---

  Parameters

  • optionalparams: ModelCategoryEntryListParams & QueryableFields<D>

    An optional object of request parameters. See ModelCategoryEntryListParams for all available parameters. field:foo syntax is also supported, see QueryableFields for more info.

  • optionaloptions: RequestInit

    An optional object of fetch options. See https://developer.mozilla.org/en-US/docs/Web/API/RequestInit for more info.

  Returns Promise<StarlightListResponse<Entry<D>>>

get

• get(params?: BaseRequestParameters, options?: RequestInit): Promise<StarlightItemResponse<ModelCategory>>

• Returns a StarlightItemResponse with a single ModelCategory.

  @example

  Requesting information from a category called “articles” in a model of slug “posts”.

  import Starlight from '@starlightcms/js-sdk'
  
  const response = await Starlight.posts.articles.get()

  ---

  Parameters

  • optionalparams: BaseRequestParameters

    An optional object of request parameters.

  • optionaloptions: RequestInit

    An optional object of fetch options. See https://developer.mozilla.org/en-US/docs/Web/API/RequestInit for more info.

  Returns Promise<StarlightItemResponse<ModelCategory>>