豫言源码浏览器 / Source Browser

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

寻观「标准库」之「语言核心」之「内建类型」之书。

「：文言：页面之语标据根元素，阙则空文。汉语：读取页面根元素的语言标签，未设置时返回空字符串。：」
「读取页面语言」乃化「有」而「字符串」也。

「：文言：以标识求既有元素，纯文置之；无此元素则报错。汉语：以 ID 查找已有元素并写入纯文本，不解析 HTML；缺失元素或危险元素时抛事故。：」
「设置节点文字」乃化「字符串」而化「字符串」而「有」也。

「：文言：以标识求既有元素，易其安全属性；属性依白册，无此元素则报错。汉语：设置已有元素的受限属性；名称与值须符合规范的属性白册，缺失元素或不允许的属性时抛事故。：」
「设置节点属性」乃化「字符串」而化「字符串」而化「字符串」而「有」也。

「：文言：候一界面事，返其名与标识；无标识则空文，关环则名曰关闭。汉语：等待一个界面事件，返回事件名称与目标 ID；没有 ID 时返回空字符串，关闭时名称为“关闭”。只取界面类型的事件，不吞其他类型。：」
「等待界面事件」乃化「有」而（「字符串」合「字符串」）也。

「：文言：读输入控件之当前值。汉语：读取 input、textarea、select 的当前值；元素不存在或不是输入控件时抛事故。：」
「读取节点值」乃化「字符串」而「字符串」也。

「：文言：写输入控件之值，不发输入事。汉语：设置 input、textarea、select 的当前值，不触发 input 或 change 事件；select 无此选项时抛事故。：」
「设置节点值」乃化「字符串」而化「字符串」而「有」也。

「：文言：阳则显，阴则隐。汉语：设置元素的 hidden 属性：阳表示显示，阴表示隐藏。：」
「设置节点显示」乃化「字符串」而化「爻」而「有」也。

「：文言：阳则禁。汉语：设置元素的 disabled 属性。：」
「设置节点禁用」乃化「字符串」而化「爻」而「有」也。

「：文言：阳则只读。汉语：设置元素的 readonly 属性。：」
「设置节点只读」乃化「字符串」而化「爻」而「有」也。

「：文言：整易类名，名以空格隔，惟许字母数字下划横线。汉语：整体替换元素的 class；类名以空格分隔，每个类名只允许字母、数字、下划线和短横线（含中文字母），空文字表示清除。：」
「设置节点类名」乃化「字符串」而化「字符串」而「有」也。

「：文言：增或去单个类名，余类不动；类名之律同上。汉语：设置元素上单个类名的有无（classList.toggle）：阳表示加上，阴表示去掉，其余类名不受影响；类名只允许一个，字符规则同设置节点类名。：」
「设置节点类标记」乃化「字符串」而化「字符串」而化「爻」而「有」也。

「：文言：使元素得焦点。汉语：让元素获得焦点；不可聚焦的元素不报错，也不改变焦点。：」
「聚焦节点」乃化「字符串」而「有」也。

「：文言：现聚焦元素之标识，无标识或无焦点则空文。汉语：读取当前获得焦点的元素 ID；没有焦点或该元素没有 ID 时返回空字符串。：」
「读取聚焦标识」乃化「有」而「字符串」也。

「：文言：元素自身或其后代得焦点则阳。汉语：元素自身或其后代当前拥有焦点时返回阳。：」
「节点包含焦点」乃化「字符串」而「爻」也。

「：文言：置输入框选区，位以豫言字符（码点）计。汉语：设置 input 或 textarea 的选区，起止位置按豫言字符（Unicode 码点）计数；越界或类型不支持时抛事故。：」
「设置输入光标」乃化「字符串」而化「整数」而化「整数」而「有」也。

「：文言：读输入框选区之起止，位以豫言字符计。汉语：读取 input 或 textarea 的选区起止位置，按豫言字符（Unicode 码点）计数。：」
「读取输入光标」乃化「字符串」而（「整数」合「整数」）也。

「：文言：读页面当前选中之文。汉语：读取页面当前选中的文字，含输入框内的选区；没有选区时返回空字符串。：」
「读取选区文字」乃化「有」而「字符串」也。

「：文言：读滚动度量，癸象文含顶、总高、可视高。汉语：读取元素滚动度量，返回 JSON 文字 {"顶":整数,"总高":整数,"可视高":整数}。：」
「读取滚动度量」乃化「字符串」而「字符串」也。

「：文言：置滚动顶。汉语：设置元素的滚动位置（scrollTop）。：」
「设置滚动顶」乃化「字符串」而化「整数」而「有」也。

「：文言：以模态开 dialog。汉语：以模态方式打开 dialog 元素；其 cancel 与 close 事件走网页事件包。：」
「打开模态框」乃化「字符串」而「有」也。

「：文言：关 dialog。汉语：关闭 dialog 元素。：」
「关闭模态框」乃化「字符串」而「有」也。

「：文言：读页面状态，癸象文含可见、联机、窄屏。汉语：读取页面状态，返回 JSON 文字 {"可见":爻,"联机":爻,"窄屏":爻}；窄屏由固定媒体查询 (max-width: 700px) 决定。：」
「读取页面状态」乃化「有」而「字符串」也。

「：文言：元素及其祖先皆未以样式隐藏，则阳。汉语：元素已连入文档，且自身与祖先的计算样式 display 都不是 none 时返回阳。：」
「读取节点可见」乃化「字符串」而「爻」也。

「：文言：读元素之属性原文；标识可为文档根或页体；有则阳与其值，无则阴与空文；布尔属性有则值为空文；元素阙、属性名不合或元素在禁列则事故。汉语：0.3.0 新增。读取元素上某个属性的原样文字（getAttribute，不是 DOM 属性）：标识除元素 ID 外还可以是保留字“文档根”（html 元素）与“页体”（body 元素）；属性存在时返回（阳，值），布尔属性存在时值为空字符串，不存在时返回（阴，空字符串）；属性名须为 [a-z][a-z0-9:_-]* 且不以 on 开头、不是 style 与 srcdoc；元素不存在、危险元素、iframe 上白册之外的属性、值超过 65536 个 UTF-16 码元时抛事故。：」
「读取节点属性」乃化「字符串」而化「字符串」而（「爻」合「字符串」）也。

「：文言：去元素之白册属性；无则无事；data-yy- 首者不可去。汉语：0.3.0 新增。移除元素上的一个白册属性（removeAttribute）；属性本来不存在时什么也不做；属性名须在设置节点属性的白册内，data-yy- 前缀保留给宿主，不可移除；移除 class 等同于把类名设为空文字。：」
「移除节点属性」乃化「字符串」而化「字符串」而「有」也。

「：文言：读元素之纯文（textContent），至多八 MiB；元素阙或在禁列则事故。汉语：0.3.0 新增。读取元素的 textContent；文字按 UTF-8 计超过 8 MiB、元素不存在或是危险元素时抛事故。：」
「读取节点文字」乃化「字符串」而「字符串」也。

「：文言：程序性一点（click()），经诸订阅；文件输入框与不合规之链接则事故。汉语：0.3.0 新增。对元素执行一次程序性点击（HTMLElement.click()），页面上对该元素的所有订阅照常收到 click 事件；文件输入框、危险元素、href 不在白册规则内的链接，或元素不存在时抛事故；被禁用的元素点击无效果且不抛事故。：」
「点击节点」乃化「字符串」而「有」也。

「：文言：置元素之左与上，各为像素整数，自负十万至十万；不涉样式之他端。汉语：0.3.0 新增。把元素的 style.left 与 style.top 设为给定像素整数（范围 -100000 至 100000），用于摆放浮层；元素的 position 须由页面样式表另行指定；不开放其他样式；元素不存在或是危险元素时抛事故。：」
「设置节点位置」乃化「字符串」而化「整数」而化「整数」而「有」也。

「：文言：读元素之视口矩形，癸象文含左、上、右、下，皆取整。汉语：0.3.0 新增。读取元素相对视口的位置（getBoundingClientRect，四舍五入取整），返回 JSON 文字 {"左":整数,"上":整数,"右":整数,"下":整数}；display:none 或未连入文档的元素四项均为 0；元素不存在或是危险元素时抛事故。：」
「读取节点矩形」乃化「字符串」而「字符串」也。