Snowboard.js - Winter JavaScript 框架

• Introduction
• Features
• 包括框架
• 手动包含框架

#Introduction

Winter 包括一个可选的 JavaScript 框架，称为Snowboard，这是对以前的升级AJAX 架构 并以可扩展的方式提供许多有用的新功能，同时放弃以前的硬依赖性以进一步增强您的项目。

该框架利用了近年来对 JavaScript 生态系统做出的令人难以置信的增强，以提供仅在Winter可用的独特体验。

#Features

• 重写的 AJAX 和 JavaScript 框架，使用最新的 JavaScript 语法 (ES2015+) 和功能从头开始构建。
• 不依赖于 jQuery，允许在各种 JavaScript 项目中使用该框架。
• 简单、全面的可扩展性和事件处理。
• 占地面积小并完全控制要包含的核心功能可确保您的网站快速加载。

#包括框架

在继续之前，请阅读迁移指南，特别是如果您打算在现有项目上使用此框架。

滑雪板可以包含在您的内容管理系统主题 通过放置{% snowboard %} 在你的任何地方做标记page 或者layout 您希望加载 JavaScript 资产的位置 - 通常，这应该在关闭之前的页面底部</body> 标签。你必须使用这个标签before 您加载依赖框架的任何资产，例如插件或事件监听器，它也应该位于{% scripts %} 标签以允许第三方代码（即Winter插件） 提供滑雪板插件 如果他们愿意的话。

默认情况下，只有基础 Snowboard 框架和必要的实用程序 包含在{% snowboard %} token 以便完全控制哪些附加功能（例如 AJAX 框架）需要包含在您的主题中。

您可以为标签指定更多属性，以包含框架的可选附加功能：

要将 Snowboard 添加到您的主题并启用其所有功能，您将使用以下内容：

{% snowboard all %}

要包含仅具有 JavaScript AJAX 请求功能的框架：

{% snowboard request %}

或者同时包括 JavaScript AJAX 和 HTML 数据属性请求功能：

{% snowboard request attr %}

#手动包含框架

已创建以下资产别名，以便可以使用资产组合器轻松包含框架：

• @snowboard.base
• @snowboard.attr
• @snowboard.request
• @snowboard.extras
• @snowboard.extras.css

您可以像这样使用资产组合器树枝过滤器来包含您的样式表：

<link rel="stylesheet" href="{{ [
    '@snowboard.extras.css',
    [other assets here]
] | theme }}">

您可以像这样使用资产组合器树枝过滤器来包含您的脚本：

<script src="{{ [
    '@snowboard.base',
    '@snowboard.attr',
    '@snowboard.request',
    '@snowboard.extras',
] | theme }}"></script>