Files
test-repo/docs/.vitepress/theme/components/appendix/api-intro/ApiConceptDemo.vue
T
2026-01-20 17:53:22 +08:00

305 lines
7.2 KiB
Vue
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!--
ApiConceptDemo.vue - 互动点餐版
目标通过"点菜"的过程演示 API 的三个核心要素
-->
<template>
<div class="demo">
<div class="header">
<span class="icon">🍳</span>
<span class="title">互动演示 AI 厨房点菜</span>
</div>
<div class="stepper">
<!-- Step 1: Endpoint -->
<div class="step-group">
<div class="step-label">1. 跟谁说(Endpoint)</div>
<select v-model="endpoint" class="control">
<option value="/kitchen/chef">👨🍳 主厨 (/kitchen/chef)</option>
<option value="/kitchen/bar">🍸 调酒师 (/kitchen/bar)</option>
</select>
</div>
<!-- Step 2: Method -->
<div class="step-group">
<div class="step-label">2. 怎么说(Method)</div>
<div class="toggle-group">
<button
:class="['toggle-btn', { active: method === 'GET' }]"
@click="method = 'GET'"
>
GET (看看有什么)
</button>
<button
:class="['toggle-btn', { active: method === 'POST' }]"
@click="method = 'POST'"
>
POST (我要下单)
</button>
</div>
</div>
<!-- Step 3: Params -->
<div class="step-group" v-if="method === 'POST'">
<div class="step-label">3. 点什么(Body)</div>
<div class="params-editor">
{ "food":
<select v-model="food" class="inline-select">
<option value="steak">🥩 牛排</option>
<option value="pasta">🍝 意面</option>
<option value="salad">🥗 沙拉</option>
</select>
}
</div>
</div>
<div class="step-group" v-else>
<div class="step-label">3. 查什么(Params)</div>
<div class="params-editor">
?type=
<select v-model="menuType" class="inline-select">
<option value="today">📅 今日特供</option>
<option value="all">📜 全部菜单</option>
</select>
</div>
</div>
<!-- Action -->
<button class="send-btn" @click="sendRequest" :disabled="loading">
{{ loading ? '🍳 正在做...' : '🚀 发送请求' }}
</button>
</div>
<!-- Result -->
<div class="result-box" v-if="response">
<div class="result-header">
<span class="badge" :class="response.status === 200 ? 'success' : 'error'">
{{ response.status }} {{ response.statusText }}
</span>
</div>
<div class="result-content">
{{ response.data }}
</div>
<div class="result-explanation">
💡 <strong>解释</strong> {{ response.explanation }}
</div>
</div>
</div>
</template>
<script setup>
import { ref, watch } from 'vue'
const endpoint = ref('/kitchen/chef')
const method = ref('GET')
const food = ref('steak')
const menuType = ref('today')
const loading = ref(false)
const response = ref(null)
// Reset response when inputs change
watch([endpoint, method, food, menuType], () => {
response.value = null
})
function sendRequest() {
loading.value = true
response.value = null
setTimeout(() => {
loading.value = false
// Logic for different combinations
if (endpoint.value === '/kitchen/bar') {
if (method.value === 'GET') {
response.value = {
status: 200,
statusText: 'OK',
data: { menu: ['Mojito', 'Martini', 'Beer'] },
explanation: '你问调酒师有哪些酒,他给了你酒单。'
}
} else {
response.value = {
status: 400,
statusText: 'Bad Request',
data: { error: "Bar only serves drinks, not food!" },
explanation: '你试图向调酒师点菜(牛排/意面),他拒绝了你。你应该去 /kitchen/chef 点菜,或者只点酒。'
}
}
return
}
// Chef logic
if (method.value === 'GET') {
response.value = {
status: 200,
statusText: 'OK',
data: { specials: ['Spicy Chicken', 'Tofu Soup'] },
explanation: '你问主厨今天有什么特供,他告诉了你。'
}
} else {
// POST to Chef
const foodMap = {
steak: '🥩 滋滋作响的牛排',
pasta: '🍝 香气扑鼻的意面',
salad: '🥗 新鲜健康的沙拉'
}
response.value = {
status: 200,
statusText: 'Created',
data: { dish: foodMap[food.value], message: "Enjoy your meal!" },
explanation: `你向主厨下了单 (${food.value}),主厨为你做好了菜。`
}
}
}, 600)
}
</script>
<style scoped>
.demo {
border: 1px solid var(--vp-c-divider);
border-radius: 12px;
background: var(--vp-c-bg-soft);
margin: 24px 0;
overflow: hidden;
}
.header {
padding: 12px 20px;
background: var(--vp-c-bg);
border-bottom: 1px solid var(--vp-c-divider);
display: flex;
align-items: center;
gap: 10px;
font-weight: 600;
}
.stepper {
padding: 20px;
display: flex;
flex-direction: column;
gap: 16px;
}
.step-group {
display: flex;
flex-direction: column;
gap: 8px;
}
.step-label {
font-size: 13px;
font-weight: 600;
color: var(--vp-c-text-2);
text-transform: uppercase;
letter-spacing: 0.5px;
}
.control, .inline-select {
padding: 8px 12px;
border-radius: 6px;
border: 1px solid var(--vp-c-divider);
background: var(--vp-c-bg);
color: var(--vp-c-text-1);
font-size: 14px;
cursor: pointer;
}
.toggle-group {
display: flex;
background: var(--vp-c-divider);
padding: 2px;
border-radius: 8px;
width: fit-content;
}
.toggle-btn {
padding: 6px 16px;
border-radius: 6px;
border: none;
background: transparent;
color: var(--vp-c-text-2);
font-size: 14px;
cursor: pointer;
transition: all 0.2s;
}
.toggle-btn.active {
background: var(--vp-c-bg);
color: var(--vp-c-brand-1);
font-weight: 600;
box-shadow: 0 1px 3px rgba(0,0,0,0.1);
}
.params-editor {
font-family: monospace;
background: var(--vp-c-bg);
padding: 12px;
border-radius: 6px;
border: 1px solid var(--vp-c-divider);
display: flex;
align-items: center;
gap: 8px;
}
.send-btn {
margin-top: 8px;
background: var(--vp-c-brand-1);
color: white;
border: none;
padding: 12px;
border-radius: 8px;
font-weight: 600;
cursor: pointer;
transition: opacity 0.2s;
}
.send-btn:disabled {
opacity: 0.7;
cursor: not-allowed;
}
.result-box {
margin: 0 20px 20px;
background: #1e293b;
border-radius: 8px;
overflow: hidden;
color: #e2e8f0;
font-family: monospace;
animation: slideDown 0.3s ease;
}
.result-header {
padding: 8px 12px;
background: rgba(0,0,0,0.3);
display: flex;
align-items: center;
}
.badge {
font-size: 12px;
padding: 2px 6px;
border-radius: 4px;
font-weight: bold;
}
.badge.success { background: #22c55e; color: #fff; }
.badge.error { background: #ef4444; color: #fff; }
.result-content {
padding: 16px;
white-space: pre-wrap;
}
.result-explanation {
padding: 12px;
background: #334155;
font-family: var(--vp-font-family-base);
font-size: 13px;
border-top: 1px solid rgba(255,255,255,0.1);
}
@keyframes slideDown {
from { opacity: 0; transform: translateY(-10px); }
to { opacity: 1; transform: translateY(0); }
}
</style>