Skip to content

Releases: BiosSun/nojiko

2.0.0

31 Dec 19:03
Compare
Choose a tag to compare
  • [danger] 删除 clamp 函数(详细信息请看 1.2.0 版本的发布说明);

1.2.0

31 Dec 18:51
Compare
Choose a tag to compare

为支持 CSS 中的 clamp 函数,Dart Sass 自其 1.31.0 版本开始会将 clamp 解析为特殊函数;自此我们若在 sass 中声明了一个名为 clamp 的自定义函数,并使用该版本进行编译,则会抛出异常:Invalid function name.。另外考虑到 sass 的官方模块 math 中也有提供一个相同的 clamp 函数,因此,我们决定弃用 nojiko 中的 clamp 函数。

若你在项目中有用到它,那么还请改为使用 sass 的官方版本,例如,将如下代码:

width: clamp($width, 20px, 30px);

改为:

@use "sass:math";                       // 引入 math 模块
width: math.clamp($width, 20px, 30px);  // 并将 `clamp` 改为 `math.clamp`

为帮助你进行迁移,我们提供了这个 nojiko 1.2.0 版本。在进行迁移前,你可以先将 Dart Sass 降级到 1.30.0,并安装 nojiko 的这个版本:

npm i [email protected] --save-dev && npm i [email protected]

在该版本中的 clamp 函数会在被调用时抛出一个异常,这可以帮助你定位在哪里使用到了它。待你完成迁移后,便可以将 Dart Sass 升回最新版本,并将 nojiko 升到 2.0.0,在 2.0.0 中,我们完全移除了 clamp 函数。

npm i sass --save-dev && npm i nojiko@^2.0.0
  • [danger] 弃用 clamp 函数;

1.1.1

31 Dec 18:00
Compare
Choose a tag to compare
  • [fix] 修复当设置 default-box-sizing 为 border-box 后,引入 scaffolding 会抛出异常的问题;

1.1.0

31 Dec 17:59
Compare
Choose a tag to compare
  • 添加 clamp 函数,用于限定某个数值在指定的区间内;

1.0.0

11 Aug 16:57
Compare
Choose a tag to compare

在该版本中,nojiko 做了较多的破坏性变更,因此请在升级到该版本前仔细阅读修改日志。

破坏性变更

1. 浏览器兼容性支持:自该版本开始,Nojiko 将不再支持 IE6 及 IE7

因为从当前的市场统计数据来看,这两个浏览器版本在全球市场份额已降到极低,而且即便是在中国,其总计市场份额也已降到 4% 以下;

另外再加上兼容这两个浏览器版本需要付出极多额外的工作量,而且在支持他们的前提下,也很难放心的大量使用更加先进的技术以满足当前市场中用户日益增高的体验需求;

基于以上考虑,我们认为再继续兼容 IE6 及 IE7 将是一件性价比非常低的事情。

升级指南: 如果你的项目仍需支持 IE6 或 IE7,那么请不要升级到该版本。

2. 浏览器兼容性支持:依然兼容 IE8,但全局配置变量 $support-for-ie8 的默认值将被改为 false

限于仍有很多用户还在继续使用 Windows XP,联带 IE8 的市场份额也高达 6% 之多,因此 Nojiko 将继续支持 IE8。

但在 Nojiko 中,IE8 已被列为低级别的兼容目标,且随时有可能放弃支持 IE8,因此特将 IE8 的兼容配置变量的默认值改为 false

升级指南: 若你的项目仍需支持 IE8,那么请在引入 nojiko 的 _variables.scss 之前,添加如下配置代码:

$support-for-ie8: true;

3. 移除 float 混入类

因已不再支持 IE6 及 IE7,因此混入类 float 也就没有必要存在,故此移除。

升级指南:* 使用关键字 @include float 检索项目中所有 .scss 文件,并将其改为直接使用 css 的 float 属性。

如将如下代码:

@include float(left);

改为:

float: left;

4. 移除已弃用混入类 block-formatting-context

该混入类用于激活元素的块级格式化上下文,但其应用场景非常有限,而且有一些副作用,因此早已于 0.5.0 版本中便已声明为 已弃用 状态,并声明将在 1.0.0 正式版本中移除。

升级指南: 使用关键字 @include block-formating-context 检索项目中所有 .scss 样式文件,并根据你的使用场景将其更换为一个更好的方案。

5. 移除已弃用混入类 computed-line-height

该混入类在 0.5.8 版本中更名为 compute-line-height,原名称依然保留,但被声明为 已弃用 状态,并声明将在 1.0.0 正式版本中移除。

升级指南: 使用关键字 @include computed-line-height 检索项目中所有 .scss 样式文件,并将混入类名称改为 compute-line-height

6. 移除 _reset.scss

Nojiko 的重置样式实际上是封装自 Normalize.css,并在其基础上添加了一些兼容 IE6/7 的代码,另外额外提供了一份清除所有元素内外边距、字号、行高及有序/无序列表符号的「破坏性重置样式」。

因当前已不再支持 IE6 及 IE7,且「破坏性重置样式」也没有太多的普适性,因此 Nojiko 已没有太大的必要提供一份样式重置代码,因此移除。

升级指南: 建议各项目改为使用 Normalize.css,若需要「破坏性重置样式」,那么请自行添加如下代码:

body,
ul, ol, dl, dd,
h1, h2, h3, h4, h5, h6, p, pre,
form, fieldset, legend, input, textarea, select, button,
blockquote, th, td, hr, article, aside, details,
figcaption, figure, header, footer, section, hgroup, menu, nav {
    margin:0;
    padding:0;
}

 h1, h2, h3, h4, h5, h6, big, small {
     font: inherit;
     font-size: 100%;
     vertical-align: baseline;
 }

 ol, ul {
     list-style: none;
 }

7. 移除 rem 支持

这将移除三个部分的内容:

  • 混入类 convert-rem
  • 混入类 add-rem-suffix
  • rem 相关的内外边距原子样式类。

在 Nojiko 中对 rem 的支持做的还不是很好,比如没有提供充分的说明文档、示例代码及单元测试;
对外暴露的接口也缺少足够的普适性。且它需要有配套的 JS 支持,这违背了 Nojiko “作为一个纯样式工具库” 的原则;
因此 Nojiko 中将不再提供对 rem 的支持。

相应的,我们认为这种特定性的功能应该放在一个单独的项目中维护会比较好。

升级指南: 建议自行寻找或编写一个 rem 功能库。

至于 rem 相关的内外边距原子样式类,可参照如下方式添加补丁代码:

// 外边距
// ---------------------------

@include el-margin(null, null, 20rem, 20rem);

@if $nojiko-el-margin-suffix-large {
    @include el-margin(null, $nojiko-el-margin-suffix-large, 40rem, 40rem);
}

@if $nojiko-el-margin-suffix-small {
    @include el-margin(null, $nojiko-el-margin-suffix-small, 10rem, 10rem);
}


// 内边距
// ---------------------------

@include el-padding(null, null, 20rem, 20rem);

@if $nojiko-el-padding-suffix-large {
    @include el-padding(null, $nojiko-el-padding-suffix-large, 40rem, 40rem);
}

@if $nojiko-el-padding-suffix-small {
    @include el-padding(null, $nojiko-el-padding-suffix-small, 10rem, 10rem);
}

关于 el-margeel-padding 混入类可以参考文档中 Elements 分组下的相关说明。

8. 所有混入类及函数的参数在定义默认值时,不再引用 _variables.scss 中所定义的全局配置变量

因为在某些特殊项目中会自行设计一套全局配置变量,而不会使用 nojiko 所默认提供的,因此为了提高 nojiko 中所提供的混入类和函数的普适性,使其能应用在所有项目中,因此提出该约束。

不过目前受该规定影响的只有如下一个函数:

  • compute-line-height

升级指南: 使用关键字 compute-line-height(" 检索项目中所有 .scss 样式文件,若调用该函数时没有传入参数,或只传入了一个参数,则修改如下:

compute-line-height($font-size-base, $line-height-base)

注意 在该版本中已移除了具有同样功能的 computed-line-height 函数,若你尚未处理该问题,那么需额外检索 computed-line-height 函数。

9. 移除盒模型相关内容

$element-box-maps 存在与 $color-maps 同样的问题,既很难定义出一份足够通用的配置。因此 nojiko 中将不再提供关于盒模型相关的配置,另外配套的一些混入类也随之移除。

相应的,关于组件盒模型的设计、配置及约束,应下移到 UI 库中进行。

相关的移除内容有:

  • 混入类 get-element-box-height-by-name
  • 混入类 set-element-box-maps
  • 混入类 element-boxelement-box-by-mapelement-box-by-nameelement-box-by-name-belement-box-by-name-bh
  • 全局配置变量 $default-element-box-name
  • 全局配置变量 $element-box-maps
  • 全局配置变量 $nojiko-el-size
  • elements-extend.scss 中尺寸相关的原子样式类;

升级指南: 移除你的项目中这些混入类、配置变量及原子样式类的使用,并根据你的项目自行设计一套更加易用且又要的盒模型约束机制。

10. 修改全局配置变量 $font-size-large 的默认值为固定像素值 18px$font-size-small 的默认值为 12px

之前这两个变量的值都是基于 $font-size-base 的值计算而来,但难以得到一个比较好的计算算法,因此简便起见,将其默认值改为固定值。

升级指南: 若你的项目中有修改 $font-size-base 的值,但未修改 $font-size-large$font-size-base,那么请明确为这两个变量指定值。

11. 提供更多的模块间距控制

首先,我们新增了八个全局配置变量:

变量 类型 默认值 说明
$distance-horizontal-large number 40px 用于设置较大的模块间水平间距值;
$distance-horizontal-small number 10px 用于设置较小的模块间水平间距值;
$distance-vertical-large number 40px 用于设置较大的模块间垂直间距值;
$distance-vertical-small number 10px 用于设置较小的模块间垂直间距值;
$nojiko-el-margin-suffix-large string -l 用于设置 「较大的外边距」原子样式类的类名后缀;
$nojiko-el-margin-suffix-small string -s 用于设置 「较小的外边距」原子样式类的类名后缀;
$nojiko-el-padding-suffix-large string -l 用于设置 「较大的内边距」原子样式类的类名后缀;
$nojiko-el-padding-suffix-small string -s 用于设置 「较小的内边距」原子样式类的类名后缀;

与字体和行高一样,我们认为将模块间的间距控制三个级别是较为合适的,既:普通间距、较大间距及较小间距。

但是在之前的版本中,我们仅通过原子样式类中提供了这三个级别的间距,而且较大间距及较小间距的值是固定为 $distance-horizontal$distance-vertical 的 2 倍及 0.5 倍,相应的,所添加的类名后缀也强制设置为 d 及 `x**,不可配置,而且难以记忆。

为改善这些问题,我们特此提供了以上八个变量。

而且需要注意的是,为了方便记忆,较大间距及较小间距的原子样式类的类名后缀,我们改为了 -l-s,既 largesmall
而不再是 dx

升级指南:

首先,若你的项目中有修改 $distance-horizontal$distance-vertical 的值,那么请额外为新增的四个配置变量设置值。

之后,若你希望沿用老的原子样式类的命名后缀,那么请配置相应的全局配置变量为 dx 即可。

新增内容

  • 添加 list-compact 函数,用于清除列表中所有值为 null 的元素;
  • 添加 hairline-border 混入类,用于实现更好的 1 物理像素边框效果(但所生成的 css 代码也会更多);

0.7.1

11 Aug 16:58
Compare
Choose a tag to compare
  • [fix] 修复状态色配置没有添加 !default 声明的问题;

0.7.0

17 Oct 08:02
Compare
Choose a tag to compare
  • 添加单元测试

0.6.3

17 Oct 08:01
Compare
Choose a tag to compare
  • [danger] 移除 color-maps 配置变量
  • [danger] 移除 set-color-mapsset-alternative-color-maps 两个函数
  • [fix] list-slice 函数在参数有误时,不再抛出异常,而是返回一个空的列表
  • 添加 strip-unit 函数,用于移除一个数值类型的单位部分
  • 添加 info-color 配置变量
  • 添加 success-color 配置变量
  • 添加 warning-color 配置变量
  • 添加 danger-color 配置变量
  • 添加 multi-text-overflow-ellipsis 混入类,用于设置多行溢出时显示省略号
  • 添加 $svg-path 配置变量,用于定义存放 SVG 文件的目录路径
  • expand-scope 混入类添加参数 $position,用于设置扩展伪元素所用的定位方式
  • expand-scope 混入类更新参数 $expand-length,支持为不同的方向设置不同的值
  • list-first 函数的 $list 参数设置默认值 null
  • list-rest 函数的 $list 参数设置默认值 ()

在这个版本中,我们重新回顾了关于颜色配置相关的一些内容,在 Nojiko 之前的颜色配置中,$color-maps 是非常重要的一部分,我们期望通过它为所有的 UI 组件定义一份通用的色表,这样当某个 UI 组件需要提供不同的样式时,只需要遍历 $color-maps,并应用所遍历到的色值即可。但在思考其实现时,我们发现,定义出一份通用于所有 UI 组件的配色集合是非常困难的事情:要么,我们提出一些规则,UI 组件必须按照这些规则去使用 $color-maps 并提供样式;要么,我们定义出一份非常庞大的 $color-maps,它应该能适用于所有的 UI 组件,但其配置和使用将变得非常繁琐,而且也会创建出非常多压根就用不到的样式。

因此,我们决定要在 Nojiko 中移除 $color-maps,当然,这仅仅表示配色集合不再是一个「适用于任何情况」的工具,而它本身还是非常优秀的;我们建议 UI 组件开发人员可以单独为每一个组件定义一份 $colors-map,通过这种方式,使你的组件样式变成完全可配置的,而不是只能通过配置去修改几个有限的样式,既不能增加,也不能移除使用者所不需要的。

或者,如果你开发了多个 UI 组件,那么可以将其汇集到一个 UI 库中,并在库级别定义一份通用的,适用于该库内所有 UI 组件的 $colors-map。我们相信,同一个 UI 库内的组件,其风格都是一致的,那么在这个级别定义 $colors-map 应该能更容易地找到一个在「简单」、「方便」与「通用」之间的很好的平衡点。