ConfigProvider 设计文档

全局配置总入口,借助 Svelte Context 向子树注入跨组件公共配置:locale(多语言,复用 LocaleProvider 的 createLocale + LOCALE_CONTEXT_KEY 机制注入)、direction(文本方向,rtl 时渲染 `<div class="cd-rtl">` 包裹层驱动组件镜像,否则 renderless 无 DOM)、timeZone(时区标识,数字偏移 / GMT± / IANA,透传给时间类组件)、getPopupContainer(全局浮层默认挂载容器,经 context 暴露给浮层组件在自身 prop 未传时回退,最终回退 document.body)。嵌套时浅合并(undefined 继承、就近 wins)。响应式断点:responsiveObserve 默认 false(不注册任何 matchMedia),开启后在首次订阅时懒注册监听、无订阅时自动注销;responsiveMap 自定义断点(key 为 xs/sm/md/lg/xl/xxl,引用比较,inline 新对象触发重注册);onBreakpoint / screens 非 props,经 getConfigResponsive(等价 Semi ConfigConsumer)读取,onBreakpoint 支持 `(cb)`(拿完整 screens)与 `(breakpoints, cb)`(拿单断点变化)两种签名、订阅时立即回调一次;defaultResponsiveMap 作为默认断点导出。ConfigProvider 本身无独立 token / scss,是纯逻辑组件(对齐 Semi)。

← API 文档

使用建议

全局配置总入口,借助 Svelte Context 向子树注入跨组件公共配置:locale(多语言,复用 LocaleProvider 的 createLocale + LOCALE_CONTEXT_KEY 机制注入)、direction(文本方向,rtl 时渲染 `<div class="cd-rtl">` 包裹层驱动组件镜像,否则 renderless 无 DOM)、timeZone(时区标识,数字偏移 / GMT± / IANA,透传给时间类组件)、getPopupContainer(全局浮层默认挂载容器,经 context 暴露给浮层组件在自身 prop 未传时回退,最终回退 document.body)。嵌套时浅合并(undefined 继承、就近 wins)。响应式断点:responsiveObserve 默认 false(不注册任何 matchMedia),开启后在首次订阅时懒注册监听、无订阅时自动注销;responsiveMap 自定义断点(key 为 xs/sm/md/lg/xl/xxl,引用比较,inline 新对象触发重注册);onBreakpoint / screens 非 props,经 getConfigResponsive(等价 Semi ConfigConsumer)读取,onBreakpoint 支持 `(cb)`(拿完整 screens)与 `(breakpoints, cb)`(拿单断点变化)两种签名、订阅时立即回调一次;defaultResponsiveMap 作为默认断点导出。ConfigProvider 本身无独立 token / scss,是纯逻辑组件(对齐 Semi)。

Accessibility

  • direction=rtl 时渲染 `<div class="cd-rtl">` 承载方向作用域供 RTL 辅助技术读取(对齐 Semi .semi-rtl);其余方向 renderless 无 DOM、不打断 a11y 树;推荐宿主同步 html lang/dir。

设计变量

该组件暂无专属设计变量。