Options
All
  • Public
  • Public/Protected
  • All
Menu

Class RenderMimeRegistry

An object which manages mime renderer factories.

This object is used to render mime models using registered mime renderers, selecting the preferred mime renderer to render the model into a widget.

Notes

This class is not intended to be subclassed.

Hierarchy

  • RenderMimeRegistry

Implements

Index

Constructors

constructor

  • Construct a new rendermime.

    Parameters

    • Optional options: IOptions

      The options for initializing the instance.

    Returns RenderMimeRegistry

Properties

Private _factories

_factories: any

Private _id

_id: any

Private _ranks

_ranks: any

Private _types

_types: any

Readonly latexTypesetter

latexTypesetter: ILatexTypesetter

The LaTeX typesetter for the rendermime.

Readonly linkHandler

linkHandler: ILinkHandler

The object used to handle path opening links.

Readonly resolver

resolver: IResolver

The object used to resolve relative urls for the rendermime instance.

Readonly sanitizer

sanitizer: ISanitizer

The sanitizer used by the rendermime instance.

Readonly translator

translator: ITranslator

The application language translator.

Accessors

mimeTypes

  • get mimeTypes(): readonly string[]
  • The ordered list of mimeTypes.

    Returns readonly string[]

Methods

addFactory

  • Add a renderer factory to the rendermime.

    Parameters

    • factory: IRendererFactory

      The renderer factory of interest.

    • Optional rank: number

      The rank of the renderer. A lower rank indicates a higher priority for rendering. If not given, the rank will defer to the defaultRank of the factory. If no defaultRank is given, it will default to 100.

      Notes

      The renderer will replace an existing renderer for the given mimeType.

    Returns void

clone

  • Create a clone of this rendermime instance.

    Parameters

    • Optional options: ICloneOptions

      The options for configuring the clone.

    Returns RenderMimeRegistry

    A new independent clone of the rendermime.

createModel

  • Create a new mime model. This is a convenience method.

    options
    • The options used to create the model.

    Parameters

    Returns MimeModel

    A new mime model.

createRenderer

  • createRenderer(mimeType: string): IRenderer
  • Create a renderer for a mime type.

    throws

    An error if no factory exists for the mime type.

    Parameters

    • mimeType: string

      The mime type of interest.

    Returns IRenderer

    A new renderer for the given mime type.

getFactory

  • Get the renderer factory registered for a mime type.

    Parameters

    • mimeType: string

      The mime type of interest.

    Returns IRendererFactory

    The factory for the mime type, or undefined.

getRank

  • getRank(mimeType: string): number
  • Get the rank for a given mime type.

    Parameters

    • mimeType: string

      The mime type of interest.

    Returns number

    The rank of the mime type or undefined.

preferredMimeType

  • preferredMimeType(bundle: ReadonlyPartialJSONObject, safe?: "ensure" | "prefer" | "any"): string
  • Find the preferred mime type for a mime bundle.

    Parameters

    • bundle: ReadonlyPartialJSONObject

      The bundle of mime data.

    • Optional safe: "ensure" | "prefer" | "any"

      How to consider safe/unsafe factories. If 'ensure', it will only consider safe factories. If 'any', any factory will be considered. If 'prefer', unsafe factories will be considered, but only after the safe options have been exhausted.

    Returns string

    The preferred mime type from the available factories, or undefined if the mime type cannot be rendered.

removeMimeType

  • removeMimeType(mimeType: string): void
  • Remove a mime type.

    Parameters

    • mimeType: string

      The mime type of interest.

    Returns void

setRank

  • setRank(mimeType: string, rank: number): void
  • Set the rank of a given mime type.

    Parameters

    • mimeType: string

      The mime type of interest.

    • rank: number

      The new rank to assign.

      Notes

      This is a no-op if the mime type is not registered.

    Returns void

Generated using TypeDoc