Interface ContextKeyService

ReadonlyonDidChange

createKey

• createKey<T extends ContextKeyValue>(
      key: string,
      defaultValue: undefined | T,
  ): ContextKey<T>

  Type Parameters

  • T extends ContextKeyValue

  Parameters

  • key: string
  • defaultValue: undefined | T

  Returns ContextKey<T>

createOverlay

• createOverlay(overlay: Iterable<[string, unknown]>): ContextMatcher

  Parameters

  • overlay: Iterable<[string, unknown]>

    values to be used in the new ContextKeyService. These values will be static. Creates a child service with a separate context and a set of fixed values to override parent values.

  Returns ContextMatcher

createScoped

• createScoped(target: HTMLElement): ScopedValueStore

  Creates a child service with a separate context scoped to the HTML element passed in. Useful for e.g. setting the {view} context value for particular widgets.

  Parameters

  • target: HTMLElement

  Returns ScopedValueStore

parseKeys

• parseKeys(expression: string): undefined | Set<string>

  Parameters

  • expression: string

  Returns undefined | Set<string>

  a Set of the keys used by the given expression or undefined if none are used or the expression cannot be parsed.

setContext

• setContext(key: string, value: unknown): void

  Set or modify a value in the service's context.

  Parameters

  • key: string
  • value: unknown

  Returns void

with

• with<T>(values: Record<string, unknown>, callback: () => T): T

  Creates a temporary context that will use the values passed in when evaluating callback. The callback must be synchronous.

  Type Parameters

  • T

  Parameters

  • values: Record<string, unknown>
  • callback: () => T

  Returns T