用法

创建连接

要连接到数据库，使用 use_surreal_login 钩子。该钩子返回一个令牌，必须在 <SurrealContext/> 上下文提供者中使用。

#[function_component]
fn MyComponent(props: &P) -> Html{
    let login = Database {
        username: "user",
        password: "user",
        database: "test",
        namespace: "test"
    };
    
    let token = use_surreal_login("localhost:8000".to_owned(), login);

    
    html! {
        <SurrealContext token={token}>
            // Your App goes here
        </SurrealContext>
    }
}

<SurrealContext/> 将挂起您的应用程序，直到登录成功。

查询组件

<Query/> 组件将检索所有匹配给定查询的数据库条目并依次显示它们

html! {
    <SurrealContext token={token}>
        <Query<Inner> selector="select * from myTable"/>
    </SurrealContext>
}

<Query<T>/> 有四个属性

• selector: 可以转换为 SelectStatement 的东西，这包括 String 和 surreal 记录（surreal 源代码中的 Thing）
• parameters（可选）：一个包含 (String, String) 元组的 Vec，这些元组将被绑定到查询
• filter（可选）：一个 yew 回调 Fn(T::Properties) -> bool，用于本地过滤。
• fallback（可选）：一个 Html 元素，在数据正在检索时将被渲染（在底层使用 yew 暂停）。

let list_state = use_query_state::<ToDoItemProps>("SELECT * FROM item");
html!{
    <QueryWithState<ToDoItem> state={list_state}/>
}

#[derive(SurrealProps, Properties, PartialEq, Clone)]
struct InnerProps {
    #[id] id: Option<ID>,
    name: AttrValue,
}


#[function_component]
fn Inner(props: &InnerProps) -> Html{
    // You know what to do here
}

#[derive(SurrealProps, Properties, PartialEq, Clone)]
struct InnerProps {
    id: AttrValue,
    name: AttrValue,
    #[local]
    color: AttrValue
}

<SurrealList<Inner> selector="select * from myTable" color="red"/>

use_surreal().create(
    "item".to_owned(),
    ToDoItemPropsRemote {
        done: false,
        // Note how having the type of id be Option<ID> 
        // enables you to delegate id creation to the Database
        id: None,
        text: None,
        title: "Test".into(),
        img: None
    },
).execute();