@clevercloud/components

---

kind: 🏠 Home title: ' Readme'

Collection of Web Components by Clever Cloud

What is this?

This project contains a collection of Web Components made by Clever Cloud.

Some of those components are low-level like <cc-button>, <cc-input-text> or <cc-loader>, the other components are more high-level and specific to Clever Cloud's domain model.

We use them on different Web UIs we have (public and internal).

Why is it public?

1. We want to share our knowledge and experience with Web Components along with the tooling we used to build them. We hope it will help others for their own components.
2. We use those components ourselves but we also want our clients and partners to use them in their own custom Web UIs based on our products.
3. We think it's a great way for our clients to give feedbacks (and even contributions) on small parts of our Web UIs.

Can I see those components?

All our components are showcased with "stories" using Storybook. You can see all our components (and their stories) on this preview.

Storybook is a great tool to present your components in many different situations. This way, you can check how they behave with different inputs (properties, attributes...) and make sure they produce the right outputs (emit events...).

We also use web-component-analyzer to generate a documentation spec sheet for each component. You can find it in the Notes tab of a component's story (example).

Can I use them in my project?

Sure, they're available on npm. Contact us if you want more details.

License

This project is licensed under the Apache-2.0.

We're using modified versions of two projects related to Leaflet:

• https://github.com/Leaflet/Leaflet.heat
• https://github.com/mourner/simpleheat

Both projects are licensed with BSD-2-Clause. They aren't updated anymore, and we wanted them to be exposed as modern ES modules. This is the main reason we decided to copy them in our own repo. The respective copyrights are at the top of each file:

• src/lib/leaflet-heat.js
• src/lib/simpleheat.js

Changelog

7.12.0 (2022-05-20)

• cc-link: remove defaultThemeStyles insertion in CSS.
• <cc-addon-linked-apps>: add defaultThemeStyles import so that variables can be used by cc-link.
• <cc-addon-option-form>: add defaultThemeStyles import so that variables can be used by cc-link.
• <cc-elasticsearch-info>: add defaultThemeStyles import so that variables can be used by cc-link.
• <cc-jenkins-info>: add defaultThemeStyles import so that variables can be used by cc-link.
• <cc-matomo-info>: add defaultThemeStyles import so that variables can be used by cc-link.
• <cc-env-var-form>: add defaultThemeStyles import so that variables can be used by cc-link.
• <cc-article-card>: add defaultThemeStyles import so that variables can be used by cc-link.
• <cc-invoice>: add defaultThemeStyles import so that variables can be used by cc-link.
• <cc-grafana-info>: add defaultThemeStyles import so that variables can be used by cc-link.
• cc-link story: update documentation following the color update. Add defaultThemeStyles import inside the example.
• cc-link: fix :visited and :active color so that they are the same as the link with default state (primary highlight).
• <cc-input-text>: set line-height to 1.25em for the <label> element.
• <cc-input-number>: set line-height to 1.25em for the <label> element.
• <cc-select>: set line-height to 1.25em for the <label> element.
• <cc-toggle>: set line-height to 1.25em for the <legend> element.
• defaultThemeStyles: add variable to be used as margin-top value on a <cc-button> when one wants to align all form elements horizontally.
• all-form-controls story: add new story with help message and add a note about how to handle horizontal layout inside forms.
• New components:
  • <cc-article-card>
  • <cc-article-list> (with smart definition)
  • <cc-doc-card>
  • <cc-doc-list>