豫言源码浏览器 / Source Browser

浏览项目文件与源码

yuyan · 73 行 · 9659 字节 · UTF-8
§
寻观「标准库」之「语言核心」之「内建类型」之书。
寻观「标准库」之「数据结构」之「多态列」之书。

「:文言:以标识取既有节点,所得柄惟本客器可用,用毕当释;阙则事故。汉语:按 ID 获取当前页面节点,句柄只在当前应用实例有效,不再使用时应调用释放页面节点;缺失或危险元素(script、style、iframe 等)则抛事故。:」
「取得页面节点」乃化「字符串」而「字符串」也。
「:文言:造白册之签节点,初置纯文与类名;柄用毕当释。汉语:创建白册内的 HTML 元素,设置纯文本和类名,不解析传入文字;返回的句柄在不再使用时应释放,元素本身是否留在文档里与句柄无关。:」
「新建页面节点」乃化「字符串」而化「字符串」而化「字符串」而「字符串」也。
「:文言:已有柄之纯文可易。汉语:设置节点的 textContent。:」
「设置页面节点文字」乃化「字符串」而化「字符串」而「有」也。
「:文言:属性限白册,网址不得行脚本。汉语:设置受限属性,名称与值须符合规范的属性白册,链接拒绝可执行协议;target=_blank 时宿主强制加 rel=noopener noreferrer。:」
「设置页面节点属性」乃化「字符串」而化「字符串」而化「字符串」而「有」也。
「:文言:以子附父,二柄皆属当前页。汉语:把子节点添加到父节点末尾。:」
「添加页面子节点」乃化「字符串」而化「字符串」而「有」也。
「:文言:去节点诸子,不去节点自身;诸子及其下诸柄同释。汉语:移除节点的所有子节点,并释放被移除子树中所有节点的句柄。:」
「清空页面子节点」乃化「字符串」而「有」也。
「:文言:易当前页之标题。汉语:设置当前文档标题。:」
「设置页面标题」乃化「字符串」而「有」也。
「:文言:取当前网址之查询值,阙则空文。汉语:按名称读取当前 URL 查询参数,缺失时返回空字符串。:」
「读取页面查询参数」乃化「字符串」而「字符串」也。
「:文言:惟同源绝对径可读,答非二百则事故。汉语:读取当前站点内以斜杠开头的文字资源,HTTP 状态不是 200 时报错。:」
「读取页面资源文字」乃化「字符串」而「字符串」也。

「:文言:一呼而建全树,仅占一柄;描述为癸象,深不逾三十二、节不逾二千、字不逾一 MiB。汉语:按 JSON 描述一次建出整棵子树并返回根节点的一个句柄;描述为 {"标签","类","属性","文字","子"},深度至多 32、节点至多 2000、文字总量至多 1 MiB,所有标签与属性走白册;树内其余节点不产生句柄。:」
「构建页面节点树」乃化「字符串」而「字符串」也。
「:文言:插子于参照之前;参照为空文则附于末。汉语:把子节点插入父节点中参照子节点之前;参照为空字符串表示追加到末尾;子节点已在文档中时是移动。:」
「插入页面子节点前」乃化「字符串」而化「字符串」而化「字符串」而「有」也。
「:文言:以列易父之诸子;被去者及其下诸柄同释。汉语:用给定的子节点列表整体替换父节点的所有子节点;被替换掉的子树内所有句柄同时释放;空列表等于清空。:」
「替换页面子节点」乃化「字符串」而化(「列」于「字符串」)而「有」也。
「:文言:自其父去此节点,并释其下诸柄。汉语:把节点从其父节点移除,并释放该节点及其子树内所有节点的句柄。:」
「移除页面节点」乃化「字符串」而「有」也。
「:文言:释一柄;节点仍在文树,不受影响。汉语:释放一个节点句柄;节点本身若在文档中则保持不变。:」
「释放页面节点」乃化「字符串」而「有」也。
「:文言:于节点末追加文字,流式输出之用。汉语:在节点末尾追加纯文本(流式输出使用),优先并入末尾的文本节点。:」
「追加页面节点文字」乃化「字符串」而化「字符串」而「有」也。
「:文言:改页中既有 iframe 之址;沙箱不可由客改。汉语:设置页面中已有 iframe 的地址;只允许同源路径,或页面在该 iframe 的 data-yy-frame-origins 属性里声明的 https 来源;iframe 必须已由页面声明 sandbox,应用不能修改它;空字符串表示清除地址。:」
「设置页面框架地址」乃化「字符串」而化「字符串」而「有」也。
「:文言:取同源之页,采其一节,去脚本与事处而装入目标。汉语:读取同源 HTML 模板(资源路径),按标识选出其中一个元素,剔除脚本类元素与 on* 等危险属性后作为目标元素的唯一子节点装入。:」
「装入页面模板」乃化「字符串」而化「字符串」而化「字符串」而「有」也。
「:文言:取当前网址全文。汉语:读取当前页面完整 URL(含查询与片段)。:」
「读取页面网址」乃化「有」而「字符串」也。

「:文言:于文档或某节点之内,依选择器求诸元素而各授一柄,以癸象数组文返之;根柄为空文则求于文档,根为 template 则求于其内容;险元素不与;逾一千零二十四则事故;诸柄用毕当释。汉语:0.3.0 新增。按 CSS 选择器查询元素:根参数是节点句柄,空字符串表示整个文档,根是 template 元素时在其 content 里查询;返回 JSON 数组文字,每项是一个元素句柄(按文档顺序,同一元素得同一句柄);危险元素不出现在结果里;选择器至多 512 个字符,语法错误、匹配超过 1024 个元素或句柄表剩余不足时抛事故。:」
「查询页面节点」乃化「字符串」而化「字符串」而「字符串」也。

「:文言:读元素之小写签名。汉语:0.3.0 新增。读取元素的小写标签名;句柄无效或不是元素时抛事故。:」
「读取页面节点标签」乃化「字符串」而「字符串」也。

「:文言:读元素之属性原文;有则阳与其值,无则阴与空文;律同网页界面之读取节点属性。汉语:0.3.0 新增。读取元素某个属性的原样文字,返回(存在与否,值);名称与元素限制同网页界面包的 读取节点属性(不含保留字标识)。:」
「读取页面节点属性」乃化「字符串」而化「字符串」而(「爻」合「字符串」)也。

「:文言:读节点之纯文。汉语:0.3.0 新增。读取节点的 textContent,按 UTF-8 至多 8 MiB。:」
「读取页面节点文字」乃化「字符串」而「字符串」也。

「:文言:得父元素之柄,无(或为险元素)则空文。汉语:0.3.0 新增。返回父元素的句柄;没有父元素、父是危险元素或节点在 template 内容里时返回空字符串。:」
「读取页面节点父级」乃化「字符串」而「字符串」也。

「:文言:自身及祖先中最近合选择器者之柄,无则空文。汉语:0.3.0 新增。等价于 closest:从节点自身向上找第一个匹配选择器的元素并返回其句柄,没有则返回空字符串。:」
「查找最近页面祖先」乃化「字符串」而化「字符串」而「字符串」也。

「:文言:节点合选择器否。汉语:0.3.0 新增。等价于 matches。:」
「页面节点匹配选择器」乃化「字符串」而化「字符串」而「爻」也。

「:文言:导其子树为描述癸象,形同构建页面节点树之入,深不逾所给之限;不在白册之属性略之。汉语:0.3.0 新增。把元素及其子树导出为 JSON 描述文字(形状与 构建页面节点树 的输入相同:{"标签","类","属性","子"},文字节点是 子 里的字符串);深度上限 1 至 32,节点至多 2000、文字至多 1 MiB;不在属性白册内的属性、危险元素与 template 子树被略去。:」
「读取页面节点树」乃化「字符串」而化「整数」而「字符串」也。

「:文言:以新易旧,旧之柄仍有效可复插;旧无父则事故。汉语:0.3.0 新增。用新节点替换旧节点在其父节点里的位置(replaceWith);旧节点及其子树的句柄不释放,旧节点可以再放到别处(例如包进新节点);旧节点没有父节点或层级违规时抛事故。:」
「替换页面节点」乃化「字符串」而化「字符串」而「有」也。

「:文言:去节点之白册属性。汉语:0.3.0 新增。移除节点上一个白册内的属性,规则同网页界面包的 移除节点属性。:」
「移除页面节点属性」乃化「字符串」而化「字符串」而「有」也。

「:文言:以超文本易节点之诸子,惟白册之签与属性得入,否则事故;旧子树之柄同释。汉语:0.3.0 新增。把 HTML 文字解析后按白册清洗并整体替换节点的子节点:标签与属性必须全在白册内(否则抛事故并指出位置,不悄悄剔除),注释被丢弃;文字至多 2 MiB、节点至多 5000、深度至多 32;被替换掉的旧子树里的句柄同时释放。用于装入豫言高亮器等可信来源产生的带样式片段。:」
「设置页面节点超文本」乃化「字符串」而化「字符串」而「有」也。