Component level cssinjs resolution for antd
[![NPM version][npm-image]][npm-url] [![npm download][download-image]][download-url]  [![build status][github-actions-image]][github-actions-url] [![Codecov][codecov-image]][codecov-url] [![bundle size][bundlephobia-image]][bundlephobia-url]
[npm-image]: http://img.shields.io/npm/v/@ant-design/cssinjs.svg?style=flat-square
[npm-url]: http://npmjs.org/package/@ant-design/cssinjs
[github-actions-image]: https://github.com/ant-design/cssinjs/workflows/CI/badge.svg
[github-actions-url]: https://github.com/ant-design/cssinjs/actions
[codecov-image]: https://img.shields.io/codecov/c/github/ant-design/cssinjs/master.svg?style=flat-square
[codecov-url]: https://codecov.io/gh/ant-design/cssinjs/branch/master
[download-image]: https://img.shields.io/npm/dm/@ant-design/cssinjs.svg?style=flat-square
[download-url]: https://npmjs.org/package/@ant-design/cssinjs
[bundlephobia-url]: https://bundlephobia.com/result?p=@ant-design/cssinjs
[bundlephobia-image]: https://badgen.net/bundlephobia/minzip/@ant-design/cssinjs
Component level cssinjs solution used in ant.design. It's a subset of Emotion with design token logic wrapper. Please feel free to use emotion directly if you want to find a web cssinjs solution. cssinjs related dep packages:
- stylis
- @emotion/hash
- @emotion/unitless
https://ant-design.github.io/cssinjs/
``bash`
npm install @ant-design/cssinjs
or
`bash`
yarn add @ant-design/cssinjs
`bash`
pnpm add @ant-design/cssinjs
`
npm install
npm start
@ant-design/cssinjs is released under the MIT license.
| Prop | Desc | Type | Default |
| --- | --- | --- | --- |
| autoClear | Clear inject style element when component remove. | boolean | false |
| cache | Config cssinjs cache entity. Only set when you need ssr to extract style on you own. | CacheEntity | - |
| hashPriority | Use :where selector to reduce hashId css selector priority | 'low' \| 'high' | 'low' |document.head
| container | Tell cssinjs where to inject style in. | Element \| ShadowRoot | |
| ssrInline | Component wil render inline for fallback in SSR. Not recommend. | boolean | false |transformers
| transformers | Transform css before inject in document. Please note that do not support dynamic update | Transformer[] | - |
return CacheEntity for StyleProvider.
Create theme object. When same algorithm provided, it will return same object.
Since @ant-design/cssinjs use strong constraints for cache hit performance, we recommend to view demo basic.tsx for usage and animation.tsx for animation usage.
Extracts the styles from the cache and returns them as a string.
#### Parameters
- cache (Cache): The cache instance containing the styles.options
- (object | boolean, optional): Options for extracting the styles.plain
- (boolean, optional): If true, the styles will be returned in plain format. Default is false.types
- (string | string[], optional): The types of styles to extract. Default is ['style', 'token', 'cssVar'].
#### Returns
- (string): The extracted styles as a string.
#### Example
`typescript
import { extractStyle, createCache } from '@ant-design/cssinjs';
// 创建并填充缓存
const cache = createCache();
// 注意：在实际使用中，缓存通常会在渲染组件时自动填充
// 提取样式
const styles = extractStyle(cache, { plain: true, types: ['style', 'token'] });
// 使用提取的样式
const styleElement = document.createElement('style');
styleElement.innerHTML = styles;
document.head.appendChild(styleElement);
`
When you need transform CSSObject before inject style. You can use transformers to handle this:
`tsx | pure
import {
legacyLogicalPropertiesTransformer,
StyleProvider,
} from '@ant-design/cssinjs';
export default () => (
);
`
Follow are the transform we provide:
#### legacyLogicalPropertiesTransformer
Convert logical properties to legacy properties. e.g. marginBlockStart to marginTop`:
- inset
- margin
- padding
- border
#### px2remTransformer
Convert pixel units to rem units. px2remTransformer.options