using System.Linq; using System.Collections.ObjectModel; /******************************************/ /* */ /* Copyright (c) 2018 monitor1394 */ /* https://github.com/monitor1394 */ /* */ /******************************************/ using System.Collections.Generic; using UnityEngine; using UnityEngine.UI; using System; using UnityEngine.EventSystems; namespace XCharts { /// /// Tooltip component. /// 提示框组件 /// [System.Serializable] public class Tooltip : MainComponent { /// /// Indicator type. /// 指示器类型。 /// public enum Type { /// /// line indicator. /// 直线指示器 /// Line, /// /// shadow crosshair indicator. /// 阴影指示器 /// Shadow, /// /// no indicator displayed. /// 无指示器 /// None, /// /// crosshair indicator, which is actually the shortcut of enable two axisPointers of two orthometric axes. /// 十字准星指示器。坐标轴显示Label和交叉线。 /// Corss } [SerializeField] private bool m_Show; [SerializeField] private Type m_Type; [SerializeField] private string m_Formatter; [SerializeField] private string m_ItemFormatter; [SerializeField] private string m_TitleFormatter; [SerializeField] private float m_FixedWidth = 0; [SerializeField] private float m_FixedHeight = 0; [SerializeField] private float m_MinWidth = 0; [SerializeField] private float m_MinHeight = 0; [SerializeField] private string m_NumericFormatter = ""; [SerializeField] private float m_PaddingLeftRight = 5f; [SerializeField] private float m_PaddingTopBottom = 5f; [SerializeField] private string m_IgnoreDataDefaultContent = "-"; [SerializeField] private bool m_AlwayShow = false; [SerializeField] private Vector2 m_Offset = new Vector2(18f, -25f); [SerializeField] private Sprite m_BackgroundImage; [SerializeField] private TextStyle m_TextStyle = new TextStyle(18, FontStyle.Normal); [SerializeField] private LineStyle m_LineStyle = new LineStyle(LineStyle.Type.Solid, 0.7f); private GameObject m_GameObject; private GameObject m_Content; private Text m_ContentText; private Image m_ContentImage; private RectTransform m_ContentRect; private RectTransform m_ContentTextRect; private List lastDataIndex { get; set; } /// /// Whether to show the tooltip component. /// 是否显示提示框组件。 /// public bool show { get { return m_Show; } set { if (PropertyUtility.SetStruct(ref m_Show, value)) { SetAllDirty(); SetActive(value); } } } /// /// Indicator type. /// 提示框指示器类型。 /// public Type type { get { return m_Type; } set { if (PropertyUtility.SetStruct(ref m_Type, value)) SetAllDirty(); } } /// /// 提示框总内容的字符串模版格式器。支持用 \n 换行。当formatter不为空时,优先使用formatter,否则使用itemFormatter。 /// 模板变量有{.}、{a}、{b}、{c}、{d}。 /// {.}为当前所指示或index为0的serie的对应颜色的圆点。 /// {a}为当前所指示或index为0的serie的系列名name。 /// {b}为当前所指示或index为0的serie的数据项serieData的name,或者类目值(如折线图的X轴)。 /// {c}为当前所指示或index为0的serie的y维(dimesion为1)的数值。 /// {d}为当前所指示或index为0的serie的y维(dimesion为1)百分比值,注意不带%号。 /// {.1}表示指定index为1的serie对应颜色的圆点。 /// {a1}、{b1}、{c1}中的1表示指定index为1的serie。 /// {c1:2}表示索引为1的serie的当前指示数据项的第3个数据(一个数据项有多个数据,index为2表示第3个数据)。 /// {c1:2-2}表示索引为1的serie的第3个数据项的第3个数据(也就是要指定第几个数据项时必须要指定第几个数据)。 /// {d1:2:f2}表示单独指定了数值的格式化字符串为f2(不指定时用numericFormatter)。 /// 示例:"{a}:{c}"、"{a1}:{c1:f1}"、"{a1}:{c1:0:f1}"、"{a1}:{c1:1-1:f1}"、 /// public string formatter { get { return m_Formatter; } set { m_Formatter = value; } } /// /// 提示框标题内容的字符串模版格式器。支持用 \n 换行。仅当itemFormatter生效时才有效。可以单独设置占位符{i}表示忽略不显示title。 /// public string titleFormatter { get { return m_TitleFormatter; } set { m_TitleFormatter = value; } } /// /// 提示框单个serie或数据项内容的字符串模版格式器。支持用 \n 换行。当formatter不为空时,优先使用formatter,否则使用itemFormatter。 /// public string itemFormatter { get { return m_ItemFormatter; } set { m_ItemFormatter = value; } } /// /// 固定宽度。比 minWidth 优先。 /// public float fixedWidth { get { return m_FixedWidth; } set { m_FixedWidth = value; } } /// /// 固定高度。比 minHeight 优先。 /// public float fixedHeight { get { return m_FixedHeight; } set { m_FixedHeight = value; } } /// /// 最小宽度。如若 fixedWidth 设有值,优先取 fixedWidth。 /// public float minWidth { get { return m_MinWidth; } set { m_MinWidth = value; } } /// /// 最小高度。如若 fixedHeight 设有值,优先取 fixedHeight。 /// public float minHeight { get { return m_MinHeight; } set { m_MinHeight = value; } } [Obsolete("Use Tooltip.textStyle.fontSize instead.", true)] public int fontSize { get; set; } [Obsolete("Use Tooltip.textStyle.fontStyle instead.", true)] public FontStyle fontStyle { get; set; } /// /// Standard numeric format strings. /// 标准数字格式字符串。用于将数值格式化显示为字符串。 /// 使用Axx的形式:A是格式说明符的单字符,支持C货币、D十进制、E指数、F定点数、G常规、N数字、P百分比、R往返、X十六进制的。xx是精度说明,从0-99。 /// 参考:https://docs.microsoft.com/zh-cn/dotnet/standard/base-types/standard-numeric-format-strings /// /// public string numericFormatter { get { return m_NumericFormatter; } set { if (PropertyUtility.SetClass(ref m_NumericFormatter, value)) SetComponentDirty(); } } /// /// the text padding of left and right. defaut:5. /// 左右边距。 /// public float paddingLeftRight { get { return m_PaddingLeftRight; } set { m_PaddingLeftRight = value; } } /// /// the text padding of top and bottom. defaut:5. /// 上下边距。 /// public float paddingTopBottom { get { return m_PaddingTopBottom; } set { m_PaddingTopBottom = value; } } /// /// 被忽略数据的默认显示字符信息。 /// public string ignoreDataDefaultContent { get { return m_IgnoreDataDefaultContent; } set { m_IgnoreDataDefaultContent = value; } } /// /// The image of icon. /// 图标的图片。 /// public Sprite backgroundImage { get { return m_BackgroundImage; } set { m_BackgroundImage = value; SetBackground(m_BackgroundImage); } } /// /// 是否触发后一直显示。 /// public bool alwayShow { get { return m_AlwayShow; } set { m_AlwayShow = value; } } /// /// 提示框相对于鼠标位置的偏移。 /// public Vector2 offset { get { return m_Offset; } set { m_Offset = value; } } /// /// 提示框内容文本样式。 /// public TextStyle textStyle { get { return m_TextStyle; } set { if (value != null) { m_TextStyle = value; SetComponentDirty(); } } } /// /// 指示线样式。 /// public LineStyle lineStyle { get { return m_LineStyle; } set { if (value != null) m_LineStyle = value; SetComponentDirty(); } } /// /// 组件是否需要刷新 /// public override bool componentDirty { get { return m_ComponentDirty || lineStyle.componentDirty || textStyle.componentDirty; } } internal override void ClearComponentDirty() { base.ClearComponentDirty(); lineStyle.ClearComponentDirty(); textStyle.ClearComponentDirty(); } /// /// 当前提示框所指示的Serie索引(目前只对散点图有效)。 /// public Dictionary> runtimeSerieIndex { get; internal set; } /// /// The data index currently indicated by Tooltip. /// 当前提示框所指示的数据项索引。 /// public List runtimeDataIndex { get; internal set; } /// /// the value for x indicator label. /// 指示器X轴上要显示的值。 /// public float[] runtimeXValues { get; internal set; } /// /// the value for y indicator label. /// 指示器Y轴上要显示的值。 /// public float[] runtimeYValues { get; internal set; } /// /// the current pointer position. /// 当前鼠标位置。 /// public Vector2 runtimePointerPos { get; internal set; } /// /// the width of tooltip. /// 提示框宽。 /// public float runtimeWidth { get { return m_ContentRect.sizeDelta.x; } } /// /// the height of tooltip. /// 提示框高。 /// public float runtimeHeight { get { return m_ContentRect.sizeDelta.y; } } /// /// Whether the tooltip has been initialized. /// 提示框是否已初始化。 /// public bool runtimeInited { get { return m_GameObject != null; } } /// /// the gameObject of tooltip. /// 提示框的gameObject。 /// public GameObject runtimeGameObject { get { return m_GameObject; } } /// /// 当前指示的角度。 /// public float runtimeAngle { get; internal set; } public static Tooltip defaultTooltip { get { var tooltip = new Tooltip { m_Show = true, runtimeXValues = new float[2] { -1, -1 }, runtimeYValues = new float[2] { -1, -1 }, runtimeDataIndex = new List() { -1, -1 }, lastDataIndex = new List() { -1, -1 }, runtimeSerieIndex = new Dictionary>() }; return tooltip; } } /// /// 绑定提示框gameObject /// /// public void SetObj(GameObject obj) { m_GameObject = obj; m_GameObject.SetActive(false); } /// /// 绑定提示框的文本框gameObject /// /// public void SetContentObj(GameObject content) { m_Content = content; m_ContentRect = m_Content.GetComponent(); m_ContentImage = m_Content.GetComponent(); m_ContentImage.raycastTarget = false; m_ContentText = m_Content.GetComponentInChildren(); if (m_ContentText != null) { m_ContentTextRect = m_ContentText.gameObject.GetComponentInChildren(); } SetBackground(backgroundImage); } /// /// Keep Tooltiop displayed at the top. /// 保持Tooltiop显示在最顶上 /// public void UpdateToTop() { int count = m_GameObject.transform.parent.childCount; m_GameObject.GetComponent().SetSiblingIndex(count - 1); } /// /// 设置提示框文本背景色 /// /// public void SetContentBackgroundColor(Color color) { if (m_ContentImage != null) m_ContentImage.color = color; } /// /// 设置提示框文本背景图片 /// /// public void SetBackground(Sprite sprite) { if (m_ContentImage != null) { m_ContentImage.type = Image.Type.Sliced; m_ContentImage.sprite = sprite; } } /// /// 设置提示框文本字体颜色 /// /// public void SetContentTextColor(Color color) { if (m_ContentText) { m_ContentText.color = color; } } /// /// 设置提示框文本内容 /// /// public void UpdateContentText(string txt) { if (m_ContentText) { m_ContentText.text = txt; float wid, hig; if (m_FixedWidth > 0) wid = m_FixedWidth; else if (m_MinWidth > 0 && m_ContentText.preferredWidth < m_MinWidth) wid = m_MinWidth; else wid = m_ContentText.preferredWidth + m_PaddingLeftRight * 2; if (m_FixedHeight > 0) hig = m_FixedHeight; else if (m_MinHeight > 0 && m_ContentText.preferredHeight < m_MinHeight) hig = m_MinHeight; else hig = m_ContentText.preferredHeight + m_PaddingTopBottom * 2; if (m_ContentRect != null) m_ContentRect.sizeDelta = new Vector2(wid, hig); if (m_ContentTextRect != null) { m_ContentTextRect.anchoredPosition = new Vector3(m_PaddingLeftRight, -m_PaddingTopBottom); } } } /// /// 清除提示框指示数据 /// internal void ClearValue() { for (int i = 0; i < runtimeDataIndex.Count; i++) runtimeDataIndex[i] = -1; for (int i = 0; i < runtimeXValues.Length; i++) runtimeXValues[i] = -1; for (int i = 0; i < runtimeYValues.Length; i++) runtimeYValues[i] = -1; } /// /// 提示框是否显示 /// /// public bool IsActive() { return m_GameObject != null && m_GameObject.activeInHierarchy; } /// /// 设置提示框是否显示 /// /// public void SetActive(bool flag) { if (!flag && m_AlwayShow) return; lastDataIndex[0] = lastDataIndex[1] = -1; if (m_GameObject && m_GameObject.activeInHierarchy != flag) m_GameObject.SetActive(flag); } /// /// 更新文本框位置 /// /// public void UpdateContentPos(Vector2 pos) { if (m_Content) m_Content.transform.localPosition = pos; } /// /// 获得当前提示框的位置 /// /// public Vector3 GetContentPos() { if (m_Content) return m_Content.transform.localPosition; else return Vector3.zero; } /// /// Whether the data item indicated by tooltip has changed. /// 提示框所指示的数据项是否发生变化。 /// /// public bool IsDataIndexChanged() { return runtimeDataIndex[0] != lastDataIndex[0] || runtimeDataIndex[1] != lastDataIndex[1]; } /// /// 当前索引缓存 /// internal void UpdateLastDataIndex() { lastDataIndex[0] = runtimeDataIndex[0]; lastDataIndex[1] = runtimeDataIndex[1]; } /// /// 当前提示框是否选中数据项 /// /// public bool IsSelected() { return runtimeDataIndex[0] >= 0 || runtimeDataIndex[1] >= 0; } /// /// 指定索引的数据项是否被提示框选中 /// /// /// public bool IsSelected(int index) { return runtimeDataIndex[0] == index || runtimeDataIndex[1] == index; } public void ClearSerieDataIndex() { foreach (var kv in runtimeSerieIndex) { kv.Value.Clear(); } } public void AddSerieDataIndex(int serieIndex, int dataIndex) { if (!runtimeSerieIndex.ContainsKey(serieIndex)) { runtimeSerieIndex[serieIndex] = new List(); } runtimeSerieIndex[serieIndex].Add(dataIndex); } public bool isAnySerieDataIndex() { foreach (var kv in runtimeSerieIndex) { if (kv.Value.Count > 0) return true; } return false; } } }