Polymer 1 Snippets 0.0.1

新的介绍内容：

Polymer 1 Snippets是一款专门为Visual Studio Code设计的扩展，旨在通过提供丰富的HTML和JavaScript代码片段，帮助开发者在Polymer 1框架下更高效地进行开发。无论您是希望在一个HTML文件中定义元素，还是在独立的文件中进行操作，Polymer 1 Snippets都能满足您的需求。

命名规范

为了提高代码的可读性和可维护性，Polymer 1 Snippets遵循了一套严格的命名规范：

• 私有属性和函数应以一个下划线（_）作为前缀。
• 处理事件的函数应以'_handle'作为前缀。
• 在listeners对象中分配的监听器函数应以'_listen'作为前缀。
• 在属性上分配的观察者或在observers数组中声明的函数应以'_observe'作为前缀。
• 计算函数应以'_compute'作为前缀。

这些命名规范旨在让开发者更清晰地理解代码结构，减少错误发生的可能性。

最佳实践

Polymer 1 Snippets还整合了Polymer的多项最佳实践：

• 布尔属性默认值设为false，以确保在标记中可以正确设置为false。
• 对于数组或对象属性，默认值通过函数分配，以确保每个元素拥有自己的副本，避免共享引用问题。

使用方法

使用Polymer 1 Snippets非常简单，只需输入代码片段的前缀（例如p-basic），按下回车键，片段就会自动展开。您可以通过Tab键在各个占位符间切换，根据需要输入值或使用默认值。

功能概览

Polymer 1 Snippets提供了多种类型的代码片段，涵盖属性、函数、行为、元素以及相关的文档片段。以下是部分片段示例：

属性片段

p-basic         // 基本属性及单行文档。
p-boolean       // 布尔属性，默认值为false。
p-basic-type    // 带类型文档的基本属性。
p-object-array  // 对象或数组属性及单行文档。
p-compute       // 带计算属性的属性。
p-observe       // 带观察者属性的属性。
p-all           // 包含所有可用属性的属性。

函数片段

f-1-param           // 带文档的一个参数函数。
f-2-param           // 带文档的两个参数函数。
f-3-param           // 带文档的三个参数函数。
f-void              // 带文档的无返回值函数。
f-observe-property  // 带文档的属性观察者函数。
f-handle-event      // 带文档的事件处理函数。

行为片段

b-basic      // 基本行为及文档。
b-extend     // 扩展现有行为及文档。

元素片段

el-basic   // 基本元素及文档。
el-all     // 包含所有可用分配及文档的元素。

要求

使用Polymer 1 Snippets需要安装Visual Studio Code 1.21.0或更高版本。

安装步骤

1. 安装Visual Studio Code 1.21.0或更高版本。
2. 启动Visual Studio Code。
3. 通过命令面板Ctrl-Shift-P（Windows, Linux）或Cmd-Shift-P（OSX）选择“安装扩展”。
4. 选择“Polymer 1 Snippets”扩展并安装。
5. 重新加载Visual Studio Code。

变更日志

所有重要变更将在CHANGELOG.md中记录。

贡献代码

欢迎参与贡献！请fork分支，创建新功能分支，添加您的更改并推送。提交拉取请求即可。

许可证

MIT许可证。