前端可访问性:别让你的网站对某些人关闭大门

前端可访问性:别让你的网站对某些人关闭大门

毒舌时刻

这网站做的跟迷宫似的,正常人都找不到路,更别说有障碍的人了。

各位前端同行,咱们今天聊聊前端可访问性。别告诉我你还在忽略可访问性,那感觉就像在公共建筑里不建无障碍通道——能进,但不是所有人都能进。

为什么你需要关注可访问性

最近看到一个项目,按钮没有焦点状态,表单没有标签,屏幕阅读器根本无法正常工作。我就想问:你是在做网站还是在做密室逃脱?

反面教材

// 反面教材:忽略可访问性 function App() { return ( <div> <h1>我的网站</h1> <div> <input type="text" placeholder="用户名" /> <input type="password" placeholder="密码" /> <button>登录</button> </div> <div> <img src="logo.png" /> <a href="#">关于我们</a> <a href="#">联系我们</a> </div> </div> ); } export default App; 

毒舌点评:这代码,就像在黑暗中摸索,什么都看不见。

正确姿势

1. 语义化 HTML

// 正确姿势:语义化 HTML function App() { return ( <div> <header> <h1>我的网站</h1> </header> <main> <form> <div> <label htmlFor="username">用户名</label> <input type="text" aria-label="用户名" /> </div> <div> <label htmlFor="password">密码</label> <input type="password" aria-label="密码" /> </div> <button type="submit" aria-label="登录">登录</button> </form> </main> <footer> <img src="logo.png" alt="网站 logo" /> <nav> <ul> <li><a href="#">关于我们</a></li> <li><a href="#">联系我们</a></li> </ul> </nav> </footer> </div> ); } export default App; 

2. ARIA 标签

// 正确姿势:使用 ARIA 标签 function App() { const [expanded, setExpanded] = React.useState(false); return ( <div> <button aria-expanded={expanded} aria-controls="menu" onClick={() => setExpanded(!expanded)} > 菜单 </button> <nav aria-hidden={!expanded}> <ul> <li><a href="#">首页</a></li> <li><a href="#">关于我们</a></li> <li><a href="#">联系我们</a></li> </ul> </nav> </div> ); } export default App; 

3. 键盘导航

// 正确姿势:键盘导航 function App() { const [focused, setFocused] = React.useState(0); const items = ['首页', '关于我们', '联系我们', '服务']; const handleKeyDown = (e) => { if (e.key === 'ArrowRight') { setFocused((prev) => (prev + 1) % items.length); } else if (e.key === 'ArrowLeft') { setFocused((prev) => (prev - 1 + items.length) % items.length); } }; return ( <nav onKeyDown={handleKeyDown} tabIndex={0}> <ul> {items.map((item, index) => ( <li key={index}> <a href="#" tabIndex={-1} style={{ outline: index === focused ? '2px solid blue' : 'none', backgroundColor: index === focused ? '#e0e0e0' : 'transparent' }} onClick={() => setFocused(index)} > {item} </a> </li> ))} </ul> </nav> ); } export default App; 

4. 颜色对比度

/* 正确姿势:颜色对比度 */ /* styles.css */ body { color: #333333; /* 深色文本 */ background-color: #ffffff; /* 浅色背景 */ } a { color: #0066cc; /* 蓝色链接,对比度高 */ text-decoration: none; } a:hover { color: #004499; text-decoration: underline; } button { background-color: #0066cc; color: #ffffff; border: none; padding: 10px 20px; border-radius: 4px; cursor: pointer; } button:hover { background-color: #004499; } 

毒舌点评:这才叫可访问性,让所有人都能平等地使用你的网站。

Read more

本地部署 Gemma-1B 轻量级大模型:Ollama + Open WebUI 完整配置与实战指南

本地部署 Gemma-1B 轻量级大模型:Ollama + Open WebUI 完整配置与实战指南 关键词:Gemma-1B、Ollama、Open WebUI、本地大模型、LLM 部署、JSON 配置、开源模型、轻量化 AI、私有化部署、OpenAI 兼容 API 适用读者:AI 工程师、全栈开发者、技术爱好者、边缘计算研究者、企业私有化 LLM 应用构建者 阅读时长:约 25 分钟(含代码实操) 📌 引言:为什么选择 Gemma-1B 进行本地部署? 在生成式人工智能(Generative AI)迅猛发展的今天,大型语言模型(Large Language Models,

Qwen3-VL-WEBUI移动端集成:App调用API部署教程

Qwen3-VL-WEBUI移动端集成:App调用API部署教程 1. 引言 1.1 业务场景描述 随着多模态大模型在移动端应用的不断拓展,如何将强大的视觉-语言模型(VLM)能力无缝集成到移动 App 中,成为智能客服、图像理解、自动化操作等场景的关键技术挑战。传统方案往往依赖云端纯文本推理,难以满足对图像、视频内容实时理解与交互的需求。 Qwen3-VL-WEBUI 的出现为这一问题提供了高效解决方案。它不仅集成了阿里最新开源的 Qwen3-VL-4B-Instruct 模型,还内置了完整的 Web API 接口服务,支持通过 HTTP 调用实现图文输入、结构化输出,非常适合移动端 App 快速接入。 1.2 痛点分析 目前移动端集成 VLM 面临三大核心痛点: * 部署复杂:多数模型需自行搭建推理环境,配置 CUDA、PyTorch、Transformers 等组件,门槛高。 * 接口缺失:

Java Web 拦截机制实战指南:Filter 与 Interceptor 深度解析

一、理解核心概念 在 Java Web 开发中,过滤器(Filter)和拦截器(Interceptor)是两种核心的请求处理机制。它们虽然都能对请求进行拦截和处理,但定位截然不同: * Filter 是 Servlet 容器的"守门人",位于应用最外层 * Interceptor 是 Spring MVC 的"执法官",位于框架内部 二、Filter:Servlet 容器的第一道防线 2.1 本质与特点 Filter 是 Java Servlet 规范 定义的组件,由 Servlet 容器(如 Tomcat)直接管理,不依赖任何框架,

Dynamics 365 Web API 对接外部系统:数据双向同步方案

一、方案背景与核心目标 1.1 背景概述 在企业数字化转型进程中,Dynamics 365 作为核心的客户关系管理(CRM)与业务运营平台,常需与ERP系统、财务系统、电商平台、自定义业务系统等外部应用联动。由于各系统数据孤立存储、更新节奏不一致,易出现客户信息滞后、订单数据脱节、业务流程断裂等问题,导致运营效率低下、决策偏差。Dynamics 365 Web API 基于RESTful架构,支持OData协议,提供标准化的数据读写接口,是实现跨系统数据互通的核心桥梁,而双向同步则是打破数据孤岛、保障全链路数据一致性的关键需求。 值得注意的是,Dynamics 365 系列应用中,Sales、Customer Service等基于Dataverse平台构建,而财务和运营应用则独立于该平台,双重写入架构与Web API结合可实现这类跨应用的数据双向流转,无需依赖外部中间件即可完成核心数据同步。 1.2 核心目标 * 数据一致性:确保Dynamics 365与外部系统的核心数据(客户、