• Introduction
    • Why Liquid
    • Getting started
    • CSS vs. Web Components
    • Component assets
    • Type checking and intellisense
    • Server-side rendering
    • Event handling
    • Form validation
    • React bindings
    • Tailwind CSS integration
    • Design tokens
    • Sandbox applications
    • FAQ
  • Globals
    • Animations
    • Border-radius
    • Colors
    • Focus
    • Fonts
    • Shadows
    • Spacings
    • Theming
    • Typography
  • Components
    • Accordion
      • Accordion Panel
      • Accordion Section
      • Accordion Toggle
    • Background Cells
    • Badge
    • Breadcrumbs
      • Crumb
    • Button
    • Card
    • Checkbox
    • Circular Progress
    • Header
    • Icon
    • Input
    • Input Message
    • Label
    • Link
    • Loading Indicator
    • Modal
    • Notice
    • Notification
    • Pagination
    • Progress
    • Radio Button
    • Screen Reader Live
    • Screen Reader Only
    • Select
      • Option
    • Sidenav
      • Sidenav Accordion
      • Sidenav Back
      • Sidenav Header
      • Sidenav Heading
      • Sidenav Navitem
      • Sidenav Separator
      • Sidenav Slider
      • Sidenav Subnav
      • Sidenav Toggle Outsid
    • Slider
    • Switch
      • Switch Item
    • Tabs
      • Tab
      • Tab List
      • Tab Panel
      • Tab Panel List
    • Toggle
    • Tooltip
    • Typography
  • Data Visualization
    • Getting Started
  1. Do I have the legal rights to use Liquid?
  2. Why should I use Liquid?
  3. Can I use Liquid with framework X?
  4. Which browsers are supported?
  5. What is Shadow DOM?
  6. Can I customize Liquid?
  7. What happened to liquid-design-react?
  8. Can Liquid Oxygen components be combined with the liquid-design-react library?
  9. Can I personally contribute to Liquid Oxygen?
Introduction FAQ

FAQ #

Do I have the legal rights to use Liquid? #

Liquid Oxygen is available under a custom license which restricts its usage to applications created for or by Merck KGaA, Darmstadt, Germany as well as its vendors. TLDR: If you develop for or have received written consent from Merck KGaA, Darmstadt, Germany, you're good to go.

Why should I use Liquid? #

Here is why.

Can I use Liquid with framework X? #

As long as your tech stack is based on HTML, CSS and JavaScript, you can use Liquid Oxygen, no matter what framework or library you use.

Which browsers are supported? #

In general, Liquid supports all modern evergreen browsers. Liquid does not support IE11. For details, check out the browserslist prop in the package.json file.

What is Shadow DOM? #

Shadow DOM is an API built into the browser that allows for DOM encapsulation and style encapsulation, meaning that it allows shielding Web Components from their surrounding environment. This means that when you use Liquid's Web Components, you do not need to be concerned about accidently overriding Liquid's CSS, nor worry about our internal DOM being interfered with anything you do outside the component.

Can I customize Liquid? #

While we do not recommend customizing Liquid's components or globals for reasons related to the consistency of a design system, we also (from our own experience) understand the need to be able to tweek things. Technically you can customize all components. Even all Web Components can be customized to a certain degree, through extention, ::part CSS pseudo-elements or by leveraging existing CSS custom props.

What happened to liquid-design-react? #

Liquid Oxygen is the successor of liquid-design-react which is still available on GitLab and npm. While liquid-design-react is still maintained with minor bug fixes and security patches and can still be used in existing projects, we recommend Liquid Oxygen for new projects as it comes with significant improvents, especially with regard to accessibility and interoperability. Liquid Oxygen is therefore meant to replace liquid-design-react in the midterm. Although Liquid Oxygen is still in an early stage of development, it is built iteratively, meaning that initial releases will include fewer features while follow-up releases will ship more and more components. Only as soon as the feature set of Liquid Oxygen includes a wide range of the most common components, the team will consider deprecating liquid-design-react and offer advice on possible migration paths.

Can Liquid Oxygen components be combined with the liquid-design-react library? #

Yes, Web Components and CSS Components are both standards conform and can be used in your React app alongside the older components. Both libraries are tree-shakable. We recommend you to iteratively replace older components with those from Liquid Oxygen, if you plan on maintaining your project for a longer period of time.

Can I personally contribute to Liquid Oxygen? #

Absolutely! Liquid Oxygen is not only open for contributions and feedback but also prioritizes its backlog according to the input from the community. If you feel you need a specific component badly, you can either contribute to the project directly or create a feature request. If you'd like to get involved, check out our contributing docs.