https://github.com/jackchoumine/stencil-component
学习 stencil componen 记录
https://github.com/jackchoumine/stencil-component
Last synced: 2 months ago
JSON representation
学习 stencil componen 记录
- Host: GitHub
- URL: https://github.com/jackchoumine/stencil-component
- Owner: jackchoumine
- License: mit
- Created: 2022-01-02T13:36:08.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-03-27T11:00:42.000Z (about 3 years ago)
- Last Synced: 2025-01-17T13:30:32.236Z (4 months ago)
- Language: TypeScript
- Size: 286 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Stencil App Starter
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. In many cases, Stencil can be used as a drop in replacement for traditional frontend frameworks given the capabilities now available in the browser, though using it as such is certainly not required.
Stencil also enables a number of key capabilities on top of Web Components, in particular Server Side Rendering (SSR) without the need to run a headless browser, pre-rendering, and objects-as-properties (instead of just strings).
## Getting Started
To start a new project using Stencil, clone this repo to a new directory:
```bash
npm init stencil app
```
and run:
```bash
npm start
```
To build the app for production, run:
```bash
npm run build
```
To run the unit tests once, run:
```
npm test
```
To run the unit tests and watch for file changes during development, run:
```
npm run test.watch
```
## vue2 如何引入 stencil web component
### 引入组件
两种方式：
1. 通过 cnd 引入 web component
index.html 中
```html
```
从 jsdelivr 引入不行：
```html
```
2. 安装 npm
```bash
npm i stencil-rating-component-test
```
在 main.js
```js
import { defineCustomElements } from 'stencil-rating-component-test/loader'
defineCustomElements()
```
### 让 vue 识别 web component 和 vue component, vue 会跳过 web component 编译
main.js
```js
Vue.config.ignoredElements = [/^([a-z][a-z0-9]*)(-[a-z0-9]+)*$/]
```
vue.config.js
```js
module.exports = {
chainWebpack: config => {
// config.resolve.symlinks(false),
config.module
.rule('vue')
.use('vue-loader')
.tap(options => ({
...(options || {}),
compilerOptions: {
isCustomElement: tag => tag.includes('-'),
},
}))
},
}
```
为了格式化方便，eslint 的规则配置
```js
'vue/component-name-in-template-casing': 0,// 不检查组件写法
// kebab-case 写法的标签是自定义元素
// PascalCase 风格的是 vue 组件
```
### 使用
```html
```
监听事件和 vue 组件一样。