# -*- coding: utf-8 -*-
"""lab03_web_frontend · 第2章 Web 前端基础（端口 5112）

本节重点（对应教材配套 PPT，授课：谢福财）：
    - HTML：标签语义化（h1/p/a/img/table/form）
    - CSS 三种写法：行内 / 内部 style / 外部文件，优先级从高到低
    - JavaScript：提交前用 onsubmit 做一次前端校验
    - Bootstrap：container / row / col 栅格，断点自动换行
    - 前后端分工：本章页面几乎不需要 Python 逻辑，重点在模板本身

运行：
    ..\\.venv\\Scripts\\python.exe app.py      # 或双击 run.bat / PyCharm 点绿三角
    浏览器打开 http://127.0.0.1:5112/

说明：本文件每一段都有注释；带 ★ 的行是这一讲要重点看的代码。
"""

from flask import Flask, render_template, request
from flask_bootstrap import Bootstrap5

app = Flask(__name__)

# BOOTSTRAP_SERVE_LOCAL=True：Bootstrap 的 css/js 从本地 static 目录读取，
# 而不是从 CDN 下载。机房断网时页面样式不会塌掉。
app.config['BOOTSTRAP_SERVE_LOCAL'] = True
Bootstrap5(app)


# 首页：只是导航
# ★ 本节重点：六节导航首页
@app.route('/')
def index():
    return render_template('index.html')


# ---------- 2.1 文字 / 图片 / 链接 ----------
# ★ 本节重点：HTML：文字、图片、链接、列表
@app.route('/html')
def html_basics():
    return render_template('html_basics.html')


# ---------- 2.2 CSS ----------
# ★ 本节重点：CSS 三种写法对照
@app.route('/css')
def css():
    return render_template('css.html')


# ---------- 2.3 JavaScript 表单校验 ----------
# ★ 本节重点：JavaScript 表单校验
@app.route('/js', methods=['GET', 'POST'])
def js_demo():
    """GET 显示表单；POST 收数据。
    注意：能走到 POST 分支，说明前端 JS 校验已经放行（return true）。
    """
    result = None
    if request.method == 'POST':
        username = request.form.get('username', '')
        password = request.form.get('password', '')
        # 服务器端再校验一遍 —— 前端校验永远不可信
        result = f'username={username}，password={"*" * len(password)}（{len(password)} 位）'
    return render_template('js.html', result=result)


# ---------- 2.4 表格 ----------
# ★ 本节重点：表格：原生 table 与 Bootstrap 表格
@app.route('/table')
def table():
    # 真实项目中这些数据来自数据库（第5章），这里先写死，只关注表格怎么渲染
    users = [
        {'id': 1, 'name': 'John',   'email': 'john@example.com'},
        {'id': 2, 'name': 'Bill',   'email': 'bill@example.com'},
        {'id': 3, 'name': 'Carlos', 'email': 'carlos@example.com'},
    ]
    return render_template('table.html', users=users)


# ---------- 2.5 HTML5 语义化表单 ----------
# ★ 本节重点：HTML5 语义化表单
@app.route('/form')
def form():
    return render_template('form.html')


@app.route('/submit', methods=['POST'])
def submit():
    """接收 form.html 提交的数据，原样打印出来。
    request.form 是一个字典，存 POST 上来的所有字段。
    """
    items = [f'{k} = {v}' for k, v in request.form.items()]
    return ('<h1>收到表单数据</h1><pre>' + '\n'.join(items)
            + '</pre><p><a href="/form">← 再填一次</a> | <a href="/">回首页</a></p>')


# ---------- 2.6 Bootstrap 栅格 ----------
# ★ 本节重点：Bootstrap 栅格：一行十二列、断点换行
@app.route('/grid')
def grid():
    return render_template('grid.html')


if __name__ == '__main__':
    # debug=True：改完代码保存，浏览器刷新即生效，不用手动重启
    app.run(debug=True, port=5112)
