[go: up one dir, main page]

Skip to content
This repository has been archived by the owner on Nov 2, 2024. It is now read-only.
/ dao3-aui Public archive

不再维护,请使用新的areact(以下链接)。 ⚛️+📦React+Dao3(Arena)=dao3-aui! Client UI React-like Programming (based on preact). 在岛三中使用类似React的框架写Client端UI(基于Preact)

License

Notifications You must be signed in to change notification settings

Box3TRC/dao3-aui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dao3-aui

⚛️+📦React+Dao3(Arena) 在岛三中使用类似 React 的框架写 Client 端 UI(基于 Preact)

预备环境

  • 请确保你已经配置好 VSCode 插件ArenaPro并安装好Node.js

快速上手

1. 创建一个 ArenaPro 项目,然后打开终端安装 dao3-aui

npm install --save dao3-aui

2. 修改文件名、文件入口点

  • client/src/clientApp.ts改为client/src/clientApp.tsx
  • dao3.config.json中的client->entry改为src/clientApp.tsx(类似下面这样)
{
    "client": {
        "base": "./client",
        "entry": "src/clientApp.tsx",
        ...省略...
    }
}

3. 修改client/tsconfig.json

需要在compilerOptions中加入一些jsx/tsx相关的配置

{
    "compilerOptions": {
        // ...省略...
        "noImplicitAny": false,// 这四行是要添加的内容
        "jsx": "react",
        "jsxFactory": "AUIApp.h",
        "jsxFragmentFactory": "AUIApp.frag"
        // ...省略...
    }
}

4. 编写代码

那我们先来一个Counter示例吧!点击一个按钮,数字会随之增加。

  • 文件client/src/clientApp.tsx
import { AUIApp, hooks } from "dao3-aui";
// 创建一个AUIApp实例
let aui = new AUIApp();

// 这个就是入口点的组件,渲染从这里开始
function App() {
  const [count,setCount]=hooks.useState<number>(0);
  return (<>
    <ui-text x="0" y="0" height="50px" width="200px" 
      background-color="#ffffff" background-opacity="100%" 
      onClick={()=>setCount(count+1)}
      text-content={"点击次数:"+count.toString()+"次"}></ui-text>
  </>)
}
// 挂载到屏幕上
aui.mount(<App />, ui);

Alt+Q使用ArenaPro构建上传代码到岛三。

5. 运行

如果你的 岛三编辑器(Arena)clientIndex.js还没有配置好运行apbundle的代码,请在clientIndex.js中贴入以下代码:

import "./_client_bundle.js"

点击运行按钮。你会发现左上角有一个按钮:

1726421489338

点击它,数字会变化:

1726421512496

快速上手就到这里。

Ui组件如何使用

目前已经兼容的组件有:

  • <ui-text></ui-text> UiText
  • <ui-image></ui-image> UiImage
  • <ui-box></ui-box> UiBox
  • <ui-input></ui-input> UiInput 是的,真的支持

Ui组件属性

  • 标签的属性是把 驼峰式的属性名 改为 横线分隔的属性名 ,例如:backgroundColor -> background-color等等。
// textContent要改为text-content
<ui-text text-content="hello world"></ui-text>
  • 特殊的属性转换
    • color类别的属性,接受css颜色,例如#ffffff(16进制)或者rgb(255,255,255)(rgb)的参数
    • opacity类别的接受百分比,形如100%的参数
    • anchor接受两个百分比,形如100%,100%的参数,表示锚点位置
    • x,y,width,height接受offset(px)+scale(%),形如100px,10px+20%,100%等的参数
    • ...(以后继续完善这里)
  • 事件绑定 目前实现的事件有:
    • onClick 适用于所有ui元素
    • onInput 仅适用于ui-input

示例

1. Counter(点击+1计数器)

import { AUIApp, hooks } from "dao3-aui";
let aui = new AUIApp();

function App() {
  const [count,setCount]=hooks.useState<number>(0);
  return (<>
    <ui-text x="0" y="0" height="50px" width="200px" 
      background-color="#ffffff" background-opacity="100%" 
      onClick={()=>setCount(count+1)}
      text-content={"点击次数:"+count.toString()+"次"}></ui-text>
  </>)
}
aui.mount(<App />, ui);

2. Input(输入框 双向数据绑定)

import { AUIApp, hooks } from "dao3-aui";
let aui = new AUIApp();

function App() {
  const [name,setName]=hooks.useState("you");
  return (<>
    <ui-text
      x="0px" y="0px" height="50px" width="200px" text-content={"say hello to " + name}
      background-color="#ffffff"
      background-opacity="100%"
    ></ui-text>
    <ui-input
      x="0px" y="50px" width="200px" height="50px" placeholder="your name here"
      onInput={(e)=>setName(e.target.getAttribute("text-content"))}
      text-content={name}
    ></ui-input>
  </>);
}
aui.mount(<App />, ui);

About

不再维护,请使用新的areact(以下链接)。 ⚛️+📦React+Dao3(Arena)=dao3-aui! Client UI React-like Programming (based on preact). 在岛三中使用类似React的框架写Client端UI(基于Preact)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published