NiceGUI 运行 JavaScript#
此函数在浏览器中执行页面上的任意 JavaScript 代码。在该函数被调用之前,客户端必须连接。要通过 ID 访问客户端对象,请使用 JavaScript 函数 getElement()
。
如果等待该函数,将返回 JavaScript 代码的结果。否则,将执行 JavaScript 代码,无需等待响应。
参数:
code
: 要运行的 JavaScript 代码timeout
: 超时时间(秒)(默认值:1.0
)check_interval
: 检查响应的时间间隔(秒)(默认值:0.01
)返回值:可等待的
AwaitableResponse
,可以等待以获取 JavaScript 代码的结果
from nicegui import ui
def alert():
ui.run_javascript('alert("Hello!")')
async def get_date():
time = await ui.run_javascript('Date()')
ui.notify(f'Browser time: {time}')
def access_elements():
ui.run_javascript(f'getElement({label.id}).innerText += " Hello!"')
ui.button('fire and forget', on_click=alert)
ui.button('receive result', on_click=get_date)
ui.button('access elements', on_click=access_elements)
label = ui.label()
# ui.run()
NiceGUI 运行异步 JavaScript#
使用 run_javascript
,您还可以在浏览器中运行异步代码。以下演示展示了如何获取用户的当前位置。
from nicegui import ui
async def show_location():
response = await ui.run_javascript('''
return await new Promise((resolve, reject) => {
if (!navigator.geolocation) {
reject(new Error('Geolocation is not supported by your browser'));
} else {
navigator.geolocation.getCurrentPosition(
(position) => {
resolve({
latitude: position.coords.latitude,
longitude: position.coords.longitude,
});
},
() => {
reject(new Error('Unable to retrieve your location'));
}
);
}
});
''', timeout=5.0)
ui.notify(f'Your location is {response["latitude"]}, {response["longitude"]}')
ui.button('Show location', on_click=show_location)
# ui.run()