盖亚
一个编译器-第一反应JavaScript UI框架,有编译时间JSX和代理商店. 没有虚拟 DOM —— Vite 插件在构建时分析您的 JSX 并生成只更新变化的外科 DOM 补丁. 一个Hello-world生产建筑是121 B brotli;一个等效的交互多事船 4.9 kb of brotli JavaScript.
斯维尔特使"将框架编为去"出名. Gea从字面上取出:在一个静态的Hello-worldapp中,框架运行时间从捆绑中消失.
编译到几乎无
在新鲜的Vite出品中... ...Hello -world building, Gea ships... ...Gea ships.. 121个B brotli Java 脚本。 等同的固体建造船为3.6克b,斯维尔特船为8.5克b,Vue船为20.7克b,反应船为50.8克b.
| 框架 | 版本 | 初步改进的联署材料 | 布罗特利联署材料 | 布罗特利对盖亚 |
|---|---|---|---|---|
| 盖亚 | 1.3.0 (单位:千美元) | 214 B类 | 121个B | 1.0x 单曲 |
| 固态 | 1.9.12 国家 | 10 196个B | 3 601个B级 | 29.8辆 |
| 丝绒 | 5.55.5 (韩语) | 23 461个B | 8 537个B级 | 70.6x 车次 |
| 阴道 | 3.5.33 (中文(简体) ) | 58,174 B (韩语) | 20 711个B | 17.1.2x (中文(简体) ) |
| 反应 | 19.2.5 反应DOM 19.2.5 | 189 717个B | 50 816个B | 420.0x (英语) |
从新鲜的Vite 8.0.10 生产应用软件中测量出,仅用JavaScript robts来进行. Gea 使用了已编译的组件输出; React, Vue, 和 Svelte 使用了等同的最小 Hello-world 组件.
当应用有效时保持倾斜
哈罗世界证明编译器可以消失. Todo证明当应用实际有所作为时,运行时间会保持倾斜.
在具有反应状态、输入处理、过滤、项目更新和相同CSS的等同交互式多功能应用程序中,Gea船 4.9 kb (中文(简体) ) brotli Java 脚本。 固体船 5.7克b,斯维尔特船 13.7克b,Vue船 22.6克b,反应船 51.5克b.
| 框架 | 版本 | 已取消资格的联署材料 | JS Brotli 残疾 | 原联署材料+共计 支助科 | 联合来文+共计 支助科 |
|---|---|---|---|---|---|
| 盖亚 | 1.3.0 (单位:千美元) | 15 364个B | 4 896个B级 | 18 075个B级 | 5 664个B级 |
| 固态 | 1.9.12 国家 | 16 181个B | 5 721个B级 | 18 892个B | 6 485个B级 |
| 丝绒 | 5.55.5 (韩语) | 38 812 B (韩语) | 13 661个B级 | 41 523个B | 14 429个B级 |
| 阴道 | 3.5.33 (中文(简体) ) | 63,676 B (韩语) | 22 585个B | 66 387个B | 23 411 B (韩语) |
| 反应 | 19.2.5 反应DOM 19.2.5 | 192 330 B (韩语) | 51,460 B (单位:千美元) | 195 041 B (韩语) | 52 287 B (韩语) |
从新鲜活性生产中测量 /tmp/gea-todo-framework-size-compare所有建筑的CSS相同:2 711 B生,746 B brotli.
哲学
Gea的指导原则是JavaScript代码应该简单易懂. 一个框架不应该发明出新的编程概念或者期望你遵守任意的规则. 你写规律的,平庸的JavaScript——具有状态和方法的类,返回标记的功能,获得衍生值的得到者——而Gea使它在罩下反应.
没有信号,没有钩子,没有依赖矩阵,没有编译指令,也没有框架特有的原始. Gea提出的唯一概念是 Store 类,它只是一个普通类,其属性恰好被代理观测到. 其他一切——阶级继承,方法调用,财产获取, Array.map, ternary 表达式 — 是您已经知道的标准的 JavaScript .
"魔人"完全活在了建设的一步. Vite 插件在编译时分析您的代码, 计算DOM 节点依赖于哪个状态, 并生成线程 。 在运行时间,你得到干净,可读,面向对象的代码,只是工作.
业绩
Gea是编译速度最快的UI框架 js-框架基准 套间,涵盖行创建,更新,互换,选择,以及大表格上删除的行业标准压力测试.
| 框架 | 加权几何平均值 |
|---|---|
| 香草酱 | 1.00 (中文(简体) ) |
| 盖亚1.3 | 1.02 (中文(简体) ) |
| 固态 1.9 | 1.10 国家 |
| 斯维尔特5号 | 1.10 国家 |
| 第3.6号 | 1.22 联合国 |
| 反应 19.2 | 1.43 国家 |
更低(1.00=最快). Gea 超越了每一个被编译的框架,同时需要零框架特定的概念——没有信号,没有钩子,没有编译指令. 这不仅仅是DX——也是最快的. 全面基准报告
快速启动
npm create gea@latest my-app
cd my-app
npm install
npm run dev
或将 Gea 添加到现有的 Vite 项目中 :
npm install @geajs/core @geajs/vite-plugin
// vite.config.ts
import { defineConfig } from 'vite'
import { geaPlugin } from '@geajs/vite-plugin'
export default defineConfig({
plugins: [geaPlugin()]
})
类型脚本
Gea通过TypeScript提供完整的JSX类型检查 jsxImportSource中添加此选项 tsconfig.json数字 :
{
"compilerOptions": {
"jsx": "react-jsx",
"jsxImportSource": "@geajs/core"
}
}
这使得您获得了道具自动补全,在无效属性上键入错误,并在任何TypeScript-aware编辑器中徘徊类型——VS代码,Cursor,Vim,Zed——没有特定框架插件.
使用 declare props 输入道具的类组件 :
export default class UserCard extends Component {
declare props: { name: string; email: string; onSelect?: () => void }
template({ name, email, onSelect }: this['props']) {
return (
<div class="user-card" click={onSelect}>
<span>{name}</span>
<span>{email}</span>
</div>
)
}
}
declare props 定义已接受的 JSX 属性——没有释放 JavaScript . : this['props'] 编辑 template() 参数是可选的但被推荐的——它为完全端到端类型安全在方法内键入已解结构的变量.
核心概念
存储
A Store 持有共享应用程序状态 。 扩展 Store,将反应属性声明为类字段,并添加可使其变异的方法,导出单通实例。 店里的东西是深层的 Proxy 跟踪每一个突变和批量通知通过 queueMicrotask。 。 。 .
import { Store } from '@geajs/core'
class CounterStore extends Store {
count = 0
increment() { this.count++ }
decrement() { this.count-- }
}
export default new CounterStore()
突变状态直接——代理自动处理反应. 阵列方法( E)push, (中文(简体) ), pop, (中文(简体) ), splice, (中文(简体) ), sort, (中文(简体) ), reverse, (中文(简体) ), shift, (中文(简体) ), unshift)被截取以产生精细的磨损变化事件,如: append, (中文(简体) ), reorder,以及 swap。 。 。 .
类组件
扩展 Component 执行 template() 返回JSX的方法。 类组件继承自 Store,因此它们有自己的反应性能——当你需要本地的,瞬态的UI表示没有其他组件在意时使用.
import { Component } from '@geajs/core'
export default class Counter extends Component {
count = 0
increment() { this.count++ }
decrement() { this.count-- }
template() {
return (
<div class="counter">
<span>{this.count}</span>
<button click={this.increment}>+</button>
<button click={this.decrement}>-</button>
</div>
)
}
}
事件处理者接受两种方法的引用(click={this.increment})和箭头函数(click={() => this.increment()}) (中文(简体) ). 编译器将两种表格都接入组件的事件授权系统. 使用简单转发的方法引用;在需要通过参数或作曲逻辑时使用箭头函数.
需要本地状态或生命周期钩时使用类组件.
函数组件
导出一个接收道具并返回JSX的默认函数. Vite插件在构建时将其转换为类组件.
export default function Greeting({ name }) {
return <h1>Hello, {name}!</h1>
}
对无国籍者使用函数组件,演示式UI.
程序和数据流
Gea的道具遵循标准的JavaScript语义学——没有框架发明的概念像 v-model, (中文(简体) ), emit,或基于回调的状态提升。 当父母将数据传递给一个子组件时,它的工作就像将参数传递给JavaScript中的函数:
- 初级 (数字,字符串,布尔斯)被传递 按数值儿童收到一份副本。 在孩子中重新分配道具并不影响父母——就像在平庸的JS中重新分配函数参数一样.
- 对象和阵列 通过 参考文献。孩子得到父母拥有的同一代理。 突变子中的对象或阵列会自动更新母体状态和DOM——因为它是同一个对象.
// parent.tsx
import { Component } from '@geajs/core'
export default class Parent extends Component {
count = 0
user = { name: 'Alice', age: 30 }
items = ['a', 'b']
template() {
return (
<div>
<span>{this.count}</span>
<span>{this.user.name}</span>
<span>{this.items.length} items</span>
<Child count={this.count} user={this.user} items={this.items} />
</div>
)
}
}
// child.tsx
export default function Child({ count, user, items }) {
return (
<div>
<span>{count}</span>
<span>{user.name}</span>
<span>{items.length} items</span>
</div>
)
}
在此设置中:
user.name = 'Bob'在孩子身上更新了父母和孩子的DOM——这是相同的反应代用.items.push('c')在孩子身上更新两个——相同的数组引用.count = 99在孩子中只更新孩子的DOM——父母仍然持有原始值.
JavaScript就是这样工作的. 没有 emit,没有 defineModel,不为对象/阵列突变调回线。 框架没有增加一层间接——它尊重语言的本土通取值和通取参考语义.
对于深筑巢穴(外孙,外孙等),适用同一规则. 只要同一对象的引用被传下,任何后人都可以变异,而变化传播到每一个观察到它的祖先——因为他们都拥有相同的代名词.
传递组件作为道具
传递组件作为多命名区域构建布局的道具——同样的想法其他框架称为"名位",没有单独的API.
// Parent passes components as named props
<Layout header={<Title />} sidebar={<Nav />} main={<Content />} />
// Layout renders each region wherever it wants
export default class Layout extends Component {
template({ header, sidebar, main }) {
return (
<div class="layout">
<aside>{sidebar}</aside>
<main>{main}</main>
<header>{header}</header>
</div>
)
}
}
对a 单人 默认区域, 组件标记内的嵌入内容并读取 children 儿童:
// Parent nests content between opening and closing tags
<Card>
<h2>Title</h2>
<p>Body text goes here.</p>
</Card>
// Card renders whatever was nested inside it
export default class Card extends Component {
template({ children }) {
return <div class="card">{children}</div>
}
}
计算值
为衍生状态使用商店上的获取器 。 它们在每个访问上重新评价——维特插件轨迹,这些轨迹显示模板读取的路径,并在这些路径改变时触发更新.
class TodoStore extends Store {
todos = []
filter = 'all'
get filteredTodos() {
const { todos, filter } = this
if (filter === 'active') return todos.filter(t => !t.done)
if (filter === 'completed') return todos.filter(t => t.done)
return todos
}
get activeCount() {
return this.todos.filter(t => !t.done).length
}
}
JSX 语法
Gea JSX与HTML关系密切. 与 React 的密钥差异 :
| 特性 | 盖亚 | 反应 |
|---|---|---|
| CSS课程 | class="foo" | className="foo" |
| 事件处理器 | click={fn} 或者说 onClick={fn} | onClick={fn} |
| 投入活动 | input={fn} 或者说 onInput={fn} | onChange={fn} |
| 键盘事件 | keydown={fn} 或者说 onKeyDown={fn} | onKeyDown={fn} |
两种土著风格(click, (中文(简体) ), change)和反应风格(onClick, (中文(简体) ), onChange) 事件属性名称得到支持.
支持的事件属性 : click, (中文(简体) ), dblclick, (中文(简体) ), input, (中文(简体) ), change, (中文(简体) ), keydown, (中文(简体) ), keyup, (中文(简体) ), blur, (中文(简体) ), focus, (中文(简体) ), mousedown, (中文(简体) ), mouseup, (中文(简体) ), submit, (中文(简体) ), dragstart, (中文(简体) ), dragend, (中文(简体) ), dragover, (中文(简体) ), dragleave, (中文(简体) ), drop。 。 。 .
与 @geajs/mobile数字 : tap, (中文(简体) ), longTap, (中文(简体) ), swipeRight, (中文(简体) ), swipeUp, (中文(简体) ), swipeLeft, (中文(简体) ), swipeDown。 。 。 .
有条件渲染
{step === 1 && <StepOne />}
{!done ? <Form /> : <Success />}
列表渲染
<ul>
{todos.map(todo => (
<TodoItem key={todo.id} todo={todo} onToggle={() => store.toggle(todo.id)} />
))}
</ul>
总是提供 key 道具 (英语). Gea使用它来高效地进行列表分解——处理添加,删除,重排,并互换而不重报整个列表.
生命周期
| 方法 | 当呼叫时 |
|---|---|
created(props) | 建造者之后,在制作之前 |
onAfterRender() | DOM 插入和孩子安装后 |
onAfterRenderAsync() | 下一个 requestAnimationFrame 提交之后 |
dispose() | 从 DOM 中删除,清理观察者和孩子 |
DOM 帮助者
| 方法 | 说明 |
|---|---|
$(selector) | 第一个匹配的后人( 范围) querySelector(中文(简体) ) |
$$(selector) | 所有匹配的后代( 范围) querySelectorAll(中文(简体) ) |
渲染
import App from './app'
const app = new App()
app.render(document.getElementById('app'))
组件完成一次。 随后的状态变化会触发外科DOM补丁——不是完全重接.
路由器
Gea包括用于单页应用程序的内置客户端-侧路由器.
路由器 API 是主要 Gea API 的一部分, 因此您可以导入 Link, (中文(简体) ), RouterView,以及 router 从 @geajs/core。 。 。 .
快速示例
import { Component, Link, RouterView } from '@geajs/core'
import Home from './views/Home'
import About from './views/About'
import UserProfile from './views/UserProfile'
export default class App extends Component {
template() {
return (
<div class="app">
<nav>
<Link to="/" label="Home" />
<Link to="/about" label="About" />
<Link to="/users/1" label="Alice" />
</nav>
<RouterView routes={[
{ path: '/', component: Home },
{ path: '/about', component: About },
{ path: '/users/:id', component: UserProfile },
]} />
</div>
)
}
}
路由模式
| 图案 | 实例 URL | 参数 |
|---|---|---|
/about | /about | {} |
/users/:id | /users/42 | { id: '42' } |
/repo/:owner/* | /repo/dashersw/src/index.ts | { owner: 'dashersw', '*': 'src/index.ts' } |
构成部分
RouterView——使组件匹配当前 URL。 接受一个routes数组{ path, component }对象。 支持类和函数组件.Link- 让一个<a>导航的标签history.pushState而不是重新装入完整页面。 修改键( Cmd/ Ctrl+ 点击) 按预期在新标签中打开 .
程序导航
import { router } from '@geajs/core'
router.navigate('/about') // push new entry
router.replace('/login') // replace current entry
router.back() // history.back()
router.forward() // history.forward()
console.log(router.path) // '/about'
console.log(router.query) // { q: 'hello' } for ?q=hello
组件路由参数
函数组件作为道具接收匹配的参数 :
export default function UserProfile({ id }) {
return <h1>User {id}</h1>
}
类组件通过 created(props) 财务报告和审定财务报表 template(props)。 。 。 .
相关软件包
- @geajs/移动 ——移动UI原始:取景,导航,手势,侧边栏,分页,牵引至再生,无穷卷.
- @geajs/vite-plugin (英语) ——维特插件,能使编译时间JSX变换,活性接线,和HMR.
- 创建- gea 项目脚手架:
npm create gea@latest。 。 。 .
文档
完整文档: 文档
AI - 辅助发展
该寄存器包括 代理技能 教AI编码助理如何和Gea合作 在相容的环境下,这为您的编辑提供了理解Gea的商店,组件,JSX常规,以及反应模型所需要的上下文,这样你就可以用更好的AI协助来脚手架和去除Gea应用软件上.
许可证
麻省理工学院 ——版权(c) 2017年至今 阿玛干·安卡拉尔