配置

设置方式

安装插件时传入：

app.use(VuEPG, { focusClass: "focused", debug: import.meta.env.DEV });

或在任意时候调用 setConfig，只需传入要修改的字段：

useVuEPG().setConfig({ debug: true });

用 getConfig() 读取当前配置（只读）。

配置项

/** 返回处理函数 */
export type BackHandler = () => void;

/** 全局配置 */
export interface EPGConfig {
  /**
   * 焦点元素的 class 名，可被 `v-epg-item` 的 `focusClass` 覆盖
   * @defaultValue `"vuepg-focus"`
   */
  focusClass: string;
  /**
   * 全局返回处理函数：按下返回键且没有生效中的 `onBack` 时调用
   * @defaultValue `null`
   */
  backHandler: BackHandler | null;
  /**
   * 是否在控制台输出调试日志
   * @defaultValue `false`
   */
  debug: boolean;
  /**
   * 文档视口的滚动方式；`true` 等同于 `"nearest"`，`false` 关闭
   * @defaultValue `false`
   */
  scrollViewport: boolean | ScrollMode;
}

focusClass

获得焦点的元素会被加上这个 class。修改后，当前焦点元素上的 class 会立即替换。单个元素可以用 v-epg-item 的 focusClass 覆盖。

必须是不含空白字符的非空字符串，否则 setConfig 会抛出 TypeError。

backHandler

没有生效中的页面级返回处理函数时，按下返回键调用它。详见 返回处理。

debug

开启后，焦点移动、按键、注册与注销等过程会输出到控制台；方向查找还会输出每一层的候选、参与比较的目标和结果，方便排查“焦点为什么去了那里”。

scrollViewport

文档视口的滚动方式，默认关闭。true 等同于 "nearest"；也可设置 "start" 或 "center"。它与元素上的 v-epg-scroll 独立，详见自动滚动。