Dioxus框架中服务器端渲染(Server-Side Rendering,简称SSR)

服务器端渲染(SSR)

为了在渲染过程中获得更低层次的控制,你可以直接使用dioxus-ssr包。当需要与dioxus-fullstack不支持的Web框架集成,或者预渲染页面时,这非常有用。

设置

在这个指南中,我们将展示如何将Dioxus SSR与Axum一起使用。

确保你已经安装了Rust和Cargo,然后创建一个新项目:

sql 复制代码
cargo new --bin demo
cd demo

添加Dioxus和SSR渲染器作为依赖项:

sql 复制代码
cargo add dioxus@0.5.0
cargo add dioxus-ssr@0.5.0

接下来,添加所有Axum依赖项。如果你使用的是不同的Web框架,这将会有所不同:

sql 复制代码
cargo add tokio --features full
cargo add axum

你的依赖项应该大致如下所示:

ini 复制代码
[dependencies]
axum = "0.7"
dioxus = { version = "*" }
dioxus-ssr = { version = "*" }
tokio = { version = "1.15.0", features = ["full"] }

现在,设置你的Axum应用以响应一个端点。

rust 复制代码
use axum::{response::Html, routing::get, Router};
use dioxus::prelude::*;

#[tokio::main]
async fn main() {
    let listener = tokio::net::TcpListener::bind("127.0.0.1:3000")
        .await
        .unwrap();

    println!("listening on http://127.0.0.1:3000");

    axum::serve(
        listener,
        Router::new()
            .route("/", get(app_endpoint))
            .into_make_service(),
    )
    .await
    .unwrap();
}

然后添加我们的端点。我们可以直接渲染rsx!:

rust 复制代码
async fn app_endpoint() -> Html<String> {
    // 将rsx!宏渲染为HTML
    Html(dioxus_ssr::render_element(rsx! { div { "hello world!" } }))
}

或者我们可以渲染VirtualDoms。

rust 复制代码
async fn app_endpoint() -> Html<String> {
    // 创建一个渲染包含文本 "hello world" 的div的组件
    fn app() -> Element {
        rsx! { div { "hello world" } }
    }
    // 创建一个包含app组件的VirtualDom
    let mut app = VirtualDom::new(app);
    // 在渲染之前重建VirtualDom
    app.rebuild_in_place();

    // 将VirtualDom渲染为HTML
    Html(dioxus_ssr::render(&app))
}

最后,你可以使用cargo run而不是dx serve来运行它。

多线程支持

遗憾的是,Dioxus的VirtualDom目前不是Send。在内部,我们使用了很多内部可变性,这不是线程安全的。当使用需要Send的Web框架工作时,可以将VirtualDom立即渲染为字符串------但你不能在await点持有VirtualDom。对于保留状态的SSR(本质上是LiveView),你需要在自己的线程上生成一个VirtualDom,并通过通道与之通信,或者创建一个VirtualDom池。你可能会发现你不能在await点持有VirtualDom。因为Dioxus目前不是ThreadSafe,它必须保留在它开始的线程上。我们正在努力放宽这一要求。

相关推荐
Mh1 小时前
我是如何设计品牌站组件库的?
前端·css·设计模式
程序员大阳2 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔2 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart3 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt4 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑4 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星5 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson5 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼5 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊6 小时前
CNC计算机数控加工模拟器
前端