Matrix

Appearance

移动端页面跳转 (jumpWeb) ​

在移动端环境中跳转到指定的 Web 页面，自动适配不同客户端环境。

签名 ​

typescript
// 对象参数方式（推荐）
function jumpWeb(options: JumpWebOptions): void;

// 兼容方式
function jumpWeb(url: string, title?: string, isFullScreen?: boolean): void;

// 参数类型定义
interface JumpWebOptions {
  url: string;
  title?: string;
  isFullScreen?: boolean;
}

参数 ​

对象参数 ​

  • options (JumpWebOptions): 跳转选项对象
    • url (string): 要跳转的 URL 地址
    • title (string, 可选): 页面标题，默认为空字符串
    • isFullScreen (boolean, 可选): 是否以全屏模式打开，默认为 false

兼容参数（不推荐） ​

  • url (string): 要跳转的 URL 地址
  • title (string, 可选): 页面标题，默认为空字符串
  • isFullScreen (boolean, 可选): 是否以全屏模式打开，默认为 false

返回值 ​

(void): 该函数没有返回值

示例 ​

typescript
import { jumpWeb } from '@fu/matrix';

// 推荐用法 - 对象参数
jumpWeb({
  url: 'https://example.com',
  title: '示例页面',
  isFullScreen: true
});

// 兼容用法
jumpWeb('https://example.com', '示例页面', true);

环境适配 ​

该函数会根据当前运行环境自动选择合适的跳转方式：

  1. 同花顺客户端：使用 client.html?action=ymtz 协议
  2. iFind客户端：使用 client.html?action=ymtz 协议
  3. 期货客户端：使用特定的 webid 参数
  4. 其他环境：直接使用 window.location.href 跳转

全屏模式 ​

当 isFullScreen 设置为 true 时：

  • iOS 环境：使用特定的状态栏参数
  • Android 环境：使用 fullscreen=1 和 notitlebar=1 参数
  • 期货客户端：使用 ishiddenbar=1 参数

注意事项 ​

  • URL 可以是绝对路径（包含 http/https）或相对路径
  • 如果 URL 已包含客户端协议（包含 client.html），将直接跳转
  • 在非客户端环境中，会直接使用 window.location.href 进行跳转
  • 当 URL 为空时，函数会输出警告并不执行任何操作