文档手册

HTML窗体参数

2024-07-07 00:22:32

参数设置如下:

<html window-blurbehind="source-desktop" window-resizable="false" window-frame="extended"
 window-width="200dip" window-height="120dip" window-alignment="5">

 

HTML 中的窗口表示形式

Sciter 窗口是加载在其中的 HTML 文档的主机。

此 HTML 完整定义了窗口的内容。窗口的根 <html> 元素具有特殊含义 - 其 window-XXX 属性定义窗口的外观。

 窗口根属性

特定于窗口的属性 - 在加载到窗口中的根 <html> 元素上定义。

 属性 描述
window-frame
  • default: 使用默认的窗口框架。

  • standard: 标准窗口框架,包括标准的标题栏、边框和系统菜单。

  • solid: 无边框且不透明的窗口。

  • solid-with-shadow: 无边框且不透明,但带有阴影的窗口。

  • extended: 扩展的窗口框架,允许在标题栏区域自定义内容。

  • transparent: 透明窗口框架,可以显示底层内容。

window-icon 窗口图标 URL
window-title 窗口标题
window-width窗口的初始宽度,CSS 长度单位
window-height窗口的初始高度,CSS 长度单位
window-min-width窗口的最小宽度,CSS 长度单位
window-min-height窗口的最小高度,CSS 长度单位
window-max-width窗口的最大宽度,CSS 长度单位
window-max-height窗口的最大高度,CSS 长度单位
window-resizabletrue,false, <length> 即从窗框向内 10px 计数
window-minimizable 对或错
window-maximizable 对或错
window-alignment1..9 - 将窗口相对于桌面对齐, -1..-9 - 将窗口相对于父窗口对齐;
window-blurbehindBlur behind effect 配置,请参见 window.blurBehind
window-cornersstring: default, not-round, round, round-small - 在支持的操作系统(例如 Win11)上定义窗口角的宽度。
window-state显示、最小化、最大化、全屏、隐藏 - HTML 窗口的初始状态
langISO 639-1 值、定义拼写检查字典、日期...
disable-debug不连接到检查器

这些属性可能会出现在 root <html> 中的其他元素上,以赋予这些元素窗口镶边角色:

 属性 描述
role="window-caption"允许将窗口拖过此元素
role="window-minimize"指示元素的行为为窗口最小化按钮
role="window-maximize"指示元素的行为为窗口最大化按钮
role="window-close"指示元素的行为为窗口关闭按钮
role="window-icon"指示元素表现为窗口图标 - 在 Windows 上,单击它时它会显示窗口菜单。

示例, <caption 此处的元素:

 <header>
<button role="window-icon" />
<caption role="window-caption">My Window</caption>
<button role="window-minimize" />
<button role="window-maximize" />
</header>

充当窗口标题,允许用户拖动和移动窗口。