可配项修改

大约 4 分钟

可配项修改

Appearance.swift 是容纳了所有可配项的类。这些可配项都有默认值,如果要修改某些配置项,需要在初始化对应 UI 控件之前修改其中的属性,配置项才生效。

通用可配项

注意下述 value 为要设置的值,会改变对应配置项的 UI 样式或者数据源等。请查看源码open in new window后使用。

  1. Appearance.pageContainerTitleBarItemWidth = value:底部弹窗页面标题栏的宽度。若要配置,请在 Xcode 中的文件中搜索 PageContainerTitleBar.swift

img

  1. Appearance.pageContainerConstraintsSize = value:底部弹窗页面的宽度和高度。主要使用类在 Xcode 中查找到 PageContainersDialogController.swift 查看该属性。

img

  1. Alert 的样式:
  • Appearance.alertContainerConstraintsSize = value:Alert 居中类型弹窗的宽度和高度。主要使用类在 Xcode 中查找到 AlertController.swift

  • Appearance.alertStyle = value:弹窗的圆角样式,即是大圆角还是小圆角。

img

  1. Appearance.primaryHue = value:主色调,用于按钮、输入框等控件的背景色。

  2. Appearance.secondaryHue = value:辅色调,用于按钮、输入框等控件的背景色。

  3. Appearance.errorHue = value:错误色调。

  4. Appearance.neutralHue = value:中性色调。

  5. Appearance.neutralSpecialHue = value:中性特殊色调。

  6. Appearance.avatarRadius = value:头像圆角,分为极小、小、中、大等四个等级。

  7. Appearance.actionSheetRowHeight = value:ActionSheet Cell 的行高。

img

  1. Appearance.avatarPlaceHolder = value 头像占位图。

会话列表可配项

  1. Appearance.conversation.rowHeight = value:会话列表 Cell 的高度。

img

  1. Appearance.conversation.swipeLeftActions = value/Appearance.conversation.swipeRightActions = value:会话列表左滑菜单项和右滑菜单项。

img

  1. Appearance.conversation.moreActions = value:右滑会话后出现的 ... 菜单项点击后的 ActionSheet 的菜单项。

img

  1. Appearance.conversation.singlePlaceHolder = value 会话列表单聊会话头像占位图和群聊会话头像占位图。

img

  1. Appearance.conversation.dateFormatToday = value/Appearance.conversation.dateFormatOtherDay = value:今天和今天之外的日期格式。

img

  1. Appearance.conversation.listMoreActions = value:点击会话列表右上角的 + 之后的 ActionSheet 的菜单项。

img

联系人列表及其后续页面可配项

  1. Appearance.contact.rowHeight = value:联系人列表 Cell 的高度。

img

  1. Appearance.contact.headerRowHeight = value:联系人列表 Header Cell 的高度。

img

  1. Appearance.contact.listHeaderExtensionActions = value:联系人列表 Header List 数据源。

img

  1. Appearance.contact.detailExtensionActionItems = value:联系人以及群组详情 header 中可配菜单项,主要功能包括聊天、音视频通话等。

img

  1. Appearance.contact.moreActions = value:联系人以及群组详情右上角的 ... 点击后的 ActionSheet 的菜单项。

img

聊天页面可配项

  1. Appearance.chat.maxInputHeight = value:聊天页面输入框最大输入高度。

  2. Appearance.chat.inputPlaceHolder = value:聊天页面输入框默认占位符。

  3. Appearance.chat.inputBarCorner = value:聊天页面输入框圆角。

img

  1. Appearance.chat.bubbleStyle = value:聊天页面消息气泡的样式分为带箭头与多圆角两种。

img

  1. Appearance.chat.contentStyle = value:聊天页面消息中显示内容的可配项数组,可以将不想要的功能移除即可。可配置项有是否显示昵称、是否显示头像、是否显示 reply、是否显示reaction、是否显示 thread、是否显示时间等。

img

  1. Appearance.chat.messageLongPressedActions = value:聊天页面长按消息后的 ActionSheet 菜单项。

img

  1. Appearance.chat.reportSelectionTags = value:聊天页面非法消息的举报类型。

img

  1. Appearance.chat.reportSelectionReasons = value:聊天页面非法消息的举报原因。

img

  1. Appearance.chat.inputExtendActions = value:聊天页面输入框右侧 + 点击后 ActionSheet 菜单项。

img

  1. Appearance.chat.dateFormatToday = value/Appearance.chat.dateFormatOtherDay = value:聊天页面消息今天和今天之外的日期格式。

img

  1. Appearance.chat.audioDuration = value:聊天页面语音消息录制的最大时长,默认为 60 秒。

img

  1. Appearance.chat.receiveAudioAnimationImages = value/Appearance.chat.sendAudioAnimationImages = value:聊天页面接收方/发送方语音消息播放时的动画图片。

img

img

  1. Appearance.chat.receiveTextColor = value/Appearance.chat.sendTextColor = value:聊天页面接收方/发送方消息文字颜色。

img

  1. Appearance.chat.imageMessageCorner = value:聊天页面图片消息圆角,默认为 4。

img

  1. Appearance.chat.imagePlaceHolder = value:聊天页面图片消息占位图。

  2. Appearance.chat.videoPlaceHolder = value:聊天页面视频消息占位图。

  3. Appearance.chat.recallExpiredTime = value:聊天页面消息撤回的有效时间,默认为 120 秒。

  4. Appearance.chat.newMessageSoundPath = value:聊天页面收到新消息时的播放音频文件的路径。

  5. Appearance.chat.receiveTranslationColor = value:消息接收方翻译文本颜色。

  6. Appearance.chat.sendTranslationColor = value:消息发送方翻译文本颜色。

  7. Appearance.chat.enableTranslation = value:是否开启文本消息长按翻译功能,默认为 false,即该功能默认关闭。如需开启该特性,需设置为 true

  8. Appearance.chat.targetLanguage = value:翻译目标语言默认为中文。