Teal TealUI

URL 处理（基于 DOM）web/url

提供解析和格式化 URL 的工具函数。

本组件利用浏览器自带的 <a> 标签实现解析。完整基于 JavaScript 的 URL 解析见URL 处理。

API
全局
Url 接口

API

全局

函数 描述
⮞ parseUrl(url)(url:string):Url

解析指定的地址为对象。

参数 类型 描述 默认值
url* string —

返回值

类型：Url

返回解析后的新对象。

示例

parseUrl("http://tealui.com/index.html?from=parse") // { href: "http://tealui.com/index.html?from=parse", protocol: "http:", host: "tealui.com", hostname: "tealui.com", path: "/index.html?from=parse", pathname: "/index.html", search: "?from=parse", query: "from=parse", "hash": "", "port": "" }

解析指定的地址为对象。
⮞ formatUrl(url)(url:Url):string

格式化指定的地址为字符串。

参数 类型 描述 默认值
url* Url —

返回值

类型：string

返回格式化后的字符串。

示例

formatUrl({ protocol:"http:", hostname: "tealui.com", path: "/index.html?from=parse", pathname: "/index.html", search: "?from=parse", query: "from=parse" }) // "http://tealui.com/index.html?from=parse"

格式化指定的地址为字符串。

Url 接口

表示一个地址。

字段 类型 描述
⮞ protocol : string

协议部分。如 "http:"。

 string

协议部分。如 "http:"。
⮞ host : string

主机部分。如 "localhost:80"。

 string

主机部分。如 "localhost:80"。
⮞ port : string

端口部分。如 "80"。

 string

端口部分。如 "80"。
⮞ hostname : string

主机名部分。如 "localhost"。

 string

主机名部分。如 "localhost"。
⮞ hash : string

哈希值部分。如 "#hash"。

 string

哈希值部分。如 "#hash"。
⮞ search : string

查询参数部分。如 "?q=1"。

 string

查询参数部分。如 "?q=1"。
⮞ query : string

查询参数部分。如 {q: 1}。

 string

查询参数部分。如 {q: 1}。
⮞ pathname : string

路径名部分。如 "/foo/a.html?q=1"。

 string

路径名部分。如 "/foo/a.html?q=1"。
⮞ path : string

路径部分。如 "/foo/a.html"。

 string

路径部分。如 "/foo/a.html"。
⮞ href : string

完整地址。如 "http://localhost:80/foo/a.html?q=1"。

 string

完整地址。如 "http://localhost:80/foo/a.html?q=1"。