Update designer readme
This commit is contained in:
parent
b87961ad5a
commit
8d8d8730cf
|
|
@ -1,75 +1,3 @@
|
|||

|
||||
|
||||
# Stencil Component Starter
|
||||
|
||||
This is a starter project for building a standalone Web Component using Stencil.
|
||||
|
||||
Stencil is also great for building entire apps. For that, use the [stencil-app-starter](https://github.com/ionic-team/stencil-app-starter) instead.
|
||||
|
||||
# Stencil
|
||||
|
||||
Stencil is a compiler for building fast web apps using Web Components.
|
||||
|
||||
Stencil combines the best concepts of the most popular frontend frameworks into a compile-time rather than run-time tool. Stencil takes TypeScript, JSX, a tiny virtual DOM layer, efficient one-way data binding, an asynchronous rendering pipeline (similar to React Fiber), and lazy-loading out of the box, and generates 100% standards-based Web Components that run in any browser supporting the Custom Elements v1 spec.
|
||||
|
||||
Stencil components are just Web Components, so they work in any major framework or with no framework at all.
|
||||
|
||||
## Getting Started
|
||||
|
||||
To start building a new web component using Stencil, clone this repo to a new directory:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/ionic-team/stencil-component-starter.git my-component
|
||||
cd my-component
|
||||
git remote rm origin
|
||||
```
|
||||
|
||||
and run:
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm start
|
||||
```
|
||||
|
||||
To build the component for production, run:
|
||||
|
||||
```bash
|
||||
npm run build
|
||||
```
|
||||
|
||||
To run the unit tests for the components, run:
|
||||
|
||||
```bash
|
||||
npm test
|
||||
```
|
||||
|
||||
Need help? Check out our docs [here](https://stenciljs.com/docs/my-first-component).
|
||||
|
||||
|
||||
## Naming Components
|
||||
|
||||
When creating new component tags, we recommend _not_ using `stencil` in the component name (ex: `<stencil-datepicker>`). This is because the generated component has little to nothing to do with Stencil; it's just a web component!
|
||||
|
||||
Instead, use a prefix that fits your company or any name for a group of related components. For example, all of the Ionic generated web components use the prefix `ion`.
|
||||
|
||||
|
||||
## Using this component
|
||||
|
||||
There are three strategies we recommend for using web components built with Stencil.
|
||||
|
||||
The first step for all three of these strategies is to [publish to NPM](https://docs.npmjs.com/getting-started/publishing-npm-packages).
|
||||
|
||||
### Script tag
|
||||
|
||||
- Put a script tag similar to this `<script type='module' src='https://unpkg.com/my-component@0.0.1/dist/my-component.esm.js'></script>` in the head of your index.html
|
||||
- Then you can use the element anywhere in your template, JSX, html etc
|
||||
|
||||
### Node Modules
|
||||
- Run `npm install my-component --save`
|
||||
- Put a script tag similar to this `<script type='module' src='node_modules/my-component/dist/my-component.esm.js'></script>` in the head of your index.html
|
||||
- Then you can use the element anywhere in your template, JSX, html etc
|
||||
|
||||
### In a stencil-starter app
|
||||
- Run `npm install my-component --save`
|
||||
- Add an import to the npm packages `import my-component;`
|
||||
- Then you can use the element anywhere in your template, JSX, html etc
|
||||
# Elsa Workflows Designer
|
||||
|
|
|
|||
Loading…
Reference in a new issue