Component Party 标志

Component Party 中文版

响应式

声明状态

Qwik 标志 Qwik

import { component$, useSignal } from "@builder.io/qwik";

export const Name = component$(() => {
  const name = useSignal("张三");

  return <h1>你好 {name.value}</h1>;
});

Ripple 标志 Ripple

import { track } from "ripple";

export default function Name() {
  let &[name] = track("张三");

  return <h1>"你好 "{name}</h1>;
}

更新状态

Qwik 标志 Qwik

import { component$, useTask$, useSignal } from "@builder.io/qwik";

export const Name = component$(() => {
  const name = useSignal("张三");

  useTask$(() => {
    name.value = "李四";
  });

  return <h1>你好 {name.value}</h1>;
});

Ripple 标志 Ripple

import { track } from "ripple";

export default function Name() {
  let &[name] = track("张三");
  name = "李四";

  return <h1>"你好 "{name}</h1>;
}

计算属性

Qwik 标志 Qwik

import { component$, useSignal, useComputed$ } from "@builder.io/qwik";

export const DoubleCount = component$(() => {
  const count = useSignal(10);
  const doubleCount = useComputed$(() => count.value * 2);

  return <div>{doubleCount.value}</div>;
});

Ripple 标志 Ripple

import { track } from "ripple";

export default function DoubleCount() {
  let &[count] = track(10);
  let &[doubleCount] = track(() => count * 2);

  return <div>{doubleCount}</div>;
}

模板语法

最简模板

Qwik 标志 Qwik

export const HelloWorld = () => {
  return <div>你好，世界</div>;
};

Ripple 标志 Ripple

export default function HelloWorld() {
  return <h1>"你好，世界"</h1>;
}

样式

Qwik 标志 Qwik

import { component$, useStyles$ } from "@builder.io/qwik";

export const App = component$(() => {
  useStyles$(`
    .title {
      color: red;
    }
    `);

  return (
    <>
      <h1 class="title">我是红色的</h1>
      <button style={{ "font-size": "10rem" }}>我是一个按钮</button>
    </>
  );
});

Ripple 标志 Ripple

export default function CssStyle() {
  return <>
    <h1 class="title">"我是红色的"</h1>
    <button style={{ fontSize: "10rem" }}>"我是一个按钮"</button>

    <style>
      .title {
        color: red;
      }
    </style>
  </>;
}

DOM循环

Qwik 标志 Qwik

import { component$ } from "@builder.io/qwik";

export const Colors = component$(() => {
  const colors = ["红", "绿", "蓝"];
  return (
    <ul>
      {colors.map((color) => (
        <li key={color}>{color}</li>
      ))}
    </ul>
  );
});

Ripple 标志 Ripple

export default function Colors() {
  const colors = ["红", "绿", "蓝"];

  return <ul>
    for (const color of colors; key color) {
      <li>{color}</li>
    }
  </ul>;
}

点击事件

Qwik 标志 Qwik

import { component$, useSignal, $ } from "@builder.io/qwik";

export const Counter = component$(() => {
  const count = useSignal(0);

  const incrementCount = $(() => {
    count.value++;
  });

  return (
    <>
      <p>计数器: {count.value}</p>
      <button onClick$={incrementCount}>Increment</button>
    </>
  );
});

Ripple 标志 Ripple

import { track } from "ripple";

export default function Counter() {
  let &[count] = track(0);

  function incrementCount() {
    count++;
  }

  return <>
    <p>"计数器: "{count}</p>
    <button onClick={incrementCount}>"+1"</button>
  </>;
}

DOM引用

Qwik 标志 Qwik

import { component$, useVisibleTask$, useSignal } from "@builder.io/qwik";

export const InputFocused = component$(() => {
  const inputElement = useSignal<HTMLInputElement>();

  useVisibleTask$(({ track }) => {
    const el = track(inputElement);
    el?.focus();
  });

  return <input type="text" ref={inputElement} />;
});

Ripple 标志 Ripple

export default function InputFocused() {
  function autofocus(element) {
    element.focus();
  }

  return <input ref={autofocus} />;
}

条件渲染

Qwik 标志 Qwik

import { $, component$, useComputed$, useSignal } from "@builder.io/qwik";

export const TRAFFIC_LIGHTS = ["红灯", "黄灯", "绿灯"];

export const TrafficLight = component$(() => {
  const lightIndex = useSignal(0);

  const light = useComputed$(() => TRAFFIC_LIGHTS[lightIndex.value]);

  const nextLight = $(() => {
    lightIndex.value = (lightIndex.value + 1) % TRAFFIC_LIGHTS.length;
  });

  return (
    <>
      <button onClick$={nextLight}>下一个灯</button>
      <p>现在亮着的是: {light.value}</p>
      <p>
        你应该 {light.value === "红灯" && <span>停下</span>}
        {light.value === "黄灯" && <span>慢行</span>}
        {light.value === "绿灯" && <span>赶紧走</span>}
      </p>
    </>
  );
});

Ripple 标志 Ripple

import { track } from "ripple";

const TRAFFIC_LIGHTS = ["红灯", "黄灯", "绿灯"];

export default function TrafficLight() {
  let &[lightIndex] = track(0);

  let &[light] = track(() => TRAFFIC_LIGHTS[lightIndex]);

  function nextLight() {
    lightIndex = (lightIndex + 1) % TRAFFIC_LIGHTS.length;
  }

  return <>
    <button onClick={nextLight}>"下一个灯"</button>
    <p>"现在亮着的是: "{light}</p>
    <p>
      "你应该 "
      if (light === "红灯") {
        <span>"停下"</span>
      } else if (light === "黄灯") {
        <span>"慢行"</span>
      } else if (light === "绿灯") {
        <span>"赶紧走"</span>
      }
    </p>
  </>;
}

生命周期

组件加载时

Qwik 标志 Qwik

import { component$, useVisibleTask$, useStore } from "@builder.io/qwik";

export const App = component$(() => {
  const store = useStore({
    pageTitle: "",
  });

  useVisibleTask$(() => {
    store.pageTitle = document.title;
  });

  return <p>页面标题: {store.pageTitle}</p>;
});

Ripple 标志 Ripple

import { effect, track } from "ripple";

export default function PageTitle() {
  let &[pageTitle] = track("");

  effect(() => {
    pageTitle = document.title;
  });

  return <h1>"页面标题: "{pageTitle}</h1>;
}

组件卸载时

Qwik 标志 Qwik

import { component$, useVisibleTask$, useStore } from "@builder.io/qwik";

export const App = component$(() => {
  const store = useStore({
    time: new Date().toLocaleTimeString(),
  });

  useVisibleTask$(({ cleanup }) => {
    const timer = setInterval(() => {
      store.time = new Date().toLocaleTimeString();
    }, 1000);

    cleanup(() => clearInterval(timer));
  });

  return <p>当前时间: {store.time}</p>;
});

Ripple 标志 Ripple

import { effect, track } from "ripple";

export default function Time() {
  let &[time] = track(new Date().toLocaleTimeString());

  effect(() => {
    const timer = setInterval(() => {
      time = new Date().toLocaleTimeString();
    }, 1000);

    return () => clearInterval(timer);
  });

  return <h1>"当前时间: "{time}</h1>;
}

组件组合

组件Props传参

Qwik 标志 Qwik

import { component$ } from "@builder.io/qwik";
import UserProfile from "./UserProfile";

const App = component$(() => {
  return (
    <UserProfile
      name="张三"
      age={20}
      favouriteColors={["green", "blue", "red"]}
      isAvailable
    />
  );
});

export default App;

Ripple 标志 Ripple

import { UserProfile } from "./UserProfile.tsrx";

export function App() {
  return <UserProfile
    name="张三"
    age={20}
    favouriteColors={["绿", "蓝", "红"]}
    isAvailable
  />;
}

向父组件emit事件

Qwik 标志 Qwik

import { $, component$, useStore } from "@builder.io/qwik";
import AnswerButton from "./AnswerButton";

const App = component$(() => {
  const store = useStore({
    isHappy: true,
  });

  const onAnswerNo = $(() => {
    store.isHappy = false;
  });

  const onAnswerYes = $(() => {
    store.isHappy = true;
  });

  return (
    <>
      <p>你快乐吗?</p>
      <AnswerButton onYes$={onAnswerYes} onNo$={onAnswerNo} />
      <p style={{ fontSize: 50 }}>{store.isHappy ? "😀" : "😥"}</p>
    </>
  );
});

export default App;

Ripple 标志 Ripple

import { track } from "ripple";

import { AnswerButton } from "./AnswerButton.tsrx";

export function App() {
  let &[isHappy] = track(true);

  function onAnswerNo() {
    isHappy = false;
  }

  function onAnswerYes() {
    isHappy = true;
  }

  return <>
    <p>"你快乐吗?"</p>
    <AnswerButton onYes={onAnswerYes} onNo={onAnswerNo} />
    <p style={{ fontSize: "50px" }}>{isHappy ? "😀" : "😥"}</p>
  </>;
}

slot插槽

Qwik 标志 Qwik

import FunnyButton from "./FunnyButton";

export default function App() {
  return <FunnyButton>点我!</FunnyButton>;
}

Ripple 标志 Ripple

import { FunnyButton } from "./FunnyButton.tsrx";

export function App() {
  return <FunnyButton>"点我!"</FunnyButton>;
}

slot插槽内容

Qwik 标志 Qwik

import FunnyButton from "./FunnyButton";

export default function App() {
  return (
    <>
      <FunnyButton />
      <FunnyButton>这是传到slot的内容!</FunnyButton>
    </>
  );
}

Ripple 标志 Ripple

import { FunnyButton } from "./FunnyButton.tsrx";

export function App() {
  return <>
    <FunnyButton />
    <FunnyButton>"这是传到slot的内容!"</FunnyButton>
  </>;
}

上下文

Qwik 标志 Qwik

import {
  component$,
  useStore,
  useContextProvider,
  createContext,
  $,
} from "@builder.io/qwik";
import UserProfile from "./UserProfile";

export const UserContext = createContext("user-context");

const App = component$(() => {
  const user = useStore({
    id: 1,
    username: "abcdefg",
    email: "[email protected]",
  });

  const updateUsername = $((newUsername) => {
    user.username = newUsername;
  });

  useContextProvider(UserContext, { user, updateUsername });

  return (
    <>
      <h1>欢迎回来, {user.username}</h1>
      <UserProfile />
    </>
  );
});

export default App;

Ripple 标志 Ripple

import { RippleObject } from "ripple";

import { UserContext } from "./UserContext.tsrx";
import { UserProfile } from "./UserProfile.tsrx";

export function App() {
  const user = new RippleObject({
    id: 1,
    username: "abcdefg",
    email: "[email protected]",
  });

  UserContext.set(user);

  return <>
    <h1>"欢迎回来, "{user.username}</h1>
    <UserProfile />
  </>;
}

表单输入

输入框

Qwik 标志 Qwik

import { component$, useSignal } from "@builder.io/qwik";

const InputHello = component$(() => {
  const text = useSignal("");

  return (
    <>
      <p>{text.value}</p>
      <input bind:value={text} />
    </>
  );
});

export default InputHello;

Ripple 标志 Ripple

import { bindValue, track } from "ripple";

export default function InputHello() {
  let &[text, textTracked] = track("你好，世界");

  return <>
    <p>{text}</p>
    <input ref={bindValue(textTracked)} />
  </>;
}

复选框

Qwik 标志 Qwik

import { component$, useSignal } from "@builder.io/qwik";

const IsAvailable = component$(() => {
  const isAvailable = useSignal(false);

  return (
    <>
      <input id="is-available" type="checkbox" bind:checked={isAvailable} />
      <label for="is-available">这是一个checkbox</label>
    </>
  );
});

export default IsAvailable;

Ripple 标志 Ripple

import { bindChecked, track } from "ripple";

export default function IsAvailable() {
  let &[isAvailable, isAvailableTracked] = track(false);

  return <>
    <input
      id="is-available"
      type="checkbox"
      ref={bindChecked(isAvailableTracked)}
    />
    <label for="is-available">"这是一个checkbox"</label>
  </>;
}

单选框

Qwik 标志 Qwik

import { component$, useSignal } from "@builder.io/qwik";

const PickPill = component$(() => {
  const pickedColor = useSignal("red");

  return (
    <>
      <div>你选择了: {pickedColor.value}</div>
      <input
        id="blue-pill"
        type="radio"
        bind:value={pickedColor}
        checked={pickedColor.value === "blue"}
        value="blue"
      />
      <label for="blue-pill">蓝色</label>

      <input
        id="red-pill"
        type="radio"
        checked={pickedColor.value === "red"}
        bind:value={pickedColor}
        value="red"
      />
      <label for="red-pill">红色</label>
    </>
  );
});

export default PickPill;

Ripple 标志 Ripple

import { bindGroup, track } from "ripple";

export default function PickPill() {
  let &[picked, pickedTracked] = track("red");

  return <>
    <div>"你选择了: "{picked}</div>

    <input
      id="blue-pill"
      type="radio"
      value="blue"
      ref={bindGroup(pickedTracked)}
    />
    <label for="blue-pill">"蓝色"</label>

    <input
      id="red-pill"
      type="radio"
      value="red"
      ref={bindGroup(pickedTracked)}
    />
    <label for="red-pill">"红色"</label>
  </>;
}

选择器

Qwik 标志 Qwik

import { component$, useSignal } from "@builder.io/qwik";

export const colors = [
  { id: 1, text: "红" },
  { id: 2, text: "蓝" },
  { id: 3, text: "绿" },
  { id: 4, text: "灰", isDisabled: true },
];

const ColorSelect = component$(() => {
  const selectedColorId = useSignal("2");

  return (
    <select bind:value={selectedColorId}>
      {colors.map((color) => (
        <option
          key={color.id}
          value={color.id}
          disabled={color.isDisabled}
          selected={`${color.id}` === selectedColorId.value}
        >
          {color.text}
        </option>
      ))}
    </select>
  );
});

export default ColorSelect;

Ripple 标志 Ripple

import { bindValue, track } from "ripple";

const colors = [
  { id: 1, text: "红" },
  { id: 2, text: "蓝" },
  { id: 3, text: "绿" },
  { id: 4, text: "灰", isDisabled: true },
];

export default function ColorSelect() {
  let &[selectedColorId, selectedColorIdTracked] = track(2);

  return <select ref={bindValue(selectedColorIdTracked)}>
    for (const color of colors; key color.id) {
      <option value={color.id} disabled={color.isDisabled}>
        {color.text}
      </option>
    }
  </select>;
}

Web应用特性

渲染应用

Qwik 标志 Qwik

<!doctype html>
<html>
  <body>
    <div id="app"></div>
    <script type="module" src="./main.tsx"></script>
  </body>
</html>

Ripple 标志 Ripple

<!doctype html>
<html>
  <body>
    <div id="app"></div>
    <script type="module" src="./main.js"></script>
  </body>
</html>

fetch获取数据

Qwik 标志 Qwik

import { component$, useResource$, Resource } from "@builder.io/qwik";

type UsersResponse = {
  results: {
    picture: {
      thumbnail: string;
    };
    name: {
      first: string;
      last: string;
    };
  }[];
};

export async function fetchUsers() {
  return (await fetch("https://randomuser.me/api/?results=3")).json();
}

export const App = component$(() => {
  const data = useResource$<UsersResponse>(fetchUsers);

  return (
    <Resource
      value={data}
      onPending={() => <p>正在获取用户信息……</p>}
      onRejected={() => <p>获取用户信息出错</p>}
      onResolved={({ results: users }) => (
        <ul>
          {users.map((user) => (
            <li>
              <img src={user.picture.thumbnail} alt="user" />
              <p>
                {user.name.first} {user.name.last}
              </p>
            </li>
          ))}
        </ul>
      )}
    />
  );
});

Ripple 标志 Ripple

import { useFetchUsers } from "./useFetchUsers.tsrx";

export function App() {
  const data = useFetchUsers();

  return <>
    if (data.isLoading) {
      <p>"正在获取用户信息……"</p>
    } else if (data.error) {
      <p>"获取用户信息出错"</p>
    } else if (data.users) {
      <ul>
        for (const user of data.users; key user.login.uuid) {
          <li>
            <img src={user.picture.thumbnail} alt="用户" />
            <p>{user.name.first}" "{user.name.last}</p>
          </li>
        }
      </ul>
    }
  </>;
}