tridion - 当仪表板按钮被禁用时，我们可以显示不同的工具提示吗？

Question

我正在专门使用 Tridion 2011 的 PowerTools 扩展，但这适用于仪表板中带有按钮的任何 Anguilla 扩展。

我们可以设置<ext:title>获得悬停工具提示。用户将鼠标悬停在 GUI 扩展按钮上以查看此文本。参见 config 中“计数项目”扩展的示例.

<ext:extension assignid="CountItems" name="Count Items" 
               pageid="Power Tools" groupid="Tools">
    <ext:command>PT_CountItems</ext:command>
    <ext:title>Count Items</ext:title>
    <ext:issmallbutton>false</ext:issmallbutton>
    <ext:dependencies>
        <cfg:dependency>PowerTools.Commands</cfg:dependency>
    </ext:dependencies>
    <ext:apply>
        <ext:view name="DashboardView" />
    </ext:apply>
</ext:extension>

我们有一个请求到 change this tooltip to some helpful text未启用扩展程序时。

我可以在 Chrome 控制台的按钮中看到“计数项目”文本。

<div id="CountItems" class="tridion button PT_CountItems ribbonitem disabled"
     title="Count Items" c:command="PT_CountItems" 
     c:controltype="Tridion.Controls.RibbonButton" 
     style="-webkit-user-select: none; ">
    <div class="image">&nbsp;</div>
    <div class="text">Count Items</div>
</div>

同样在控制台中，我可以选择文本周围的 div: $("div#CountItems > div.text") .我不确定如何获取文本。

问题:
当 GUI 按钮处于非事件状态时，如何/应该更改工具提示文本？

我可能也需要澄清这些。

在安圭拉(或 PowerTools)中，$()与 jQuery() 相同?我试过$("div#CountItems > div.text").text()并获取 Object #<HTMLDivElement> has no method 'text'

当按钮被禁用时，是否有首选或可配置的方式来设置该工具提示？我确信我们可以在 DOM 中找到一个元素，但我可能遗漏了一些东西。

最后，

会{NameSpace}.Commands.{ExtensionName}.prototype.isValidSelection = function(selection)
{ }通常是更改此工具提示的正确位置吗？

对于上下文菜单，我相信我们有 _isAvailable 代替。

Answer 1

$() 和 jQuery() 一样吗？

不，Tridion UI 包含 jQuery 库的一个子集:sizzle CSS selector engine .

因此，所有用于选择一组元素的常用 jQuery 技巧都可以使用，但其他 jQuery 方法(AJAX 东西、事件处理程序、实用方法)将不是 能得到的。

请注意，如果您想在扩展中使用完整的 jQuery，可以通过将其包含在所谓的 noConflict mode 中来实现。 .

当按钮被禁用时，我可以设置工具提示吗？

据我所知，Tridion GUI 中的按钮只有一个工具提示，并且每个按钮状态都会显示该工具提示。也没有ontooltip当 GUI 即将显示它时，您可以 Hook 以计算工具提示的事件。

按钮确实有公共(public) setTooltip ，因此一旦检测到某种情况，您就可以自己更改它。如果您在安圭拉源代码中搜索 setTooltip您将找到一些如何使用它的示例(在欢迎屏幕中，将组件演示添加到页面时以及在 BluePrint 查看器中)。

isValidSelection 是更改此工具提示的正确位置吗？

不要问“我可以在显示工具提示时更改它吗？”，而是尝试将其改写为“哪个状态导致哪个工具提示？我可以检测到状态更改并在那个时候设置正确的工具提示吗？”。

如果您的工具/命令仅在选择某种类型的项目时启用，您应该检测该条件，然后在那时设置工具提示。然后，当 GUI 需要向您显示工具提示时，您无需执行任何操作。

当然，这只会将您的问题推到其他地方:如何检测这种或那种情况。但是您会发现为此类“应用程序状态更改”查找事件通常比为“ontooltip”查找事件更容易。