跳到主要内容

Logo 主标

展示调用方提供的标识图片。本页使用 Unif 标识演示,应用通过 source 提供自己的内容。

代码演示

下方渲染的就是 src/components/ui/Logo/Logo.tsx 本体,通过 react-native-web 翻译成浏览器节点。source 由 consumer 自传(品牌资产由消费者持有),文档站这里通过本地包装传入 static/img/logo.png

装饰 Logo · 默认 size=64
有意义图片 · role=image / label=Unif
尺寸档位 32 / 64 / 96 / 120
borderRadius 覆盖

0 直角 · 默认 squircle · 32 满圆

资源位置

用途路径说明
RN App消费端自有资源(例如 @/assets/logo.pngLogo 只接收 source,npm 包不携带品牌图片
文档站 navbar / OG image / Faviconwebsite/static/img/logo.png同源镜像,docusaurus.config.ts 内三处都引用同一份

用法

React Native(推荐:用 <Logo> 组件)

import { Logo } from '@unif/react-native-design';

const source = require('@/assets/logo.png');

<Logo source={source} /> // 装饰图片
<Logo source={source} accessibilityLabel="Unif" /> // 有意义图片
<Logo source={source} size={32} borderRadius={32} /> // 满圆

Web / Docusaurus(静态资源)

import useBaseUrl from '@docusaurus/useBaseUrl';

function BrandImage() {
return (
<img src={useBaseUrl('/img/logo.png')} alt="Unif" width="64" height="64" />
);
}

App Icon 预设尺寸

平台输出尺寸
iOS App icon1024×1024(源文件即用)
iOS @1x/@2x/@3x60 / 120 / 180
Android mdpi → xxxhdpi48 / 72 / 96 / 144 / 192
浏览器 favicon32 / 48 / 64

消费端若持有 1024×1024 主标源文件,可按需下采样;组件本身不负责生成或分发这些尺寸。

API

参数类型默认值说明
sourceImageSourcePropType必填 —— 品牌 logo 图片源(require('./logo.png') / { uri: '...' });组件不持有任何资产
sizenumber?64渲染正方形边长
borderRadiusnumber?size / 4圆角;不传走柔和的 squircle
accessibilityLabelstring?trim 后非空时设为图片名称,并启用 role="image";缺省/空白时按装饰图片处理
styleStyleProp<ImageStyle>?附加样式
testIDstring?E2E 定位

底层渲染为单个 <Image>resizeMode="cover"

无障碍(a11y)

来源:src/components/ui/Logo/Logo.tsxtypes.ts

本组件渲染为单个本地 RN <Image>accessibilityLabel trim 后非空时,图片设置 accessibleaccessibilityRole="image" 与对应名称;缺省或空白时,完整使用内部装饰隐藏属性移出 a11y tree。空白值仍按装饰图片处理,并在 dev effect 中为每个实例诊断一次。

<Logo source={require('@/assets/logo.png')} /> // 装饰
<Logo
source={require('@/assets/logo.png')}
accessibilityLabel="Unif 健康快乐"
/>

用法规则

  • 背景色 主橙 #EB6E00不要换其它底色。如需放在浅色背景上,外层包一层主橙圆角容器或留 padding。
  • 不要变形 等比缩放可以;扁平拉伸 / 改色 / 加阴影 / 加描边都不行。
  • 最小尺寸 24×24 飞鸟主标在 ≥24px 清晰可读;更小尺寸(如 16×16 浏览器 tab)就接受糊感,或临时用一张降采样后的 PNG,不要为了清晰度重画 logo。
  • 不要替换 "健康快乐" 标语 这是 logo 内嵌文字,不是 caption——不要外加自定义副标。
  • 不要重新绘制飞鸟 使用 <Logo> 组件并传入消费端持有的正式品牌资源,不要用 SVG 重画。

Favicon

文档站 (docusaurus.config.ts) 的 favicon / themeConfig.image / navbar.logo.src 三处都指向同一份 img/logo.png —— 站点视觉一致性优先于小尺寸辨识度。