echarts-enhanced-completion

中文文档

This is an extension of vscode that is used to prompt completion when editing the options of echarts.

Installed extensions

Search for echarts-enhanced-completion in the vscode extension, and then click to install.

Getting Started

After install and enable the extension, add a comment on the previous line of the object you need to use as the option of echarts: /** @type EChartsOption */(Enter echartsoption to use code snippets). It is used to define an object as echarts option object. Now, when you press the Enter key in the echarts option object, the extension will display a list of the option you may need, and there is a detailed description of the option in the prompt.

Snapshots

Features

• Trigger completion prompt after Enter.

• The completion prompt has a detailed description consistent with the official website for each option.

• Support multiple option objects in a single file.

• hover attribute display description.

• Support configurable initialization options.

• Support checking attribute values.

Requirements

• Supported file types: html, javascript, typescript, vue, php, razor.

• There must be no syntax errors in the option object. Because the extension needs to parse the option object when it works.

Extension Settings

Configuration items are in Settings => Extensions => Echarts Enhanced Completion

Init: Custom

When the configuration item is initialized, the program will provide options for quick initialization, but it may not meet your requirements, so we allow custom initialization options. Edit the echarts-enhanced-completion.init.custom item in the vscode settings file.

The value type is BaseOptions and is defined as follows:

type BaseOptions = BaseOption[];

interface BaseOption {
    name: string;
    imgSrc?: string;
    code: string;
}

Validation > Rule: Custom

Validation rules can help you better spot errors and omissions when using configuration items. Currently, there are few default rules, so we allow custom rules to supplement. Edit the echarts-enhanced-completion.validation.rule.custom item in the vscode settings file.

The value type is DependRules and is defined as follows:

type DependRules = DependRule[];

interface DependRule {
    /** Target key, concatenated with `.`. */
    key: string;
    msg: string;
    depends: DependItem[];
    /** Default is 0. */
    severity?: 0 | 1 | 2 | 3; // vscode.DiagnosticSeverity
    options?: Array<string|number|boolean>;
    disable?: boolean;
}

type DependItem = ExpectedDepend | ExcludeDepend;

interface ExpectedDepend {
    key: string;
    /** Default value. If not provided, it is equal to the `expectedValue` */
    defaultValue?: string | number | boolean | null;
    expectedValue: string | number | boolean | null;
    msg?: string;
}

interface ExcludeDepend {
    key: string;
    /** Default value. If not provided, it is equal to the `excludeValue` */
    defaultValue?: string | number | boolean | null;
    excludeValue: string | number | boolean | null;
    msg?: string;
}

For example, this property works only if show: true is configured and backgroundColor is defined other than transparent(This rule has been used as the default rule.):

{
    "echarts-enhanced-completion.validation.rule.custom": [
        {
            "key": "legend.shadowBlur",
            "msg": "This property works only if show: true is configured and backgroundColor is defined other than transparent.",
            "severity": 0,
            "depends": [
                {
                    "key": "legend.show",
                    "defaultValue": true,
                    "expectedValue": true,
                },
                {
                    "key": "legend.backgroundColor",
                    "defaultValue": "transparent",
                    "excludeValue": "transparent",
                },
            ],
        }
    ]
}

Results as shown below:

Issues

If you encounter any problem in use, you can create a Issues and we will solve it for you as soon as possible.

About

Document source: echarts-doc