vue 项目其余规范

列表

z-index叠层规范

  • lever1:普通content:1-99;
  • lever2:header、footer、广告、页面tips等在内容之上,但又与内容相关性较大的;层:100-199;
  • lever3:返回顶部等页面工具类:200-299;
  • lever4:popup、picker等浮在页面上的操做层:300-399;
  • lever5:loading:400-499;
  • lever6: toast等直接遮罩在页面上的warning、error信息:500-599。

基础布局

结构html

  • .page
    • header
    • footer
    • content

规范vue

每一个页面仅容许一组基础布局,这为组件加载、交互、分层提供挂载、容器等基础。webpack

缘由web

若是出现多套,将会影响公共组件引入的准确性和灵活性;也会影响功能的扩展等。vuex

示例:totop组件数组

从引入组件的角度上看,做为一个基础浮动的工具组件,不该该关注实际业务及根插销,直接动态加载到基础布局当中便可。若是有多个嵌套的基础布局,将须要更多的代码,来辨别其插入点,也会失去灵活性,因此从组件的角度,惟一布局很重要。数据结构

从功能角度上看,它须要监控页面的滚动位置,在这种布局下,其须要监控content的位置状况,若是出现多个基础布局,将影响功能的使用。异步

组件的相关规范

加载方式模块化

a、业务组件:可根据业务需求选择相应加载方式;工具

b、基础组件:尽可能使用动态加载的方式,如popup、pick、loading这些浮层组件。其优点以下:

  • 能够对使用者(开发人员)屏蔽加载点;
  • 防止叠层错乱(业务组件引入基础浮层组件,若是非动态加载,浮层将于内容层交错,致使样式叠层错乱,要作额外的hack等);
  • 有利于单页跳转时,组件的统一清除。

数据流

  • a、基础组件:使用props加载数据,不关注业务;
  • b、业务组件:抽象业务组件的业务范围,抽象数据结构,从vuex中进行取值,增强vuex数据的复用及组件的复用。

如何区分业务组件和基础组件:以地址picker为例。其首先是基础的picker组件,可实现多列滚动,每次滚动都会产生一个惟一的结果数组,确认之后,返回该结果数组。该基础picker组件能够扩展成动态请求数据的地址picker,也能够是固定值的多级picker,到底须要哪一种,就与业务相关。所以,地址picker,是对基础组件picker的扩展,其包含数据流的存取过程,及数据流的交互,异步请求等。

组件升级

  • 接口:对于公共组件,多人的调用的业务组件,须要作到旧接口的兼容。
  • 兼容方式:提供一个新旧接口交替期,在该时期,新旧接口并存,开发者将组件往新的接口上迁移,迁移完成以后,组件设计者,再将旧接口移除。

叠层的定义 公共组件,能够根据给出的z-index规范,给出组件的z-index叠层id;但其取值尽可能在该组件类型叠层规范数值范围的中间值,便于同类型业务组件的向下向上叠层处理。

相关文章
相关标签/搜索