index-en-US.md 3.7 KB


category: Getting Started title: Frequently Asked Questions subTitle: Frequently Asked Questions icon: doc-faq localeCode: en-US

order: 7

About the release time

Semi team will release the official minor version every two Fridays, and the minor beta will be released on the middle Friday

Relationship between versions

  • The Semi version number follows the Semver specification (major version number-minor version number-revision number). We will add features or components to the minor version. In the patch version, we will only fix bugs and not update new features.
  • Between 2.x versions (that is, when the major version number is the same), the API will remain forward compatible, but there may be style adjustments between different minor versions. When you need to upgrade, we recommend you Use the version Diff function on the changelog page to check all changes and whether they really affect your business system.

Why is defaultValue, default XXX not working?

Property like defaultValue, defaultXXX will only be consumed once when the component mount. If your defaultXXX property is updated asynchronously later, the component will not reconsume the value. If necessary, you should use controlled value, controlled XXX. Or force React to remount the component by passing in a different key.

this._adapter.xxx is not a function

This situation generally occurs when semi-ui-react does not match the semi-ui version of the dependency. It is more common when users lock the semi-ui-react version in package.json (that is, remove ^), but In some cases, package-lock.json and node_modules were deleted, and install was executed again Please check the version of semi-ui and semi-ui-react through package-lock.json in your project. It is recommended that if the version is locked, either lock both. Either don't lock both of them, and directly use the package-lock.json mechanism to ensure that the versions used are consistent.

Does Semi support i18n?

As of 2021-10, Semi supports 14 languages. See Semi·LocaleProvider for details.

Who should I look for if there is a new component requirement, or an existing component Feature does not meet my business needs?

You can submit your issue to describe your needs. Issue Label Please select Feature Request / New Component Request. We will handle these needs with high quality.

Confused about the use of components? I wonder if there are components that can meet your business needs scenarios?

Welcome to ours Customer Service Lark Group For a consultation question.

Is the style of Semi based on Scss or Less? Why not use CSS Module?

Our style is based on Scss, and we also use CSS Variable as the color wheel variable. Color variables and common variables are mounted under body. CSS Module is not used because we want to have a fixed className and retain the ability to modify / override Semi style for our users(although it is not recommended, it is really needed sometime).

Semi's default theme style does not match the positioning of our system. Can i configure another theme?

Please refer to Custom theme . In our DSM You can configure the style. You only need to specify the theme package name in webpack.config.js to complete the access.

Why Tooltip、Typography does not set style word-break to all or word?

Content in difference languages (e.g. English, Chinese, combination of English and Chinese) may require different styles in terms of word-break, so Semi does not use a default setting. You could use corresponding CSS styles to your own needs.

More FAQ

Please refer to https://bytedance.feishu.cn/docs/doccnMRDbkhde6p3dMokfFpcNug