响应式
声明状态
更新状态
模板语法
样式
<h1 class="title">我是红色的</h1>
<button style="font-size: 10rem">我是一个按钮</button>
<style>
.title {
color: red;
}
</style>
DOM循环
点击事件
<div x-data="{ count: 0 }">
<p>计数器: <span x-text="count"></span></p>
<button x-on:click="count++">+1</button>
</div>
DOM引用
条件渲染
<div
x-data="{
TRAFFIC_LIGHTS: ['红灯', '黄灯', '绿灯'],
lightIndex: 0,
get light() { return this.TRAFFIC_LIGHTS[this.lightIndex] },
nextLight() {
this.lightIndex = (this.lightIndex + 1) % this.TRAFFIC_LIGHTS.length;
}
}"
>
<button x-on:click="nextLight">下一个灯</button>
<p>现在亮着的是: <span x-text="light"></span></p>
<p>
你应该
<span x-show="light === '红灯'">停下</span>
<span x-show="light === '黄灯'">慢行</span>
<span x-show="light === '绿灯'">赶紧走</span>
</p>
</div>
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>
</>;
}
生命周期
组件加载时
<p
x-data="{ pageTitle: '' }"
x-init="$nextTick(() => { pageTitle = document.title })"
>
页面标题: <span x-text="pageTitle"></span>
</p>
组件卸载时
<p
x-data="{
time: new Date().toLocaleTimeString(),
timer: null,
init() { this.timer = setInterval(() => (this.time = new Date().toLocaleTimeString()), 1000) },
destroy() { clearInterval(this.timer) }
}"
>
当前时间: <span x-text="time"></span>
</p>
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传参
<!--Alpine JS suggests using a server-side templating engine or another frontend framework in conjunction with Alpine to do this-->
<div
x-data="{
name: '张三',
age: 20,
favouriteColors: ['green', 'blue', 'red'],
isAvailable: true
}"
>
<p>我的名字是 <span x-text="张三"></span></p>
<p>My age is <span x-text="age"></span></p>
<p>
My favourite colors are <span x-text="favouriteColors.join(', ')"></span>
</p>
<p>I am <span x-text="isAvailable ? 'available' : 'not available'"></span></p>
</div>
向父组件emit事件
<div
x-data="{ isHappy: true }"
x-on:yes="isHappy = true"
x-on:no="isHappy = false"
>
<p>你快乐吗?</p>
<div>
<button x-on:click="$dispatch('yes')">是的!</button>
<button x-on:click="$dispatch('no')">不是!</button>
</div>
<p style="font-size: 50px" x-text="isHappy ? '😀' : '😥'"></p>
</div>
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插槽
<!--Alpine JS suggests using a server-side templating engine or another frontend framework in conjunction with Alpine to do this-->
<button
x-data
x-text="'点我!'"
style="
background: rgba(0, 0, 0, 0.4);
color: #fff;
padding: 10px 20px;
font-size: 30px;
border: 2px solid #fff;
margin: 8px;
transform: scale(0.9);
box-shadow: 4px 4px rgba(0, 0, 0, 0.4);
transition: transform 0.2s cubic-bezier(0.34, 1.65, 0.88, 0.925) 0s;
outline: 0;
"
>
<span>默认slot内容</span>
</button>
slot插槽内容
<!--Alpine JS suggests using a server-side templating engine or another frontend framework in conjunction with Alpine to do this-->
<button
x-data
style="
background: rgba(0, 0, 0, 0.4);
color: #fff;
padding: 10px 20px;
font-size: 30px;
border: 2px solid #fff;
margin: 8px;
transform: scale(0.9);
box-shadow: 4px 4px rgba(0, 0, 0, 0.4);
transition: transform 0.2s cubic-bezier(0.34, 1.65, 0.88, 0.925) 0s;
outline: 0;
"
>
<span>默认slot内容</span>
</button>
<button
x-data
x-text="'这是传到slot的内容!'"
style="
background: rgba(0, 0, 0, 0.4);
color: #fff;
padding: 10px 20px;
font-size: 30px;
border: 2px solid #fff;
margin: 8px;
transform: scale(0.9);
box-shadow: 4px 4px rgba(0, 0, 0, 0.4);
transition: transform 0.2s cubic-bezier(0.34, 1.65, 0.88, 0.925) 0s;
outline: 0;
"
>
<span>默认slot内容</span>
</button>
上下文
<!-- x-text 必须用在带有 x-data 的元素或其子元素上。 -->
<!-- 这两个元素可以共用一个带有 x-data 的父元素,也可以像下面这样分别添加 x-data: -->
<h1 x-data>
欢迎回来, <span x-text="$store.user.username">未知用户</span>
</h1>
<div x-data>
<h2>我的简介</h2>
<p>用户名: <span x-text="$store.user.username"></span></p>
<p>邮箱: <span x-text="$store.user.email"></span></p>
<button @click="$store.user.updateUsername('李四')">
更新用户名为 李四
</button>
</div>
<script>
document.addEventListener("alpine:init", () => {
Alpine.store("user", {
id: 1,
username: "abcdefg",
email: "[email protected]",
updateUsername(newUsername) {
this.username = newUsername;
},
});
});
</script>
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 />
</>;
}
表单输入
输入框
复选框
<div x-data="{ isAvailable: true }">
<input id="is-available" x-model="isAvailable" type="checkbox" />
<label for="is-available">这是一个checkbox</label>
</div>
单选框
<div x-data="{ picked: 'red' }">
<div>你选择了: <span x-text="picked"></span></div>
<input id="blue-pill" x-model="picked" type="radio" value="blue" />
<label for="blue-pill">蓝色</label>
<input id="red-pill" x-model="picked" type="radio" value="red" />
<label for="red-pill">红色</label>
</div>
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>
</>;
}
选择器
<div
x-data="{
selectedColorId: 2,
colors: [
{ id: 1, text: '红' },
{ id: 2, text: '蓝' },
{ id: 3, text: '绿' },
{ id: 4, text: '灰', isDisabled: true }
]
}"
>
<select x-model.number="selectedColorId">
<template x-for="color in colors" x-bind:key="color.id">
<option
x-text="color.text"
x-bind:value="color.id"
x-bind:disabled="!!color.isDisabled"
x-bind:selected="color.id === selectedColorId"
></option>
</template>
</select>
</div>
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应用特性
渲染应用
fetch获取数据
<div
x-data="
function fetchUsers() {
return {
users: null,
isLoading: false,
error: null,
async init() {
this.isLoading = true;
try {
this.users = (await (await fetch('https://randomuser.me/api/?results=3')).json()).results;
} catch (err) {
this.users = [];
this.error = err
}
this.isLoading = false;
},
};
}
"
>
<template x-if="isLoading">
<p>正在获取用户信息……</p>
</template>
<template x-if="error">
<p>获取用户信息出错</p>
</template>
<template x-if="!error">
<ul>
<template x-for="user in users">
<li>
<img
:src="user.picture.thumbnail"
:alt="`picture of ${user.name.first} ${user.name.last}`"
/>
<p x-text="`${user.name.first} ${user.name.last}`"></p>
</li>
</template>
</ul>
</template>
</div>
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>
}
</>;
}