我的前端架构养成记之整洁的工作流
wptr33 2025-01-03 19:20 27 浏览
【编者按】本文作者Matt Carella为我们讲解了如何构建一个良好的架构。除了选择正确的工具以外,在组织工作流中遵循清晰整洁的原则对于我们来说是非常重要的。或许有的人会觉得文中所说的是在DOS时代的标准的做法,不过本文对新入门的人来说或许会有帮助。如果您是一位资深的架构师,也欢迎您在评论中与我们一起分享您的心得与体会。
建立一个好的前端架构是开始开发Web应用或网站的一个基本步骤。良好的实践和编码常规是必不可少的,但是结构呢?我们如何在可控的时间内构思一个好的架构?但最重要的事情是,我们应该从哪里开始?
- 我想要一个多页面项目(一个Web应用或网站);
- 我希望我的项目支持不同的屏幕尺寸和分辨率,换句话说,我希望它是响应式的;
- 我希望最终产品是可被维护的;
- 我希望最终产品性能上是出色的;
- 我希望可以为将来的项目重复使用相同的模板。
正确的工具
现在我们拥有大量很酷的工具可以用于现代化前端开发工作流中。因此,面对第1、2点我告诉自己我需要一个基于CSS体系结构的中断点(能够帮我支持不同的设备和桌面的大小)。而另一个方面大量的CSS和文件可能会有点混乱(这违背了第3点),这就是为什么我决定开始使用CSS预处理器的原因。关于第4点,答案很简单,我决定使用Gruntjs。而第5点在我看来Yeoman是一个很好的解决方案。
组织工作流
每个前端项目总是包含库、jQuery插件和大量的JavaScript&CSS文件(或本文例子中的SCSS)以达到不同的目的和目标。使用不同的技术手段混合所有的元素,并把它们放在一起,这意味着建立一个前端工作流。我们会发现自己在管理一个巨大的、涉及不同技术的工作流。这就是为什么我们需要将所有东西通过遵循一种模式或公约置入文件夹中,以此来保持清晰、整洁。这对我们而言是非常重要的。
我们可以在巨大的组合中选择分解所有基本的前端组件,如以下所示:
当然我们还可以继续细分:
SCSS
- variables(变量)
- mixins(混合类)
- 公共部分到每一个布局
- 单一布局
js
- 库(如:jquery、angularjs、gAnalytics等等)
- 插件(通常为jquery插件)
- 控制器(我的意思是类似angularjs这样的控制器)
在一个基于模板的架构(例如使用blade.php或jade with nodejs)我们也可以将视图分割如下:
views
视图这块在本文不做讨论,因为我假设项目里每个页面或布局只有一个视图(一个HTML文件)。
基于这些初步的考虑,下面展示的是我的文件夹树:
文件夹树注解
imgs
存放所有的图片文件:.png、.jpg、.jpeg、壁纸等。
示例:icon.png、home-background.jpeg、userAvatar.jpg。
js(主文件夹)
存放.js文件。子文件夹组织情况如下:
\controllers(子文件夹)
存放angular控制器,每一个控制器都有一个与对应视图相同的名字。比如,如果home.html需要一个angular控制器,你可以创建一个像这样的文件:project\js\controllers\home.js。
示例:home.js、user-registration.js、user-login.js
\libs(子文件夹)
用于存放JavaScript库,当然这里不包含插件。
示例:jquery-latest.js、angular.js、googleAnalytics.js
\plugins(子文件夹)
插件需要依赖关系来工作,而库不需要,这也就是为什么这里创建两个文件夹的原因。
示例:jquery-fancyInput.js、restangular.js、customPlugin.js、jquery-airport.js
\views(子文件夹)
存放所有表象的东西,每个文件都与对应的视图名称相同。例如,如果home.html需要一些效果、材料以及插件初始值,你可以创建一个像这样的文件:project\js\views\home.js。
示例:home-animations.js、user-registration.js、user-login.js、site-animations.js
CSS(主文件夹)
这个文件夹包含了所有从主SCSS文件中生成的CSS。例如home.scss会在该文件中生成对应的home.css文件。
\libs(子文件夹)
即使是对CSS文件,我也会区分库和插件,这里有些CSS库例子。
示例:_meyers-reset.scss、_normalize.scss、_animate.scss、_960gridSystem.scss
\plugins(子文件夹)
CSS文件包含于该文件夹中是使JavaScript插件工作的必备风格。
示例:_jquery-fancyInput.scss、_jqueryTooltip.scss
\framework (子文件夹)
我决定在这个目录中存放scss文件以共享到整个项目页面,框架子文件将以下面的方式组织:
- _variables.scss(项目变量声明——colors、spacings等)
- _mixins.scss(项目mixin声明——typography、clearfix、animations等)
- _forms.scss(自定义表单样式和重置)
- _input.scss(自定义输入样式和重置)
\layouts (子文件夹)
这是一个敏感的部分。这个目录中的文件以这种方式组织:它们涵盖所有屏幕分辨率、遵循移动第一的原则。所以,你应该使用_all.scss声明你自己的风格。在该文件中的规格声明是对所有屏幕尺寸和所有视图都有效的。如果你希望你的网站适应性强的话,就不要仅仅是重写规则,为其他屏幕分辨率声明它们。
文件夹组织结构如下:
- phablets (481up) _phablets.scss
- tablets and small laptops (768up) _tablets.scss
- desktops (1030up) _desktop.scss
- desktops with large screens (1204up) _desktop-large.scss
- retina displays exceptions (@2x) _retina.scss
这些文件将把握布局异常,被称为mediaqueries。
请注意:这些文件共享于所有视图(HTML页面)。这就是为什么你需要在scss\layouts文件下创建一个新的文件夹以给定一个特定的风格到一个特定的页面。
最后
我知道这不是一个普遍的解决方案,也许在某些情况下还会包含一些冗余,但我认为这是一个很好的起点。不管目的是什么,我的建议是根据自己的需求定制自己的体系结构或框架,特别是在不丢失用户体验的前提下保障性能和可维护性。(编译:陈明)
编者注:关于文件夹树结构可查看详情,当然你也可以下载。
原文来自:sitepoint
相关推荐
- [常用工具] git基础学习笔记_git工具有哪些
-
添加推送信息,-m=messagegitcommit-m“添加注释”查看状态...
- centos7安装部署gitlab_centos7安装git服务器
-
一、Gitlab介1.1gitlab信息GitLab是利用RubyonRails一个开源的版本管理系统,实现一个自托管的Git项目仓库,可通过Web界面进行访问公开的或者私人项目。...
- 太高效了!玩了这么久的Linux,居然不知道这7个终端快捷键
-
作为Linux用户,大家肯定在Linux终端下敲过无数的命令。有的命令很短,比如:ls、cd、pwd之类,这种命令大家毫无压力。但是,有些命令就比较长了,比如:...
- 提高开发速度还能保证质量的10个小窍门
-
养成坏习惯真是分分钟的事儿,而养成好习惯却很难。我发现,把那些对我有用的习惯写下来,能让我坚持住已经花心思养成的好习惯。...
- 版本管理最好用的工具,你懂多少?
-
版本控制(Revisioncontrol)是一种在开发的过程中用于管理我们对文件、目录或工程等内容的修改历史,方便查看更改历史记录,备份以便恢复以前的版本的软件工程技术。...
- Git回退到某个版本_git回退到某个版本详细步骤
-
在开发过程,有时会遇到合并代码或者合并主分支代码导致自己分支代码冲突等问题,这时我们需要回退到某个commit_id版本1,查看所有历史版本,获取git的某个历史版本id...
- Kubernetes + Jenkins + Harbor 全景实战手册
-
Kubernetes+Jenkins+Harbor全景实战手册在现代企业级DevOps体系中,Kubernetes(K8s)、Jenkins和Harbor组成的CI/CD流水...
- git常用命令整理_git常见命令
-
一、Git仓库完整迁移完整迁移,就是指,不仅将所有代码移植到新的仓库,而且要保留所有的commit记录1.随便找个文件夹,从原地址克隆一份裸版本库...
- 第三章:Git分支管理(多人协作基础)
-
3.1分支基本概念分支是Git最强大的功能之一,它允许你在主线之外创建独立的开发线路,互不干扰。理解分支的工作原理是掌握Git的关键。核心概念:HEAD:指向当前分支的指针...
- 云效Codeup怎么创建分支并进行分支管理
-
云效Codeup怎么创建分支并进行分支管理,分支是为了将修改记录分叉备份保存,不受其他分支的影响,所以在同一个代码库里可以同时进行多个修改。创建仓库时,会自动创建Master分支作为默认分支,后续...
- git 如何删除本地和远程分支?_git怎么删除远程仓库
-
Git分支对于开发人员来说是一项强大的功能,但要维护干净的存储库,就需要知道如何删除过时的分支。本指南涵盖了您需要了解的有关本地和远程删除Git分支的所有信息。了解Git分支...
- git 实现一份代码push到两个git地址上
-
一直以来想把自己的博客代码托管到github和coding上想一次更改一次push两个地址一起更新今天有空查资料实践了下本博客的github地址coding的git地址如果是Gi...
- git操作:cherry-pick和rebase_git cherry-pick bad object
-
在编码中经常涉及到分支之间的代码同步问题,那就需要cherry-pick和rebase命令问题:如何将某个分支的多个commit合并到另一个分支,并在另一个分支只保留一个commit记录解答:假设有两...
- 模型文件硬塞进 Git,GitHub 直接打回原形:使用Git-LFS管理大文件
-
前言最近接手了一个计算机视觉项目代码是屎山就不说了,反正我也不看代码主要就是构建一下docker镜像,测试一下部署的兼容性这本来不难但是,国内服务器的网络环境实在是恶劣,需要配置各种镜像(dock...
- 防弹少年团田柾国《Euphoria》2周年 获世界实时趋势榜1位 恭喜呀
-
当天韩国时间凌晨3时左右,该曲在Twitter上以“2YearsWithEuphoria”的HashTag登上了世界趋势1位。在韩国推特实时趋势中,从上午开始到现在“Euphoria2岁”的Has...
- 一周热门
-
-
C# 13 和 .NET 9 全知道 :13 使用 ASP.NET Core 构建网站 (1)
-
程序员的开源月刊《HelloGitHub》第 71 期
-
详细介绍一下Redis的Watch机制,可以利用Watch机制来做什么?
-
假如有100W个用户抢一张票,除了负载均衡办法,怎么支持高并发?
-
Java面试必考问题:什么是乐观锁与悲观锁
-
如何将AI助手接入微信(打开ai手机助手)
-
SparkSQL——DataFrame的创建与使用
-
redission YYDS spring boot redission 使用
-
一文带你了解Redis与Memcached? redis与memcached的区别
-
如何利用Redis进行事务处理呢? 如何利用redis进行事务处理呢英文
-
- 最近发表
- 标签列表
-
- git pull (33)
- git fetch (35)
- mysql insert (35)
- mysql distinct (37)
- concat_ws (36)
- java continue (36)
- jenkins官网 (37)
- mysql 子查询 (37)
- python元组 (33)
- mybatis 分页 (35)
- vba split (37)
- redis watch (34)
- python list sort (37)
- nvarchar2 (34)
- mysql not null (36)
- hmset (35)
- python telnet (35)
- python readlines() 方法 (36)
- munmap (35)
- docker network create (35)
- redis 集合 (37)
- python sftp (37)
- setpriority (34)
- c语言 switch (34)
- git commit (34)