上下文

宿主向 mount、activate 和命令处理器传入上下文。可选能力取决于声明、挂载位置和宿主支持，调用前应检查是否存在。将订阅加入 subscriptions；signal 随调用方作用域结束，共享 background 连接有独立的生命周期。

使用指南: views. API 索引.

签名、参数及返回类型从 SDK 自动生成；可选成员不保证在每个宿主和上下文中存在。

Lifetime

源码

Lifetime.signal

readonly signal: AbortSignal;

Lifetime.subscriptions

readonly subscriptions: {
    add<T extends Disposable>(value: T): T;
};

关联类型: Disposable.

CommonCapabilities

源码

CommonCapabilities.background

readonly background?: PluginBackground;

CommonCapabilities.fs

readonly fs?: PluginFileSystem;

CommonCapabilities.filemeta

readonly filemeta?: PluginFileMeta;

CommonCapabilities.storage

readonly storage?: PluginStorage;

CommonCapabilities.network

已废弃

readonly network?: PluginNetwork;

CommonCapabilities.settings

readonly settings?: Pick<PluginSettings, "get">;

CommonCapabilities.connections

readonly connections?: PluginConnections;

CommonCapabilities.ui

readonly ui: HostUI;

关联类型: PluginBackground, PluginFileSystem, PluginFileMeta, PluginStorage, PluginNetwork, PluginSettings, PluginConnections, HostUI.

CommonContext

源码

interface CommonContext extends Lifetime { /* members below */ }

CommonContext.i18n

readonly i18n: PluginI18n;

CommonContext.capabilities

readonly capabilities: CommonCapabilities;

关联类型: PluginI18n, CommonCapabilities, Lifetime.

PluginI18n

源码

PluginI18n.locale

readonly locale: string;

PluginI18n.t

t(key: string, values?: Record<string, string | number>): string;

参数	类型	必填
key	string	是
values	Record<string, string &#124; number>	否

返回值: string.

PluginI18n.onDidChangeLocale

onDidChangeLocale(listener: (event: {
    locale: string;
}) => void): Disposable;

参数	类型	必填
listener	(event: { locale: string; }) => void	是

返回值: Disposable.

关联类型: Disposable.

ViewCapabilities

源码

interface ViewCapabilities extends CommonCapabilities { /* members below */ }

ViewCapabilities.explorer

readonly explorer?: ExplorerContext;

ViewCapabilities.document

readonly document?: TextDocument;

ViewCapabilities.eidos

readonly eidos?: EidosCapabilities;

关联类型: ExplorerContext, TextDocument, EidosCapabilities, CommonCapabilities.

ViewContext

源码

interface ViewContext extends CommonContext { /* members below */ }

ViewContext.presentation

readonly presentation?: {
    mode: "standalone" | "embedded";
};

ViewContext.binding

readonly binding: ViewBinding;

ViewContext.capabilities

readonly capabilities: ViewCapabilities;

关联类型: ViewBinding, ViewCapabilities, CommonContext.

TextFileViewContext

源码

export type TextFileViewContext = ViewContext & {
    readonly binding: Extract<ViewBinding, {
        kind: "file";
    }>;
    readonly capabilities: ViewCapabilities & {
        readonly document: TextDocument;
    };
};

关联类型: ViewContext, ViewBinding, ViewCapabilities, TextDocument.

TableFileViewContext

源码

export type TableFileViewContext = ViewContext & {
    readonly binding: Extract<ViewBinding, {
        kind: "file";
    }>;
    readonly capabilities: ViewCapabilities & {
        readonly eidos: EidosCapabilities & {
            readonly table: EidosTable;
        };
    };
};

关联类型: ViewContext, ViewBinding, ViewCapabilities, EidosCapabilities, EidosTable.

ActionContext

源码

interface ActionContext extends CommonContext { /* members below */ }

ActionContext.binding

readonly binding: ActionBinding;

ActionContext.capabilities

readonly capabilities: CommonCapabilities & {
    readonly document?: TextDocument;
    readonly settings: PluginSettings;
};

关联类型: ActionBinding, CommonCapabilities, TextDocument, PluginSettings, CommonContext.

ExtensionContext

源码

interface ExtensionContext extends Lifetime { /* members below */ }

ExtensionContext.i18n

readonly i18n: PluginI18n;

ExtensionContext.capabilities

readonly capabilities: {
    readonly hooks: {
        register(id: string, handler: FileHookHandler): Disposable;
    };
    readonly formatters: {
        register(id: string, provider: FormatterProvider): Disposable;
    };
    readonly actions: {
        registerTableProvider(id: string, provider: TableActionProvider): Disposable;
        register(id: string, handler: (ctx: ActionContext) => void | Promise<void>): Disposable;
    };
};

关联类型: PluginI18n, FileHookHandler, Disposable, FormatterProvider, TableActionProvider, ActionContext, Lifetime.

TableActionContext

源码

TableActionContext.i18n

readonly i18n: PluginI18n;

TableActionContext.signal

readonly signal: AbortSignal;

TableActionContext.capabilities

readonly capabilities: TableActionCapabilities;

关联类型: PluginI18n, TableActionCapabilities.

Mount

源码

export type Mount = (ctx: ViewContext, root: HTMLElement) => void | Disposable | Promise<void | Disposable>;

关联类型: ViewContext, Disposable.

Activate

源码

export type Activate = (ctx: ExtensionContext) => void | Disposable | Promise<void | Disposable>;

关联类型: ExtensionContext, Disposable.