JSS Core Styles使用指南

介绍

  • JSS是CSS的创作工具,它使你可以使用JavaScript以声明性,无冲突和可重用的方式描述样式。它可以在浏览器中,服务器端或在Node的构建时进行编译。
  • JSS与框架无关。它由多个软件包组成:内核,插件,框架集成和其他。
  • 基于对象的样式语法,用于声明样式表
  • JSS被设计为尽可能地接近CSS语法。但是,也有一些例外。 JSS的使用基于插件的体系结构,因此插件通过可选插件添加了核心软件包中的某些语法,并通过可选插件添加了其他语法。

特性

Real CSS

JSS生成实际的CSS,而不是内联样式。它支持所有现有的CSS功能。 CSS规则创建一次,并且使用与内联样式相反的类名称在元素之间重用。另外,当DOM元素更新时,将应用先前创建的CSS规则。

无冲突的选择器

默认情况下,JSS生成唯一的类名。它可以避免典型的CSS问题,默认情况下,所有问题都是全局的。它完全消除了命名约定的需要。

代码重用

使用JavaScript作为宿主语言,使我们有机会以常规CSS无法实现的方式重用CSS规则。你可以利用JavaScript模块,变量,函数,数学运算等。如果操作正确,它仍然可以完全声明。

易于删除和修改

明确使用CSS规则可让你追踪到使用者,并确定是否可以安全地删除或修改它。

动态样式

使用JavaScript函数和Observables可以在浏览器中动态生成样式,从而使你有机会访问应用程序状态,浏览器API或用于样式化的远程数据。你不仅可以定义样式,还可以在任何时间点以有效的方式更新样式。

用户控制的动画

JSS高效地处理CSS更新使得使用它创建复杂的动画成为可能。使用函数值,Observables并将其与CSS过渡结合使用,将为用户控制的动画提供最佳性能。对于预定义的动画,最好使用@keyframestransitions,因为它们将完全解除JavaScript线程的阻塞。

关键CSS

为了优化首次绘画的时间,可以使用服务器端渲染并提取关键的CSS。你可以将CSS的呈现与HTML的呈现耦合,这样就不会生成未使用的CSS。这将在服务器端渲染期间提取最少的关键CSS,并允许你内联它。

插件

JSS核心实现了基于插件的体系结构。它允许你创建可实现自定义语法或其他强大功能的自定义插件。 JSS有许多官方插件,可以单独安装或使用默认预设安装。社区插件的一个很好的例子是jss-rtl

富有表达力的语法

由于使用了各种插件,JSS允许你使用嵌套,全局选择器以及具有现有全局类名的组合。例如。 jss-plugin-expand允许你以比CSS更加可读的方式来表达类似box-shadow的属性。如果要直接从浏览器开发工具中复制粘贴样式,也可以使用模板字符串。

完全隔离

另一个有用的插件示例是jss-plugin-isolate,它允许你将元素与全局级联规则完全隔离,并可能覆盖不需要的属性。在创建应该在第三方文档内部呈现的小部件时特别有用。

与react集成

React-JSS软件包提供了一些附加功能:

  • 动态主题-允许基于上下文的主题传播和运行时更新。
  • 关键CSS提取-仅从呈现的组件中提取CSS。
  • 惰性评估-安装组件时会创建样式表。
  • 样式表的静态部分在所有元素之间共享。
  • 函数值和规则以props作为参数自动更新。

JavaScript构建管道

无需为CSS进行其他构建管道配置。无论选择哪种工具来构建JavaScript,它都可以与JSS一起使用。

基本语法

const styles = {
  button: {
    color: 'red',
    'font-size': '12px'   // or fontSize: '12px'
  },
  container: {
     width: '200px',
     height: '100px',
     '& .content': {  // 子类
        fontSize: '18px'
     },
     '&:hover': {  // 容器hover属性
       backgroundColor: '#DDD'
     },
     '& p': {  // 子节点
       textIndent: '10px'
     }
  },
}

编译为:

.button-0-1-66 {
  color: red;
  font-size: 12px;
}
.container-0-1-67 {
  width: 200px;
  height: 100px;
}
.container-0-1-67 .content {
  font-size: 18px;
}
.container-0-1-67:hover {
  background-color: #DDD;
}
.container-0-1-67 p {
  text-indent: 10px;
}

媒体查询

const styles = {
  button: {
    width: 100
  },
  '@media (min-width: 1024px)': {
    button: {
      width: 200
    }
  }
}

使用ES6常量

const minWidth = 1024

const styles = {
  button: {
    width: 100
  },
  [`@media (min-width: ${minWidth}px)`]: {
    button: {
      width: 200
    }
  }
}

编译为:

.button-0 {
  width: 100px;
}
@media (min-width: 1024px) : {
  .button-0 {
    width: 200px;
  }
}

关键帧动画

关键帧名称将使用与类名称相同的id生成器函数。动画名称默认为作用域。要在同一样式表中访问它,可以将$ref语法用作animationNameanimation属性的值。

此外,你可以通过sheet.keyframes{name}映射访问生成的名称。

要生成全局动画名称,可以使用@global规则。

const styles = {
  '@keyframes slideRight': {
    from: {opacity: 0},
    to: {opacity: 1}
  },
  container: {
    animationName: '$slideRight'
  }
}

编译为:

@keyframes keyframes-slideRight-0 {
  from {
    opacity: 0;
  }
  to {
    opacity: 1;
  }
}
.container-1 {
  animation-name: keyframes-slideRight-0;
}

使用@global

const styles = {
  '@global': {
    body: {
      color: 'green'
    },
    a: {
      textDecoration: 'underline'
    }
  }
}

备选值

const styles = {
  container: {
    background: 'linear-gradient(to right, red 0%, green 100%)',
    fallbacks: {
      background: 'red'
    }
  }
}

或者

const styles = {
  container: {
    display: 'flex',
    fallbacks: [{display: 'box'}, {display: 'flex-box'}]
  }
}

编译为:

.container-0 {
  background: red;
  background: linear-gradient(to right, red 0%, green 100%);
}

使用@font-face自定义字体

const styles = {
  '@font-face': {
    fontFamily: 'MyWebFont',
    src: 'url(webfont.eot)'
  }
}
// 或
const styles = {
  '@font-face': [
    {
      fontFamily: 'MyWebFont',
      src: 'url(webfont.eot)'
    },
    {
      fontFamily: 'MySecondFont',
      src: 'url(webfont2.eot)'
    }
  ]
}

编译为:

@font-face {
  font-family: 'MyWebFont';
  src: url('webfont.eot');
}
// 或
@font-face {
  font-family: 'MyWebFont';
  src: url('webfont.eot');
}
@font-face {
  font-family: 'MySecondFont';
  src: url('webfont2.eot');
}

空格和逗号分隔值的替代语法

为了以JavaScript方式描述用空格或逗号分隔的CSS值,jss引入了基于数组的语法。

使用此语法有一些优点:

1、插件jss-plugin-default-unit能够有效设置数字值的默认单位。
2、你可以在值声明中使用变量,而无需使用字符串模板或串联。

逗号分隔值

const styles = {
  button: {
    // 逗号分隔值,内部包含常规CSS字符串
    border: ['1px solid red', '1px solid blue']
  }
}

编译为:

.button-0 {
  border: 1px solid red, 1px solid blue;
}
const styles = {
  button: {
    // 逗号分隔值,内部包含常规CSS字符串.
    border: [
      // 数字可以自动成为默认单位。
      [1, 'solid', 'red'],
      [1, 'solid', 'blue']
    ]
  }
}

编译为:

.button-0 {
  border: 1px solid red, 1px solid blue;
}

以空格分隔的值

const styles = {
  button: {
    // 以空格分隔的值。
    margin: [[5, 10]]
  }
}

编译为:

.button-0 {
  margin: 5px 10px;
}

修饰符!important

const styles = {
  button: {
    color: [['red'], '!important'],
    margin: [[5, 10], '!important']
  }
}

编译为:

.button-0 {
  color: red !important;
  margin: 5px 10px !important;
}

属性content
将字符串分配给content属性时,在CSS中需要双引号或单引号。因此,你还必须在内容的值字符串中提供引号,使得属性content能匹配正解的表示形式。

const styles = {
  button: {
    '&:after': {
      content: '"JSS"'
    }
  }
}

编译为:

.button-0:after {
  content: 'JSS';
}

参考
JSS

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,736评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,167评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,442评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,902评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,302评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,573评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,847评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,562评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,260评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,531评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,021评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,367评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,016评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,068评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,827评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,610评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,514评论 2 269

推荐阅读更多精彩内容

  • HTML 5 HTML5概述 因特网上的信息是以网页的形式展示给用户的,因此网页是网络信息传递的载体。网页文件是用...
    阿啊阿吖丁阅读 3,361评论 0 0
  • 官网 中文版本 好的网站 Content-type: text/htmlBASH Section: User ...
    不排版阅读 4,310评论 0 5
  • 概要 64学时 3.5学分 章节安排 电子商务网站概况 HTML5+CSS3 JavaScript Node 电子...
    阿啊阿吖丁阅读 8,618评论 0 3
  • 慕课网学习笔记 什么是 CSS 预处理器? CSS 预处理器定义了一种新的语言,其基本思想是,用一种专门的编程语言...
    打铁大师阅读 1,189评论 0 0
  • -------------------------一、控制指令--------------------------...
    夜幕小草阅读 3,116评论 0 5