- 自定义组件对应的样式文件,只对该组件内的节点生效。
编写组件样式时,需要注意以下几点:
- 组件和引用组件的页面不能使用 id 选择器(#a)、属性选择器([a])和标签名选择器,请改用 class 选择器。
- 组件和引用组件的页面中使用后代选择器(.a .b)在一些极端情况下会有非预期的表现,如遇,请避免使用。
- 子元素选择器(.a>.b)只能用于 View 组件与其子节点之间,用于其他组件可能导致非预期的情况。
- 继承样式,如 font 、 color ,会从组件外(父组件)继承到组件内。但是引用组件时在组件节点上书写的 className 无效。 (具体解决方案请参见下面的外部和全局样式介绍。)
- 除继承样式外, app.scss 中的样式、组件所在页面的样式,均对自定义组件无效。
除此以外,组件可以指定它所在节点的默认样式,使用 :host 选择器(需要包含基础库 1.7.2 或更高版本的开发者工具支持)。
1/* 该自定义组件的默认样式 */ 2:host { 3 color: yellow; 4}
外部样式类
如果想传递样式给引用的自定义组件,需要利用 externalClasses 定义段定义若干个外部样式类。这个特性从小程序基础库版本 1.9.90 开始支持。
1/* CustomComp.js */ 2export default CustomComp extends Component { 3 static externalClasses = ['my-class'] 4 5 render () { 6 return <View className="my-class">这段文本的颜色由组件外的 class 决定</View> 7 } 8} 9/* MyPage.js */ 10export default MyPage extends Component { 11 render () { 12 return <CustomComp my-class="red-text" /> 13 } 14} 15/* MyPage.scss */ 16.red-text { 17 color: red; 18}
注意:externalClasses 需要使用 短横线命名法 (kebab-case),而不是 React 惯用的 驼峰命名法 (camelCase)。否则无效。
全局样式类
使用外部样式类可以让组件使用指定的组件外样式类,如果希望组件外样式类能够完全影响组件内部,可以将组件构造器中的 options.addGlobalClass 字段置为 true。这个特性从小程序基础库版本 2.2.3 开始支持。
1/* CustomComp.js */ 2export default CustomComp extends Component { 3 static options = { 4 addGlobalClass: true 5 } 6 7 render () { 8 return <View className="red-text">这段文本的颜色由组件外的 class 决定</View> 9 } 10} 11/* 组件外的样式定义 */ 12.red-text { 13 color: red; 14}