# vscode-xml-complete

**Repository Path**: zhchmmx/vscode-xml-complete

## Basic Information

- **Project Name**: vscode-xml-complete
- **Description**: XML Complete gitee镜像
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-02-21
- **Last Updated**: 2023-02-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Xml Complete

This extension helps with editing XML files by providing hints. Sample [schema files](https://github.com/rogalmic/vscode-xml-complete/tree/master/test) provided for `XAML` file types (`WPF`, `Avalonia`) and for `csproj` files.

It does not require any runtime like `java`, `python` or `xmllint`, while does partial XSD parsing.

## Features

- Basic linter (XML + partial XSD validation)

[<img src="https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/gif/images/vscode-xml-complete-linter.png" width="400" style="filter: blur(1px); " title="Click to show in browser"/>](https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/gif/images/vscode-xml-complete-linter.png)

- Fast autocomplete based on XSD (utilizes comments from XSD)

[<img src="https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/gif/images/vscode-xml-complete-complete.png" width="400" style="filter: blur(1px); " title="Click to show in browser"/>](https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/gif/images/vscode-xml-complete-complete.png)

- Formatting XML (selected range or full document)

[<img src="https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/gif/images/vscode-xml-complete-format.png" width="400" style="filter: blur(1px); " title="Click to show in browser"/>](https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/gif/images/vscode-xml-complete-format.png)

- Auto-closing and auto-rename for currently edited tag (works only for single tag in given line)

[<img src="https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/gif/images/vscode-xml-complete-auto.png" width="400" style="filter: blur(1px); " title="Click to show in browser"/>](https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/gif/images/vscode-xml-complete-auto.png)

- Mouse hover documentation for xml nodes/attributes (utilizes comments from XSD)

- Go to definition support (using XSD as target)


## Configuration

### Extension configuration per XML namespace
```javascript
"xmlComplete.schemaMapping":
[
 {
  "xmlns": "https://github.com/avaloniaui",
  "xsdUri": "https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/master/test/Avalonia/AvaloniaXamlSchema.xsd",
  "strict": true // shows errors instead of tips
 }
]
```
### Using `schemaLocation` or `noNamespaceSchemaLocation` attribute directly in edited file
```xml
<root
...
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/master/test/Avalonia/AvaloniaXamlSchema.xsd"
/>
```

### Supported URI protocols

| Protocol  | Description                     | Example
|:---------:|:-------------------------------:|:---------------------------------:
| `data`    | XSD encoded directly in link    | `data:text/plain;base64,SGVsbG8sIFdvcmxkIQ%3D%3D`
| `file`    | XSD from local storage          | `file:///c:/windows/example.ini`
| `ftp`     | XSD from ftp server             | `ftp://ftp.kernel.org/pub/site/README`
| `http`    | XSD from http server            | `http://www.example.com/path/to/name`
| `https`   | XSD from https server           | `https://www.example.com/path/to/name`

XSD location URIs can be [whitespace separated](https://raw.githubusercontent.com/rogalmic/vscode-xml-complete/master/test/Svg/Test.svg). Only absolute paths are fully supported, but when a [plain filename](https://github.com/rogalmic/vscode-xml-complete/blob/master/test/Custom3/IO-Link-01-DirectParamsDevice-20130515-IODD1.1.xml) is provided, the extension will search for schema next to local file for convenience.

## Known Issues

- This is a preview version, bugs expected...