애플리케이션 개발자용

맞춤 테마

변경할 수 없는 사전 설정을 복사하고, 검증이 완료된 후에만 저장하고, 런타임의 원자 경계 내에서 가져오기, 미리 보기 및 지속성을 유지합니다.

사전 설정은 변경할 수 없습니다.

const copied = runtime.duplicateTheme("oria-default", {
  id: "brand-2026",
  name: "Brand 2026",
});

runtime.updateCustomTheme(copied.id, {
  name: "Brand 2026 (refined)",
  modes: { light: draftLightTokens, dark: draftDarkTokens },
});
runtime.setTheme(copied.id);

DuplicateTheme은 사용자 정의 테마를 생성합니다. 사전 설정은 변경하거나 삭제할 수 없습니다. 활성 사용자 정의 테마를 제거하면 구성된 기본값으로 돌아갑니다.

미리보기는 지속성이 아닙니다.

PreviewTheme는 기본 설정이나 저장 공간을 변경하지 않고 현재 완전한 유효한 초안만 적용합니다. 핸들을 폐기하면 최신 공식 상태가 복원됩니다. createCustomTheme 또는 updateCustomTheme을 통해 저장하면 쓰기 전에 완전히 검증됩니다.

가져오기는 항상 계약을 통해 이루어집니다.

try {
  const imported = runtime.importTheme(json);
  runtime.setTheme(imported.id);
} catch (error) {
  // Branch on OriaThemeError.code, not its English message.
}

가져오기는 사용자 정의 테마가 되며 사전 설정을 덮어쓸 수 없습니다. 잘못된 JSON 또는 토큰은 부분적으로 적용되지 않습니다. 오류 텍스트를 일치시키는 대신 OriaThemeError.code 또는 유효성 검사 문제를 제시합니다.

계속: 애플리케이션 정의 사전 설정