Skip to content

简介

Omi 是什么?

Omi (读音 /ˈomɪ/,类似于 欧米) 是 Web Components 框架,内置 JSX 和信号 signal/Signal。

Omi looks really neat!
    — Jason Miller (Creator of Preact)

I really like the trend towards "frameworks" that:

"export default class Component extends HTMLElement {..}"

This one, Omi, is from Tencent.

    — Dion Almaer

快速上手

Usage

tsx
import { render, signal, tag, Component, h } from 'omi'

const count = signal(0)

function add() {
  count.value++
}

function sub() {
  count.value--
}

@tag('counter-demo')
class CounterDemo extends Component {
  static css = 'span { color: red; }'

  render() {
    return (
      <>
        <button onClick={sub}>-</button>
        <span>{count.value}</span>
        <button onClick={add}>+</button>
      </>
    )
  }
}

render(<counter-demo />, document.body)
import { render, signal, tag, Component, h } from 'omi'

const count = signal(0)

function add() {
  count.value++
}

function sub() {
  count.value--
}

@tag('counter-demo')
class CounterDemo extends Component {
  static css = 'span { color: red; }'

  render() {
    return (
      <>
        <button onClick={sub}>-</button>
        <span>{count.value}</span>
        <button onClick={add}>+</button>
      </>
    )
  }
}

render(<counter-demo />, document.body)

如上面的阴影区域划分,解释如下:

  • 从 'omi' 模块导入了几个函数和类,包括 render、signal、tag、Component 和 h。
  • 创建了一个名为 count 的信号,并初始化为 0。信号是 Omi 中的一种响应式数据源,当信号的值改变时,所有使用这个信号的组件都会重新渲染
    • 定义了两个函数 add 和 sub,分别用于增加和减少 count 的值。
  • 定义了一个名为 CounterDemo 的组件,这个组件使用了 @tag 装饰器来指定其 HTML 标签名为 'counter-demo'。这个组件有一个静态属性 css 用于定义局部样式,以及一个 render 方法用于定义组件的渲染内容。
  • 使用 render 函数将 CounterDemo 组件渲染到 document.body。

入门了,恭喜你!

使用 OMI CLI

快速创建 Omi + Vite + TS/JS 项目:

bash
$ npx omi-cli init my-app    # 或者创建js项目: npx omi-cli init-js my-app
$ cd my-app           
$ npm start           # develop
$ npm run build       # release
$ npx omi-cli init my-app    # 或者创建js项目: npx omi-cli init-js my-app
$ cd my-app           
$ npm start           # develop
$ npm run build       # release

快速创建 Omi + Router + Signal + Suspense + Tailwindcss + Vite + TS 项目:

bash
$ npx omi-cli init-spa my-app  
$ cd my-app           
$ npm start           # develop
$ npm run build       # release
$ npx omi-cli init-spa my-app  
$ cd my-app           
$ npm start           # develop
$ npm run build       # release