For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt, and this page is available as Markdown at /zh/configure/app/html/meta.md.
  • 简体中文
  • html.meta

    • 类型: Object | Function
    • 默认值:
    const defaultMeta = {
      charset: { charset: 'utf-8' },
      viewport: 'width=device-width, initial-scale=1',
    };

    配置 HTML 页面的 <meta> 标签。

    默认 viewport 允许用户缩放页面。如果应用需要铺满屏幕或关闭电话号码自动识别,可以按需配置:

    modern.config.ts
    import { defineConfig } from '@modern-js/app-tools';
    
    export default defineConfig({
      html: {
        meta: {
          viewport: 'width=device-width, initial-scale=1, viewport-fit=cover',
          'format-detection': 'telephone=no',
        },
      },
    });

    设置 viewport 会替换整个默认字符串,因此自定义时需保留 width=device-width 和 initial-scale=1。使用 viewport-fit=cover 时,还需在页面样式中处理设备安全区。

    Info

    该配置项的使用方式与 Rsbuild 完全一致。详细信息请参考 Rsbuild - html.meta。