如何将特征绑定到使用document.create_element构建的元素

时间:2020-01-11 08:27:24

标签: rust wasm-bindgen

使用Rust和wasm-bindgen开发用于Dom操纵的最小原型/测试程序。

使用document.create_element(tag)构建元素,该元素返回web_sys::Element。该元素根据标签等类型转换为特定类型。 web_sys::HtmlButtonElement。这可以正常工作,并且进一步放入一个小的包装器中,用于设置特定于元素类型的构建器。

struct ElemSpec<T> {
    html_tag : html_const::HtmlTag<'static>,
    resource_type: std::marker::PhantomData<T>
}

impl<T : wasm_bindgen::JsCast> ElemSpec<T> {

    fn build_element(&self) -> T {
        let window = web_sys::window().expect("no global `window` exists");
        let document = window.document().expect("should have a document on window");
        let elem = document.create_element(&self.html_tag);

        let elem = match elem {
            Ok(e) => e,
            Err(error) => {
                panic!("Call to document.create_element failed with error: {:?}", error)
            },
        };
        let result = wasm_bindgen::JsCast::dyn_into::<T>(elem);
        let helement = match result {
            Ok(e) => e,
            Err(e) => {
                panic!("Cast to specific Element failed tag:{}", &self.html_tag);
            },
        };
        helement
    }
}

const BUTTON_ELEM : ElemSpec<web_sys::HtmlButtonElement> =
    ElemSpec{ html_tag: html_const::BUTTON, resource_type: std::marker::PhantomData};

这有效,HtmlButtonElement的构建方式是:

let buttonElement = BUTTON_ELEM.build_element();

现在,我正在寻找一个特质Bound,它限制于可以从web_sys::Element强制转换的元素。例如。 HtmlSpanElementHtmlDivElement,...,HtmlButtonElement

wasm_bindgen::JsCast中绑定到impl<T : wasm_bindgen::JsCast>的附加或替代对象,可以这样做吗?

1 个答案:

答案 0 :(得分:2)

wasm_bindgen::JsCast::dyn_into文档指出它依赖于JsCast::has_type,后者依次称为JsCast::instanceof。实际上web_sys::Element确实实现了JsCast特征。其他HTML元素类型(例如HtmlButtonElement)也是如此。

该实现是从Web IDL文件生成的,这些文件是Web浏览器界面的正式定义。但是:

impl JsCast for Element {
    fn instanceof(val: &JsValue) -> bool {
        #[link(wasm_import_module = "__wbindgen_placeholder__")]
        #[cfg(all(target_arch = "wasm32", not(target_os = "emscripten")))]
        extern "C" {
            fn __widl_instanceof_Element(val: u32) -> u32;
        }
        #[cfg(not(all(target_arch = "wasm32", not(target_os = "emscripten"))))]
        unsafe fn __widl_instanceof_Element(_: u32) -> u32 {
            panic!("cannot check instanceof on non-wasm targets");
        }
        unsafe {
            let idx = val.into_abi();
            __widl_instanceof_Element(idx) != 0
        }
    }
}

生成的instanceof方法调用WebIDL本机库。由于它跨越了语言的边界,因此无法告诉我们这些元素类型在Rust方面的共同点。

另一方面,HtmlButtonElement和其他人也将AsRef<Element>实现为:

impl AsRef<Element> for HtmlButtonElement {
    #[inline]
    fn as_ref(&self) -> &Element {
        use wasm_bindgen::JsCast;
        Element::unchecked_from_js_ref(self.as_ref())
    }
}

因此,有了它们,AsRef<Element>是它们之间的一个共同界限。这很可能是web-sys作者的有意识的设计决定,因为WebIDL / JavaScript perspective也很有意义:

enter image description here