> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.

# html.meta

- **类型：** `Object | Function`
- **默认值：**

```js
const defaultMeta = {
  charset: { charset: 'utf-8' },
  viewport: 'width=device-width, initial-scale=1',
};
```

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

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

```ts title="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](https://v2.rsbuild.dev/zh/config/html/meta)。
:::