dnadesign/silverstripe-patternlab

模式实验室。

安装数: 1,919

依赖者: 0

建议者: 0

安全性: 0

星标: 6

关注者: 15

分支: 3

开放问题: 1

类型:silverstripe-module

dev-master 2016-01-21 20:48 UTC

This package is auto-updated.

Last update: 2024-09-06 15:00:11 UTC


README

介绍

模式实验室是一个模块,允许SilverStripe开发者在单个位置定义静态HTML,以便进行测试。在项目开发过程中,页面上的一个元素可能有多个状态或变化,需要通过浏览器进行测试。然而,由于CMS是数据库驱动的,并不能保证所有可能的实例都会包含在现有内容中。模式实验室允许您为这些变化创建静态HTML,以记录和测试每一个。

您可以在此处了解更多关于模式实验室的信息:http://bradfrostweb.com/blog/post/atomic-web-design/

使用此模块

在您的模板目录下创建一个模式文件夹:templates

  • 模式

然后在这个文件夹中开始创建模式模板,例如:templates

  • 模式
    • Pattern1
    • Pattern2

这些将在索引页面的/patterns位置自动显示,您可以通过点击进入模式,然后渲染该模式的模板。

由于这些不是页面,需要在每个文件中包含<head>标签,我们通常建议以下做法

<% include Head %>
Some Content
<% include Foot %>

在Page.ss中使用上述包含确保head标记、文档类型等的连贯性。

自定义实验室控制器

可选地通过名称,如MyPatternLab扩展PatternLab_Controller

class MyPatternLab extends PatternLab {

}

这允许您添加一个init函数,类似于Page.php的init函数,以确保它们包含相同的CSS和Js。

您需要创建一个routes.yml文件来覆盖现有的路由配置

---
name: routes
After: 'pattern-lab'
---
Director:
  rules:
    'patterns//$Action/$ID/$Name': 'MyPatternLab'