1
0
mirror of https://github.com/SpaceVim/SpaceVim.git synced 2025-01-24 14:50:04 +08:00
SpaceVim/docs/cn/api.md
2021-08-06 21:07:50 +08:00

64 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: "可用接口"
description: "SpaceVim 接口函数库提供了一套开发插件的公共接口,以及 Neovim 和 Vim 的兼容组件。"
lang: zh
---
# [主页](../) >> 可用接口
<!-- vim-markdown-toc GFM -->
- [简介](#简介)
- [使用方法](#使用方法)
- [可用 APIs](#可用-apis)
<!-- vim-markdown-toc -->
## 简介
为了兼容不同版本的 Vim避免使用重复的兼容函数SpaceVim 提供了一套兼容的公共 API。开发插件时
可以在你的插件中使用这些公共 API这一思想主要借鉴于 [vital.vim](https://github.com/vim-jp/vital.vim)。
## 使用方法
可以通过 `SpaceVim#api#import()` 函数导入相关 API参考以下示例
```vim
" 导入 file API并赋值给变量 s:file
let s:file = SpaceVim#api#import('file')
" 导入 system API并赋值给变量 s:system
let s:system = SpaceVim#api#import('system')
" 调用 system API 的 isWindows 成员变量
if s:system.isWindows
echom "OS is Windows"
endif
echom s:file.separator
echom s:file.pathSeparator
```
<!-- call SpaceVim#dev#api#updateCn() -->
<!-- SpaceVim api cn list start -->
## 可用 APIs
| 名称 | 描述 |
| ------------------------------------- | ----------------------------------------------------------------------- |
| [cmdlinemenu](cmdlinemenu/) | cmdlinemenu 接口函数提供了一套通过命令行进行选择的快捷接口。 |
| [data#dict](data/dict/) | data#dict 接口提供了一些处理字典变量的常用方法,包括基础的增删改查。 |
| [data#list](data/list/) | data#list 函数库主要提供一些操作列表的常用函数。 |
| [data#number](data/number/) | data#number 函数库主要提供一些操作数字的常用函数。 |
| [data#string](data/string/) | data#string 函数库主要提供一些操作字符串的常用函数。 |
| [file](file/) | 文件函数提供了基础的文件读写相关函数,兼容不同系统平台。 |
| [job](job/) | 兼容 neovim 和 vim 的异步协同接口,对于旧版 vim 采用非异步机制 |
| [notify](notify/) | notify 接口提供了一个弹出通知消息的接口函数 |
| [system](system/) | system 函数提供了系统相关函数,包括判断当前系统平台,文件格式等函数。 |
| [unicode#spinners](unicode/spinners/) | unicode#spinners API 可启用一个定时器,根据指定的名称定时更新进度条符号 |
| [vim#command](vim/command/) | vim#command 接口提供一些设置和获取 Vim 命令的基础函数。 |
| [vim#highlight](vim/highlight/) | vim#highlight API 提供一些设置和获取 Vim 高亮信息的基础函数。 |
| [vim#message](vim/message/) | vim#message API 提供一些设置和获取 Vim 提示消息的函数。 |
| [vim#signatures](vim/signatures/) | vim#signatures API 提供一些设置和获取 Vim 提示消息的函数。 |
<!-- SpaceVim api cn list end -->