Theme color Gray color Appearance SizeSmall(1) Medium(2) Large(3) Radius Scale90% 95% 100% 105% 110%
none
small
medium
large
full
目前可通过以下方式自定义元素内部样式:
::part
伪元素,仅能选择到对应的节点,无法根据节点的状态进行区分,详细可参考下一节innerStyle
属性,每个拥有 Open Shadow DOM 的元素均支持该属性,通过它可直接向该元素内部注入样式,无需再写繁琐的::part,也可以自行添加任意内部 class 的选择器<l-button
inner-style="button.is-disabled { opacity: 0.5 } .l-button--size-1 { font-size: 12px }"
></l-button>
GlobalStaticConfig.styles
可自定义某个或所有组件的样式,需要在组件使用之前调用,不可动态更改。支持样式字符串和CSSStyleSheet
(如果兼容的话)GlobalStaticConfig.styles.button.push(`button { color: red }`);
GlobalStaticConfig.styles.common.push(`:host { display: inline-flex }`); // 所有组件
也可以通过工具函数设置,这种方式设置样式会经过处理,会受 GlobalStaticConfig 中的wrapCSSLayer
, preferCSSStyleSheet
, stylePreprocessor
的影响
import { createImportStyle } from '@lun-web/components';
const importButtonStyle = createImportStyle('button', 'button { color: red }');
importButtonStyle();
GlobalContextConfig.dynamicStyles
可动态设置某个或所有组件的样式,具有响应式,且可以设置为函数以根据组件的属性来变化。支持样式字符串和CSSStyleSheet
GlobalContextConfig.dynamicStyles.button.push(`button { color: red }`);
GlobalContextConfig.dynamicStyles.button.push((vm) => (vm.props.variant === 'surface' ? 'button { color: blue }' : ''));
l-context-config-provider
同GlobalContextConfig
,但作用范围为其下的子元素,暂未实现