lynx-html-renderer

Lynx HTML Renderer

一个将 HTML 渲染到 Lynx 原生组件 的轻量、可扩展渲染引擎。

A lightweight and extensible renderer that render HTML string on Lynx.

---

✨ 项目简介 | Introduction

HTML → Lynx Renderer 通过解析 HTML 并转换为一棵中间语义树（LynxNode），最终渲染为 Lynx 原生组件。

该项目并非浏览器实现，而是一个 面向原生的 HTML 安全集渲染方案，适用于：

• 内容页 / 详情页
• 富文本展示
• 配置化页面

HTML → Lynx Renderer parses HTML into a semantic intermediate representation (LynxNode), then renders it into Lynx native components.

It is not a browser, but a native-oriented, safe HTML rendering solution, suitable for:

• Content & detail pages
• Rich text rendering
• Configuration-driven pages

---

🎯 设计目标 | Design Goals

• ✅ 渲染大部分真实业务中的 HTML 页面
• ✅ 支持文本、图片、Flex 布局、基础表格
• ✅ 支持用户自定义标签与渲染组件
• ✅ 架构可扩展、可长期维护

---

🚫 非目标 | Non-goals

• ❌ 不实现完整 HTML/CSS 规范
• ❌ 不执行 JavaScript（script / inline events）
• ❌ 不追求浏览器级像素一致
• ❌ 不做 DOM diff 或 hydration

---

🧠 核心思想 | Core Concepts

参考 Architecture

📦 功能特性 | Features

• ✅ HTML 标签 → Lynx 组件映射
• ✅ CSS style 安全集解析（白名单）
• ✅ 文本语义（strong / em / code）
• ✅ 基础表格支持（table / tr / td）
• ✅ 用户自定义渲染组件
• ✅ 插件化 Transform 机制（可选）

---

🧩 插件机制 | Plugin System

Transform 阶段支持插件，用于：

• 覆盖某些 HTML 标签的解析方式
• 插入自定义语义节点
• 扩展样式或结构处理逻辑

插件以 pipeline 形式执行，不影响核心逻辑的稳定性。

---

🛠 使用场景 | Use Cases

• 内容管理系统（CMS）页面渲染
• 富文本展示（不依赖 WebView）
• 多端统一内容渲染

---

🙌 贡献 | Contributing

欢迎 issue、讨论与 PR。

本项目更关注 架构正确性与可维护性，而非一次性功能堆叠。

Contributions, issues, and discussions are welcome.

---

This project is designed as a long-term maintainable HTML-to-Native rendering pipeline, not a one-off rich text solution.

This site is open source. Improve this page.