stdwebダウンロードstdwebソースコードのダウンロード

クライアント側Web用の標準ライブラリ

このクレートの目標は、Web APIにRust Bindingsを提供し、RustとJavaScriptの間の高度な相互運用性を可能にすることです。

寄付する

パトロン

このソフトウェアは、これらの素晴らしい人々のおかげであなたにもたらされました：

スタジオを乗り越えます
ジョー・ナルヴェズ
エドゥアルド・クニショフ
アンセルム・アイクホフ
ヨハン・アンダーソン
スティーブン・サグデン
IS8AC

ありがとう！

例

JavaScriptコードを錆に直接埋め込むことができます。

 let message = "Hello, 世界!" ;
let result = js ! {
    alert ( @ { message } ) ;
    return 2 + 2 * 2 ;
} ;

println ! ( "2 + 2 * 2 = {:?}" , result ) ;

閉鎖もサポートされています：

 let print_hello = | name : String | {
    println ! ( "Hello, {}!" , name ) ;
} ;

js ! {
    var print_hello = @ { print_hello } ;
    print_hello ( "Bob" ) ;
    print_hello . drop ( ) ; // Necessary to clean up the closure on Rust's side.
}

Serdeのおかげで、任意の構造を渡すこともできます。

 # [ derive ( Serialize ) ]
struct Person {
    name : String ,
    age : i32
}

js_serializable ! ( Person ) ;

js ! {
    var person = @ { person } ;
    console . log ( person . name + " is " + person . age + " years old." ) ;
} ;

このクレートは、たとえば、多くのWeb APIも公開しています。

 let button = document ( ) . query_selector ( "#hide-button" ) . unwrap ( ) . unwrap ( ) ;
button . add_event_listener ( move |_ : ClickEvent | {
    for anchor in document ( ) . query_selector_all ( "#main a" ) {
        js ! ( @ { anchor } . style = "display: none;" ; ) ;
    }
} ) ;

錆機能をJavaScriptにさらすこともサポートされています。

 # [ js_export ]
fn hash ( string : String ) -> String {
    let mut hasher = Sha1 :: new ( ) ;
    hasher . update ( string . as_bytes ( ) ) ;
    hasher . digest ( ) . to_string ( )
}

次に、node.jsからこれを行うことができます：

 var hasher = require ( "hasher.js" ) ; // Where `hasher.js` is generated from Rust code.
console . log ( hasher . hash ( "Hello world!" ) ) ;

または、同じ.jsファイルを使用して、Webブラウザーで使用することもできます。

 < script src =" hasher.js " > </ script >
< script >
    Rust . hasher . then ( function ( hasher ) {
        console . log ( hasher . hash ( "Hello world!" ) ) ;
    } ) ;
</ script >

小包を使用している場合は、実験用小包プラグインも使用できます。まず、既存の小包プロジェクトでこれを行います。

 $ npm install --save parcel-plugin-cargo-web

そして単純に：

 import hasher from "./hasher/Cargo.toml" ;
console . log ( hasher . hash ( "Hello world!" ) ) ;

設計目標

Webブラウザーによって公開されているように、Web APIの完全なスイートを公開します。
明確に優れたデザインをもたらす場合を除き、元のJavaScriptの規則と構造にできるだけフォローしてみてください。
より高いレベルのフレームワークとライブラリを構築できるビルディングブロックになります。
JavaScriptコードを直接錆に直接埋め込み、2つの間のデータをマーシャルするのに便利で簡単にします。
SerdeのSerializableを実装する構造体のマーシャリングなど、より広いRustエコシステムと統合します。
JavaScriptにまったく触れることなく、自明でないWebアプリケーションを書くことができるドライバーの座席に錆を置きます。
Rustが今後のWebAssembly（再）ボリューションに参加できるようにします。
JavaScriptから簡単に呼び出すことができるスタンドアロンライブラリを簡単に作成できるようにします。

はじめる

いくつかの例を見てください：

examples/minimal - アラートを呼び出す完全に最小限の例
examples/todomvc -NYIVELY実装TODOMVCアプリケーション。 DOMを呼び出す方法を示します
examples/hasher錆機能をJavaScriptにエクスポートする方法と、バニラのWebブラウザー環境またはnodejsからそれらを呼び出す方法を示しています
examples/hasher-parcel小包プロジェクトでエクスポートされた錆機能をインポートして呼び出す方法を示しています
pinky-web -NESエミュレータ。ここで、事前コンパイルされたバージョンで再生できます

APIドキュメントもご覧いただけます。

例を実行します

カーゴウェブをインストールします：
```
 $ cargo install -f cargo-web
```
examples/todomvcに移動し、これらのコマンドのいずれかを使用して例を開始します。
- RustのネイティブWebAssemblyバックエンドを使用して、WebAssemblyにコンパイルします。
```
 $ cargo web start --target=wasm32-unknown-unknown
```
- emscriptenを使用してasm.jsにコンパイルします。
```
 $ cargo web start --target=asmjs-unknown-emscripten
```
- emscriptenを使用してWebAssemblyにコンパイルします。
```
 $ cargo web start --target=wasm32-unknown-emscripten
```
ブラウザでhttp://localhost:8000にアクセスしてください。

*-emscriptenターゲットの場合cargo-web必要ありませんが、emscriptenを必要としないネイティブwasm32-unknown-unknownでは、 cargo-webを機能させる必要があります！

Changelog

stdweb 0.4.20
- 最新のwasm-bindgenとの互換性
- 新しいイベント：
  - FullscreenChangeEvent
stdweb 0.4.19
- 新しい方法：
  - Document::fullscreen_enabled
  - Document::fullscreen_element
  - InputElement::selection_start
  - InputElement::selection_end
  - InputElement::set_selection_start
  - InputElement::set_selection_end
  - Object::to_iter
  - Window::confirm
- &Array sは、 TryFromを通じてVecに変換できるようになりました
- ランタイムは、emscriptenの新しいバージョンと互換性があるはずです
- 不安定なfutures関連APIは、最新の夜間と連携するように更新されました
- syn依存関係はバージョン1に更新されました
stdweb 0.4.18
- js!マクロをuseしてインポートできるようになりました
- 新しいイベント：
  - BeforeUnloadEvent
  - UnloadEvent
- 新しい方法：
  - IBlob::slice
  - IBlob::slice_with_content_type
  - IWindowOrWorker::set_clearable_timeout
stdweb 0.4.17
- 不安定なfutures関連APIは、最新の夜間と連携するように更新されました
stdweb 0.4.16
- 初期のwasm-bindgen互換性。 wasm-bindgenを使用したプロジェクトでstdweb使用できるようになりました
- 最小限のサポートされた錆バージョンは1.33.0になりました
- 必要な最小のcargo-webバージョンは0.6.24になりました
stdweb 0.4.15
- 不安定なfutures関連APIは、最新の夜間と連携するように更新されました
- 新しいタイプ：
  - FormData
  - FormDataEntry
  - MouseButtonsState
- 新しい方法：
  - Blob::new
stdweb 0.4.14
- js! JSスニペットから何も返さない場合、Macroはわずかに効率的なコードを生成するようになりました。これにより、大部分のケースで@(no_return)注釈を追加する必要があります。
- 新しいタイプ：
  - File
stdweb 0.4.13
- 手続き上のjs!マクロの空白の取り扱い
- 新しいタイプ：
  - ITouchEvent
  - Touch
  - TouchType
- 新しいイベント：
  - TouchEvent
  - TouchMove
  - TouchLeave
  - TouchEnter
  - TouchEnd
  - TouchCancel
  - TouchStart
- 新しい方法：
  - XmlHttpRequest::set_response_type
stdweb 0.4.12
- cargo-webなしでwasm32-unknown-unknownターゲットをコンパイルしようとするときに診断の改善
stdweb 0.4.11
- 必要な錆バージョンは1.30.1になりました
- 必要な最小のcargo-webバージョンは現在0.6.22です
- wasm32-unknown-unknownは現在、安定した錆について正式にサポートされています
- wasm32-unknown-unknownのデバッグビルドが現在サポートされています
- js!マクロは、手続き型マクロを使用して部分的に実装されています
- ネイティブコーデックAPIの使用により、文字列デコード/エンコードはより速くなりました
- 新しい方法：
  - Document::import_node
  - IElement::slot
  - IElement::attach_shadow
  - IElement::shadow_root
- 新しいタイプ：
  - ISlotable
  - ShadowRoot
  - ShadowRootMode
  - TemplateElement
  - SlotElement
- 新しいイベント：
  - SlotChangeEvent
- IParentNode::query_selectorおよびIParentNode::query_selector_all 、適切なエラータイプを返すようになりました
stdweb 0.4.10 、 stdweb-derive 0.5.1
- 新しい方法：
  - IElement::insert_adjacent_html
  - IElement::insert_html_before
  - IElement::insert_html_after
  - IElement::prepend_html
  - IElement::append_html
  - IElement::namespace_uri
  - IElement::closest
  - Document::create_element_ns
  - Window::get_selection
- 新しいタイプ：
  - AbortError
  - SelectionType
  - Selection
  - Range
- 失敗したタイプ変換のエラーメッセージが改善されました
- 失敗した変換のエラータイプ（ .try_into() / .try_from()を使用する場合）は、 TypeErrorに変換可能になりました
- アグリゲートエラータイプ（例えば、 DrawImageErrorなど）は、 js!マクロ
- TypeErrorは修正されました（ DOMExceptionとして誤って扱われました）
- Number .into() / .from()でf64に変換できるようになりました。
- Mutを追加しました。これは、JSにFnMut閉鎖を安全に渡すための新しいラッパータイプですjs!マクロ;今のところオプションですが、このラッパータイプの使用は将来的に必須です！
- FnMut閉鎖は、再帰的に呼び出すことはできません
- #[derive(ReferenceType)]一般的なタイプの限られたサブセットをサポートするようになりました
- 非同期単位テストは、新しい#[async_test]属性マクロ（夜間のみ）でサポートされるようになりました
- futures 0.3に更新（毎晩のみ）
stdweb 0.4.9 、 stdweb-derive 0.5.0
- パフォーマンスの改善。 Serdeを介したシリアル化は、2倍速くなりました
- 新しいイベント：
  - ScrollEvent
  - DragRelatedEvent
  - DragEvent
  - DragStartEvent
  - DragEndEvent
  - DragEnterEvent
  - DragLeaveEvent
  - DragOverEvent
  - DragExitEvent
  - DragDropEvent
- 新しいタイプ：
  - DataTransfer
  - EffectAllowed
  - DropEffect
  - DataTransferItemList
  - DataTransferItem
  - DataTransferItemKind
  - IDragEvent
- Valueは、 try_intoでOption< Serde< T > >に変換できるようになりました
- Serdeを介した数字の脱isizationは、 i32およびf64以外のタイプを使用できるようになり、ほとんどの場合に機能します
- すべてのイベントは、より強くタイプになっています
  - イベントのJSタイプのみがチェックされ、 keyupとkeydownの両方が同じJSタイプ（ KeyboardEvent ）を共有しているため、以前はKeyDownEventイベントとしてkeyupイベントをゆるくすることができました。これからは、イベントのtypeフィールドもチェックされているため、このような変換はもう許可されていません。
0.4.8
- wasm32-unknown-unknownをターゲットにするとき、最新の夜間にコンピレーションを修正しました
- 新しいイベント：
  - PointerLockChangeEvent
  - PointerLockErrorEvent
  - MouseWheelEvent
- 新しいタイプ：
  - MouseWheelDeltaMode
  - XhrResponseType
- 新しい方法：
  - XmlHttpRequest::raw_response
  - Window::device_pixel_ratio
  - Document::pointer_lock_element
  - Document::exit_pointer_lock
0.4.7
- 新しいイベント：
  - AuxClickEvent
  - MouseEnterEvent
  - MouseLeaveEvent
  - ContextMenuEvent
  - SelectionChangeEvent
- 新しいタイプ：
  - FileList
  - FileReaderReadyState
- GamePad APIを実装：
  - Gamepad
  - GamepadButton
  - GamepadButtonMapping
  - GamepadEvent
- CanvasRenderingContext2d::clear_rectを修正しました
- VecおよびArrayBufferからTypedArrayを作成するときにリークを修正しました。
0.4.6
- docs.rsをもう一度修正します
- 新しいタイプ：
  - SubmitEvent
  - IChildNode
- CanvasElement::to_data_urlを修正します
0.4.5
- 新しいタイプ：
  - DocumentFragment
  - SelectElement
  - OptionElement
  - HtmlCollection
- 新しい方法：
  - Node::from_html
  - Value::is_null
- 列挙の公開：
  - SocketMessageData
  - NodeType
- futuresの更新0.2
0.4.4
- docs.rs （できれば）を修正します。
- 新しい方法：
  - Location::origin
  - Location::protocol
  - Location::host
  - Location::hostname
  - Location::port
  - Location::pathname
  - Location::search
- これらは、エラーの場合にSecurityErrorを返します。
  - Location::hash
  - Location::href
0.4.3
- WeakMapのキーとして使用できないオブジェクトは、今すぐサポートする必要があります（たとえば、Firefoxの下のWebGL関連オブジェクトの一部）
- 新しい方法：
  - Element::get_bounding_client_rect
  - Element::scroll_top
  - Element::scroll_left
  - Window::page_x_offset
  - Window::page_y_offset
  - NodeList::item
  - Document::body
  - Document::head
  - Document::title
  - Document::set_title
  - IMouseEvent::offset_x
  - IMouseEvent::offset_y
- より多くのキャンバス関連タイプを公開します：
  - CompositeOperation
  - LineCap
  - LineJoin
  - Repetition
  - TextAlign
  - TextBaseline
- Canvas関連のエラータイプを公開する： AddColorStopError 、 DrawImageError 、 GetImageDataError
- 新しいイベント：
  - MouseOverEvent
  - MouseOutEvent
  - PointerOverEvent
  - PointerEnterEvent
  - PointerDownEvent
  - PointerMoveEvent
  - PointerUpEvent
  - PointerCancelEvent
  - PointerOutEvent
  - PointerLeaveEvent
  - GotPointerCaptureEvent
  - LostPointerCaptureEvent
- ポインターイベント用の新しいインターフェイス： IPointerEvent
0.4.2
- 参照を脱出するときに漏れを修正しました
- CanvasRenderingContext2d::get_canvasを修正しました
- 露出したFillRuleとSocketReadyState
- IElementに追加された新しい属性関連メソッド
- 新しいDateバインディング
0.4.1
- wasm32-unknown-unknownでの最新の夜間錆のサポート
- 露出したSocketBinaryType enum
- 新しいキャンバスAPI：
  - CanvasRenderingContext2dのための多数の新しい方法
  - 新しいタイプ： CanvasGradient 、 CanvasPattern 、 CanvasStyle 、 ImageData 、 TextMetrics
- 新しいエラータイプ： IndexSizeError 、 NotSupportedError 、 TypeError
0.4
- （壊れた変化） ValueからArrayとObjectバリアントを削除しました。これらは現在、 Referenceとして扱われます
- （壊れた変化） Valueには追加のバリアント： Symbolがあります
- （変化の破壊）削除：
  - InputElement::set_kind
  - InputElement::files
- （壊れた変化）改名：
  - KeydownEvent > KeyDownEvent
  - KeyupEvent > KeyUpEvent
  - KeypressEvent > KeyPressEvent
  - ReadyState > FileReaderReadyState
  - InputElement::value > InputElement::raw_value
  - InputElement::set_value > InputElement::set_raw_value
- （壊れた変化） ArrayBuffer::newはu64引数を取ります
- （壊れた変更） InputElement::set_raw_valueはInto< Value >の代わりに&str取るようになりました>
- （壊れた変更）変更されたリターンタイプ：
  - usizeを返したすべての方法はu32返します
  - INode::remove_child 、 OkケースでNodeを返すようになりました
  - 以下はu64を返します。
    - ArrayBuffer::len
  - 以下は、 f64の代わりにi32を返します。
    - IMouseEvent::client_x
    - IMouseEvent::client_y
    - IMouseEvent::movement_x
    - IMouseEvent::movement_y
    - IMouseEvent::screen_x
    - IMouseEvent::screen_y
  - 次の結果、 Resultを返してください。
    - INode::insert_before
    - INode::replace_child
    - INode::clone_node
    - StringMap::insert
    - TokenList::add
    - TokenList::remove
    - Document::create_element
    - IEventTarget::dispatch_event
    - FileReader::read_as_text
    - FileReader::read_as_array_buffer
    - FileReader::read_as_text
    - History::replace_state
    - History::go
    - History::back
    - History::forward
    - Location::href
    - Location::hash
    - CanvasElement::to_data_url
    - CanvasElement::to_blob
    - ArrayBuffer::new
  - INode::base_uri 、 Option< String >の代わりにStringを返すようになりました
  - InputElement::raw_valueは、 Valueの代わりにStringを返します
- （変化の破壊） INode::inner_text IHtmlElement::inner_textに移動されました
- （変更の変更） Document::query_selectorとDocument::query_selector_all IParentNodeに移動されました
- （壊れた変更） IElement::query_selectorおよびIElement::query_selector_all IParentNodeに移動しました
- （変更の変更） Document::get_element_by_id INonElementParentNodeに移動されました
- （壊れた変更） TryFrom / TryIntoを使用して任意の参照様オブジェクト間を変換するためのブランケットは削除されました
- 最近のcargo-webを使用して建設するときはstdweb::initialize nor stdweb::event_loopに電話する必要はありません
- wasm32-unknown-unknownのcdylib箱のサポート
- 新しいバインディング：
  - XmlHttpRequest
  - WebSocket
  - MutationObserver
  - History
  - TextAreaElement
  - CanvasElement
- 新しいイベントタイプ：
  - MouseDownEvent
  - MouseUpEvent
  - MouseMoveEvent
  - PopStateEvent
  - ResizeEvent
  - ReadyStateChange
  - SocketCloseEvent
  - SocketErrorEvent
  - SocketOpenEvent
  - SocketMessageEvent
- Canvas APIの最初のサポート
- 新しい特性： ReferenceTypeとInstanceOf
- stdweb-derive crateに#[derive(ReferenceType)]を追加します。 stdweb以外でカスタムAPIバインディングを定義することが可能になりました
- add #[js_export] procedural属性（ wasm32-unknown-unknownのみ）
- JavaScriptの例外を渡すために、 DomExceptionとサブタイプを追加します
- IElementはINodeから継承されます
- すべてのインターフェイスがReferenceTypeから継承されます
- stdweb::traitsモジュールを追加して、すべてのインターフェイス特性をuseためのプレリュードとして機能します
- console!マクロ
- 現在、ほとんどのタイプはPartialEqとEqを実装しています
0.3
- （壊れた変更）削除されたErrorEventメソッド
- （壊れた変化）改名：
  - LoadEvent > ResourceLoadEvent
  - AbortEvent > ResourceAbortEvent
  - ErrorEvent > ResourceErrorEvent
- ゼロコストスライスをjs!に通過するためにUnsafeTypedArray追加してください！
- js!にFnOnce閉鎖を渡すためにOnce追加してください！