yumoqing
1291f7fee3
When valueField/textField are not explicitly set in opts, the auto-select logic (line 1140) and nullable empty-option creation (lines 1144-1145) used data[0][undefined] which returned undefined, causing: - Single-option selects to show blank (auto-select failed) - nullable empty options to have undefined keys Now extracts vf/tf local variables with ||'value'/||'text' fallback at the top of build_options(), used consistently throughout.
2.0 KiB
2.0 KiB
WebSocket
Widget Functionality: Establishes a WebSocket connection with the backend, supports sending and receiving text and Base64-encoded audio/video data, and provides various event callbacks.
Type: Regular widget
Parent Widget: bricks.VBox
Initialization Parameters
| Parameter Name | Type | Description |
|---|---|---|
| ws_url | string | The WebSocket server URL (e.g., ws://example.com/socket) |
| with_session | boolean | Whether to include current session information; if true, retrieves session from bricks.app.get_session() and passes it to the WebSocket constructor (Note: There is a typo in the source code — sessopn should be session) |
Example:
new bricks.WebSocket({ ws_url: "ws://localhost:8080/ws", with_session: true });
Main Events
| Event Name | Trigger Condition |
|---|---|
| onopen | Triggered when the WebSocket connection is successfully opened |
| onmessage | Triggered when a message is received from the server (raw message) |
| onerror | Triggered when an error occurs in the WebSocket connection |
| onclose | Triggered when the WebSocket connection is closed |
| ontext | Triggered when a message of type text is received (dispatched after parsing by on_message) |
| onbase64audio | Triggered when a message of type base64audio is received |
| onbase64video | Triggered when a message of type base64video is received |
Other custom types can be dynamically dispatched via the
ontypedatapattern, formatted ason + type.
Event Data Description
- All event data dispatched after parsing in
onmessagecomes from JSON-formattede.data, with the following structure:
The widget automatically dispatches the corresponding event (e.g.,{ "type": "text", "data": "Hello" }ontext) based on thetypefield, and passes thedatafield as the parameter to the event handler.