dnadesign / silverstripe-patternlab
模式实验室。
dev-master
2016-01-21 20:48 UTC
Requires
- silverstripe/cms: 3.*
- silverstripe/framework: 3.*
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'