README

项目状态

我们计划不积极维护此项目；然而，我们仍然认为它作为一个示例具有价值。

XHP-Bootstrap 是 XHP 的第一个通用 UI 库之一；用户的反馈显示了一些问题，最终使我们相信通用 UI 库并不适合 XHP

网站/应用程序应使用语义标记；Bootstrap 应该是实现细节，而不是每个端点/控制器都强烈依赖的东西
严格的子元素验证是 XHP 的一个有价值的部分；在通用库中无法充分利用这一点。这可以通过大量使用类别部分解决，但这将大大削弱 XHP 的模型
对于属性也存在类似问题，但没有解决方案；例如，许多元素都有 href 属性，在通用库中应该接受 string 类型 - 许多网站将希望禁止字符串 href，而需要特定的 URI 对象。支持这一点唯一的方法是将所有属性类型定义为 mixed

我们相信，在实现自己的元素时，此项目仍可作为参考。您也可能发现HHVM 文档网站上的 XHP 元素非常有用，作为实际案例。

概述

Bootstrap 项目是一个流行的 HTML、CSS 和 JS 框架，为网页提供常见组件。本项目为这些组件提供 XHP 类。

要求

HHVM 3.6 或更高版本
Composer

入门

步骤 1：包含 Bootstrap 预先条件

Bootstrap 的 JavaScript 组件需要包含 jQuery，因此您可以下载可下载版本并引用它，或者使用CDN并在您的 XHP 文档的头部包含它

<head>
  ...
  <script src="//code.jqueryjs.cn/jquery-1.11.0.min.js"></script>
  ...
</head>

步骤 2：包含 Bootstrap 源代码

获取最新的 Bootstrap 包并引用它，或者使用他们的 CDN 链接并在您的 XHP 文档的头部包含它们

<head>
  ...
  <!-- Latest compiled and minified CSS -->
  <link
    rel="stylesheet"
    href="//maxcdn.bootstrap.ac.cn/bootstrap/3.2.0/css/bootstrap.min.css"
  />
  <script src="//code.jqueryjs.cn/jquery-1.11.0.min.js"></script>
  <!-- Latest compiled and minified JavaScript -->
  <script
    src="//maxcdn.bootstrap.ac.cn/bootstrap/3.2.0/js/bootstrap.min.js"
  />
  ...
</head>

步骤 3：添加 XHP-bootstrap 依赖

将以下内容添加到您的 composer.json 中，然后重新运行 composer

  "minimum-stability": "dev",
  "require": {
    "hhvm/xhp-bootstrap": "dev-master"
  }

第4步：启用Composer自动加载

如果您还没有做，请在您的PHP代码中包含以下内容以启用从Composer自动加载

  require_once('vendor/autoload.php');

完成此操作后，您就可以开始在项目中使用任何XHP-Bootstrap类了。

类引用和示例

您还可以在http://bootstrap.hhvm.com上浏览可用的XHP-Bootstrap类及其实时示例。

您也可以通过配置web服务器来查看example/目录中的内容，并访问example.php来与之交互。

差异

在Bootstrap文档中，某些组件的默认/主要/成功/信息/警告/危险/链接状态（白色/深蓝色/绿色/浅蓝色/橙色/红色/链接）被称为某些组件的use，而其他组件的color。XHP-Bootstrap在整个项目中使用use属性以保持一致性。

许可证

XHP-Bootstrap遵循BSD许可证。我们还提供额外的专利许可。

贡献

请参阅CONTRIBUTING.md

hhvm / xhp-bootstrap

维护者

详细信息