重构symfony.coob娱乐下载m前端

目前的symfony.cob娱乐下载om web站点创建之前Symfony 2.0的发布2011年7月。虽然代码不断更新最新的稳定版本(3.3 Symfony写这篇博文的时候),应用程序在某些部分显示出它的年龄。ob娱乐下载这就是为什么我们决定修改其前端简化模板和管理网络资产不同。

我们的前端需求简单,因此我们使用一个非常传统的设置基于引导3和一群SCSS和JavaScript文件。这对我们很好,在一开始,但这是最近变得越来越难维持。

重构过程花了将近两个星期,涉及50提交219个文件(主要是改变.html.twig和.scss)。我们添加或改变了6209行代码,删除10291行。在本文中,我们解释一些最相关的refactorization期间所做的更改。

新的资产组织

以前,我们有数万小SCSS文件除以其目的:code.scss,typography.scss,forms.scss等。除了很难重用风格,这种方法复杂的维护,因为很难找到所涉及的所有风格的设计给定的页面元素。

这是一个典型的开发人员错误:分裂成许多小块的东西相信这“模块化”设计更好,但最终难以维护混乱。

现在我们定义所有常见的风格在一个大app.scss文件,我们有专门的文件有特殊需要的页面:home.scss,download.scss等等。这使得设计大大简化了维护,帮助我们创造一个更加一致的设计,因为它更容易重用相同的风格不同的元素。

新的设计理念

之前的设计是“桌面第一”和新的“移动第一”,这是我们想要改变自很久以前的事了。任何功能是现在智能手机第一次进行设计和测试,然后我们调整为更大的设备如果需要。

现在的结果是,www.pdashmedia.com的ob娱乐下载内容很好地适应任何设备。例如,ob娱乐下载Symfony路线图页面,你可以找到有关当前和即将到来的Symfony版本的信息,现在智能手机上显示了一个垂直的路线图和水平路线图更大的设备上。ob娱乐下载看到这个页面的前后对比:

为了避免复杂的设计太多,我们决定定义两个响应断点:768 px为平板电脑和小型台式机和992 px剩下的设备。

新CSS样式

以前,我们没有使用任何特定CSS的方法和我们的大多数选择器依靠嵌套的HTMLid属性(如。# p-7-2。# #添加评论发表评论)。新的设计使用HTML类属性完全基于边界元方法。我们不适用本严格,因为它可以迅速变得过于冗长,但贝姆帮助我们创建一个更模块化、易于维护的设计。

另一个不错的改进包括第三方依赖更细粒度的方式。包括整个引导3的框架,而是我们现在选择准确的引导文件,我们需要:

/ / app.scss@进口”~ bootstrap-sass /资产/样式表/引导/变量”;@进口”~ bootstrap-sass /资产/样式表/引导/ mixin”;@进口”~ bootstrap-sass /资产/样式表/引导/正常化”;@进口”~ bootstrap-sass /资产/样式表/引导/网格”;/ /……

最后修改,允许我们简化风格很多的实用程序设置边缘属性(例如CSS类。.m-t-0意味着margin-top: 0,.m-b-15意味着margin-bottom: 15像素等)。

尽管有点争议,一些人认为他们可以膨胀CSS,在我们的例子中我们覆盖所有的需求只有10个实用程序类,进而拯救了我们很多无用的自定义CSS类,只有设置利润或填充。这些实用程序类来引导4。

新的工作流程

一开始,我们使用www.pdashmedia.com Assetic管理资产。ob娱乐下载然而,几个月前,我们删除它,开始过渡到基于javascript的资产管理。大多数非javascript开发人员,我们困惑的工具,但是最终我们决定使用Webpack。

Webpack包你的风格是一个很好的工具,脚本和图像,处理并生成最终的CSS和JavaScript文件。然而,起初Webpack很难掌握。幸运的是,我们有一个盟友:瑞安·韦弗。瑞安在过去的几个月,一直在秘密工作的一个新的JavaScript工具来管理网络资产。

这个新工具,叫做Webpack安可,是一种简单的方法将Webpack集成到您的应用程序。它包装Webpack,给你一个干净的和强大的API,用于捆绑JavaScript模块、预处理CSS & JS和编译和缩减资产。

我们一直使用这个工具在生产在www.pdashmedia.com上在过去的几个月,我必须说,这是一个喜ob娱乐下载悦。此外,这个新工具将成为官方推荐的方法来管理资产Symfony应用程序ob娱乐下载。你想在自己的项目中使用它吗?因为你不需要等待更长的时间它将在本周公布。

新嫩枝模板

前面的树枝模板是很好,但我们做了一些修改,简化使用现代树枝特性。这是我们使用的一些技巧,你也可以在自己的项目中使用:

零合并操作符:在树枝1.28中引入的,它提供了相同的? ?运营商所定义的PHP 7。这是一个很好的和简洁的更换默认的过滤器:

{%集版本=version_label? ?version_number? ?”当前的”%}{#相当于:#}{%集版本=version_label|违约(version_number)|违约(”当前的”)%}{#也相当于:#}{%集版本=version_label是定义吗?version_label:…%}

不要模板分割成很多碎片:分割成微小的碎片,并使用模板包括()包括他们的模板会损害性能。它还复杂的维护,因为很难找到定义的内容。

只在部分模板创建片段是真正在多个模板中重用。包括碎片时,更喜欢包括()函数包括标签,总是用树枝名称空间语法,这是速度比传统的包语法:

{#推荐的方法包括模板片段#}{{包括(@App /博客/ _list_comments.html.twig)}} {#这束符号使应用程序慢#}{{包括(AppBundle:博客:_list_comments.html.twig)}}

检查块的存在:另一个特性添加到树枝1.28的支持定义运营商的块,这是有用的,以检查他们的存在在高度动态模板:

{%如果块(”介绍”)是定义%}<部分>{{块(”介绍”)}}</部分>{%endblock%}

定义定制的树枝名称空间:在设计过程中,我们更换一个自定义图标字体与适当的SVG文件为每个图标。指很无聊(如那些文件模板。图片/图标/ arrow.svg,包/博客/图片/图标/ arrow.svg所以我们使用定制的树枝名称空间存储所有图标下图标名称空间和嵌入使用源()嫩枝功能:

{#树枝名称空间创建简洁漂亮的模板#}<我类=”图标”>{{源(”@icons / arrow.svg”)}}</我>

不关心空白在HTML代码:我们的工作是开发人员是创建可维护的树枝模板,不是产生完美的HTML代码。HTML被浏览器用户,支离破碎,缩小和压缩之前交付给浏览器,所以不要介意:

{#这是美丽的和易于维护#}<李类=”{{当前= =项目。鼻涕虫?‘选择’}}”…>{#这是一个混乱和复杂的一切毫无理由的#}<李{%如果当前的==item.slug= %}类”选择”{%endif%}…>

结果

结合以上提到的这些变化和技术,refactorization的结果是惊人的。symfob娱乐下载ony.com网站外观和感觉一样的,但是所有的设计问题,该网站是充分响应,“手机第一”,以及性能都得到了极大的改进:之前,每一个www.pdashmedia.com页面下载194 kb app.css文件(gzip之前);现在,常见app.css文件重量仅59 kb,减少高达70% !

尽管重构的目的并不是要改变网站的视觉设计,我们把这个机会做一些小的修改,特别是在文档部分。欧宝官网下载app例如,笔记,现在更容易识别:提示和警告