feat(docs): enhance interactive demos and improve documentation
- Add new interactive components for frontend routing, browser rendering pipeline, and database transactions - Improve existing demos with better visuals, explanations, and examples - Update documentation structure and content for better clarity - Add new utility scripts and update package.json with new commands - Fix formatting and alignment in documentation tables
This commit is contained in:
@@ -59,33 +59,60 @@ const startSearch = async () => {
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div class="db-demo">
|
||||
<div class="controls">
|
||||
<div class="control-item">
|
||||
<span>查找 ID: </span>
|
||||
<div class="db-index-demo">
|
||||
<div class="demo-header">
|
||||
<span class="icon">🔍</span>
|
||||
<span class="title">索引查找演示</span>
|
||||
<span class="subtitle">全表扫描 vs 索引查找</span>
|
||||
</div>
|
||||
|
||||
<div class="intro-text">
|
||||
想象你在<span class="highlight">图书馆</span>找一本叫"数据库原理"的书。如果没有目录,你得一排排书架找;有了索书号,直接去对应区域拿。数据库索引就像这个<span class="highlight">索书号</span>,让查找速度从"翻遍所有书"变成"直接定位"。
|
||||
</div>
|
||||
|
||||
<div class="controls-area">
|
||||
<div class="input-group">
|
||||
<label>查找 ID:</label>
|
||||
<el-input-number
|
||||
v-model="searchQuery"
|
||||
:min="1"
|
||||
:max="DATA_SIZE"
|
||||
size="small"
|
||||
:disabled="isSearching"
|
||||
/>
|
||||
</div>
|
||||
<el-radio-group v-model="mode" size="small">
|
||||
<el-radio-button label="scan">全表扫描 (O(n))</el-radio-button>
|
||||
<el-radio-button label="index">索引查找 (O(log n))</el-radio-button>
|
||||
</el-radio-group>
|
||||
<el-button
|
||||
type="primary"
|
||||
|
||||
<div class="mode-selector">
|
||||
<button
|
||||
class="mode-btn"
|
||||
:class="{ active: mode === 'scan' }"
|
||||
@click="mode = 'scan'"
|
||||
:disabled="isSearching"
|
||||
>
|
||||
🐢 全表扫描 O(n)
|
||||
</button>
|
||||
<button
|
||||
class="mode-btn"
|
||||
:class="{ active: mode === 'index' }"
|
||||
@click="mode = 'index'"
|
||||
:disabled="isSearching"
|
||||
>
|
||||
⚡ 索引查找 O(log n)
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<button
|
||||
class="search-btn"
|
||||
@click="startSearch"
|
||||
:loading="isSearching"
|
||||
size="small"
|
||||
>开始查询</el-button
|
||||
:disabled="isSearching"
|
||||
>
|
||||
{{ isSearching ? '查找中...' : '开始查找' }}
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<div class="visualization-area">
|
||||
<!-- Full Scan Visualization -->
|
||||
<div v-if="mode === 'scan'" class="view-container">
|
||||
<div v-if="mode === 'scan'" class="view-container scan-view">
|
||||
<div class="grid">
|
||||
<div
|
||||
v-for="(item, index) in data"
|
||||
@@ -93,19 +120,20 @@ const startSearch = async () => {
|
||||
class="data-block"
|
||||
:class="{
|
||||
active: index === scanCurrentIndex,
|
||||
found: searchResult && searchResult.id === item.id
|
||||
found: searchResult && searchResult.id === item.id,
|
||||
dimmed: scanCurrentIndex >= 0 && index > scanCurrentIndex
|
||||
}"
|
||||
>
|
||||
{{ item.id }}
|
||||
</div>
|
||||
</div>
|
||||
<p class="desc">
|
||||
全表扫描:数据库必须逐行检查数据,直到找到匹配项。数据越多,速度越慢。
|
||||
<p class="view-desc">
|
||||
全表扫描:数据库像<span class="highlight">逐个翻书架</span>一样,必须逐行检查数据,直到找到匹配项。数据越多,速度越慢。
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<!-- Index Visualization -->
|
||||
<div v-else class="view-container">
|
||||
<div v-else class="view-container index-view">
|
||||
<div class="grid">
|
||||
<div
|
||||
v-for="(item, index) in data"
|
||||
@@ -114,150 +142,293 @@ const startSearch = async () => {
|
||||
:class="{
|
||||
visited: treeActiveNodes.includes(index),
|
||||
found: searchResult && searchResult.id === item.id,
|
||||
dimmed:
|
||||
treeActiveNodes.length > 0 && !treeActiveNodes.includes(index)
|
||||
dimmed: treeActiveNodes.length > 0 && !treeActiveNodes.includes(index)
|
||||
}"
|
||||
>
|
||||
{{ item.id }}
|
||||
</div>
|
||||
</div>
|
||||
<p class="desc">
|
||||
索引查找:类似二分查找或 B+
|
||||
树,每次比较都能排除掉一半(或更多)的数据,极快地定位目标。
|
||||
<p class="view-desc">
|
||||
索引查找:类似<span class="highlight">查字典</span>,通过二分查找或 B+ 树,每次比较都能排除掉一半(或更多)的数据,极快地定位目标。
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="stats" v-if="!isSearching && searchResult">
|
||||
<div class="stats-box" v-if="!isSearching && searchResult">
|
||||
<div class="stat-item">
|
||||
<span class="label">查找结果:</span>
|
||||
<span class="value">{{ searchResult.value }}</span>
|
||||
<span class="stat-icon">🎯</span>
|
||||
<div class="stat-content">
|
||||
<div class="stat-label">查找结果</div>
|
||||
<div class="stat-value">{{ searchResult.value }}</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="stat-item">
|
||||
<span class="label">操作次数:</span>
|
||||
<span class="value highlight"
|
||||
>{{
|
||||
mode === 'scan' ? scanCurrentIndex + 1 : treeActiveNodes.length
|
||||
}}
|
||||
次</span
|
||||
>
|
||||
<span class="stat-icon">{{ mode === 'scan' ? '🐢' : '⚡' }}</span>
|
||||
<div class="stat-content">
|
||||
<div class="stat-label">操作次数</div>
|
||||
<div class="stat-value" :class="mode">
|
||||
{{ mode === 'scan' ? scanCurrentIndex + 1 : treeActiveNodes.length }} 次
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="info-box">
|
||||
<span class="icon">💡</span>
|
||||
<strong>核心思想:</strong>索引是用<span class="highlight">空间换时间</span>的经典案例。虽然需要额外空间存储索引结构,但能让查询速度提升成千上万倍。就像图书馆的目录卡片,虽占位置,但找书快太多了。
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.db-demo {
|
||||
padding: 20px;
|
||||
border: 1px solid #e4e7ed;
|
||||
.db-index-demo {
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
border-radius: 8px;
|
||||
background: #ffffff;
|
||||
font-family: sans-serif;
|
||||
background: var(--vp-c-bg-soft);
|
||||
padding: 1rem;
|
||||
margin: 1rem 0;
|
||||
}
|
||||
.controls {
|
||||
display: flex;
|
||||
gap: 15px;
|
||||
margin-bottom: 20px;
|
||||
flex-wrap: wrap;
|
||||
align-items: center;
|
||||
padding-bottom: 15px;
|
||||
border-bottom: 1px solid #eee;
|
||||
}
|
||||
.control-item {
|
||||
|
||||
.demo-header {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
font-size: 14px;
|
||||
gap: 0.5rem;
|
||||
margin-bottom: 0.75rem;
|
||||
}
|
||||
.view-container {
|
||||
min-height: 200px;
|
||||
|
||||
.demo-header .icon { font-size: 1.25rem; }
|
||||
.demo-header .title { font-weight: bold; font-size: 1rem; }
|
||||
.demo-header .subtitle { color: var(--vp-c-text-2); font-size: 0.85rem; margin-left: 0.5rem; }
|
||||
|
||||
.intro-text {
|
||||
font-size: 0.9rem;
|
||||
color: var(--vp-c-text-2);
|
||||
line-height: 1.6;
|
||||
margin-bottom: 1rem;
|
||||
padding: 0.75rem;
|
||||
background: var(--vp-c-bg);
|
||||
border-radius: 6px;
|
||||
}
|
||||
|
||||
.intro-text .highlight {
|
||||
color: var(--vp-c-brand-1);
|
||||
font-weight: 500;
|
||||
}
|
||||
|
||||
.controls-area {
|
||||
background: var(--vp-c-bg);
|
||||
padding: 0.75rem;
|
||||
border-radius: 6px;
|
||||
margin-bottom: 1rem;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
gap: 0.75rem;
|
||||
}
|
||||
|
||||
.input-group {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 0.5rem;
|
||||
}
|
||||
|
||||
.input-group label {
|
||||
font-size: 0.85rem;
|
||||
color: var(--vp-c-text-2);
|
||||
font-weight: 500;
|
||||
}
|
||||
|
||||
.mode-selector {
|
||||
display: grid;
|
||||
grid-template-columns: 1fr 1fr;
|
||||
gap: 0.5rem;
|
||||
}
|
||||
|
||||
.mode-btn {
|
||||
padding: 0.5rem 0.75rem;
|
||||
background: var(--vp-c-bg-soft);
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
border-radius: 6px;
|
||||
font-size: 0.8rem;
|
||||
cursor: pointer;
|
||||
transition: all 0.2s;
|
||||
color: var(--vp-c-text-1);
|
||||
}
|
||||
|
||||
.mode-btn:hover:not(:disabled) {
|
||||
background: var(--vp-c-bg-soft);
|
||||
border-color: var(--vp-c-brand);
|
||||
}
|
||||
|
||||
.mode-btn.active {
|
||||
background: var(--vp-c-brand-soft);
|
||||
border-color: var(--vp-c-brand);
|
||||
color: var(--vp-c-brand-1);
|
||||
font-weight: 500;
|
||||
}
|
||||
|
||||
.mode-btn:disabled {
|
||||
opacity: 0.5;
|
||||
cursor: not-allowed;
|
||||
}
|
||||
|
||||
.search-btn {
|
||||
width: 100%;
|
||||
padding: 0.75rem;
|
||||
background: var(--vp-c-brand);
|
||||
color: white;
|
||||
border: none;
|
||||
border-radius: 6px;
|
||||
font-size: 0.9rem;
|
||||
font-weight: 500;
|
||||
cursor: pointer;
|
||||
transition: background 0.2s;
|
||||
}
|
||||
|
||||
.search-btn:hover:not(:disabled) {
|
||||
background: var(--vp-c-brand-1);
|
||||
}
|
||||
|
||||
.search-btn:disabled {
|
||||
opacity: 0.6;
|
||||
cursor: not-allowed;
|
||||
}
|
||||
|
||||
.visualization-area {
|
||||
background: var(--vp-c-bg);
|
||||
padding: 0.75rem;
|
||||
border-radius: 6px;
|
||||
margin-bottom: 1rem;
|
||||
}
|
||||
|
||||
.view-container {
|
||||
max-height: 300px;
|
||||
overflow-y: auto;
|
||||
}
|
||||
|
||||
.grid {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 6px;
|
||||
justify-content: center;
|
||||
margin-bottom: 15px;
|
||||
margin-bottom: 0.75rem;
|
||||
}
|
||||
|
||||
.data-block {
|
||||
width: 32px;
|
||||
height: 32px;
|
||||
background: #f0f2f5;
|
||||
background: var(--vp-c-bg-soft);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
font-size: 12px;
|
||||
font-size: 0.7rem;
|
||||
border-radius: 4px;
|
||||
color: #606266;
|
||||
color: var(--vp-c-text-2);
|
||||
transition: all 0.3s;
|
||||
border: 1px solid transparent;
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
}
|
||||
|
||||
.data-block.active {
|
||||
background: #409eff;
|
||||
background: var(--vp-c-brand);
|
||||
color: white;
|
||||
transform: scale(1.15);
|
||||
box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1);
|
||||
border-color: #409eff;
|
||||
box-shadow: 0 2px 8px rgba(37, 99, 235, 0.3);
|
||||
border-color: var(--vp-c-brand);
|
||||
z-index: 1;
|
||||
}
|
||||
|
||||
.data-block.found {
|
||||
background: #67c23a;
|
||||
background: #22c55e;
|
||||
color: white;
|
||||
transform: scale(1.2);
|
||||
box-shadow: 0 0 15px rgba(103, 194, 58, 0.5);
|
||||
border-color: #67c23a;
|
||||
box-shadow: 0 0 12px rgba(34, 197, 94, 0.5);
|
||||
border-color: #22c55e;
|
||||
z-index: 2;
|
||||
font-weight: bold;
|
||||
}
|
||||
|
||||
.tree-node.visited {
|
||||
background: #e6a23c;
|
||||
color: white;
|
||||
transform: scale(1.1);
|
||||
box-shadow: 0 2px 8px rgba(230, 162, 60, 0.4);
|
||||
z-index: 1;
|
||||
}
|
||||
.tree-node.dimmed {
|
||||
.data-block.dimmed {
|
||||
opacity: 0.2;
|
||||
filter: grayscale(100%);
|
||||
}
|
||||
|
||||
.desc {
|
||||
font-size: 14px;
|
||||
color: #909399;
|
||||
text-align: center;
|
||||
margin-top: 10px;
|
||||
max-width: 600px;
|
||||
.tree-node.visited {
|
||||
background: #f59e0b;
|
||||
color: white;
|
||||
transform: scale(1.1);
|
||||
box-shadow: 0 2px 8px rgba(245, 158, 11, 0.4);
|
||||
z-index: 1;
|
||||
}
|
||||
|
||||
.stats {
|
||||
margin-top: 20px;
|
||||
padding: 15px;
|
||||
background: #fdf6ec;
|
||||
border-radius: 4px;
|
||||
display: flex;
|
||||
justify-content: space-around;
|
||||
.view-desc {
|
||||
text-align: center;
|
||||
font-size: 0.8rem;
|
||||
color: var(--vp-c-text-2);
|
||||
line-height: 1.5;
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.view-desc .highlight {
|
||||
color: var(--vp-c-brand-1);
|
||||
font-weight: 500;
|
||||
}
|
||||
|
||||
.stats-box {
|
||||
display: grid;
|
||||
grid-template-columns: 1fr 1fr;
|
||||
gap: 0.75rem;
|
||||
margin-bottom: 1rem;
|
||||
}
|
||||
|
||||
.stat-item {
|
||||
background: var(--vp-c-bg);
|
||||
padding: 0.75rem;
|
||||
border-radius: 6px;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
gap: 5px;
|
||||
gap: 0.75rem;
|
||||
}
|
||||
.label {
|
||||
font-size: 12px;
|
||||
color: #909399;
|
||||
|
||||
.stat-icon {
|
||||
font-size: 1.5rem;
|
||||
}
|
||||
.value {
|
||||
font-size: 16px;
|
||||
font-weight: bold;
|
||||
color: #303133;
|
||||
|
||||
.stat-content {
|
||||
flex: 1;
|
||||
}
|
||||
.value.highlight {
|
||||
color: #e6a23c;
|
||||
font-size: 20px;
|
||||
|
||||
.stat-label {
|
||||
font-size: 0.7rem;
|
||||
color: var(--vp-c-text-3);
|
||||
margin-bottom: 0.25rem;
|
||||
}
|
||||
|
||||
.stat-value {
|
||||
font-size: 1rem;
|
||||
font-weight: 600;
|
||||
color: var(--vp-c-text-1);
|
||||
}
|
||||
|
||||
.stat-value.scan {
|
||||
color: #ef4444;
|
||||
}
|
||||
|
||||
.stat-value:not(.scan) {
|
||||
color: #22c55e;
|
||||
}
|
||||
|
||||
.info-box {
|
||||
background: var(--vp-c-bg-alt);
|
||||
padding: 0.75rem;
|
||||
border-radius: 6px;
|
||||
font-size: 0.85rem;
|
||||
color: var(--vp-c-text-2);
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
.info-box .icon { margin-right: 0.25rem; }
|
||||
|
||||
.info-box .highlight {
|
||||
color: var(--vp-c-brand-1);
|
||||
font-weight: 500;
|
||||
}
|
||||
</style>
|
||||
|
||||
Reference in New Issue
Block a user