OPEN_GRID API - v1.6.0
    Preparing search index...

    Function applyHeader

    • 헤더 프리셋을 적용한다. 코어 무수정 경로.

      두 경로가 있고, 능력 차이가 타이포 축보다 훨씬 크다. 정직하게 밝힌다.

      1. targetHTMLElement(그리드 컨테이너 = .og-container)이면 data-og-header 속성을 붙인다. header.css 의 프리셋 블록이 전부 살아난다. 이 경로가 완전판이며 open-grid/header.css 로드가 전제다. 값을 인라인하지 않는 이유는 인라인 스타일이 프리셋의 T1(토큰 재정의) 규칙보다 강해 프리셋을 덮어버리기 때문이다.
      2. target그리드 인스턴스이면 공개 setThemeVar() 로 형태 토큰 8개만 인라인 주입한다. OpenGrid 는 컨테이너 요소를 반환하는 공개 접근자를 제공하지 않으므로(_container 는 private) 속성을 붙일 방법이 없다. 헤더 축은 프리셋의 거의 전부가 속성 조건부 셀렉터라 이 경로로는 사실상 아무 변화가 없다 — 타이포 축과 달리 "반쪽" 이 아니라 "거의 무동작" 이다. 그 사실을 경고로 반환한다.

      완전 적용이 필요하면 컨테이너 요소를 직접 넘겨라(document.querySelector('.og-container')).

      Apply a header preset. Requires no core modification.

      There are two paths and the capability gap is much wider than the typography axis's.

      1. An HTMLElement target gets the data-og-header attribute and every CSS preset rule works.
      2. A grid instance target gets only the 8 shape tokens injected inline. Because virtually all preset rules are attribute-conditional, this path produces almost no visible change — this is returned as a warning rather than failing silently.

      ヘッダープリセットを適用します。コアの修正は要りません。

      経路は2つあり、その能力差はタイポグラフィ軸よりずっと大きいです。正直に明かします。

      1. targetHTMLElement(グリッドのコンテナ = .og-container)なら data-og-header 属性を 付けます。header.css のプリセットブロックがすべて生きます。この経路が完全版であり、 open-grid/header.css の読み込みが前提です。 値をインライン化しないのは、インラインスタイルが プリセットの T1(トークン再定義)規則より強く、プリセットを上書きしてしまうからです。
      2. targetグリッドインスタンスなら、公開 API の setThemeVar() で形状トークン8個だけを インライン注入します。OpenGrid はコンテナ要素を返す公開アクセサーを提供しないため (_container は private)、属性を付ける手段がありません。 ヘッダー軸はプリセットのほとんどが 属性条件付きセレクターなので、この経路では事実上まったく変化がありません — タイポグラフィ軸と 違って「半分」ではなく「ほぼ無動作」です。その事実を警告として返します。

      完全に適用したいときは、コンテナ要素を直接渡してください(document.querySelector('.og-container'))。

      应用表头预设。不需要修改核心。

      有两条路径,能力差距比排版轴大得多。这里如实说明。

      1. targetHTMLElement(表格容器 = .og-container)时,加上 data-og-header 属性。 header.css 的预设块全部生效。这条路径才是完整版,前提是加载了 open-grid/header.css 不把值内联的理由是: 内联样式比预设的 T1(令牌重定义)规则更强,会把预设覆盖掉。
      2. target表格实例时,通过公开的 setThemeVar() 只内联注入8个形状令牌。OpenGrid 不提供 返回容器元素的公开访问器(_container 是 private),因此没有办法加上属性。表头轴的预设几乎 全是属性条件选择器,所以这条路径实际上什么也不会变 — 与排版轴不同,不是「一半」而是 「几乎不动」。这个事实会作为警告返回。

      需要完全应用时,请直接传入容器元素(document.querySelector('.og-container'))。

      Parameters

      • target: HTMLElement | HeaderGridTarget

        그리드 컨테이너 요소 또는 그리드 인스턴스

        The grid container element, or a grid instance

        グリッドのコンテナ要素、またはグリッドインスタンス

        表格容器元素,或表格实例

      • id: string

        프리셋 id('default' 는 축 해제 = 오늘의 헤더)

        Preset id ('default' clears the axis)

        プリセット id('default' は軸の解除 = 今のヘッダーそのまま)

        预设 id('default' 为解除该轴 = 保持现在的表头)

      Returns HeaderApplyResult

      적용 경로 + 정직 고지

      The path taken plus honest notices

      適用した経路 + 正直な注意書き

      采用的路径 + 如实告知

      target 이 요소도 그리드도 아니면 Error

      Throws when the target is neither an element nor a grid

      target が要素でもグリッドでもなければ Error

      target 既不是元素也不是表格时抛出 Error

      import { applyHeader } from 'open-grid/header';
      import 'open-grid/header.css';

      applyHeader(document.querySelector('.og-container')!, 'rule'); // 완전 적용
      applyHeader(grid, 'rule'); // 토큰만 — 경고 1건 반환(사실상 무동작)